{"pageKey":"Developers","slug":"developers-api-integrations","locale":"fi","localeResolved":"fi","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/fi/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"MerchandAise API- ja integraatiosopimukset | MerchandAise","description":"Tutustu MerchandAise-sopimuksiin avustintyökaluja, yhteisöupotuksia, toimittajaoperaatioita ja yritystunnistusta varten — selkein julkisin ja suojatuin pääsynrajoin.","sections":[{"heading":"Pidä yksi totuuden lähde","paragraphs":["Integraation tulee laajentaa MerchandAise-työnkulkua, ei haarukoida sitä. Verkkosivustojen, upotusten, toimittaja- ja yrityspintojen sekä tulevien avustintapojen on luettava ja päivitettävä samaa versioitua suunnittelu-, kaupallinen tarkoitus-, tarjous-, hyväksyntä- ja tila-tilaa.","Missä MerchandAise käsittelee ostotapahtumaa, Hutter Products GmbH on MerchandAise-brändin alle sopimuksellinen myyjä ja Merchant of Record. Toimittajatiedot ja yhteystiedot pidetään yksityisinä, ellei paljastaminen ole pakollista, ja tuotanto vaatii edelleen digitaalisen todistuksen ja oikean tuotantosample-hyväksynnän ennen massatuotantoa."]},{"heading":"API-rajapinnat ja integraatiopinnat","items":[{"title":"Avustintyökalujen API-dokumentaatio","description":"Tutustu tämän hetken avustin- ja työkalupäätepisteisiin suunnittelusessioita ja integraatiotarkistusta varten. Tämä julkinen viite ei anna anonyymiä oikeutta tehdä tarjouksia tai tehdä tilauksia. Human guide: Avaa avustintyökalujen dokumentaatio (/fi/developers/api-integrations). Machine-readable contract: Avustintyökalujen OpenAPI JSON (/api/docs/openapi.json). Access: public. Julkinen viite avustin- ja työkalujen API:lle. Tuotantokäyttö ja tilaustilaa muuttavat toiminnot edellyttävät edelleen asianmukaista valtuutusta. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"Yhteisöupotus-API","description":"Liitä paikallistetut klubin, yhteisön tai myymälän kokemukset MerchandAise-omistettuihin suunnittelu- ja kaupankäyntivaiheisiin ilman, että tarvitsee rakentaa työnkulkua uudelleen. Human guide: Tutustu yhteisöintegraatio-oppaaseen (/fi/developers/api-integrations#community-integrations). Machine-readable contract: Yhteisön OpenAPI JSON (/api/v1/community/public/openapi/v1). Access: public. Julkinen versionoitu sopimus myymäläupotuksia, yhteisönlöytöjä ja paikallisuuteen sopeutettuja siirtoja varten. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"Toimittaja-API","description":"Yhdistä hyväksytyt toimittajat perehdytykseen, luetteloihin, tarjouksiin ja toimitusoperaatioihin sen jälkeen kun toimittajasuhde ja pääsyn malli on hyväksytty. Human guide: Tutustu toimittaja-integraatio-oppaaseen (/fi/developers/api-integrations#supplier-integrations). Machine-readable contract: Toimittajan OpenAPI JSON (/api/v1/supplier/openapi/v1). Access: public. Julkinen sopimus suunnittelua ja asiakasasiakirjojen generointia varten. Operatiivinen toimittajapääsy pysyy luvanvaraisena. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"Yritystunnistus-API","description":"Suunnittele SSO-, SCIM-provisiointi- ja auditointivalmiit tunnistusvirrat hyväksytyille yritysohjelmille ja ohjatuille käyttöönotolle. Human guide: Tutustu yritysintegratio-oppaaseen (/fi/developers/api-integrations#enterprise-integrations). Machine-readable contract: Yritystunnistus OpenAPI JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Suojaistu sopimus hyväksytyille yritystyötiloille; pyydä käyttöoikeutta ennen tämän päätepisteen käyttämistä. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Valitse sopimus ennen koodia","items":[{"title":"Step 1: Kartoi käyttäjäpolku","description":"Päätä, kuka tulee työnkulkuun ja mistä: ostaja upotetussa myymälässä, hyväksytty toimittaja, yrityskäyttäjä tai avustin, jolla on nimenomainen valtuutus."},{"title":"Step 2: Vahvista pääsyn rajaus","description":"Käytä julkisia sopimuksia arviointiin ja asiakasohjelmien generointiin, ja vahvista sitten tunnukset, scopet, ympäristöt, callbackit ja suojatut päätepisteet ennen toteutusta."},{"title":"Step 3: Todista tilan jatkuvuus","description":"Testaa, että suunnittelut, tarjoukset, hyväksynnät, virheet ja tilansiirrot pysyvät versiotasalla integraation yli, mukaan lukien uudelleenyrittoyritykset ja peruutuspolut."}]},{"heading":"Mitä jokaisen integraation on säilytettävä","items":[{"title":"Yksi versioitu tila","description":"Suunnittelu, kaupallinen tarkoitus, toimittajan tukema tarjous, hyväksyntä ja tilan tila pysyvät yhteydessä. Vanhoihin muutoksiin on liitettävä näkyvä uudelleenlaskenta tai tarkistustila."},{"title":"Kaupallinen ja toimittajaprioriteetti","description":"MerchandAise on ostajaa kohtaava myyjä ja tukivastuu pysyy sillä. Toimittajaidentiteetit, yhteystiedot ja sisäinen data eivät ole julkisesti näkyvissä integraatioiden kautta."},{"title":"Hyväksyntä ennen tuotantoa","description":"Tuote-spesifinen 3D-näkymä ja digitaalinen proof tukevat päätöstä, mutta ne eivät korvaa aitoa tuotantosampelia, joka vaaditaan ennen massatuotantoa."}]},{"heading":"Ennen tuotantoliikennettä","paragraphs":["Julkaistu OpenAPI-tiedosto on suunnitteluympäristö, ei lupaus anonyymista tuotantokäytöstä. Tarkistamme ympäristöt, tunnukset, virheenkäsittelyn ja operatiivisen vastuun ennen käyttöönottoa."],"items":[{"title":"Pääsy ja ympäristöt","description":"Vahvista sopimuksen versio, hyväksytty työtila, todennusscope, sandbox, tuotantotunnukset ja callback-kohteet."},{"title":"Virhe ja palautus","description":"Määrittele uudelleenyrittoyritykset, idempotenssi, aikakatkaisut, käyttäjälle näkyvät virheet, observoitavuus, tukivastuu ja rollback ennen julkaisua."},{"title":"Loppu-to-loppu todisteet","description":"Varmista odotettu polku stagingissa sisäänpääsystä ja tilan muutoksesta tarjouksen, hyväksynnän, siirron ja palautumisen kautta."}]},{"heading":"UKK","items":[{"title":"Mistä integraatiopinnasta minun pitäisi aloittaa?","description":"Aloita henkilöstä ja tilansiirrosta. Käytä yhteisöupotuksia ostajalle suunnattuihin klubi- tai yhteisöpolkuihin, toimittajaoperaatioita hyväksyttyihin supply-side-työnkulkuihin, yritystunnistusta SSO- ja SCIM-käyttöihin ja avustintyökaluja vain nimenomaisesti valtuutettuihin AI-johtuisiin työnkulkuihin."},{"title":"Tarkoittaako julkinen sopimus julkista tuotantokäyttöä?","description":"Ei. Julkinen OpenAPI-sopimus tukee löytämistä, arkkitehtuurin tarkistusta ja asiakasgenerointia. Tuotantotunnukset, kirjoitustoiminnot, toimittajatyönkulut, yritystunnistus ja avustinajon suoritus voivat silti vaatia hyväksyttyä työtilaa ja rajattua valtuutusta."},{"title":"Voiko integraatio paljastaa toimittajia tai ohittaa hyväksynnät?","description":"Ei. Toimittajaidentiteetit ja yhteystiedot pysyvät yksityisinä ellei lakisääteinen paljastaminen vaadi toisin. MerchandAise omistaa ostajasuhteen, ja tilaa muuttavat toimet on suojattava konfiguroiduilla hyväksyntä- ja aito-sample-porteilla."}]},{"heading":"Tuo meille työnkulku, ei valmiiksi suunniteltua arkkitehtuuria.","paragraphs":["Kerro, kuka käyttää integraatiota, mitä tilaa heidän pitää lukea tai muuttaa ja missä kokemus elää. Kartoitamme kanssasi sopimuksen, pääsyn mallin ja turvallisimman käyttöönoton reitin."],"items":[{"title":"Suunnittele integraatio","description":"/fi/contact?intent=api-integration-review"},{"title":"Tutustu AI-agenteihin ja MCP:hen","description":"/fi/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}