Skip to content
Help support@rechnungskit.de
Topics: Setting up integrations

Connect Shopware 6

Rechnungskit connects Shopware 6 through the Admin API, without a plugin in your shop. Orders, payment and shipping status are fetched every 15 minutes; the Flow Builder can trigger an instant fetch.

Updated

Rechnungskit connects Shopware 6 through the Admin API, without a plugin in your shop. Good to know: the connection works by fetching at regular intervals (polling), not with webhooks. What the Shopware connection covers, from the e-invoice to the DATEV batch, is on the product page.

Flow · one Shopware order
Polling instead of webhooks: from Shopware 6 to the DATEV export
Comes in
Order from Shopware 6Fetched through the Admin API every 15 minutes, no plugin in the shop
Optionally right awayA Flow Builder "Call webhook" action triggers the fetch
PaymentFrom your payment provider, or as prepayment in the shop
In Rechnungskit
  1. MatchPayment to order, by order number
  2. InvoiceE-invoice in ZUGFeRD format, for goods at shipping
  3. CancellationFrom the "refunded" transaction status in the shop
Result
GoBD archiveEvery document archived, unchangeable
DATEV exportMonthly, revenue and payments separate
Rechnungskit deliberately ignores the content of the Flow Builder notification. All data comes from the authenticated API fetch.

Rechnungskit matches the payment to the order by order number (see zahlungen-abgleich). The result is an e-invoice in ZUGFeRD format, archived unchangeable in the GoBD archive (the German bookkeeping rules) and included in the monthly DATEV export, with revenue and payments kept separate.

Setup

Setup · three steps, no plugin
From the integration in Shopware to the first fetch
  1. Step 1 · ShopwareCreate an integrationSettings → System → Integrations, read access is enough
  2. Step 2 · RechnungskitEnter the credentialsUnder Settings → Connections → Shops and payment providers: shop URL, access key ID (SWIA…) and secret access key
  3. Step 3 · automaticTest fetch, then the last 7 daysAfter that, fetching runs on its ownEvery 15 minutes
The shop URL is the final address, the way the shop responds. The connection does not follow a redirect and shows a notice instead.
  1. In the Shopware admin, go to Settings → System → Integrations and create a new integration. Read access is enough.

  2. In Rechnungskit, under Settings → Connections → Shops and payment providers, enter the shop URL, the access key ID (SWIA...) and the secret access key. Use the final address as the shop URL (with or without www, depending on how the shop responds), because the connection does not follow a redirect and shows a notice instead.

    Rechnungskit, the "Connect Shopware" dialog (via "+ Add connection"): the shop URL https://dein-shop.de is filled in, below it the empty access key ID (SWIA…) and secret access key fields, the note that you create the credentials in the Shopware admin under Settings → System → Integrations, and the "Connect shop" button; "What happens next" on the right

  3. Rechnungskit checks the credentials with a test fetch. After that, syncing runs automatically.

How the data arrives

  • Orders, payment status and shipping status are fetched automatically every 15 minutes. That is plenty for invoicing, since your customer gets the invoice after shipping or payment anyway.
  • Real time is optional: with the Flow Builder (from Shopware Evolve, through the Commercial extension) you can add a "Call webhook" action pointing at the URL Rechnungskit provides. That triggers an immediate fetch. Rechnungskit deliberately ignores the content of this notification; all data comes from the authenticated API fetch.
  • On the first connection Rechnungskit loads the last 7 days and also learns the payment methods your shop uses.

Prepayment and pay by invoice

Shopware has both built in. Payment status changes in the shop (for example "paid" for prepayment) are picked up with the next fetch and trigger the invoice. Corrections through the transaction status (refund, cancellation) are processed as well.

Status changes in the shop · what Rechnungskit makes of them
Prepayment, refund and partial refund
Prepayment paid
You set the payment status in the shop to "paid". The next fetch picks it up.
Invoicefor goods at shipping
Full refund
The transaction is set to "refunded" in the shop.
Cancellationfor the full amount
Partial refund
Shopware does not report refunded items. Your payment provider supplies the amount.
Cancellationper your document rule
You set the document rule under Settings → Documents → Document rules, card "Cancellation invoices for refunds": proportionally across all line items, as a single line item, or assign manually.

For goods, the invoice is created at shipping. If a transaction is set to "refunded" in the shop, Rechnungskit creates the cancellation invoice for the full amount. For partial refunds Shopware reports no refunded items. Your document rule then decides, under Settings → Documents → Document rules, card "Cancellation invoices for refunds": proportionally across all line items (default), as a single line item, or assigned manually (see belege-archiv).

Rechnungskit, Settings → Documents → Document rules, Refunds section: under "Runs automatically" full refunds and refunds for which the shop reports the items, on the right under "Partial refund without item data" (which applies to Shopware partial refunds) the options "Proportionally across all line items" (selected, recommended), "As a single “refund” line item" and "Assign manually", and below the expanded example: a €50 refund on €120 at 19% and €30 at 7% gives a credit note of €40.00 at 19% and €10.00 at 7%

Limits

Limits · at a glance
What works, and what doesn't
WebhooksCore Shopware offers no configurable webhooks
Fetch every 15 minutes
Real timeOnly with the Flow Builder from the paid Shopware plans
Optional
Refunded itemsShopware reports no items for partial refunds
Document rule
Shopware's own document feature in parallelOtherwise two number ranges run side by side
Don't use both
Shopware 6Through the Admin API
Supported
Shopware 5Can't be connected
Not supported
Details on each point are in the list below.
  • Core Shopware offers no configurable webhooks, hence the 15-minute polling. If you want real time, you need the Flow Builder from the paid Shopware plans.
  • Don't create invoices in parallel with Shopware's own document feature, or you end up with two number ranges side by side.
  • Shopware 6 is supported, Shopware 5 is not.

Shipping tax

Rechnungskit applies the tax rate of the goods to shipping, even if the shop reports a flat 19 %. For mixed carts, shipping is split by the gross value of the goods; the guide Shipping costs and VAT explains the background with examples. You find the setting per shop connection under Settings → Documents → Document rules, card "Shipping tax".

Where to find it in the app

Recent changes

Still have a question? Ask Kit in the app or write to support@rechnungskit.de
No tax or legal advice

Rechnungskit is not a tax advisory or law firm. This article explains general principles and does not replace advice from a tax advisor (Steuerberater, § 5 StBerG) or a lawyer (§ 3 RDG). Rechnungskit is built for businesses based in Germany and prepares documents, tax rates and bookings automatically. How your specific case is treated remains your decision, ideally together with your tax advisor or a lawyer.

de en