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

Connect Shopify

Connect Shopify with just your shop domain, through the App Store or OAuth. What Rechnungskit imports, billing through Shopify App Pricing, shipping tax on mixed carts, multiple markets and legal entities, and Shopify POS.

Updated

The Shopify connection needs only your shop domain. You don't have to copy any credentials; you grant access directly at Shopify. For an overview of what the Shopify connection does, see the product page. This guide covers setup, matching and special cases.

Is there a Shopify app? Yes: Rechnungskit is listed in the Shopify App Store. There are two equivalent ways: you install the app from the App Store and link it to your Rechnungskit account there, or you start in Rechnungskit under Settings → Connections → Shops and payment providers with your shop domain and confirm access with a click at Shopify (OAuth). The app installs nothing in your theme or checkout; it reads order, payment and product data through the Shopify API and registers the webhooks it needs itself.

Setup

  1. Under Settings → Connections → Shops and payment providers, choose Shopify and enter your shop domain (for example your-shop.myshopify.com). Important: this means the permanent Shopify address ending in .myshopify.com, not your own domain like your-shop.com. You find it in the Shopify admin in the address bar or under Settings, Domains. If you enter your own domain, the input field points this out right away.

    Under "Add data source", choose Shopify:

    Rechnungskit, Settings → Connections → Shops and payment providers, the "What do you want to connect?" dialog after "+ Add connection": a search field at the top, then under "Shop or order source" the Shopify tile (highlighted) next to WooCommerce and Shopware, and below them Odoo Community, Your own software (API) and Fixed line item

    Then enter the shop domain and click "Connect via app":

    Rechnungskit, the "Connect Shopify" dialog: the Shop domain field holds nordlicht-kaffee.myshopify.com (highlighted), below it the "Connect via app" button (highlighted), and on the right "What happens next" with three steps: confirm access once in your Shopify admin, Rechnungskit registers the webhooks itself, orders and payment status arrive in real time

    A common mistake is entering your own domain. The field tells you right away:

    Rechnungskit, the "Connect Shopify" dialog with the custom domain nordlicht-kaffee.de in the Shop domain field (highlighted): below it a red note that this looks like your own domain, that Shopify identifies the shop only by the address ending in .myshopify.com, and that you find it in the Shopify admin under Settings, Domains

  2. You are redirected to Shopify and confirm access there.

  3. Back in Rechnungskit, the connection is active. Rechnungskit registers the webhooks (orders, payments, refunds, fulfillment, products) automatically; you don't need to set anything up in Shopify.

If Settings → Connections → Shops and payment providers shows "Shopify-Zugriff abgelaufen" (Shopify access expired), open Rechnungskit once in your Shopify admin (Apps → Rechnungskit). Shopify issues fresh access, Rechnungskit picks it up and keeps syncing. You can also reconnect the shop under Settings → Connections → Shops and payment providers.

What happens automatically

How it works: order and payment come from Shopify (Shopify Payments automatically, PayPal, Klarna and Unzer optionally), Rechnungskit matches both and creates the e-invoice with the shipping date as the date of supply; the result lands as an invoice in the GoBD archive and in the DATEV export for your tax advisor

  • Orders arrive in real time by webhook; a 4-hourly sync serves as a safety net.
  • Shopify Payments is detected automatically and set up as a payment source, including fees and payouts. You don't need separate credentials for it.
  • If you use PayPal directly next to Shopify Payments, those payments are matched unambiguously too. Some of them carry the order number; for the rest, Rechnungskit reads the PayPal transaction ID from the Shopify order and matches on that. See zahlungen-abgleich.
  • Products are imported from the shop, including prices. You check the VAT category under Products → From your shops (see produkte-ust-kategorien).
  • The invoice's date of supply (Leistungsdatum) is the shipping date, not the payment date.
  • Refunds in the shop create the cancellation invoice (Storno) automatically. So do canceled orders.
  • Discounts, shipping costs and gift cards are imported line by line. Shopify gift cards are treated as multi-purpose vouchers.
  • If a customer pays partly with a gift card and partly with another payment method, Rechnungskit determines the redeemed gift card share automatically from your shop's payment transactions and books it in the voucher report. Only if shop access is missing (for example an old manual connection without app approval) does a task ask you to enter the amount manually.

This is how it looks in Rechnungskit afterwards: under Orders, every Shopify order appears with its status and the related invoice.

Rechnungskit, Orders page: the filters All, Open, Awaiting shipment, Invoiced, More filters and All time plus the search field at the top, below them Shopify orders with order number, date and source Shopify, customer with email address, gross amount, status "Invoiced" and the invoice number in the Document column

Under Products → From your shops you find the imported products with their VAT category.

Rechnungskit, Products page: products imported from Shopify with item ID (shp_…) and source Shopify, tax category such as "Coffee & food · 7 %" or "Equipment & accessories · 19 %", status "Confirmed" with the type "Physical goods", and price

Special cases at a glance

Special cases · what Rechnungskit makes of them
Partial refund, gift card, store credit, POS and markets
Partial refund in the shop
Shopify reports the refunded items, even when the money went back through PayPal, Stripe or Mollie.
Cancellationexactly these items
Refund without items
For example an amount-only refund directly at the payment provider, with no refund in the shop.
Cancellationper your document rule
Gift card redeemed
Shopify gift cards are multi-purpose vouchers. Rechnungskit reads the share from the payment transactions.
Voucher reportshare booked automatically
Paid with store credit
Only the shop knows whether the credit came from a return or was purchased.
Taskclassify the origin once
In-store sale (Shopify POS)
Rechnungskit recognizes it by the sales channel. You set the rule per connection.
Defaultno document, your POS app books it
Excluded market
Shopify Plus with markets: the connection only invoices the markets you choose.
Resultno document in this connection
Invoices already issued stay unchanged in every case. Corrections always go through a new document.

For a partial refund in the shop, the cancellation invoice lists exactly the refunded items Shopify reports, even when the money went back through PayPal, Stripe or Mollie. If the item details are missing, for example with an amount-only refund directly at the payment provider, your document rule 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" 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%

If a customer pays with Shopify store credit, the task "Shopify-Guthaben einordnen" (classify Shopify credit) asks for its origin: "Return or goodwill credit" or "Purchased credit / gift card". The invoice itself stays unchanged. With "Remember for this shop", the classification applies to all following orders (see aufgabe-shop-correction).

Billing through the Shopify App Store (App Pricing)

If you installed Rechnungskit from the Shopify App Store and created a new account in the process, the Rechnungskit fees run through Shopify App Pricing: the base fee and your invoices appear on your Shopify bill, and you don't need a SEPA mandate with Rechnungskit. Shopify charges €29 per 30 days with one bank account included. Invoices and each further bank account (€9) are added as usage-based charges, at the same prices as with direct billing (Pricing and billing). An existing Shopify subscription keeps its current price.

For Shopify to bill you, you have to approve the fee in Shopify once. Shopify shows you an approval page with the base fee and the per-document price. In test mode there is nothing to approve yet: billing starts when you go live, and right after that you are redirected there (with a scheduled go-live, the link comes by email). If you closed or declined the page, you can find the approval again at any time: as a notice at the top of Rechnungskit, under Settings → Company → Plan and billing ("Approve in Shopify") and in the Rechnungskit app in your Shopify admin. Without approval, no documents are billed.

If you uninstall the app and install it again later, Shopify ends the previous subscription automatically. So after reinstalling, Rechnungskit asks you for approval again. You see the running fees in Shopify under Settings → Billing.

Important: if your Shopify subscription ends for good (app uninstalled and not reinstalled), Rechnungskit can no longer bill any fees. Your account is then canceled automatically at the end of the month, and you get an email about it. Until the end of the month everything stays fully active; after that the 90-day window for the free full export starts. You can prevent the cancellation at any time by reinstalling the app and confirming the subscription, or by adding a SEPA direct debit mandate under Settings → Company → Plan and billing.

Existing Rechnungskit accounts that connect a shop from the App Store later stay with their existing billing by SEPA direct debit.

Want the buyer to get just one email, your shop's shipping confirmation, with the invoice link in it? Go to Settings → Documents → Invoice e-mails and use the "Invoice link in Shopify emails" card. It shows up once Shopify is connected, and a note right below the "Send automatically" switch then points to it as well.

Rechnungskit, Settings → Documents → Invoice e-mails, "Send automatically" section: the toggle is off, below it "Prefer Shopify's own emails?" with the snippet expanded: Shopify template "Shipping confirmation (recommended)", the Liquid snippet with the "Rechnung herunterladen" link, the "Copy" button, the note that the link shows the current state, and the link "Step-by-step guide with screenshots"

  1. Pick the template: shipping confirmation (recommended), order confirmation or refund notification.
  2. Copy the snippet and paste it into the matching template in Shopify under Settings → Notifications, for example below the shipment details.
  3. Turn off "Send automatically" in Rechnungskit. Otherwise the buyer also gets the invoice by email from Rechnungskit.
  4. Test it once with a real order, all the way to the shipping confirmation.
Per order · one email to the buyer
From the shipping email to the invoice
In Shopify
  1. Order shipsShopify sends the shipping confirmation with your snippet in it
In Rechnungskit
  1. Buyer clicks the linkIt carries the order ID and the order status address
  2. Rechnungskit checksIf the address matches the order, it looks up the documents
The buyer sees
Invoice as PDFOnce it exists; before that, a note to open the link again later
Credit noteAfter a refund, on the same page
Rechnungskit writes nothing to your shop for this. Without the matching order status address the page only says "Link not valid".

How the link works: it carries the Shopify order ID and the secret order status address that Shopify puts into every order email. Rechnungskit looks up the order's documents only when someone clicks. So it doesn't matter that the shipping email goes out a few seconds before the invoice exists. If the invoice isn't ready yet, the page says so and asks the buyer to open the link again later. A credit note issued after a refund shows up on the same page. Nobody can guess the link: without the matching order status address the page only says "Link not valid".

This is what the buyer sees after clicking:

Page after clicking the invoice link: Nordlicht Kaffee GmbH at the top, the heading "Documents for order NK-10019" and below it invoice RK-2026-0019 · 22/05/2026 · €35.00 with a "Download PDF" button and download icon

Worth knowing:

  • Rechnungskit writes nothing to your shop for this. You need no metafields and no theme code.
  • The order confirmation usually has no invoice yet, because the invoice is created when the order ships. The link still works and shows the invoice once it exists.
  • With partial shipments, the invoice is created once the whole order has shipped. From then on, the link in the first shipping email shows it too.
  • If the buyer clicks the link in the order confirmation within the first few seconds after buying, Rechnungskit may not know the order yet. The page then says "Link not valid". Shortly after, the same link works.
  • The page uses the buyer's language from Shopify, German or English, including dates and amounts.
  • After a click on "Download PDF", the button shows that the PDF is being created, then "Downloaded" and a note that the invoice is in the downloads folder. The link can be opened again as often as needed.

Prepayment and pay by invoice

Both payment methods work with Shopify. What matters is mapping the exact gateway names from your shop under Settings → Documents → Document rules, card "Payment methods & flow" (see zahlarten-rechnungskauf-vorkasse).

Shipping tax on mixed carts

In short: shipping costs follow the tax rate of the goods. If the cart mixes 7 % and 19 %, or exempt and taxable goods, Rechnungskit splits the shipping automatically, even if Shopify taxes it at a flat 19 %.

For tax purposes, shipping costs are an ancillary service that shares the fate of the goods (Abschn. 3.10 Abs. 5 UStAE, the German VAT application decree). With mixed rates they are split by the ratio of the gross values of the goods (BFH, judgment of January 22, 2025, XI R 22/22; Abschn. 10.1 Abs. 11 UStAE). The guide Shipping costs and VAT explains the background with examples.

Example: coffee for €30.00 (7 %) and a hand grinder for €70.00 (19 %), shipping €5.90 gross. The goods are in a ratio of 30 to 70.

Shopify (flat) Document in Rechnungskit
Shipping at 7 % no line of its own €1.77 (net €1.65, VAT €0.12)
Shipping at 19 % €5.90 (net €4.96, VAT €0.94) €4.13 (net €3.47, VAT €0.66)
Shipping total €5.90 €5.90

What this means for you:

  • The gross amount stays the same. Your customer pays exactly the shipping from the checkout; only net and tax are split differently. The document shows one line per tax rate, such as "Shipping costs (19 %)" and "Shipping costs (7 %)".
  • The same applies without a mix. If the cart contains only 7 % goods (coffee, for example) and Shopify charges shipping at 19 %, Rechnungskit puts all of the shipping at 7 %. A rate that appears on no line item never ends up on the document, regardless of the setting below.
  • Exempt goods count too. VAT-exempt or 0 % products form their own group. Their share of the shipping stays exempt, and for a VAT-exempt category the invoice carries its note. If Shopify charged less tax on shipping than the full rate, for example with proportional shipping tax, Rechnungskit works from the shipping amount the customer actually paid.
  • If the shop already splits it itself (several tax lines on shipping, with Shopify Tax for example), Rechnungskit takes that over unchanged.

To make shop and document match, turn on the option in Shopify under Settings → Taxes and duties that calculates shipping tax proportionally based on the products.

Good to know: checkout and order confirmation in the shop can therefore show a higher VAT amount than the document from Rechnungskit. That is correct and intended; the document is the version that is right for tax purposes. So report VAT from Rechnungskit or the DATEV export, not from the Shopify tax report, and deactivate second invoicing apps in the shop (Order Printer, for example), so that no contradicting documents are in circulation.

Changing the setting: under Settings → Documents → Document rules (card "Shipping tax") you switch the behavior per shop connection to "Take the tax from the shop". Rechnungskit then takes the flat shipping tax from the checkout, provided the rate matches a line item, and shows a task instead saying that the shop does not split it. Refunds and cancellation invoices always take over the split of the original document.

If you use Shopify Markets (Shopify Plus) and invoice different markets through different legal entities, for example the EU through a German GmbH and Switzerland through a separate Swiss company, you can limit this connection to certain markets. Under Settings → Connections → Shops and payment providers, a store with several markets shows the section "Filter markets / legal entities". There you choose either "All except these" (for example to ignore the Swiss market if another system invoices it) or "Only these". Orders from excluded markets are not invoiced by this connection and don't even show up here.

Shopify no longer tells apps which market an order belongs to. Rechnungskit therefore checks the order's delivery country against the countries in your active markets, or the billing country if there is no delivery address. If a country is in two markets and one sits inside the other (Switzerland inside a Europe market), the narrower market counts, as in Shopify. Sometimes the market still can't be determined, for example when the order has no country or the country isn't in any active market. Then the mode decides: "All except these" picks up the order, "Only these" doesn't. Every such order is listed on the task "Shopify orders without a clear market" (see aufgabe-shopify-market-unclear). Changes to your markets in Shopify reach Rechnungskit within ten minutes.

If you want to invoice a second market separately in Rechnungskit, connect the same shop from a second Rechnungskit account or project and filter the other way round there. That way each legal entity gets its own number range and its own documents, with just one Shopify app. If the two filters mirror each other ("All except Switzerland" here, "Only Switzerland" there), exactly one of the two connections picks up the order, even when its market can't be determined.

In-store sales with Shopify POS

Rechnungskit is not a POS system. In Germany, sales through an electronic cash register come with their own obligations: the records must be protected by a certified technical security device (TSE) (§ 146a Abs. 1 AO), the customer gets a receipt (obligation to issue receipts, § 146a Abs. 2 AO), and the data must be exportable through the uniform digital interface (§ 4 KassenSichV, in practice the DSFinV-K export for tax audits). In practice there is also the end-of-day report (Z report) and the cash book. With Shopify POS a POS app such as OpenFiskal handles this. Rechnungskit does not cover these obligations.

So that an in-store sale doesn't get an extra invoice and the revenue doesn't appear twice in the books, Rechnungskit recognizes orders from Shopify POS by their sales channel. What happens with them is up to you under Settings → Documents → Document rules on the card "In-store sales (Shopify POS)", per Shopify connection:

  • Do not invoice, my POS app books them (default for new connections): in-store sales appear under Orders as "POS", with no document and no task. Their payments, including card payments through Shopify Payments, and their refunds stay visible for payout reconciliation but don't count as revenue in the reports and the DATEV export. The in-store share is shown separately in the payout.
  • Invoice like online orders: only makes sense if you don't use a POS app with a TSE at the register.

Rechnungskit, Settings → Documents → Document rules, More rules, block "In-store sales (Shopify POS)": your POS app books in-store sales with a TSE, including receipt, end-of-day report and cash book; below it the connection nordlicht-kaffee.myshopify.com with the selection "Please choose" and the note that in-store sales are held and get no document until you decide

For connections that existed before this setting, nothing is set yet. With the first in-store sale a task appears, and owners and admins get an email right away. Until you decide, in-store sales are put on hold: no document, and the payments wait. Once you decide, Rechnungskit files them correctly right away. If you change the rule, Rechnungskit updates open orders and their payments. Invoices already issued stay unchanged (GoBD).

Agree this with your tax advisor: a Shopify Payments payout contains online and in-store revenue together. Rechnungskit does not book the in-store share as revenue. How it is offset against the bookings of your POS app is best decided with your tax advisor.

If you only sell on site occasionally, for example to regular customers who pick up their goods, create the sale as a normal Shopify order, for example as a pickup order. That produces a proper invoice like any online order. If the customer pays cash, mark the order as paid in Shopify before you mark it as picked up. That way the invoice carries the paid note right away. Whether you need a register with a TSE for cash sales on site is best clarified with your tax advisor.

Importing older orders

When you connect, Rechnungskit only fetches the orders of the last few days. You bring in older ones under Settings → Connections → Shops and payment providers: click "Settings" on your Shopify connection to find the "Older orders" section with its "Import" button. There you choose the order date the import starts from and what happens to the orders:

  • Import only: the orders show up under Orders. Orders before your Belegstart (the date from which Rechnungskit issues documents) get no document; their invoice comes from your previous system. This also works in test mode.
  • Create invoices, don't send them: Rechnungskit creates the invoices for the archive and the DATEV export. Your customers get no email.
  • Create and send invoices: as above, and the emails go out according to your sending setting.

Rechnungskit, Settings → Connections → Shops and payment providers, under "Connections" the row "Nordlicht Shopify Store" (connected via app) with the links "Test", "Disconnect" and "Settings"; after clicking "Settings", below it the "Connection active" switch, the links "Sync products", "View orders", "Reload markets", "Show details" and the "Older orders" section with the "Import" button

Rechnungskit, Settings → Connections → Shops and payment providers, settings of the Shopify connection, "Older orders" section expanded: a note that Shopify so far only gives the last 60 days of orders, below it the "Orders from" field set to 01/10/2026, the three options "Import only", "Create invoices, don't send them" (selected) and "Create and send invoices", the note box on the document start with the checkbox "No invoice exists yet for sales from 1.10.2026 onwards, not even from another program" and the "Start import" button

By default Shopify only gives apps the last 60 days of orders. For older ones Rechnungskit needs the extended "read all orders" access. If it is missing, the section tells you. Open Rechnungskit once in your Shopify admin under Apps and approve the access. After that you can pick an earlier date.

The import runs in the background and can take a while for a large shop. The orders appear as they come in. Orders already in Rechnungskit are not created twice, so you can safely run it again. Cancelled orders are not imported.

Invoices for older orders

Invoices for older orders are only available once your account is live. If you choose one of the two invoice options, your Belegstart moves back to the date you picked. First you confirm that no invoice exists yet for sales from that date on, not even from another program. A second invoice for the same sale can mean you owe the tax shown on it a second time (§ 14c(1) UStG, in German).

Before you start:

  • The Belegstart applies to every sales channel, not just Shopify. Payments from that period via Stripe, PayPal or other providers that Rechnungskit had filed as "Historic" go back into matching and get an invoice too. Payments you ignored yourself stay as they are.
  • As always, an invoice is only created once the payment is there. The import brings in Shopify Payments payments as well. If an order has no payment, it shows up as the task Order paid, but no payment (in German).
  • The invoices carry today's issue date and the next numbers from your number range. The date of supply stays the order's shipping date. Every invoice counts as a document.
  • If the sales fall in months whose VAT return you have already filed, check with your tax advisor whether a corrected return is needed.

This is the only way to move the Belegstart back, and it can't be moved forward. Rechnungskit logs the change with the date and the person who made it.

Why revenue differs from Shopify

The Rechnungskit overview counts issued invoices by invoice date. Shopify's reports start from orders. So the numbers differ without anything missing:

  • Invoice only after payment: An order gets its invoice once it's paid, or only when it ships if you use "Wartet auf Versand" (awaiting shipment). Open orders aren't counted yet, and an order from the end of a month can count in the next one.
  • Refunds: A cancellation invoice reduces revenue in the month it's created.
  • Gift cards: Selling a multi-purpose voucher isn't revenue yet; VAT applies only when it's redeemed (§ 3 Abs. 15 UStG). That's why Rechnungskit leaves the sale out.
  • Foreign currency: Rechnungskit converts invoices in other currencies to euros at the invoice's rate.
  • Project and test data: Only the selected project counts, and after go-live without test invoices. Orders from before the document start have no invoice.

Limits

Limits · at a glance
What works, and what doesn't
Orders older than 60 daysImport from a start date after approving the extended access once in Shopify
Import yourself
Manual orders in ShopifyWithout a payment through a connected provider: manual products or payment method mapping
Map the payment method
Recognize in-store salesNo document if you want, their payments stay visible for payout reconciliation
Automatic
Run a registerA POS app handles TSE, receipt, Z report and cash book
Not a POS system
Shopify store creditYou classify the origin: return or goodwill, or purchased credit
Classification
Details on each point are in the list below.
  • Older orders: by default Shopify only gives apps the last 60 days. You approve the extended access once in your Shopify admin and then import from a date of your choice, see Importing older orders. One run takes at most 50,000 orders; for more, run it in stages.
  • Orders created manually in Shopify without a payment through a connected provider go through manual products or the payment method mapping.
  • Shopify POS: Rechnungskit recognizes in-store sales and, if you want, does not invoice them, but it does not run a register. A POS app handles TSE, Z report and cash book; see the section above.
  • Voucher sales through Shopify Store Credit have their own rules; Rechnungskit guides you through the classification (return credit or purchased voucher).

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