# Merchandise API-Dokumentation & OpenAPI | MerchandAise

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

Entdecken Sie MerchandAise API-Dokumentation und OpenAPI-Spezifikationen für individuelle Merchandise-Produkte, Community-Einbettungen, Lieferantenprozesse und Enterprise Identity.

## 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, außer 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.

## APIs und Integrationsschnittstellen
- **API-Dokumentation & OpenAPI:** Finden Sie die API-Referenz für Assistenten-Tools und Design-Sessions. Wählen Sie anschließend den Community-, Lieferanten- oder Enterprise-Vertrag für Ihren Anwendungsfall. Implementierungsleitfaden: Assistenten-Tooling-Dokumentation lesen (/api/docs). Maschinenlesbarer Vertrag: OpenAPI-JSON für Assistenten-Tools (/api/docs/openapi.json). Zugriff: Öffentlich. Öffentliche Referenz für Assistenten- und Tooling-APIs. Produktivzugriff und Bestellvorgänge erfordern weiterhin die passende Autorisierung. Kanonische Seite: /de-at/developers/api-integrations. Kanonischer Abschnitt: /de-at/developers/api-integrations#api-docs.
- **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. Implementierungsleitfaden: Community API ansehen (/de-at/developers/api-integrations#community-integrations). Maschinenlesbarer Vertrag: Community OpenAPI JSON (/api/v1/community/public/openapi/v1). Zugriff: Öffentlich. Öffentlicher, versionierter Vertrag für Storefront-Einbettungen, Community-Suche und sprachspezifische Übergaben. Kanonische Seite: /de-at/developers/api-integrations. Kanonischer Abschnitt: /de-at/developers/api-integrations#community-integrations.
- **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. Implementierungsleitfaden: Lieferanten-API ansehen (/de-at/developers/api-integrations#supplier-integrations). Maschinenlesbarer Vertrag: Lieferanten-OpenAPI-JSON (/api/v1/supplier/openapi/v1). Zugriff: Öffentlich. Öffentlicher Vertrag für Planung und Client-Generierung. Operativer Lieferantenzugriff bleibt berechtigungsgebunden. Kanonische Seite: /de-at/developers/api-integrations. Kanonischer Abschnitt: /de-at/developers/api-integrations#supplier-integrations.
- **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. Implementierungsleitfaden: Enterprise Identity ansehen (/de-at/developers/api-integrations#enterprise-integrations). Maschinenlesbarer Vertrag: Enterprise-Identity-OpenAPI-JSON (/api/v1/enterprise/identity/openapi/v1). Zugriff: Geschützt. Geschützter Vertrag für zugelassene Enterprise-Workspaces. Fordern Sie vor der Nutzung dieses Endpunkts Zugriff an. Kanonische Seite: /de-at/developers/api-integrations. Kanonischer Abschnitt: /de-at/developers/api-integrations#enterprise-integrations.

## Erst den Vertrag wählen, dann implementieren
- **Schritt 1: 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.
- **Schritt 2: 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.
- **Schritt 3: Durchgängigen Status nachweisen:** Testen Sie, dass Designs, Angebote, Freigaben, Fehler und Bestellübergaben über die Integration hinweg versionsaktuell bleiben – auch bei Wiederholungsversuchen und Rückfällen.

## Was jede Integration bewahren muss
- **Ein versionierter Status:** Design, Kaufabsicht, lieferantengestütztes Angebot, Freigaben und Bestellstatus bleiben verbunden. Veraltete Änderungen müssen ein sichtbares neues Angebot oder eine 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. Das bestätigte Angebot 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.

## 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 Angebot, 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, außer 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.
- **Integration planen:** /de-at/contact?intent=api-integration-review
- **KI-Agenten und MCP ansehen:** /de-at/developers/ai-agents-mcp