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.

Ablauf · eine Shopware-Bestellung
Abruf statt Webhook: von Shopware 6 bis zum DATEV-Export
Kommt an
Bestellung aus Shopware 6Abruf über die Admin-API alle 15 Minuten, ohne Plugin im Shop
Optional sofortEine Flow-Builder-Aktion „Webhook aufrufen“ stößt den Abruf an
ZahlungVon deinem Zahlungsanbieter oder als Vorkasse im Shop
In Rechnungskit
  1. ZuordnenZahlung zur Bestellung, über die Bestellnummer
  2. RechnungE-Rechnung im ZUGFeRD-Format, bei Ware mit dem Versand
  3. StornoAus dem Transaktionsstatus „erstattet“ im Shop
Ergebnis
GoBD-ArchivJeder Beleg unveränderbar archiviert
DATEV-ExportMonatlich, Erlöse und Zahlungen getrennt
Den Inhalt der Flow-Builder-Benachrichtigung ignoriert Rechnungskit bewusst. Alle Daten kommen aus dem authentifizierten API-Abruf.

Die Zahlung ordnet Rechnungskit über die Bestellnummer der Bestellung zu (siehe Zahlungen, Zuordnung und Auszahlungs-Abgleich). Daraus entsteht eine E-Rechnung im ZUGFeRD-Format, die unveränderbar im GoBD-Archiv liegt und in den monatlichen DATEV-Export läuft, Erlöse und Zahlungen getrennt.

Einrichtung

Einrichtung · drei Schritte, kein Plugin
Von der Integration in Shopware zum ersten Abruf
  1. Schritt 1 · ShopwareIntegration anlegenEinstellungen → System → Integrationen, Lesezugriff genügt
  2. Schritt 2 · RechnungskitZugangsdaten eintragenUnter Verbindungen → Connect: Shop-URL, Access-Key-ID (SWIA…) und Secret-Access-Key
  3. Schritt 3 · automatischTest-Abruf, dann die letzten 7 TageDanach läuft der Abruf von selbstAlle 15 Minuten
Die Shop-URL ist die endgültige Adresse, so wie der Shop antwortet. Einer Weiterleitung folgt die Verbindung nicht und zeigt stattdessen einen Hinweis.

  1. Im Shopware-Admin: Einstellungen → System → Integrationen, neue Integration anlegen. Lesezugriff genügt.

  2. In Rechnungskit unter Verbindungen → Connect: 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, Dialog „Shopware verbinden“: Shop-URL https://dein-shop.de ist eingetragen, darunter die leeren Felder Access-Key-ID (SWIA…) und Secret-Access-Key und der Hinweis, dass du die Zugangsdaten im Shopware-Admin unter Einstellungen → System → Integrationen erstellst

  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 (ab Shopware Evolve, über die Commercial-Erweiterung) 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.

Statuswechsel im Shop · was Rechnungskit daraus macht
Vorkasse, Erstattung und Teilerstattung
Vorkasse bezahlt
Du setzt den Zahlstatus im Shop auf „bezahlt“. Der nächste Abruf übernimmt das.
Rechnungbei Ware mit dem Versand
Volle Erstattung
Die Transaktion steht im Shop auf „erstattet“.
Stornoüber den ganzen Betrag
Teilerstattung
Shopware meldet keine erstatteten Artikel. Den Betrag liefert dein Zahlungsanbieter.
Stornonach deiner Belegregel
Die Belegregel stellst du unter Verbindungen → Belegregeln, Karte „Stornorechnungen bei Erstattungen“ ein: anteilig über alle Positionen, als eine Sammel-Position oder manuell zuordnen.

Bei Ware entsteht die Rechnung mit dem Versand. Steht eine Transaktion im Shop auf „erstattet“, erstellt Rechnungskit die Stornorechnung über den ganzen Betrag. Bei Teilerstattungen meldet Shopware keine erstatteten Artikel. Dann entscheidet deine Belegregel unter Verbindungen → Belegregeln, Karte „Stornorechnungen bei Erstattungen“: anteilig über alle Positionen (Standard), als eine Sammel-Position oder manuell zugeordnet (siehe Belege, Formate und GoBD-Archiv).

Rechnungskit, Belegregeln, Karte „Stornorechnungen bei Erstattungen“: Oben „Shop liefert Storno-Positionen“ mit dem Hinweis, dass Shopware bei Teilerstattungen keine Artikel meldet und der Fallback greift, darunter die drei Fallback-Optionen „Anteilig über alle Positionen“ (ausgewählt, empfohlen), „Als eine Sammel-Position „Erstattung““ und „Manuell zuordnen“ sowie ein Rechenbeispiel: 50 € Erstattung auf 120 € zu 19 % und 30 € zu 7 % ergibt Storno 40,00 € zu 19 % und 10,00 € zu 7 %

Grenzen, ehrlich benannt

Grenzen · auf einen Blick
Was geht, und was nicht
WebhooksKern-Shopware bietet keine konfigurierbaren Webhooks
Abruf alle 15 Minuten
EchtzeitNur mit dem Flow Builder aus den kostenpflichtigen Shopware-Plänen
Optional
Erstattete ArtikelShopware meldet bei Teilerstattungen keine Artikel
Belegregel
Shopwares eigene Belegfunktion parallelSonst laufen zwei Nummernkreise nebeneinander
Nicht parallel nutzen
Shopware 6Über die Admin-API
Unterstützt
Shopware 5Wird nicht angebunden
Nicht unterstützt
Details zu jedem Punkt stehen in der Liste darunter.
  • 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.

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; Hintergrund und Beispiele erklärt der Ratgeber Versandkosten und Umsatzsteuer. Die Einstellung je Shop-Verbindung findest du unter Verbindungen → Belegregeln, Karte „Versandsteuer“.

So findest du es in der App

Zuletzt geändert

Rechnungskit ist keine Steuerberatung und keine Rechtsberatung. Dieser Beitrag erklärt allgemeine Zusammenhänge und ersetzt weder die Beratung durch deine Steuerkanzlei (§ 5 StBerG) noch eine Rechtsberatung (§ 3 RDG). Rechnungskit richtet sich an in Deutschland ansässige Unternehmen und bereitet Belege, Steuersätze und Buchungen automatisch auf. Wie dein Einzelfall zu bewerten ist, entscheidest du, im Zweifel gemeinsam mit deiner Steuerkanzlei oder einer Anwaltskanzlei.

de en