Hoppa till huvudinnehållet

MerchandAises utvecklarplattform

Koppla arbetsflödet till MerchandAise.

Hitta API-dokumentation och OpenAPI-specifikationer för anpassade produktflöden. Koppla webbplatser, communities, leverantörsarbete eller företagskonton till gemensam design-, offert- och beställningsinformation.

Välj kopplingen som projektet behöver

Använd referenserna nedan för att bedöma ändpunkter, anropsformat och behörighetskrav. Offentliga specifikationer stödjer planering och klientgenerering. Operativ åtkomst beror på API, konto och miljö.

När MerchandAise hanterar köpartransaktionen är Hutter Products GmbH avtalssäljare och Merchant of Record under varumärket MerchandAise. Leverantörsidentitet och kontaktuppgifter förblir privata utom när utlämning krävs. Produktion kräver fortsatt godkänt digitalt korrektur, bekräftad tillverkningsbarhet, obligatoriska tekniska kontroller och de provgodkännanden som gäller för den exakta accepterade beställningen.

01 — Kontrakt

API- och integrationsytor

01

API-dokumentation och OpenAPI

Hitta API-referensen för assistentverktyg och designsessioner och välj sedan community-, leverantörs- eller företagskontrakt för arbetsflödet.

Åtkomst: Offentlig/api/docs/openapi.json

Offentlig referens för assistent- och verktygs-API:er. Produktionsåtkomst och beställningspåverkande åtgärder kräver fortfarande tillämplig behörighet.

02

Community-API

Koppla en förenings- eller communitywebbplats till offentlig communityinformation, designbidrag, omröstningar och överlämning för beställningsgodkännande.

Vad kontraktet omfattar
Offentligt communitysammanhang, designinlägg och röster, publicering av annonser, väntande beställningar samt godkännande eller avslag från communityägaren.
En praktisk utgångspunkt
Läs offentligt communitysammanhang för en föreningswebbplats. Kartlägg sedan vilka åtgärder som kräver medlemssession eller ägarbehörighet innan designbidrag eller övergångar till kassan läggs till.
Åtkomst
Specifikationen är offentlig. Offentlig läsning, medlemsåtgärder och ägaråtgärder har olika behörighetskrav. Använd säkerhetsreglerna för varje ändpunkt.
Åtkomst: Offentlig/api/v1/community/public/openapi/v1

Offentligt versionshanterat kontrakt för inbäddade butiker, communitysökning och språkanpassade övergångar.

03

Leverantörs-API

Koppla godkända leverantörssystem till frisläppta produktionspaket, anslutningsstatus och webhookflöden för ERP eller PLM.

Vad kontraktet omfattar
Leverantörsanslutningens status, frisläppta produktionspaket, spårbara filnedladdningar, analys, webhookprenumerationer och synkroniseringspunkter.
En praktisk utgångspunkt
Planera en koppling mellan ert ERP- eller produktlivscykelsystem och leverantörscentret. Granska webhookinnehåll, återförsök och synkroniseringsstatus innan en tilldelad beställning hanteras.
Åtkomst
Läs OpenAPI-specifikationen utan inloggning. Operativa anrop kräver rätt leverantörskonto och behörigheter. Offentlig dokumentation ansluter inte en leverantör och ger inte åtkomst till andra leverantörers data.
Åtkomst: Offentlig/api/v1/supplier/openapi/v1

Offentligt kontrakt för planering och klientgenerering. Operativ leverantörsåtkomst kräver fortsatt behörighet.

04

API för företagsidentitet

Koppla godkända företagsarbetsytor till enkel inloggning, etablering av användare och grupper samt granskningsloggar för identitet.

Vad kontraktet omfattar
Enkel inloggning med OpenID Connect (OIDC), SCIM-livscykelåtgärder för användare och grupper, rotation av SCIM-token och granskningshändelser för etablering.
En praktisk utgångspunkt
Koppla identitetsleverantören till den godkända arbetsytan. Planera inloggning, etablering och avveckling av användare och verifiera sedan gruppmappning och granskningsloggar i överenskommen testmiljö.
Åtkomst
Specifikationen för företagsidentitet är skyddad. Kontakta integrationsteamet för att granska arbetsyta och åtkomstkrav före implementation. Företagsidentitet är valfritt vid vanliga produktköp.
Åtkomst: Skyddad

Maskinkontrakt

OpenAPI-JSON för företagsidentitet
/api/v1/enterprise/identity/openapi/v1

Skyddat kontrakt för godkända företagsarbetsytor. Begär åtkomst innan ändpunkten används.

Planera en integration

02 — Implementationsguide

Välj kontraktet före koden

  1. 01

    Kartlägg användarresan

    Bestäm vem som använder arbetsflödet och var: en köpare i en inbäddad butik, en godkänd leverantör, en företagsanvändare eller en assistent med uttrycklig behörighet.

  2. 02

    Bekräfta åtkomstgränsen

    Använd offentliga kontrakt för bedömning och klientgenerering. Bekräfta sedan autentiseringsuppgifter, behörighetsomfattningar, miljöer, callbacks och skyddade ändpunkter före implementation.

  3. 03

    Verifiera att tillståndet följer med

    Testa att designer, offerter, godkännanden, fel och beställningsövergångar behåller aktuell version genom integrationen, inklusive återförsök och återställningsvägar.

03 — Vad varje integration måste bevara

Vad varje integration måste bevara

Ett versionshanterat tillstånd

Design, köpavsikt, leverantörsbekräftad offert, godkännande och beställningsstatus förblir sammankopplade. Inaktuella ändringar måste leda till en synlig ny offert eller granskning.

Affärs- och leverantörssekretess

MerchandAise förblir köparens säljare och supportansvarig. Leverantörsidentiteter, kontakter och interna data visas inte genom offentliga integrationer.

Godkännande före produktion

En 3D-vy är inget fysiskt belägg. Den bekräftade offerten beskriver tillgängliga kundprov, kostnader, begränsningar och tidsplan. Godkänn det exakta digitala korrekturet och slutför obligatoriska tekniska kontroller samt godkännande av alla obligatoriska eller valda prov före serieproduktion. Befintliga krav för accepterade beställningar fortsätter att gälla.

04

Före produktionstrafik

En publicerad OpenAPI-fil är en planeringsyta, inte ett löfte om anonym produktionsåtkomst. Vi granskar miljöer, autentiseringsuppgifter, felhantering och operativt ansvar före driftsättning.

01

Åtkomst och miljöer

Bekräfta kontraktsversion, godkänd arbetsyta, behörighetsomfattningar, testmiljö, produktionsuppgifter och callbackdestinationer.

02

Fel och återhämtning

Definiera återförsök, idempotens, tidsgränser, kundsynliga fel, övervakning, supportansvar och återställning före release.

03

Underlag för hela flödet

Verifiera den avsedda resan i testmiljön från ingång och tillståndsändring till offert, godkännande, överlämning och återhämtning.

Vanliga frågor

Vilket produkt-API ska jag börja med?

Börja med personen och tillståndsövergången. Använd inbäddad community för köparflöden i föreningar och communities, leverantörsarbete för godkända leverantörsflöden, företagsidentitet för SSO och SCIM och assistentverktyg endast för uttryckligen behöriga AI-ledda flöden.

Innebär ett offentligt kontrakt offentlig produktionsåtkomst?

Nej. Ett offentligt OpenAPI-kontrakt stödjer upptäckt, arkitekturgranskning och klientgenerering. Produktionsuppgifter, skrivåtgärder, leverantörsflöden, företagsidentitet och assistentkörning kan fortfarande kräva en godkänd arbetsyta och avgränsad behörighet.

Kan en integration visa leverantörer eller kringgå godkännanden?

Nej. Leverantörsidentitet och kontaktuppgifter förblir privata utom när utlämning krävs. MerchandAise ansvarar för köparrelationen, och beställningspåverkande åtgärder måste bevara konfigurerade krav på digitalt korrektur, teknik och beställningsspecifika provgodkännanden.

Planera integrationen med oss.

Berätta vem som ska använda integrationen, vilket tillstånd de behöver läsa eller ändra och var upplevelsen ska finnas. Vi kartlägger kontrakt, åtkomstmodell och en säker införandeväg med er.