# 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.
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.

## 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). Pääsy: Julkinen. 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). Pääsy: Julkinen. 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). Pääsy: Julkinen. 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). Pääsy: Suojattu. 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:** A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding.

## 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?:** No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.

## 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