MerchandAise Entwicklerplattform
Verbinden Sie Ihre Abläufe mit MerchandAise.
Finden Sie API-Dokumentation und OpenAPI-Spezifikationen für individuelle Merchandise-Prozesse. Verbinden Sie Websites, Communities, Lieferantenprozesse oder Unternehmenskonten mit gemeinsamen Design-, Offert- und Bestellinformationen.
Wählen Sie die passende Verbindung für Ihr Projekt
Nutzen Sie die folgenden Referenzen, um Endpunkte, Anfrageformate und Zugriffsanforderungen zu prüfen. Öffentliche Spezifikationen helfen bei Planung und Client-Generierung; operativer Zugriff hängt von API, Konto und Umgebung ab.
Wenn MerchandAise die Käufertransaktion abwickelt, ist Hutter Products GmbH die vertragliche Verkäuferin und Merchant of Record unter der Marke MerchandAise. Identität und Kontaktdaten von Lieferanten bleiben privat, ausser eine Offenlegung ist erforderlich. Vor der Produktion sind die Freigabe des digitalen Entwurfs, bestätigte Herstellbarkeit, verbindliche technische Prüfungen und die für den genau angenommenen Auftrag geltenden Musterfreigaben erforderlich.
01 — Verträge
APIs und Integrationsschnittstellen
01
API-Dokumentation & OpenAPI
Finden Sie die API-Referenz für Assistenten-Tools und Design-Sessions. Wählen Sie anschliessend den Community-, Lieferanten- oder Enterprise-Vertrag für Ihren Anwendungsfall.
Implementierungsleitfaden
Assistenten-Tooling-Dokumentation lesenMaschinenlesbarer Vertrag
OpenAPI-JSON für Assistenten-Tools/api/docs/openapi.jsonÖffentliche Referenz für Assistenten- und Tooling-APIs. Produktivzugriff und Bestellvorgänge erfordern weiterhin die passende Autorisierung.
02
Community API
Verbinden Sie eine Vereins- oder Community-Website mit öffentlichen Community-Daten, Designeinreichungen, Abstimmungen und Übergaben zur Bestellfreigabe.
- Umfang des Vertrags
- Öffentlicher Community-Kontext, Designbeiträge und Stimmen, Veröffentlichung von Produkteinträgen, ausstehende Bestellungen sowie Freigabe oder Ablehnung durch Community-Verantwortliche.
- Ein möglicher Einstieg
- Lesen Sie den öffentlichen Community-Kontext für eine Vereinswebsite. Klären Sie danach, welche Aktionen eine Mitgliedersitzung oder Rechte von Verantwortlichen benötigen, bevor Sie Designeinreichungen oder Checkout-Übergaben einbauen.
- Zugriff
- Die Spezifikation ist öffentlich. Für öffentliche Lesezugriffe, Mitgliederaktionen und Aktionen von Verantwortlichen gelten unterschiedliche Berechtigungen. Beachten Sie die Sicherheitsregeln jedes Endpunkts.
Maschinenlesbarer Vertrag
Community OpenAPI JSON/api/v1/community/public/openapi/v1Öffentlicher, versionierter Vertrag für Storefront-Einbettungen, Community-Suche und sprachspezifische Übergaben.
03
Lieferanten-API
Verbinden Sie Systeme zugelassener Lieferanten mit freigegebenen Produktionspaketen, dem Onboarding-Status und ERP- oder PLM-Webhook-Prozessen.
- Umfang des Vertrags
- Onboarding-Status von Lieferanten, freigegebene Produktionspakete, protokollierte Artefakt-Downloads, Analysen, Webhook-Abonnements und Synchronisationspunkte.
- Ein möglicher Einstieg
- Planen Sie die Verbindung zwischen Ihrem ERP- oder Produktlebenszyklus-System und dem Supplier Center. Prüfen Sie Webhook-Daten, Wiederholungen und Synchronisationsstatus, bevor Sie eine zugewiesene Bestellung bearbeiten.
- Zugriff
- Die OpenAPI-Spezifikation ist ohne Anmeldung lesbar. Operative Anfragen erfordern ein berechtigtes Lieferantenkonto. Die öffentliche Dokumentation meldet keinen Lieferanten an und gewährt keinen Zugriff auf Daten anderer Lieferanten.
Maschinenlesbarer Vertrag
Lieferanten-OpenAPI-JSON/api/v1/supplier/openapi/v1Öffentlicher Vertrag für Planung und Client-Generierung. Operativer Lieferantenzugriff bleibt berechtigungsgebunden.
04
Enterprise Identity API
Verbinden Sie zugelassene Unternehmens-Workspaces mit Single Sign-on, Benutzer- und Gruppenbereitstellung sowie Identity-Audit-Daten.
- Umfang des Vertrags
- OpenID Connect (OIDC) Single Sign-on, SCIM-Prozesse für Benutzer und Gruppen, Rotation von SCIM-Tokens und Audit-Ereignisse zur Bereitstellung.
- Ein möglicher Einstieg
- Ordnen Sie Ihren Identitätsanbieter dem zugelassenen Workspace zu. Planen Sie Anmeldung, Bereitstellung und Deaktivierung von Benutzern und prüfen Sie danach Gruppenzuordnung und Audit-Daten in der vereinbarten Testumgebung.
- Zugriff
- Die Enterprise-Identity-Spezifikation ist geschützt. Besprechen Sie Workspace und Zugriffsanforderungen vor der Implementierung mit dem Integrationsteam. Für gewöhnliche Produktkäufe ist Enterprise Identity nicht erforderlich.
Maschinenlesbarer Vertrag
Enterprise-Identity-OpenAPI-JSON/api/v1/enterprise/identity/openapi/v1Geschützter Vertrag für zugelassene Enterprise-Workspaces. Fordern Sie vor der Nutzung dieses Endpunkts Zugriff an.
Integration planen02 — Implementierungsleitfaden
Erst den Vertrag wählen, dann implementieren
- 01
Den Nutzerablauf abbilden
Legen Sie fest, wer wo in den Ablauf eintritt: Käufer in einer eingebetteten Storefront, zugelassene Lieferanten, Unternehmensnutzer oder ausdrücklich autorisierte Assistenten.
- 02
Die Zugriffsgrenze bestätigen
Nutzen Sie öffentliche Verträge für Bewertung und Client-Generierung. Klären Sie danach Zugangsdaten, Berechtigungsumfänge, Umgebungen, Callbacks und geschützte Endpunkte vor der Implementierung.
- 03
Durchgängigen Status nachweisen
Testen Sie, dass Designs, Offerten, Freigaben, Fehler und Bestellübergaben über die Integration hinweg versionsaktuell bleiben – auch bei Wiederholungsversuchen und Rückfällen.
03 — Was jede Integration bewahren muss
Was jede Integration bewahren muss
Ein versionierter Status
Design, Kaufabsicht, lieferantengestützte Offerte, Freigaben und Bestellstatus bleiben verbunden. Veraltete Änderungen müssen eine sichtbare neue Offerte oder Prüfung auslösen.
Geschäftsdaten und Lieferanten schützen
MerchandAise bleibt für Käufer Verkäuferin und Support-Anlaufstelle. Identitäten, Kontakte und interne Daten von Lieferanten werden durch öffentliche Integrationen nicht offengelegt.
Freigabe vor der Produktion
Eine 3D-Ansicht ist kein physischer Nachweis. Die bestätigte Offerte erläutert verfügbare Optionen für ein Kundenmuster, Kosten, Grenzen und Termine. Vor der Serienproduktion müssen der genaue digitale Entwurf freigegeben, verbindliche technische Prüfungen abgeschlossen und alle erforderlichen oder gewählten Musterfreigaben erteilt sein. Bereits angenommene Auftragsanforderungen gelten weiterhin.
04
Vor produktivem Datenverkehr
Eine veröffentlichte OpenAPI-Datei dient der Planung und verspricht keinen anonymen Produktivzugriff. Vor dem Start prüfen wir Umgebungen, Zugangsdaten, Fehlerbehandlung und betriebliche Zuständigkeit.
Zugriff und Umgebungen
Bestätigen Sie Vertragsversion, zugelassenen Workspace, Authentifizierungsrechte, Testumgebung, Produktivzugang und Callback-Ziele.
Fehler und Wiederherstellung
Definieren Sie Wiederholungsversuche, Idempotenz, Zeitlimits, sichtbare Fehler, Überwachung, Support-Zuständigkeit und Rückfallwege vor der Freigabe.
Nachweis des gesamten Ablaufs
Prüfen Sie den geplanten Ablauf in der Testumgebung vom Einstieg über Statusänderungen bis zu Offerte, Freigabe, Übergabe und Wiederherstellung.
Häufige Fragen
Mit welcher Merchandise-API soll ich beginnen?
Beginnen Sie bei der Person und der Statusänderung. Community-Einbettungen eignen sich für Käuferabläufe von Vereinen und Communities, Lieferantenprozesse für zugelassene Lieferanten, Enterprise Identity für SSO und SCIM und Assistenten-Tools nur für ausdrücklich autorisierte KI-gestützte Abläufe.
Bedeutet ein öffentlicher Vertrag auch öffentlichen Produktivzugriff?
Nein. Eine öffentliche OpenAPI-Spezifikation unterstützt Suche, Architekturprüfung und Client-Generierung. Produktive Zugangsdaten, Schreibzugriffe, Lieferantenprozesse, Enterprise Identity und die Ausführung durch Assistenten können weiterhin einen zugelassenen Workspace und begrenzte Berechtigungen erfordern.
Darf eine Integration Lieferanten offenlegen oder Freigaben umgehen?
Nein. Identität und Kontaktdaten von Lieferanten bleiben privat, ausser eine Offenlegung ist erforderlich. MerchandAise verantwortet die Käuferbeziehung. Bestellwirksame Aktionen müssen die für den Auftrag geltenden Freigaben des digitalen Entwurfs, technischen Prüfungen und Musterfreigaben bewahren.
Planen Sie Ihre Integration mit uns.
Sagen Sie uns, wer die Integration nutzt, welche Daten gelesen oder geändert werden sollen und wo das Erlebnis stattfindet. Gemeinsam klären wir Vertrag, Zugriffsmodell und einen sicheren Start.