If an invoice fails to be created, you will be notified in one of two ways:
if you triggered the invoice manually, the error message will appear directly in the app
if invoice creation is automatic, the app will send an error notification to the email address you have set in the app's General settings
Please note: If an invoice fails to be created, any related functionality will also stop working. Specifically:
The automatic invoice email will not be sent to the customer.
If you have added an invoice link to your Shopify order confirmation email, that link will return an error when clicked.
Address Too Long
What happened: One or more address lines in the customer's billing address exceed 100 characters. The invoice cannot be created with an address this long.
How to fix it: Because billing addresses in Shopify cannot be edited directly, you will need to create the invoice manually in Fakturoid and split the address across multiple lines there.
Street Parsing Error
What happened: The error message "Couldn't parse street due to…" means the customer's address contains special characters — such as apostrophes — that the system cannot process.
How to fix it: If you need to issue the invoice immediately, open the order in Fakturoid and manually remove the problematic characters from the address. If this keeps happening, please contact our support at [email protected].
VAT-Related Errors
Incorrect VAT rate (lines.vat_rate: must be zero)
What happened: Fakturoid expects a VAT rate of 0%, but Shopify is sending VAT data. This usually means there is a mismatch between your VAT configuration in Shopify and in Fakturoid.
How to fix it:
If you are not a VAT payer: Tax charging in Shopify may be accidentally enabled. Check and disable tax in the following places in Shopify:
Settings → Taxes and Duties
Tax settings for individual products and variants
Shipping tax settings
If you are a VAT payer: The issue is likely a misconfiguration in Fakturoid. Verify your VAT payer status and OSS mode (if applicable) under Fakturoid → Settings → Billing Information. Also make sure that tax rates in Shopify are correctly set for all relevant countries, and check each product and its variants individually — a single misconfigured product can trigger this error for the entire order.
See How to Set VAT Settings for a detailed walkthrough.
Invalid VAT ID
What happened: The error "Invalid VAT ID. Does it include a country code? (e.g., CZ)" means the VAT ID entered by the customer is either incorrect or missing the country prefix.
How to fix it: Double-check the VAT ID — make sure it starts with the correct country code (e.g., CZ12345678) — and then reissue the invoice.