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.

Während MerchandAise die Transaktion des Käufers abwickelt, tritt Hutter Products GmbH als vertragsschließender Verkäufer und Merchant of Record unter der Marke MerchandAise auf. Lieferantenidentitäten und Kontaktdaten bleiben vertraulich, es sei denn, eine Offenlegung ist gesetzlich vorgeschrieben; für die Produktion sind zudem weiterhin ein digitaler Korrekturabzug und ein physisches Produktionsmuster erforderlich.

01 — Verträge

API- und Integrationsoberflächen

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.

Zugriff: public

Implementierungsleitfaden

Assistenz-Tool-Doku öffnen

Maschinenlesbarer 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.

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.

Zugriff: public

Maschinenlesbarer Vertrag

Community-OpenAPI-JSON

/api/v1/community/public/openapi/v1

Öffentlicher, versionierter Vertrag für Storefront-Embeds, Community-Entdeckung und sprachangepasste Übergaben.

Lieferanten-API

Binden Sie freigegebene Lieferanten nach erfolgreicher Prüfung der Lieferantenbeziehung und des Zugriffsmodells an Onboarding-, Katalog-, Angebots- und Fulfillment-Prozesse an.

Zugriff: public

Maschinenlesbarer Vertrag

Lieferanten-OpenAPI-JSON

/api/v1/supplier/openapi/v1

Öffentlicher Vertrag für Planung und Client-Generierung. Der operative Lieferantenzugriff bleibt berechtigungsbasiert.

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.

Zugriff: protected

Maschinenlesbarer Vertrag

Enterprise-Identitäts-OpenAPI-JSON

/api/v1/enterprise/identity/openapi/v1

Geschü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 produktnative 3D-Ansicht und digitale Korrekturabzüge unterstützen die Entscheidung, ersetzen jedoch nicht das genuine Produktionsmuster, das vor der Massenproduktion erforderlich ist.

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?

Nein. Lieferantenidentitäten und Kontaktdaten bleiben vertraulich, es sei denn, eine Offenlegung ist vorgeschrieben; MerchandAise verwaltet die Kundenbeziehung und bestellrelevante Aktionen müssen die konfigurierten Freigabe- und Produktionsmuster-Schranken einhalten.

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.

Integration planen AI-Agenten und MCP erkunden

Ein Produkt-Workflow. Vier Wege zur Anbindung.

Eine einzige Datenquelle als Fundament

Wählen Sie den Vertrag vor dem Code

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.

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.

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.

Was jede Integration gewährleisten muss

Ein einziger versionierter Status

Handels- und Lieferantenschutz

Freigabe vor der Produktion

Eine produktnative 3D-Ansicht und digitale Korrekturabzüge unterstützen die Entscheidung, ersetzen jedoch nicht das genuine Produktionsmuster, das vor der Massenproduktion erforderlich ist.

FAQ

Mit welcher Integrationsoberfläche sollte ich beginnen?

Bedeutet ein öffentlicher Vertrag auch einen öffentlichen Produktionszugriff?

Kann eine Integration Lieferanten offenlegen oder Freigaben umgehen?