FAQ
Which format should we use?
Use the format named by the recipient or their delivery provider. For a German B2B customer that wants one readable file with machine data, ZUGFeRD is often practical. Use Factur-X when the French profile is required, XRechnung for recipients that explicitly request it, EN 16931 for a CII-based European workflow, and PEPPOL BIS only when the next system expects its UBL profile.
Does the extension send invoices through PEPPOL?
No. It generates PEPPOL BIS Billing 3.0 UBL. Participant registration, access-point lookup, network transmission and delivery receipts belong to a PEPPOL access point or integration layer.
Does XRechnung generation upload to ZRE or OZG-RE?
No. The extension creates XML. Portal registration, routing and upload are separate tasks.
Are invoices and credit memos supported?
Yes. Credit-memo support is disabled by default and has its own generation mode, trigger, document type, attachment setting and filename pattern. The supported formatters cover all five available formats for both invoices and credit memos.
What is the difference between document types 381 and 384?
381 represents a credit note. 384 represents a corrected invoice and the formatter applies negative quantities and amounts for that model. Confirm which representation the receiver expects before changing the default.
Can each customer use a different format?
Not through a standard customer field. Automatic generation reads the store-view Default B2B Format. A customer-specific decision requires custom integration code around the generator or separate store views with deliberate configuration.
Can we select a different format for credit memos?
Not through a separate credit-memo format setting. Credit memos use the same store-level default format as invoices.
What do pending, generated, error and disabled mean?
pending: waiting for generation or manual processing;generated: generation completed and metadata was stored;error: the last attempt failed; inspect the stored error message;disabled: automatic generation mode is disabled for that document flow.
Does generated prove the recipient will accept the file?
No. It means Magento completed its generation lifecycle. Receiver-specific business rules, procurement references, access-point requirements and transport remain separate.
What does strict XSD validation check?
It validates XML structure against the bundled schema selected for the format and profile. It is not a complete legal, tax or receiver-acceptance audit. PEPPOL and government recipients commonly apply additional rule sets.
Why is there no PDF for XRechnung, EN 16931 or PEPPOL BIS?
Those formatters create XML-only documents. Hybrid PDFs are created for ZUGFeRD and Factur-X. If people also need a visual invoice, keep Magento's normal invoice PDF in the process.
What does the Automatic email attachment strategy send?
It sends the PDF for a hybrid document and XML for an XML-only document. Both sends both when both contents exist. PDF only cannot invent a PDF for an XML-only format.
Where are files stored?
With permanent storage, invoices default to pub/media/einvoice/ and credit memos to pub/media/einvoice/creditmemo/. With on-demand storage, files are regenerated when an action requests them rather than kept as a permanent archive.
Can customers download an e-invoice?
The storefront invoice view can expose a PDF download for a generated hybrid invoice when the customer owns the invoice. XML-only formats do not provide that PDF action.
Do REST and CLI commands use invoice numbers?
No. Their invoiceId and creditmemoId values are numeric Magento entity IDs, not visible increment IDs such as 000000123.
Does force: true regenerate an existing document?
No. The command accepts the argument for compatibility, but the management service still skips a document already marked generated.
Why did an invoice generate even though the trigger is Manual Only or On Invoice Payment?
The invoice-create observer follows the generation mode without checking the configured invoice trigger. Do not rely on that trigger to suppress creation-time processing. Credit-memo Manual Only is checked by its observer.
Can Block on Error guarantee that Magento creates no invoice?
No. Invoice generation runs from an after-commit sales event. In immediate mode, the setting can propagate a generation failure back to the request, but it cannot reliably roll back an invoice already committed to the database. Queue and cron failures happen later and cannot block creation.
Why does Factur-X fail even when it is selected?
Factur-X reads Default B2B Format in the invoice's store view. Confirm that setting and the general enable switch, then retry. Do not add an undocumented configuration row as a workaround.
What should we send to support?
Include the installed package and Magento compatibility details, store view, selected format/profile, generation mode, numeric entity ID, status, exact error message and sanitized validation output. Do not send complete invoices or customer data unless a secure support channel specifically requests them.