API-Endpunkte (Referenz)

Der Shopware 6 API Connector kommuniziert ausschließlich über die Shopware-Admin-API. Diese Referenz gibt einen vollständigen Überblick über die genutzten Endpunkte, gruppiert nach Themen. Für die tägliche Arbeit müssen Sie die Endpunkte nicht kennen – der Connector wählt sie automatisch. Für Verständnis und Fehlersuche ist die Übersicht jedoch hilfreich.

Authentifizierung

Endpunkt	Verwendung
oauth/token	Abruf des Bearer-Tokens. Zwei Modi: Client Credentials (client_id, client_secret, grant_type=client_credentials) oder Password Grant (username, password, grant_type=password, client_id=administration).

Alle weiteren Aufrufe erfolgen mit dem Header Authorization: Bearer {token}. Der Connector erneuert das Token bei Ablauf automatisch.

Katalog (Produkte, Kategorien, Attribute, Medien)

Endpunkt	Verwendung
product	Produkte anlegen (POST) und aktualisieren (PATCH).
search/product	Produkte suchen – u. a. für das SKU-Matching (productNumber).
category, search/category	Kategorien anlegen, aktualisieren und herunterladen (Suche mit Limit 500).
tag, search/tag	Tags anlegen und suchen (Matching per ID, dann Name).
media, search/media, product-media	Medien/Bilder hochladen, suchen und dem Produkt zuordnen.
product-manufacturer	Hersteller anlegen und zuordnen.
unit	Maßeinheiten.
property-group, property-group-option	Attribute (Eigenschaften) und deren Optionswerte.

Preise

Endpunkt	Verwendung
product-price, search/product-price	Staffel-/Kundengruppen-Preise verwalten und für die Löschung suchen.
rule	Preisregeln (Rules) für kundengruppenspezifische Preise.

Bestellungen

Endpunkt	Verwendung
search/order	Inkrementeller Bestell-Download (Filter autoIncrement, Bereichsfilter gte).
order, order-address, order-delivery, order-transaction, order-line-item	Bestell- und Positionsdaten.
_action/order	Statusübergänge einer Bestellung (Rückmeldung an Shopware).

Kunden & B2B

Endpunkt	Verwendung
customer, search/customer	Kunden anlegen, aktualisieren, suchen.
customer-address	Liefer-/Rechnungsadressen.
customer-group	Kundengruppen.
atlantis-b2b-employee	B2B-Benutzer (Mitarbeiter) aus Kontakten.

Stammdaten (Erstdaten / Mapping)

Endpunkt	Verwendung
payment-method, shipping-method	Zahlungs- und Versandarten.
tax, tax-rule	Steuersätze und Steuerregeln.
currency	Währungen.
sales-channel	Verkaufskanäle.
salutation, country, language	Anreden, Länder, Sprachen.
state-machine, state-machine-transition	Bestellstatus und mögliche Übergänge.

Premium-Endpunkte (Plugin erforderlich)

Endpunkt	Verwendung
solutioo-invoice-document, .../import, .../import/bulk, .../by-reference	Upload und Verwaltung von PDF-Belegen im Kundenkonto.
solutioo-grouped-product, solutioo-grouped-product-assignment	Gruppenartikel und deren Zuordnungen.

Technische Hinweise

• HTTP-Methoden: GET, POST, PATCH, PUT, DELETE.
• Sprachbezug: Übersetzungen werden über einen Sprach-Header gezielt je Sprache aktualisiert (PATCH).
• Protokollierung: Bei aktivem Developer Log werden Anfrage und Antwort im API Call Log gespeichert (Statuscode, Endpunkt, JSON) – siehe „API Call Log“ und „API-Antworten analysieren“.
• Bulk: Preise werden in Paketen hochgeladen; die Paketgröße steuert das Feld Price API Limit.

Fehlermeldungen der API (z. B. 400, 401, 404) werden im API Call Log mit der genauen Serverantwort protokolliert. Das erleichtert die Zuordnung zum betroffenen Feld oder Mapping erheblich.