How to use
Please note first: this tool creates Factur-X and ZUGFeRD hybrid invoices of the kind German, French and other European customers ask for. It is a different system from Korea’s electronic tax invoice (Hometax and National Tax Service transmission) and cannot be used to issue one. The result may not be a PDF/A-3 conformant file. This is not legal or tax advice.
- Choose one invoice PDF. A password-protected PDF is opened on your device only after you enter the password, and the result is saved without a password.
- Decide the invoice data. Fill in a form builds CII XML with the same form as the E-Invoice Creator; Import XML takes CII XML you already have, pasted or loaded from a file.
- Check the profile (ConformanceLevel) and AFRelationship. They are detected from the XML’s CustomizationID and you can override them.
- Press Embed the invoice XML in the PDF and the PDF with the attachment is downloaded. The result table shows the attachment name, AFRelationship and the catalog /AF link.
- Before you send it, check the embedded XML with the E-Invoice Validator.
What this tool does
Factur-X (called ZUGFeRD in Germany) sends machine-readable XML inside the human-readable PDF as one file. With pdf-lib this tool writes the following into the PDF.
| Item | Content |
|---|---|
| Attachment | Name factur-x.xml (xrechnung.xml for the XRECHNUNG profile), MIME text/xml, description “Factur-X Invoice” |
| AFRelationship | Alternative or Data in the file specification, linked from the catalog /AF array |
| XMP metadata | fx:DocumentType=INVOICE, fx:DocumentFileName, fx:Version=1.0, fx:ConformanceLevel, the Factur-X extension schema description, title, creator tool and dates |
AFRelationship describes how the PDF and the XML relate. Use Alternative when the PDF is another rendering of the XML (EN 16931, BASIC, XRechnung) and Data when the XML is supplementary data (MINIMUM, BASIC WL). The tool picks the value that fits the profile by default.
| ConformanceLevel | CustomizationID (BT-24) | Default AFRelationship |
|---|---|---|
| MINIMUM | urn:factur-x.eu:1p0:minimum |
Data |
| BASIC WL | urn:factur-x.eu:1p0:basicwl |
Data |
| BASIC | urn:cen.eu:en16931:2017#compliant#urn:factur-x.eu:1p0:basic |
Alternative |
| EN 16931 | urn:cen.eu:en16931:2017 |
Alternative |
| EXTENDED | urn:cen.eu:en16931:2017#conformant#urn:factur-x.eu:1p0:extended |
Alternative |
| XRECHNUNG | urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0 |
Alternative |
The PDF/A-3 limitation
The Factur-X specification asks for the PDF to be PDF/A-3. pdf-lib alone cannot guarantee PDF/A-3 conformance. This tool adds the attachment and the metadata, and it cannot do the following.
- Embed every font used on the pages into the file
- Add an output intent with a colour profile
- Write a PDF/A identifier (pdfaid:part, conformance) into the XMP. It is left out on purpose so that a non-conformant file does not carry a conformance claim.
- Remove elements PDF/A forbids, such as encryption, certain transparency and scripts
So the result may not be a PDF/A-3 conformant file. If the recipient requires PDF/A-3, start from a PDF produced as PDF/A-3 and check the result with a validator such as veraPDF. When you pick a PDF the tool shows a PDF/A-3 readiness hint (output intent present, number of fonts not embedded, a PDF/A identifier in existing XMP, encryption); it is not a conformance check. The PDF to PDF/A tool shows whether a PDF meets the PDF/A basics (fonts, encryption, JavaScript, XMP), but the PDF/A-2b it produces is a level that does not allow attachments, so attaching XML to it still does not give the PDF/A-3 that Factur-X asks for.
Rules to be aware of (as of 2026-10-19, subject to change)
In Germany it is widely read that the MINIMUM and BASIC WL profiles of ZUGFeRD and Factur-X do not count as e-invoices because they do not carry the full invoice content, so a profile of EN 16931 or above is the safer choice. Germany is understood to require every business to be able to receive e-invoices from 2025, and France plans to phase in mandatory e-invoicing from September 2026. Schedules and accepted formats have changed before, so check the official guidance of the German Federal Ministry of Finance and the French tax authority.
Frequently asked questions
Are Factur-X and ZUGFeRD the same thing?
Technically they are the same format. France calls it Factur-X and Germany ZUGFeRD, and versions from 2.0 on are aligned. Profile names and some requirements differ a little by country.
How can I check that the resulting PDF is PDF/A-3?
This tool cannot. Open it with a PDF/A validator such as veraPDF. Starting from a PDF with no unembedded fonts and with an output intent makes conformance more likely but does not guarantee it.
Can I embed UBL XML?
No. Factur-X attaches only CII (CrossIndustryInvoice) XML. If you work in UBL you need to create the invoice again as CII.
What happens to a PDF that already contains factur-x.xml?
An attachment with the same name is replaced with the new XML and you are told so. Other attachments stay as they are. Existing XMP metadata is rewritten for Factur-X and only the title, creator tool and dates are carried over.
Is my file uploaded to a server?
No. The PDF and the XML are processed in your browser only and are never sent to a server.
Related tools
Tidy the title and author with PDF Metadata Editor, and Protect PDF can set a password before you send it. Note that encrypting a Factur-X file may stop the recipient’s system from reading the XML. You can also make the invoice itself with the Invoice Maker. Files are processed in your browser only and never sent to a server.