Changelog
Release notes and version history.
v1.0.0-beta.1Pre-ReleaseBreaking Changes
Nov 16, 2026
Complete Rewrite
node-zugferd has been completely rewritten from the ground up. Previous versions are no longer maintained or supported.
The new release introduces a modular, fully typed API for creating invoices and PDF/A-3 documents, with support for ZUGFeRD/Factur-X, XRechnung, and Order-X profiles.
What's New
- Invoice creation: Create structured invoices and PDF/A-3 documents.
- Multiple profiles: Support for ZUGFeRD/Factur-X, XRechnung, and Order-X.
- Parsing: Extract invoice data from existing documents.
- XSD validation: Validate XML schemas without requiring Java.
- Mustang validation: Integrate validation through Mustang.
- Templates: Generate documents using reusable templates.
- CLI: Access library functionality through the command line.
Breaking Changes
This release introduces breaking changes across the entire API. Previous versions are incompatible with the new architecture.
The legacy @node-zugferd/api package has been removed, including its HTTP API, client, framework integrations, and renderers. Applications using the previous API must migrate to the new library
The old documentation remains available at old.node-zugferd.jsolano.de.
v0.1.1-beta.1Pre-Release
Aug 7, 2025
🐞 Bug Fixes
View changes on GitHub
v0.1.0Latest
Aug 4, 2025
🚀 Features
- Add zugferd instance type - by
@jslno in #92 (f5069) - Logger - by
@jslno in #94 (8728f) - Add $Infer property to zugferd context for schema inference - by
@jslno in #96 (a6b82) - Migrate to Factur-X 1.07.3/ZUGFeRD 2.3.3 - by
@jslno in #103 (6f421) - api:
View changes on GitHub
v0.0.11-beta.3Pre-Release
Aug 2, 2025
🚀 Features
View changes on GitHub
v0.0.11-beta.2Pre-Release
Aug 1, 2025
🚀 Features
- Logger - by
@jslno in #94 (8728f) - Add $Infer property to zugferd context for schema inference - by
@jslno in #96 (a6b82) - api: Rewritten & enhanced API plugin - by
@jslno in #95 (2e65d)
View changes on GitHub
v0.0.11-beta.1Pre-Release
Jul 29, 2025
🚀 Features
View changes on GitHub
v0.0.10
Jul 28, 2025
🚀 Features
- Add support for billed quantity unit BT-130 - by
@karladler in #68 (8f915) - Codelist enum lookups - by
@jslno in #90 (a4bf1) - api: Support multiple templates - by
@jslno in #75 (6fb3f)
🐞 Bug Fixes
- Removed unecessary async for create function - by
@jslno in #69 (a3c26) - Moved
electronicAddressoutsidepostalAddress- by
@jslno in #71 (63b49) - Make getAsset function ESM and CommonJS friendly - by
@bastiion in #77 (ed6bc) - Correct typo in
serviceProviderIdentifierin EN16931 profile - by
@jslno in #79 (2fb49) - Add missing mask keys for BT-107 and BT-108 - by
@jslno in #84 (ed3fa) - Ensure correct structure and order in additionalXml fields - by
@jslno in #89 (f21d2) - api: Fixed typo in svelte-kit fallback basePath - by
@jslno in #80 (442ab)
View changes on GitHub
v0.0.10-beta.3Pre-Release
Jul 13, 2025
🐞 Bug Fixes
View changes on GitHub
v0.0.10-beta.2Pre-Release
Jun 28, 2025
🚀 Features
🐞 Bug Fixes
- Moved
electronicAddressoutsidepostalAddress- by
@jslno in #71 (63b49) - Make getAsset function ESM and CommonJS friendly - by
@bastiion in #77 (ed6bc) - Correct typo in
serviceProviderIdentifierin EN16931 profile - by
@jslno in #79 (2fb49) - api: Fixed typo in svelte-kit fallback basePath - by
@jslno in #80 (442ab)
View changes on GitHub
v0.0.10-beta.1Pre-Release
May 1, 2025
🚀 Features
- Add support for billed quantity unit BT-130 - by
@karladler in #68 (8f915)
🐞 Bug Fixes
View changes on GitHub
v0.0.9
Apr 28, 2025
🚀 Features
- Optional xsdPath for profiles - by
@jslno in #58 (3b0fc) - Add BT-24 specification identifier - by
@karladler in #62 (1361d)
🐞 Bug Fixes
- Export profile factory - by
@jslno in #57 (8a6c6) - Add missing business term keys for BG-1 - by
@karladler in #61 (d1faa) - Wrong EN16931-IDs - by
@jslno in #67 (f5974)
View changes on GitHub
v0.0.9-beta.4Pre-Release
Apr 27, 2025
No significant changes
View changes on GitHub
v0.0.9-beta.3Pre-Release
Apr 24, 2025
🚀 Features
- Add BT-24 specification identifier - by
@karladler in #62 (1361d)
View changes on GitHub
v0.0.9-beta.2Pre-Release
Apr 20, 2025
🐞 Bug Fixes
- Add missing business term keys for BG-1 - by
@karladler in #61 (d1faa)
View changes on GitHub
v0.0.9-beta.1Pre-Release
Mar 30, 2025
🚀 Features
🐞 Bug Fixes
View changes on GitHub
v0.0.8
Mar 26, 2025
🚀 Features
🐞 Bug Fixes
View changes on GitHub
v0.0.7
Mar 25, 2025
No significant changes
View changes on GitHub
v0.0.6
Mar 25, 2025
🚀 Features
- Plugins - by
@jslno in #48 (0f848) - Allow using date strings - by
@jslno in #51 (d4612) - API plugin - by
@jslno in #50 (261e4)
🐞 Bug Fixes
View changes on GitHub
v0.0.5
Mar 21, 2025
🚀 Features
- strict mode constraint - by
@jslno in #27 (adb53) - Untdid codelists - by
@jslno in #35 (014b5) - Additional codelists - by
@jslno in #39 (62dfc) - country code list (ISO 3166) - by
@jslno in #40 (c5597) - Validate documents when generating - by
@jslno in #44 (fd97b) - ISO 639-2 codelist - by
@jslno in #46 (20ea4) - UNTDID 2475 codelist - by
@jslno in #45 (cbf25)
🐞 Bug Fixes
- Xsd-schema-validator not found when skipping optional deps - by
@jslno in #32 (a82b9) - Resolve xsd path - by
@jslno in #43 (f24f6)
View changes on GitHub
v0.0.5-beta.12Pre-Release
Mar 21, 2025
🚀 Features
- Validate documents when generating - by
@jslno in #44 (fd97b) - ISO 639-2 codelist - by
@jslno in #46 (20ea4) - UNTDID 2475 codelist - by
@jslno in #45 (cbf25)
🐞 Bug Fixes
View changes on GitHub
v0.0.5-beta.11Pre-Release
Mar 20, 2025
🚀 Features
View changes on GitHub
v0.0.5-beta.10Pre-Release
Mar 19, 2025
🚀 Features
View changes on GitHub
v0.0.5-beta.9Pre-Release
Mar 18, 2025
🚀 Features
View changes on GitHub
v0.0.5-beta.8Pre-Release
Mar 18, 2025
🐞 Bug Fixes
- Feature_request.yml missing label - by
@jslno in #34 (82325) - Xsd-schema-validator not found - by
@jslno (15f7c)
View changes on GitHub
v0.0.5-beta.7Pre-Release
Mar 17, 2025
🐞 Bug Fixes
View changes on GitHub
v0.0.5-beta.6Pre-Release
Mar 17, 2025
No significant changes
v0.0.5-beta.5Pre-Release
Mar 16, 2025
No significant changes
v0.0.5-beta.3Pre-Release
Mar 15, 2025
No significant changes
View changes on GitHub
v0.0.5-beta.2Pre-Release
Mar 12, 2025
No significant changes
View changes on GitHub
v0.0.5-beta.1Pre-Release
Mar 12, 2025
No significant changes
View changes on GitHub
v0.0.4
Mar 12, 2025
Bug Fixes
Full Changelog: https://github.com/jslno/node-zugferd/commits/v0.0.4