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.
Implementatiehandleiding
Lees assistent-toolingdocumentatieMachineleesbaar contract
Assistent-tooling OpenAPI JSON/api/docs/openapi.jsonOpenbare 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.
Machineleesbaar contract
Community OpenAPI JSON/api/v1/community/public/openapi/v1Openbaar, 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.
Machineleesbaar contract
Leveranciers-OpenAPI JSON/api/v1/supplier/openapi/v1Openbaar 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.
Machineleesbaar contract
Enterprise Identity OpenAPI JSON/api/v1/enterprise/identity/openapi/v1Beschermd contract voor goedgekeurde bedrijfswerkruimtes; vraag toegang aan voordat je dit eindpunt gebruikt.
Plan een integratie02 — Implementatiehandleiding
Kies het contract vóór de code
- 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.
- 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.
- 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.
Toegang en omgevingen
Bevestig de contractversie, goedgekeurde werkruimte, authenticatiescopes, testomgeving, productie-inloggegevens en callbackbestemmingen.
Fouten en herstel
Leg vóór release herhaalde verzoeken, idempotentie, time-outs, zichtbare fouten, monitoring, verantwoordelijkheid voor ondersteuning en terugdraaien vast.
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.