{"pageKey":"Developers","slug":"developers-api-integrations","locale":"fi","localeResolved":"fi","fallbackApplied":false,"version":"developers-api-integrations@2026-11-19T13:03:04.145Z","lastModified":null,"canonicalUrl":"https://www.merchandaise.com/fi/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"Tuote-API-dokumentaatio ja OpenAPI-integraatiot | MerchandAise","description":"Tutustu MerchandAisen API-ohjeisiin ja OpenAPI-määrityksiin personoiduille tuotteille, yhteisöupotuksille, toimittajatyönkuluille ja yritystunnistukselle.","sections":[{"heading":"Valitse projektisi tarvitsema yhteys","paragraphs":["Arvioi alla olevien viitteiden avulla päätepisteet, pyyntömuodot ja valtuutusvaatimukset. Julkiset määritykset tukevat suunnittelua ja asiakasohjelmien generointia. Operatiivinen käyttö riippuu APIsta, tilistä ja ympäristöstä.","Kun MerchandAise käsittelee ostajan maksutapahtuman, Hutter Products GmbH toimii sopimuksen myyjänä ja maksutapahtuman vastuullisena myyjänä (Merchant of Record) MerchandAise-brändin alla. Toimittajan henkilöllisyys ja yhteystiedot pysyvät yksityisinä, ellei niiden ilmoittamista vaadita. Tuotanto edellyttää edelleen digitaalisen vedoksen hyväksyntää, vahvistettua valmistettavuutta, pakollisia teknisiä tarkistuksia ja juuri hyväksyttyyn tilaukseen sovellettavia näytehyväksyntöjä."]},{"heading":"API- ja integraatiorajapinnat","items":[{"title":"API-dokumentaatio ja OpenAPI","description":"Etsi avustajien työkalujen ja suunnitteluistuntojen API-viite. Valitse sitten työnkulkuusi sopiva yhteisö-, toimittaja- tai yritysmääritys. Toteutusopas: Lue avustajatyökalujen ohjeet (/api/docs). Koneluettava määritys: Avustajatyökalujen OpenAPI JSON (/api/docs/openapi.json). Käyttöoikeus: Julkinen. Julkinen viite avustajien ja työkalujen rajapinnoille. Tuotantokäyttö ja tilauksiin vaikuttavat toiminnot edellyttävät yhä soveltuvaa valtuutusta. Ensisijainen sivu: /fi/developers/api-integrations. Ensisijainen osio: /fi/developers/api-integrations#api-docs."},{"title":"Yhteisö-API","description":"Yhdistä seuran tai yhteisön sivusto julkisiin yhteisötietoihin, suunnitelmien lähettämiseen, äänestämiseen ja tilauksen hyväksyntään siirtymiseen. Mitä määritys kattaa: Julkinen yhteisön asiayhteys, suunnitelmajulkaisut ja äänet, listausten julkaisu, odottavat tilaukset sekä yhteisön omistajan hyväksyntä tai hylkäys. Käytännöllinen lähtökohta: Lue julkinen yhteisön asiayhteys seuran sivustolle. Kartoita sitten jäsenistunnon tai omistajan oikeuksia vaativat toiminnot ennen suunnitelmien lähettämistä tai kassalle siirtymistä. Käyttöoikeus: Määritys on julkinen. Julkisilla lukupyynnöillä, jäsentoiminnoilla ja vain omistajalle sallituilla toiminnoilla on eri valtuutusvaatimukset. Noudata jokaisen päätepisteen turvallisuussääntöjä. Toteutusopas: Tutustu Yhteisö-APIin (/fi/developers/api-integrations#community-integrations). Koneluettava määritys: Yhteisön OpenAPI JSON (/api/v1/community/public/openapi/v1). Käyttöoikeus: Julkinen. Julkinen versioitu määritys kauppaupotuksiin, yhteisöjen löytämiseen ja kieliversion säilyttäviin siirtymiin. Ensisijainen sivu: /fi/developers/api-integrations. Ensisijainen osio: /fi/developers/api-integrations#community-integrations."},{"title":"Toimittaja-API","description":"Yhdistä hyväksyttyjen toimittajien järjestelmät julkaistuihin tuotantopaketteihin, perehdytystilaan ja ERP- tai PLM-webhook-työnkulkuihin. Mitä määritys kattaa: Toimittajan perehdytystila, julkaistut tuotantopaketit, kirjatut aineistolataukset, analytiikka, webhook-tilaukset ja synkronoinnin tarkistuspisteet. Käytännöllinen lähtökohta: Suunnittele ERP- tai tuotteen elinkaarenhallintajärjestelmäsi yhteys Toimittajakeskukseen. Tarkista webhookien tietosisällöt, uudelleenyritykset ja synkronointitilanne ennen osoitetun tilauksen käsittelyä. Käyttöoikeus: Lue OpenAPI-määritys ilman kirjautumista. Operatiiviset pyynnöt edellyttävät asianmukaista toimittajatiliä ja oikeuksia. Julkinen dokumentaatio ei liitä toimittajaa verkostoon eikä anna pääsyä toisen toimittajan tietoihin. Toteutusopas: Tutustu Toimittaja-APIin (/fi/developers/api-integrations#supplier-integrations). Koneluettava määritys: Toimittajan OpenAPI JSON (/api/v1/supplier/openapi/v1). Käyttöoikeus: Julkinen. Julkinen määritys suunnittelua ja asiakasohjelmien generointia varten. Toimittajan operatiivinen käyttö edellyttää käyttöoikeuksia. Ensisijainen sivu: /fi/developers/api-integrations. Ensisijainen osio: /fi/developers/api-integrations#supplier-integrations."},{"title":"Yritysten tunnistautumis-API","description":"Yhdistä hyväksytyt yritystyötilat kertakirjautumiseen, käyttäjien ja ryhmien hallintaan sekä tunnistautumisen tarkistuslokiin. Mitä määritys kattaa: OpenID Connect (OIDC) -kertakirjautuminen, SCIM-käyttäjien ja -ryhmien elinkaaritoiminnot, SCIM-tunnisteiden vaihto sekä käyttäjähallinnan tarkistustapahtumat. Käytännöllinen lähtökohta: Yhdistä tunnistuspalvelusi hyväksyttyyn työtilaan. Suunnittele kirjautuminen sekä käyttäjien lisääminen ja poistaminen. Vahvista sitten ryhmävastaavuudet ja tarkistuslokit sovitussa testiympäristössä. Käyttöoikeus: Yritystunnistuksen määritys on suojattu. Ota yhteyttä integraatiotiimiin arvioidaksesi työtilan ja käyttöoikeusvaatimukset ennen toteutusta. Yritystunnistus ei ole tavallisten tuoteostosten edellytys. Toteutusopas: Tutustu yritysten tunnistautumiseen (/fi/developers/api-integrations#enterprise-integrations). Koneluettava määritys: Yritystunnistuksen OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Käyttöoikeus: Suojattu. Suojattu määritys hyväksytyille yritystyötiloille. Pyydä käyttöoikeus ennen tämän päätepisteen käyttämistä. Ensisijainen sivu: /fi/developers/api-integrations. Ensisijainen osio: /fi/developers/api-integrations#enterprise-integrations."}]},{"heading":"Valitse määritys ennen koodia","items":[{"title":"Vaihe 1: Kartoita käyttäjän polku","description":"Päätä, kuka siirtyy työnkulkuun ja missä: upotetun kaupan ostaja, hyväksytty toimittaja, yrityskäyttäjä tai nimenomaisella valtuutuksella toimiva avustaja."},{"title":"Vaihe 2: Vahvista käyttöoikeusraja","description":"Käytä julkisia määrityksiä arviointiin ja asiakasohjelmien generointiin. Vahvista sitten tunnistetiedot, käyttöoikeusalueet, ympäristöt, paluukutsut ja suojatut päätepisteet ennen toteutusta."},{"title":"Vaihe 3: Todista tilan jatkuvuus","description":"Testaa, että suunnitelmat, tarjoukset, hyväksynnät, virheet ja tilaussiirtymät säilyvät ajantasaisina koko integraatiossa, myös uudelleenyrityksissä ja palautuspoluilla."}]},{"heading":"Mitä jokaisen integraation on säilytettävä","items":[{"title":"Yksi versioitu tila","description":"Suunnitelma, ostoaikomus, toimittajan vahvistama tarjous, hyväksyntä ja tilaustilanne pysyvät yhteydessä toisiinsa. Vanhentuneiden muutosten on tuotava näkyviin uusi tarjouspyyntö tai arviointitila."},{"title":"Kaupallisten ja toimittajatietojen yksityisyys","description":"MerchandAise säilyy ostajalle näkyvänä myyjänä ja tuesta vastaavana tahona. Toimittajien henkilöllisyyksiä, yhteystietoja ja sisäisiä tietoja ei paljasteta julkisissa integraatioissa."},{"title":"Hyväksyntä ennen tuotantoa","description":"3D-näkymä ei ole fyysistä näyttöä. Vahvistettu tarjous kertoo mahdollisista asiakasnäytteistä, niiden kustannuksista, rajoituksista ja aikataulusta. Hyväksy täsmällinen digitaalinen vedos ja suorita pakolliset tekniset tarkistukset sekä vaadittu tai valittu näytteen hyväksyntä ennen massatuotantoa. Hyväksyttyjen tilausten nykyiset vaatimukset pysyvät sitovina."}]},{"heading":"Ennen tuotantoliikennettä","paragraphs":["Julkaistu OpenAPI-tiedosto on suunnittelun apuväline, ei lupaus anonyymistä tuotantokäytöstä. Arvioimme ympäristöt, tunnistetiedot, virheiden käsittelyn ja toimintavastuut ennen käyttöönottoa."],"items":[{"title":"Käyttöoikeudet ja ympäristöt","description":"Vahvista määritysversio, hyväksytty työtila, tunnistautumisen käyttöoikeusalueet, testiympäristö, tuotantotunnisteet ja paluukutsujen kohteet."},{"title":"Virheet ja palautuminen","description":"Määritä uudelleenyritykset, idempotenssi, aikakatkaisut, asiakkaalle näkyvät virheet, seurattavuus, tukivastuut ja palautus ennen julkaisua."},{"title":"Koko polun näyttö","description":"Vahvista tarkoitettu polku testiympäristössä aloituksesta ja tilamuutoksesta tarjoukseen, hyväksyntään, siirtymään ja palautumiseen."}]},{"heading":"Usein kysyttyä","items":[{"title":"Mistä tuote-APIsta kannattaa aloittaa?","description":"Aloita käyttäjästä ja tilasiirtymästä. Käytä yhteisöupotuksia ostajille suunnattuihin seura- ja yhteisöpolkuihin, toimittajatoimintoja hyväksyttyihin tarjontapuolen työnkulkuihin, yritystunnistusta SSO:hon ja SCIMiin sekä avustajatyökaluja vain nimenomaisesti valtuutettuihin tekoälyn ohjaamiin toimintoihin."},{"title":"Tarkoittaako julkinen määritys julkista tuotantokäyttöä?","description":"Ei. Julkinen OpenAPI-määritys tukee löytämistä, arkkitehtuurin arviointia ja asiakasohjelmien generointia. Tuotantotunnisteet, kirjoitustoiminnot, toimittajatyönkulut, yritystunnistus ja avustajan suorittamat toiminnot voivat silti edellyttää hyväksyttyä työtilaa ja rajattua valtuutusta."},{"title":"Voiko integraatio paljastaa toimittajia tai ohittaa hyväksynnät?","description":"Ei. Toimittajan henkilöllisyys ja yhteystiedot pysyvät yksityisinä paitsi silloin, kun niiden ilmoittamista vaaditaan. MerchandAise vastaa asiakassuhteesta, ja tilauksiin vaikuttavien toimintojen on säilytettävä määritetyt digitaalisen vedoksen, teknisten tarkistusten ja tilauskohtaisten näytteiden hyväksyntävaatimukset."}]},{"heading":"Suunnittele integraatiosi kanssamme.","paragraphs":["Kerro, kuka integraatiota käyttää, mitä tilaa luetaan tai muutetaan ja missä käyttökokemus sijaitsee. Kartoitamme kanssasi määrityksen, käyttöoikeusmallin ja turvallisimman käyttöönottopolun."],"items":[{"title":"Suunnittele integraatio","description":"/fi/contact?intent=api-integration-review"},{"title":"Tutustu tekoälyagentteihin ja MCP:hen","description":"/fi/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"route-owned-source","schema":"2025-11-05"}}