⌘Ctrlk
Sie benötigen entweder einen Integrationszugang (Access Key ID + Secret Access Key) oder einen Administrationsbenutzer (Benutzername + Passwort) aus Shopware. Empfohlen ist der Integrationszugang, da er unabhängig von persönlichen Benutzerkonten ist. Details unter Authentifizierungsmethoden im Detail.
Der Integrationszugang (Client-Credentials) ist ein technischer Zugang ohne Personenbezug und daher für Automatisierung ideal. Der Admin-Benutzer (Password-Grant) nutzt Benutzername und Passwort eines Shopware-Administrators und muss bei Passwortänderungen aktualisiert werden. Der Connector unterstützt beide Verfahren.
Hinterlegen Sie URL, API-Modulpfad und Zugangsdaten in der Shopware Konfiguration und nutzen Sie die Aktion Verbindung testen. Bei Erfolg wird ein gültiges Token abgerufen. Eine ausführliche Anleitung finden Sie unter Verbindung testen & Diagnose.
Prüfen Sie die Webseite-URL (inklusive https://), den API-Modulpfad (in der Regel /api) sowie Access Key und Secret. Aktivieren Sie bei Bedarf den Developer Log, um die genaue Serverantwort zu sehen. Testen Sie die URL zusätzlich im Browser und prüfen Sie Firewall-Einstellungen.
In der Regel /api. Ein abschließender Schrägstrich wird vom Connector automatisch entfernt, sodass keine doppelten Pfade entstehen.
Nein. Der Shopware 6 API Connector ruft das Zugriffstoken bei Bedarf automatisch ab und erneuert es selbstständig. Sie müssen sich nicht um die Token-Verwaltung kümmern.
Beim Password-Grant (Admin-Benutzer) müssen Sie das neue Passwort in der Konfiguration hinterlegen, sonst schlägt die Anmeldung fehl. Beim Integrationszugang hat eine Passwortänderung keine Auswirkung – ein weiterer Grund, den Integrationszugang zu bevorzugen.
Ein 401 Unauthorized bedeutet, dass die Anmeldung an der Shopware-API fehlgeschlagen ist. Prüfen Sie die API-Zugangsdaten, generieren Sie ggf. neue Integration-Credentials in Shopware und stellen Sie sicher, dass die Integration aktiv ist.
Empfohlen ist Shopware 6.4 oder höher mit Zugriff auf die Admin-API. Der Connector kommuniziert ausschließlich über die Shopware-Admin-API.
Mehr zur technischen Kommunikation: API-Endpunkte (Referenz).
Der Integrationszugang (Access Key) benötigt in Shopware 6 Lese- und Schreibrechte auf die relevanten Bereiche der Admin-API: Produkte, Kategorien, Eigenschaften, Medien, Kunden, Bestellungen, Preise und Verkaufskanäle. Am einfachsten legen Sie in Shopware unter Einstellungen › System › Integrationen eine Integration mit Administrator-Berechtigung an. So kann der Shopware 6 API Connector alle Daten zwischen Business Central und Shopware vollständig synchronisieren.
Nein, das eigentliche Zugangs-Token (Bearer-Token) wird vom Shopware 6 API Connector automatisch abgerufen und bei Ablauf selbstständig erneuert. Sie hinterlegen in Business Central nur einmalig Access Key ID und Secret Access Key. Nur wenn Sie die Integration in Shopware löschen oder die Schlüssel neu generieren, müssen Sie die Zugangsdaten in der Konfiguration aktualisieren.
Ja. Der Connector unterstützt mehrere Verkaufskanäle und Umgebungen. Für getrennte Shops arbeiten Sie mit unterschiedlichen Verkaufskanälen (Sales Channels) bzw. separaten Konfigurationen. So können Sie z. B. einen B2B- und einen B2C-Shop parallel aus demselben Business Central bedienen. Details unter Verkaufskanäle einrichten und Mehrere Verkaufskanäle betreiben.
Ein HTTP-Status 401 Unauthorized bedeutet, dass die Authentifizierung fehlgeschlagen ist. Prüfen Sie Access Key ID und Secret Access Key auf Tippfehler, stellen Sie sicher, dass die Integration in Shopware nicht deaktiviert oder gelöscht wurde, und kontrollieren Sie den API-Modulpfad (in der Regel /api). Nach dem Korrigieren nutzen Sie erneut die Aktion Verbindung testen.
Ein 404 oder eine leere Antwort deutet meist auf eine falsche Shop-URL oder einen falschen API-Modulpfad hin. Kontrollieren Sie, dass die Webseite-URL mit https:// beginnt, keine überflüssigen Pfade enthält und der API-Pfad korrekt ist. Rufen Sie die URL zusätzlich im Browser auf, um zu prüfen, ob der Shop erreichbar ist und kein Wartungsmodus oder eine Firewall den Zugriff blockiert.