For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.