# MerchandAise-API & Integrationsverträge | MerchandAise

- slug: developers-api-integrations
- locale: de
- localeResolved: de
- canonical: https://www.merchandaise.com/de/developers/api-integrations

Entdecken Sie MerchandAise-Verträge für KI-Assistenz-Tools, Community-Einbettungen, Lieferantenprozesse und Enterprise-Identität – mit klaren öffentlichen und geschützten Zugriffsgrenzen.

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

## 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. Human guide: Assistenz-Tool-Doku öffnen (/de/developers/api-integrations). Machine-readable contract: Assistenz-Tool-OpenAPI-JSON (/api/docs/openapi.json). Access: public. Öffentliche Referenz für Assistenten und Tool-APIs. Produktionszugriff und bestellrelevante Aktionen erfordern weiterhin die entsprechende Autorisierung. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **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. Human guide: Community-Integrationsleitfaden ansehen (/de/developers/api-integrations#community-integrations). Machine-readable contract: Community-OpenAPI-JSON (/api/v1/community/public/openapi/v1). Access: public. Öffentlicher, versionierter Vertrag für Storefront-Embeds, Community-Entdeckung und sprachangepasste Übergaben. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **Lieferanten-API:** Binden Sie freigegebene Lieferanten nach erfolgreicher Prüfung der Lieferantenbeziehung und des Zugriffsmodells an Onboarding-, Katalog-, Angebots- und Fulfillment-Prozesse an. Human guide: Lieferanten-Integrationsleitfaden ansehen (/de/developers/api-integrations#supplier-integrations). Machine-readable contract: Lieferanten-OpenAPI-JSON (/api/v1/supplier/openapi/v1). Access: public. Öffentlicher Vertrag für Planung und Client-Generierung. Der operative Lieferantenzugriff bleibt berechtigungsbasiert. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **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. Human guide: Enterprise-Integrationsleitfaden ansehen (/de/developers/api-integrations#enterprise-integrations). Machine-readable contract: Enterprise-Identitäts-OpenAPI-JSON (/api/v1/enterprise/identity/openapi/v1). Access: protected. Geschützter Vertrag für freigegebene Enterprise-Workspaces; fordern Sie vor der Nutzung dieses Endpunkts den Zugriff an. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Wählen Sie den Vertrag vor dem Code
- **Step 1: 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.
- **Step 2: 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.
- **Step 3: 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:** 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:** /de/contact?intent=api-integration-review
- **AI-Agenten und MCP erkunden:** /de/developers/ai-agents-mcp