Overslaan naar de hoofdinhoud

MerchandAise ontwikkelaarsplatform

Koppel je workflow aan MerchandAise.

Vind API documentatie en OpenAPI-specificaties voor aangepaste merchandise-workflows. Verbind websites, communities, leveranciersactiviteiten of bedrijfsaccounts met gedeelde ontwerp-, offerte- en bestelinformatie.

Kies de verbinding die je project nodig heeft

Gebruik de onderstaande documentatie om eindpunten, aanvraagformaten en autorisatievereisten te beoordelen. Openbare specificaties ondersteunen planning en het genereren van clients. Operationele toegang hangt af van de API, het account en de omgeving.

Waar MerchandAise de klanttransactie verwerkt, is Hutter Products GmbH onder het merk MerchandAise de contractuele verkoper en Merchant of Record. Leveranciersidentiteiten en contactgegevens blijven privé, behalve waar openbaarmaking vereist is. Productie vereist nog steeds goedkeuring van de digitale proef, bevestigde maakbaarheid, verplichte technische controles en de monstergoedkeuringen die voor de exact aanvaarde bestelling gelden.

01 — Contracten

API en integratiefuncties

01

API-documentatie en OpenAPI

Zoek de API-referentie voor assistent-tooling en ontwerpsessies en kies vervolgens het community-, leveranciers- of ondernemingscontract voor je workflow.

Toegang: Openbaar

Implementatiehandleiding

Lees assistent-toolingdocumentatie

Machineleesbaar contract

Assistent-tooling OpenAPI JSON
/api/docs/openapi.json

Openbare referentie voor assistent- en tooling API’s. Voor productietoegang en orderbeïnvloedende handelingen is nog steeds de toepasselijke autorisatie vereist.

02

Community API

Verbind een club- of communitywebsite met openbare community-informatie, ontwerpinzendingen, stemmingen en overdrachten van goedkeuringen van bestellingen.

Wat het contract omvat
Openbare communitycontext, ontwerpposts en -stemmen, publicatielijsten, lopende bestellingen en goedkeuring of afwijzing door community-eigenaren.
Een praktisch uitgangspunt
Lees de openbare communitycontext voor een clubwebsite. Breng vervolgens in kaart welke acties een ledensessie of eigenaarsrechten vereisen voordat ontwerpinzendingen of betalingsoverdrachten worden toegevoegd.
Toegang
De specificatie is openbaar. Openbare leesacties, ledenacties en acties voor eigenaren hebben verschillende autorisatievereisten. Volg de beveiligingsregels van elk eindpunt.
Toegang: Openbaar

Machineleesbaar contract

Community OpenAPI JSON
/api/v1/community/public/openapi/v1

Openbaar, geversioneerd API-contract voor winkel-embeds, communityontdekking en overdrachten met behoud van de taalinstelling.

03

Leveranciers-API

Verbind goedgekeurde leverancierssystemen met vrijgegeven productiepakketten, onboardingstatus en ERP- of PLM-webhookworkflows.

Wat het contract omvat
Onboardingstatus van leveranciers, vrijgegeven productiepakketten, gecontroleerde downloads van bestanden, analyses, webhookabonnementen en controlepunten voor synchronisatie.
Een praktisch uitgangspunt
Plan een verbinding tussen je ERP- of PLM-systeem en het Supplier Center. Controleer webhook-payloads, herhaalde verzoeken en de synchronisatiestatus voordat je een toegewezen bestelling verwerkt.
Toegang
Lees de OpenAPI-specificatie zonder in te loggen. Operationele verzoeken vereisen het juiste leveranciersaccount en de juiste rechten. Openbare documentatie schrijft geen leverancier in en geeft geen toegang tot gegevens van andere leveranciers.
Toegang: Openbaar

Machineleesbaar contract

Leveranciers-OpenAPI JSON
/api/v1/supplier/openapi/v1

Openbaar API-contract voor planning en het genereren van clients. Operationele toegang voor leveranciers vereist nog steeds autorisatie.

04

Enterprise Identity API

Koppel goedgekeurde bedrijfswerkruimtes aan single sign-on, gebruikers- en groepsbeheer en auditgegevens over identiteit.

Wat het contract omvat
OpenID Connect (OIDC) voor single sign-on, SCIM-acties voor de levenscyclus van gebruikers en groepen, SCIM-tokenrotatie en auditgebeurtenissen voor provisioning.
Een praktisch uitgangspunt
Koppel je identiteitsprovider aan de goedgekeurde werkruimte. Plan aanmelding en het aanmaken en verwijderen van gebruikers. Controleer vervolgens groepskoppelingen en auditgegevens in de afgesproken testomgeving.
Toegang
De Enterprise Identity-specificatie is beveiligd. Neem vóór implementatie contact op met het integratieteam om werkruimte- en toegangsvereisten te bespreken. Enterprise Identity is optioneel voor gewone productaankopen.
Toegang: Beschermd

Machineleesbaar contract

Enterprise Identity OpenAPI JSON
/api/v1/enterprise/identity/openapi/v1

Beschermd contract voor goedgekeurde bedrijfswerkruimtes; vraag toegang aan voordat je dit eindpunt gebruikt.

Plan een integratie

02 — Implementatiehandleiding

Kies het contract vóór de code

  1. 01

    Breng de gebruikersreis in kaart

    Bepaal wie de workflow betreedt en waar: een koper in een geïntegreerde winkel, een goedgekeurde leverancier, een zakelijke gebruiker of een assistent die werkt met expliciete toestemming.

  2. 02

    Bevestig de toegangsgrens

    Gebruik openbare contracten voor evaluatie en het genereren van clients, en bevestig vervolgens inloggegevens, scopes, omgevingen, callbacks en beschermde eindpunten vóór implementatie.

  3. 03

    Controleer de continuïteit van de status

    Test of ontwerpen, offertes, goedkeuringen, fouten en besteloverdrachten tijdens de hele integratie aan de actuele versie gekoppeld blijven, inclusief herhaalde verzoeken en herstel bij terugdraaien.

03 — Wat elke integratie moet behouden

Wat elke integratie moet behouden

Eén status met versiebeheer

Ontwerp, koopintentie, door leveranciers onderbouwde offerte, goedkeuring en bestelstatus blijven verbonden. Verouderde wijzigingen moeten zichtbaar een nieuwe offerte of beoordeling vereisen.

Commerciële en leveranciersprivacy

MerchandAise blijft de kopergerichte verkoper en ondersteuningseigenaar. Leveranciersidentiteiten, contacten en interne gegevens worden niet openbaar gemaakt via publieke integraties.

Goedkeuring vóór productie

Een 3D-preview is geen fysiek monster. De bevestigde offerte beschrijft beschikbare klantmonsteropties, kosten, beperkingen en planning. Keur de exacte digitale proef goed en voltooi vóór serieproductie de verplichte technische controles en vereiste of gekozen monstergoedkeuringen. Bestaande vereisten voor aanvaarde bestellingen blijven bindend.

04

Vóór productieverkeer

Een gepubliceerd OpenAPI-bestand helpt je plannen en belooft geen anonieme toegang tot productie. We beoordelen omgevingen, inloggegevens, foutafhandeling en operationele verantwoordelijkheid voordat de integratie live gaat.

01

Toegang en omgevingen

Bevestig de contractversie, goedgekeurde werkruimte, authenticatiescopes, testomgeving, productie-inloggegevens en callbackbestemmingen.

02

Fouten en herstel

Leg vóór release herhaalde verzoeken, idempotentie, time-outs, zichtbare fouten, monitoring, verantwoordelijkheid voor ondersteuning en terugdraaien vast.

03

End-to-end bewijs

Controleer de beoogde gebruikersreis in de testomgeving: van binnenkomst en statuswijziging tot offerte, goedkeuring, overdracht en herstel.

Veelgestelde vragen

Met welke merchandise API moet ik beginnen?

Begin met wie de integratie gebruikt en welke status verandert. Gebruik community-embeds voor klantgerichte club- en communityworkflows, leveranciersactiviteiten voor goedgekeurde leveranciersworkflows, bedrijfsidentiteit voor SSO en SCIM, en assistenttools alleen voor expliciet geautoriseerde AI-workflows.

Betekent een openbaar API-contract ook openbare toegang tot productie?

Nee. Een openbaar OpenAPI-contract ondersteunt ontdekking, architectuurbeoordeling en het genereren van clients. Productie-inloggegevens, schrijfacties, leveranciersworkflows, bedrijfsidentiteit en acties van assistenten kunnen nog steeds een goedgekeurde werkruimte en afgebakende autorisatie vereisen.

Kan een integratie leveranciers blootleggen of goedkeuringen omzeilen?

Nee. Leveranciersidentiteiten en contactgegevens blijven privé, behalve waar openbaarmaking vereist is. MerchandAise blijft verantwoordelijk voor de klantrelatie. Acties die bestellingen beïnvloeden moeten de ingestelde vereisten voor digitale proef, technische controles en bestellingsspecifieke monstergoedkeuring behouden.

Plan je integratie met ons.

Vertel ons wie de integratie gaat gebruiken, welke status ze moeten lezen of wijzigen, en waar de ervaring zal plaatsvinden. Samen met je brengen wij het contract, het toegangsmodel en het veiligste uitroltraject in kaart.