Zum Inhalt springen
Rechnungskit

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

  1. Im Shopware-Admin: Einstellungen → System → Integrationen, neue Integration anlegen. Lesezugriff genügt.
  2. 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.
  3. 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“.

Zuletzt geändert

de