Shopware 6 verbinden
Aktualisiert am
Shopware 6 wird über die Admin-API angebunden, ohne Plugin im Shop. Wichtig zu wissen: Die Anbindung arbeitet mit regelmäßigem Abruf (Polling), nicht mit Webhooks.
Einrichtung
- Im Shopware-Admin: Einstellungen → System → Integrationen, neue Integration anlegen. Lesezugriff genügt.
- In Rechnungskit unter Einstellungen → Verbinden: Shop-URL, Access-Key-ID (SWIA...) und Secret-Access-Key eintragen. Als Shop-URL gehört die endgültige Adresse hinein (mit oder ohne www, je nachdem, wie der Shop antwortet), denn einer Weiterleitung folgt die Verbindung nicht und zeigt stattdessen einen Hinweis.
- Rechnungskit prüft die Zugangsdaten mit einem Test-Abruf. Danach läuft die Synchronisation automatisch.
Wie die Daten ankommen
- Bestellungen, Zahlstatus und Versandstatus werden automatisch alle 15 Minuten abgerufen. Für die Rechnungsstellung ist das völlig ausreichend, dein Kunde bekommt die Rechnung ohnehin nach Versand oder Zahlungseingang.
- Echtzeit ist optional: Mit dem Flow Builder (Shopware Commercial/Evolve) kannst du eine „Webhook aufrufen"-Aktion auf die von Rechnungskit bereitgestellte URL legen. Das stößt einen sofortigen Abruf an. Der Inhalt dieser Benachrichtigung wird bewusst ignoriert, alle Daten kommen aus dem authentifizierten API-Abruf.
- Beim ersten Verbinden werden die letzten 7 Tage geladen, dabei lernt Rechnungskit auch die im Shop verwendeten Zahlarten kennen.
Vorkasse und Kauf auf Rechnung
Beides ist mit Shopware eingebaut. Zahlstatus-Änderungen im Shop (zum Beispiel „bezahlt" bei Vorkasse) werden beim nächsten Abruf übernommen und lösen die Rechnung aus. Auch Korrekturen über Transaktionsstatus (Erstattung, Storno) werden verarbeitet.
Grenzen, ehrlich benannt
- Kern-Shopware bietet keine konfigurierbaren Webhooks, daher das 15-Minuten-Polling. Wer Echtzeit will, braucht den Flow Builder aus den kostenpflichtigen Shopware-Plänen.
- Erzeuge Rechnungen nicht parallel mit Shopwares eigener Belegfunktion, sonst entstehen zwei Nummernkreise nebeneinander.
- Unterstützt wird Shopware 6, nicht Shopware 5.
Wo in der App
- /settings/connect, Shopware verbinden, Poke-URL für den Flow Builder
- /orders, Bestellungen mit Zahl- und Versandstatus
- /payments, zugeordnete Zahlungen und offene Klärfälle
Versandsteuer
Rechnungskit setzt den Versand auf den Steuersatz der Ware, auch wenn der Shop pauschal 19 % meldet. Bei gemischten Warenkörben wird nach Brutto-Warenwert aufgeteilt; Details und die Einstellung je Shop-Verbindung stehen unter Recht und Grundlagen sowie in der Belegregeln-Karte „Versandsteuer“.