When Zeppol invoices an order
Not every order is owed an e-invoice, and an app that tried to issue one for all of them would be wrong more often than right. This page is the rule Zeppol actually follows.
Which orders are in scope
Zeppol invoices B2B orders. An order qualifies when the buyer is identifiable as a business, which in practice means a company name and a VAT number on the order or the customer record.
Consumer sales are deliberately passed over, and are marked as skipped rather than failed. A private individual is owed a receipt, not a structured B2B e-invoice.
Credit notes are manual in this version. See Shopify refunds and Germany's credit note rules for what that document actually needs to be, and why it is not the "Gutschrift" German tax law means.
Skipped and blocked are kept apart on purpose. Skipped means no invoice was owed and nothing is waiting on you. Blocked means one was owed and something stopped it. Those are opposite facts, and an app that renders them the same way is hiding the one that matters.
The three triggers
You choose one, and it applies to every order. The default is paid.
| Trigger | Fires when | Worth knowing |
|---|---|---|
| Created | The order appears in Shopify | Earliest possible invoice. |
| Paid | Shopify marks the order paid | The default, and the right answer for most stores. |
| Fulfilled | The order is fulfilled | The goods have shipped before the invoice goes out. |
Reviewing before it sends
You can hold invoices for your own approval before anything leaves, either permanently or for the first few while you build confidence. A held invoice has passed the checks and is waiting on you, which is different again from being blocked.
Invoice numbers
The number is one of the two things Zeppol owns outright, the archive being the other, and it is the field a tax auditor reaches for first.
- Continuous, with no annual reset. The year is not part of the key.
- Assigned once, at the moment the invoice is approved, which is after every check has passed and before the document is built. §14(4) Nr. 4 UStG requires exactly that.
- Blocked, held and skipped invoices consume no number. A number parked in an invoice that may never be issued is a gap with no end date.
- Credit notes run their own series, because a credit note is a different document type and mixing the two makes neither continuous.
- Every gap carries a stored reason. German tax authorities accept gaps a taxpayer can explain; they do not accept holes nobody can account for.
Every number starts with ZPL-, and TEST-ZPL- in test mode.
The prefix cannot be changed. A sequence you can renumber is not a sequence. For the regulatory basis behind
each of these rules, see
GoBD invoice numbers for Shopify.
Sending the same invoice twice
Zeppol will not do it by itself. Webhooks and jobs are deduplicated on stable keys, so a Shopify webhook arriving twice produces one invoice. Where that guarantee stops is at the Access Point, and that is covered under how an invoice leaves.
Something missing here?
Write to me. Anything asked more than once ends up on this page.