# MerchandAise API- ja integraatiosopimukset | MerchandAise

- slug: developers-api-integrations
- locale: fi
- localeResolved: fi
- canonical: https://www.merchandaise.com/fi/developers/api-integrations

Tutustu MerchandAise-sopimuksiin avustintyökaluja, yhteisöupotuksia, toimittajaoperaatioita ja yritystunnistusta varten — selkein julkisin ja suojatuin pääsynrajoin.

## Pidä yksi totuuden lähde
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.

## API-rajapinnat ja integraatiopinnat
- **Avustintyökalujen API-dokumentaatio:** 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.
- **Yhteisöupotus-API:** 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.
- **Toimittaja-API:** 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.
- **Yritystunnistus-API:** 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.

## Valitse sopimus ennen koodia
- **Step 1: Kartoi käyttäjäpolku:** 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.
- **Step 2: Vahvista pääsyn rajaus:** Käytä julkisia sopimuksia arviointiin ja asiakasohjelmien generointiin, ja vahvista sitten tunnukset, scopet, ympäristöt, callbackit ja suojatut päätepisteet ennen toteutusta.
- **Step 3: Todista tilan jatkuvuus:** Testaa, että suunnittelut, tarjoukset, hyväksynnät, virheet ja tilansiirrot pysyvät versiotasalla integraation yli, mukaan lukien uudelleenyrittoyritykset ja peruutuspolut.

## Mitä jokaisen integraation on säilytettävä
- **Yksi versioitu tila:** Suunnittelu, kaupallinen tarkoitus, toimittajan tukema tarjous, hyväksyntä ja tilan tila pysyvät yhteydessä. Vanhoihin muutoksiin on liitettävä näkyvä uudelleenlaskenta tai tarkistustila.
- **Kaupallinen ja toimittajaprioriteetti:** MerchandAise on ostajaa kohtaava myyjä ja tukivastuu pysyy sillä. Toimittajaidentiteetit, yhteystiedot ja sisäinen data eivät ole julkisesti näkyvissä integraatioiden kautta.
- **Hyväksyntä ennen tuotantoa:** Tuote-spesifinen 3D-näkymä ja digitaalinen proof tukevat päätöstä, mutta ne eivät korvaa aitoa tuotantosampelia, joka vaaditaan ennen massatuotantoa.

## Ennen tuotantoliikennettä
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.
- **Pääsy ja ympäristöt:** Vahvista sopimuksen versio, hyväksytty työtila, todennusscope, sandbox, tuotantotunnukset ja callback-kohteet.
- **Virhe ja palautus:** Määrittele uudelleenyrittoyritykset, idempotenssi, aikakatkaisut, käyttäjälle näkyvät virheet, observoitavuus, tukivastuu ja rollback ennen julkaisua.
- **Loppu-to-loppu todisteet:** Varmista odotettu polku stagingissa sisäänpääsystä ja tilan muutoksesta tarjouksen, hyväksynnän, siirron ja palautumisen kautta.

## UKK
- **Mistä integraatiopinnasta minun pitäisi aloittaa?:** 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.
- **Tarkoittaako julkinen sopimus julkista tuotantokäyttöä?:** 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.
- **Voiko integraatio paljastaa toimittajia tai ohittaa hyväksynnät?:** 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.

## Tuo meille työnkulku, ei valmiiksi suunniteltua arkkitehtuuria.
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.
- **Suunnittele integraatio:** /fi/contact?intent=api-integration-review
- **Tutustu AI-agenteihin ja MCP:hen:** /fi/developers/ai-agents-mcp