MerchandAise-Entwicklerplattform
Ein Produkt-Workflow. Vier Wege zur Anbindung.
Verbinden Sie eine Website, eine Community, den Lieferantenbetrieb oder einen Unternehmens-Workspace mit denselben versionierten Design-, Angebots-, Freigabe- und Bestellstatus. Beginnen Sie mit dem veröffentlichten Vertrag und planen Sie anschließend gemeinsam mit uns den Zugriff und die Produktionsanbindung.
Eine einzige Datenquelle als Fundament
Eine Integration sollte den MerchandAise-Workflow erweitern, nicht duplizieren oder abspalten. Website-, Embed-, Lieferanten-, Enterprise- und zukünftige Assistenz-Oberflächen müssen denselben versionierten Status für Design, kommerzielle Absicht, Angebot, Freigabe und Bestellung lesen und aktualisieren.
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.
01 — Verträge
API- und Integrationsoberflächen
01
Assistenz-Tools-API-Dokumentation
Entdecken Sie aktuelle Endpunkte für Assistenten und Tools für Design-Sitzungen und Integrationsprüfungen. Diese öffentliche Referenz gewährt keine anonymen Befugnisse zum Erstellen von Angeboten oder Aufgeben von Bestellungen.
Implementierungsleitfaden
Assistenz-Tool-Doku öffnenMaschinenlesbarer Vertrag
Assistenz-Tool-OpenAPI-JSON/api/docs/openapi.jsonÖffentliche Referenz für Assistenten und Tool-APIs. Produktionszugriff und bestellrelevante Aktionen erfordern weiterhin die entsprechende Autorisierung.
02
Community-Embed-API
Verbinden Sie lokalisierte Club-, Community- oder Storefront-Erlebnisse mit den von MerchandAise bereitgestellten Design- und Commerce- Übergaben, ohne den zugrunde liegenden Workflow neu zu entwickeln.
Maschinenlesbarer Vertrag
Community-OpenAPI-JSON/api/v1/community/public/openapi/v1Öffentlicher, versionierter Vertrag für Storefront-Embeds, Community-Entdeckung und sprachangepasste Übergaben.
03
Lieferanten-API
Binden Sie freigegebene Lieferanten nach erfolgreicher Prüfung der Lieferantenbeziehung und des Zugriffsmodells an Onboarding-, Katalog-, Angebots- und Fulfillment-Prozesse an.
Maschinenlesbarer Vertrag
Lieferanten-OpenAPI-JSON/api/v1/supplier/openapi/v1Öffentlicher Vertrag für Planung und Client-Generierung. Der operative Lieferantenzugriff bleibt berechtigungsbasiert.
04
Enterprise-Identitäts-API
Planen Sie SSO, SCIM-Bereitstellung und audit-sichere Identitätsabläufe für genehmigte Merchandise-Programme von Unternehmen und gesteuerte Rollouts.
Maschinenlesbarer Vertrag
Enterprise-Identitäts-OpenAPI-JSON/api/v1/enterprise/identity/openapi/v1Geschützter Vertrag für freigegebene Enterprise-Workspaces; fordern Sie vor der Nutzung dieses Endpunkts den Zugriff an.
02 — Implementierungsleitfaden
Wählen Sie den Vertrag vor dem Code
- 01
User Journey abbilden
Legen Sie fest, wer den Workflow an welcher Stelle betritt: Ein Käufer in einem eingebetteten Storefront, ein freigegebener Lieferant, ein Unternehmensbenutzer oder ein Assistent mit expliziter Autorisierung.
- 02
Zugriffsgrenzen bestätigen
Verwenden Sie öffentliche Verträge für Evaluierung und Client-Generierung und bestätigen Sie vor der Implementierung Anmeldeinformationen, Scopes, Umgebungen, Callbacks und geschützte Endpunkte.
- 03
Statuskontinuität nachweisen
Testen Sie, ob Designs, Angebote, Freigaben, Fehler und Bestellübergaben über die Integration hinweg versionsaktuell bleiben – einschließlich Wiederholungsversuchen und Rollback-Pfaden.
03 — Was jede Integration gewährleisten muss
Was jede Integration gewährleisten muss
Ein einziger versionierter Status
Design, kommerzielle Absicht, lieferantenbasiertes Angebot, Freigabe und Bestellstatus bleiben miteinander verknüpft. Veraltete Änderungen müssen eine sichtbare erneute Angebotserstellung oder Prüfung auslösen.
Handels- und Lieferantenschutz
MerchandAise bleibt der für den Käufer sichtbare Händler und Ansprechpartner für den Support. Lieferantenidentitäten, Kontakte und interne Daten werden über öffentliche Integrationen nicht offengelegt.
Freigabe vor der Produktion
Eine 3D-Ansicht ist kein physischer Nachweis. Das bestätigte Angebot erläutert verfügbare Kundenmusteroptionen, Kosten, Einschränkungen und Termine. Geben Sie vor der Serienproduktion den exakten digitalen Entwurf frei und erfüllen Sie verpflichtende technische Prüfungen sowie erforderliche oder gewählte Musterfreigaben. Bestehende Anforderungen angenommener Bestellungen bleiben verbindlich.
04
Vor dem Produktionstraffic
Eine veröffentlichte OpenAPI-Datei ist eine Planungsgrundlage, keine Zusicherung eines anonymen Produktionszugriffs. Vor dem Go-Live überprüfen wir Umgebungen, Anmeldeinformationen, Fehlerbehandlung und operative Zuständigkeiten.
Zugriff und Umgebungen
Bestätigen Sie die Vertragsversion, den genehmigten Workspace, Authentifizierungsscopes, Sandbox, Produktionsanmeldeinformationen und Callback-Ziele.
Fehlerbehandlung und Wiederherstellung
Definieren Sie vor der Veröffentlichung Wiederholungsversuche (Retries), Idempotenz, Timeouts, kundenfokussierte Fehlermeldungen, Observability, Support-Zuständigkeiten und Rollbacks.
End-to-End-Nachweise
Überprüfen Sie den vorgesehenen Ablauf im Staging von Einstieg und Statusänderung bis hin zu Angebot, Freigabe, Übergabe und Wiederherstellungsverhalten.
FAQ
Mit welcher Integrationsoberfläche sollte ich beginnen?
Beginnen Sie mit der jeweiligen Person und dem Statusübergang. Nutzen Sie Community-Embeds für käuferseitige Club- oder Community-Journeys, Lieferantenprozesse für freigegebene lieferantenseitige Workflows, Enterprise-Identität für SSO und SCIM sowie Assistenz-Tools ausschließlich für explizit autorisierte AI-gesteuerte Abläufe.
Bedeutet ein öffentlicher Vertrag auch einen öffentlichen Produktionszugriff?
Nein. Ein öffentlicher OpenAPI-Vertrag unterstützt die Entdeckung, Architekturprüfung und Client-Generierung. Produktionsanmeldeinformationen, Schreiboperationen, Lieferanten-Workflows, Enterprise-Identität und Assistentenausführung erfordern nach wie vor einen freigegebenen Workspace und eine bereichsbezogene Autorisierung.
Kann eine Integration Lieferanten offenlegen oder Freigaben umgehen?
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.
Bringen Sie uns den Workflow, nicht eine fertige Architektur.
Teilen Sie uns mit, wer die Integration nutzen wird, welchen Status sie lesen oder ändern müssen und wo das Erlebnis stattfinden wird. Wir erarbeiten gemeinsam mit Ihnen den passenden Vertrag, das Zugriffsmodell und den sichersten Rollout-Pfad.