finaX XRechnung API Releases

1.4.4 (2024-08-04)

Sun, 04 Aug 2024 00:00:00 +0200

We updated the docs and incorporated the UBL test payloads from https://github.com/itplr-kosit/xrechnung-testsuite/.
This release contains some bugfixes for UBL invoice generation.

1.4.5 (2024-08-11)

Sun, 11 Aug 2024 00:00:00 +0200

We updated the docs and incorporated the CII test payloads from https://github.com/itplr-kosit/xrechnung-testsuite/.
This release contains some bugfixes for CII invoice generation.
The Postman collection was updated with the latest examples.
The docs now include a cURL example.
Tests were extended to Postman collection as well as PDF/Zugferd API endpoints.

1.4.6 (2024-09-09)

Mon, 09 Sep 2024 00:00:00 +0200

Added X-FINAX-API-VERSION response HTTP header to all API endpoints
[Internal] Rework exceptions for missing values
Add Business Terms information to docs

1.4.7 (2024-09-23)

Mon, 23 Sep 2024 00:00:00 +0200

Added a better error message for wrong content-type header

1.4.8 (2024-09-29)

Sun, 29 Sep 2024 00:00:00 +0200

We fixed documenation example values and added tests for those.

1.4.9 (2024-09-29)

Sun, 29 Sep 2024 00:00:00 +0200

We fixed tax values for the examples in our docs.
Added a better error message for XML parsing errors.

1.4.10 (2024-10-02)

Wed, 02 Oct 2024 00:00:00 +0200

We exclude unset fields now in JSON from XML (XML2JSON) as they are not needed.
We improved the error messages for tax validation (BR-AE-8, BR-E-8, BR-G-8, BR-IC-8, BR-IG-8, BR-IP-8 BR-O-8, BR-S-8, BR-Z-8).

1.4.11 (2024-10-03)

Thu, 03 Oct 2024 00:00:00 +0200

We fixed a rounding issue in the vat breakdown validation.

1.4.12 (2024-10-04)

Fri, 04 Oct 2024 00:00:00 +0200

We now provide a more clear error message for unprocessable XML attachments in pdf files.
We fixed an issue in the peppol en16931 r046 rule validation. If discounts have been provided explictly as null this caused the rule to fail.
We improved JSON decode error messages for invalid JSON payloads.
The credit note invoice type is now allowed for UBL. We recommend using CII for credit notes.

1.4.13 (2024-10-06)

Sun, 06 Oct 2024 00:00:00 +0200

We added support for UBL credit notes. Examples can be found in our docs: https://docs.finax.dev

1.4.14 (2024-10-06)

Sun, 06 Oct 2024 00:00:00 +0200

We added a metrics exporter for how often which endpoint gets called. This should help us improve finaX SaaS offering.

1.4.15 (2024-10-08)

Tue, 08 Oct 2024 00:00:00 +0200

We made enums in the documentation collapsible and default collapsed for less scrolling.
We fixed the decimal places for BT-148 and >= condition for BT-146 and BT-148.

1.4.16 (2024-10-09)

Wed, 09 Oct 2024 00:00:00 +0200

We removed the validation for BR-DE-12 since this is not officially enforced by the schema. This now allows for foreign post codes for delivery addresses.
We added a more clear error message for unprocessable PDF files.

1.4.17 (2024-10-15)

Tue, 15 Oct 2024 00:00:00 +0200

We added validation_mode to XML generation. Read more in our docs. Furthermore BT-130 and BT-150 allow now also arbitrary strings for XML2JSON endpoints. The changes are backwards compatible.
We removed version and extension from XML2JSON API responses, since these always just displayed the default values.

1.4.18 (2024-10-30)

Wed, 30 Oct 2024 00:00:00 +0100

We added a validation for minimum length for mandatory string fields.

1.4.19 (2024-11-04)

Mon, 04 Nov 2024 00:00:00 +0100

We added endpoints for pdf rendering from UBL, CII and JSON.

1.4.20 (2024-11-05)

Tue, 05 Nov 2024 00:00:00 +0100

We fixed the missing "Basisbetrag" in the payment_terms (BT-20) validation (BR-DE-18).
We fixed a typo in the tax validation error messages.
We added a hint for "Leitweg-ID" / BT-10 in the docs.

1.4.21 (2024-11-12)

Tue, 12 Nov 2024 00:00:00 +0100

We fixed an issue with date parsing.
We added samples in many programming languages to our documentation.

1.4.22 (2024-11-14)

Thu, 14 Nov 2024 00:00:00 +0100

We fixed an issue with delivery addresses in the experimental template rendering of invoices.

1.4.23 (2024-11-20)

Wed, 20 Nov 2024 00:00:00 +0100

We fixed the error message for vat exemption reason codes and vat exemption reason texts.
We updated the Postman collection to contain trailing slashes. This avoids a redirect.
We updated the examples for the experimental pdf endpoints.

1.5.0 (2024-11-24)

Sun, 24 Nov 2024 00:00:00 +0100

We added support for ZUGFeRD EN-16931 (Comfort) profile.
We added the Content-Type header to the programming samples.

1.5.1 (2024-12-02)

Mon, 02 Dec 2024 00:00:00 +0100

We fixed an issue with the payment terms visualization (days have been cut off).
We added more ZUGFeRD CII invoice type codes.
We fixed a bug for corrected invoices (CII only).

1.5.2 (2024-12-05)

Thu, 05 Dec 2024 00:00:00 +0100

We fixed a bug for the summation of charges and allowances on the document total level for VAT category S.

1.5.3 (2024-12-08)

Sun, 08 Dec 2024 00:00:00 +0100

We fixed a bug for the validation of the summation of charges and allowances on the document total level.
We added an endpoint which takes UBL or CII and converts it to JSON.

1.5.4 (2024-12-12)

Thu, 12 Dec 2024 00:00:00 +0100

We fixed a floating point bug (rounding) for the validation rule PEPPOL EN16931 R040.

1.5.5 (2024-12-16)

Mon, 16 Dec 2024 00:00:00 +0100

We fixed an issue with PDF generation for UBL files. The transformation of random tax scheme identifiers, which can be used in UBL potentially failed here.
We disabled the currency for Sierra Leone, since it it rejected by the KoSIT validation (request in progress).

1.5.6 (2024-12-31)

Tue, 31 Dec 2024 00:00:00 +0100

We fixed an issue with the visualization of line items without vat rate.
We fixed a line break issue in the invoice line item description for pdf generation.

1.5.7 (2025-01-02)

Thu, 02 Jan 2025 00:00:00 +0100

We added an option to insert a logo into PDF generated files.
Generated "reverse charge invoices" will automatically have an added hint concerning reverse charge.

1.5.8 (2025-01-07)

Tue, 07 Jan 2025 00:00:00 +0100

We added an improved IBAN validation.
For logos in the pdf creation endpoints - invalid base64 strings now raise an error.

1.5.9 (2025-01-19)

Sun, 19 Jan 2025 00:00:00 +0100

We added a description for the 415 HTTP error code to the docs.
We relaxed the Content-Type header check slighty to accept values like application/json; charset=utf-8.

1.5.10 (2025-02-02)

Sun, 02 Feb 2025 00:00:00 +0100

We fixed the error message for BR-DE-25.
We added the buyer vat id to zugferd visualization.

1.5.11 (2025-02-09)

Sun, 09 Feb 2025 00:00:00 +0100

We added rate limit headers to responses.

1.5.12 (2025-02-11)

Tue, 11 Feb 2025 00:00:00 +0100

We fixed an issue concerning BT-48, which should be optional in UBL syntax.

1.5.13 (2025-02-14)

Fri, 14 Feb 2025 00:00:00 +0100

We improved the file name recognition for ZUGFeRD files.
We fixed the optional input for BT-41 for EN16931 ZUGFeRD files.
We improved the error message for unrecognized attachments in ZUGFeRD files.
We made BT-132 for reading CII XML optional.

1.5.14 (2025-02-18)

Tue, 18 Feb 2025 00:00:00 +0100

We refactored the error message for missing files in PDFs.
We fixed a bug which caused peppol_en16931_r120 to be applied in CII.

1.5.15 (2025-02-23)

Sun, 23 Feb 2025 00:00:00 +0100

We improved the error handling / message for PDFs with an undeterminable conformance level.

1.5.16 (2025-02-23)

Sun, 23 Feb 2025 00:00:00 +0100

We added an error message for Comfort Profile (ZUGFeRD 1).
We improved the search for conformance level indicators in ZUGFeRD.

1.5.17 (2025-03-01)

Sat, 01 Mar 2025 00:00:00 +0100

We tweaked the error handler extracting invoice JSON from ZUGFeRD PDFs.

1.5.18 (2025-03-10)

Mon, 10 Mar 2025 00:00:00 +0100

We now automatically replace depcreated electronic address scheme identifiers (9917, 9956, 9958).
We fixed an issue for ZUGFeRD generation when only some lines are discounted.
We removed unwanted linebreaks between currencies and amounts in ZUGFeRD generation.

1.5.19 (2025-03-23)

Sun, 23 Mar 2025 00:00:00 +0100

We added a new header x-finax-trace-id. If set it will be returned in the response headers.

1.5.20 (2025-04-03)

Thu, 03 Apr 2025 00:00:00 +0200

We fixed a minor internal bug with the tracing middleware. No user was impacted.
We fixed an issue with mixed structured and unstructured content in BT-20. Users using BT-20 are now able to mix content.

1.5.21 (2025-04-28)

Mon, 28 Apr 2025 00:00:00 +0200

We restructured PDF endpoints in the documentation and removed the "experimental" label from the visualization endpoints.
We added 2 new endpoints - one to extract pdf xml metadata from a ZUGFeRD file and one to extract the invoice xml from a ZUGFeRD file.

1.5.22 (2025-05-14)

Wed, 14 May 2025 00:00:00 +0200

We fixed some missing validation rules for PDF from JSON endpoint (/v1/pdf/json/).

1.5.23 (2025-05-26)

Mon, 26 May 2025 00:00:00 +0200

Fix issue when logo file field for PDF generation is empty. Now returns pdf without logo.
Fix issue when reading CII - BG-4 (seller) with multiple identifiers and first one has no scheme identifier.

1.6.0 (2025-06-22)

Sun, 22 Jun 2025 00:00:00 +0200

We added Accept-Header functionality to switch the language error messages.
If a business rule was violated a field in the error message displays the name of the business rule.

1.6.1 (2025-06-24)

Tue, 24 Jun 2025 00:00:00 +0200

We fixed an issue with the tax validation for VAT category "E" - buyer identifiers were required which was wrong.

1.7.0 (2025-07-13)

Sun, 13 Jul 2025 00:00:00 +0200

Endpoints with XML input (XRechnung and ZUGFeRD) return the XPath for the given document in field in case the validation failed with HTTP 422.
UBL XML inputs are now verified for PEPPOL-EN16931-R008 (empty tags).
HTTP 422 errors now contain a field business_term the caused the validation failure.
We fixed a typo in tax validation messages.

1.7.1 (2025-07-14)

Mon, 14 Jul 2025 00:00:00 +0200

Fix for validation of inputs for JSON extracting endpoints. XMLs with encoding definitions caused an error.

1.7.2 (2025-08-18)

Mon, 18 Aug 2025 00:00:00 +0200

We added some more German HTTP 422 error message translations.
We added XPath selectors also for business rule errors (HTTP 422).
The dotted json paths in HTTP 422 error field have been improved.
The message in HTTP 422 errors are now more humane.
Currency codes have been updated.
We fixed minor display issues in the PDF footer.

1.7.3 (2025-08-22)

Fri, 22 Aug 2025 00:00:00 +0200

We fixed an issue where validation_mode=lax still validated strict (UBL and CII endpoints).
The default validation_mode is not explicitly set to lax for backwards compatibility.

1.7.4 (2025-09-08)

Mon, 08 Sep 2025 00:00:00 +0200

We fixed an issue where "None" was displayed as namespace in HTTP 422 xpath error messages.
We fixed an issue that caused a server error when BR-CO-14 validation failed.

1.7.5 (2025-10-19)

Sun, 19 Oct 2025 00:00:00 +0200

We fixed an issue where BR-CO-17 could cause a server error.

1.7.6 (2025-10-19)

Sun, 19 Oct 2025 00:00:00 +0200

We fixed another issue that caused server errors for BR-CO-14 and BR-CO-18.

1.7.7 (2025-10-20)

Mon, 20 Oct 2025 00:00:00 +0200

We fixed some minor issues with json path error formatting.
It was possible to set an empty string for payment_terms (BT-20) which caused issues in BR-CO-25 validation. Now an empty string is treated as not set.

1.7.8 (2025-10-27)

Mon, 27 Oct 2025 00:00:00 +0100

We fixed an error with indexing lists in tax error messages. This lead to HTTP 500 errors in some cases.

1.7.9 (2025-10-28)

Tue, 28 Oct 2025 00:00:00 +0100

We fixed a redirect error for the /v1/json/xml/ endpoint.

1.8.0 (2025-11-10)

Mon, 10 Nov 2025 00:00:00 +0100

New feature: Added support for Peppol BIS Billing invoices. Create UBL Peppol BIS Billing 3.0 compliant invoices using the /v1/xml/ubl endpoint. It is also possible to read UBL Peppol BIS Billing 3.0. Set x-finax-cius header set to Peppol BIS Billing 3.0. More information can be found in the documentation.
We fixed a bug where CreditNote documents would not be recognized in /v1/json/xml/.

1.8.1 (2025-11-30)

Sun, 30 Nov 2025 00:00:00 +0100

We added the display of invoice line invoicing period to PDF generation endpoints

1.8.2 (2025-12-07)

Sun, 07 Dec 2025 00:00:00 +0100

New feature: Generate PDF invoices also in English and French. We added a language parameter to the PDF generation endpoint payloads. Supported values are de (default), en and fr.
We added a text endpoint in the documentation to retrieve the api's version: https://docs.finax.dev/api-version

1.8.3 (2025-12-07)

Sun, 07 Dec 2025 00:00:00 +0100

Bumps a dependency for PDF generation to fix memory seg faults.

1.8.4 (2025-12-13)

Sat, 13 Dec 2025 00:00:00 +0100

We fixed an issue that caused french ZUGFeRD invoices to not be generated correctly.

1.8.5 (2025-12-16)

Tue, 16 Dec 2025 00:00:00 +0100

We added x-finax-cius - None to disable CIUS validation for the UBL endpoint. This is useful for users who want to create UBL invoices which do not conform to PEPPOL EN16931.

1.8.6 (2025-12-28)

Sun, 28 Dec 2025 00:00:00 +0100

We fixed a validation error for BR-DE-27 and BR-DE-28 when no phone number or email address for a seller contact is provided an error occured.

1.8.7 (2026-01-02)

Fri, 02 Jan 2026 00:00:00 +0100

We addressed minor descrapancies from the ZUGFeRD / Factor-X PDF metadata specifications (only for PDF generation - /v1/pdf/merge/ endpoint).

1.8.8 (2026-01-08)

Thu, 08 Jan 2026 00:00:00 +0100

We fixed the subtotal field in the PDF generation. In case there were discounts and charges the price after discounts and charges was displayed.

1.8.9 (2026-01-26)

Mon, 26 Jan 2026 00:00:00 +0100

We fixed an issue when generating CII XML with multiple GlobalIDs incl. attributes for seller or buyer.
We fixed an issue which caused payment terms (BT-20) for invoices with a sum <= 0 to contain an empty tag.

1.8.10 (2026-02-01)

Sun, 01 Feb 2026 00:00:00 +0100

We added consistent formatting to numbers (minimum 2 decimal places) in PDF generation endpoints.
We fixed cases where the rule PEPPOL-EN16931-R120 was not applied correctly.
We added the official slack value of 0.02 for PEPPOL and XRechnung to the rules PEPPOL-EN16931-R120 and PEPPOL-EN16931-R046.

1.8.11 (2026-03-01)

Sun, 01 Mar 2026 00:00:00 +0100

We corrected the example for PDF from JSON to not use XRechnung Extension.
We improved the performance for large invoice XML generation - /api/xml/ubl/ and /api/xml/cii/ endpoints.
We removed CUC currency code from the allowed currency codes since it is deprecated by ISO 4217.
We added support for basic ZUGFeRD invoice to JSON extraction.
We added a watermark in PDFs for test keys. Production (paid) keys are not effected by this.

1.8.12 (2026-03-02)

Mon, 02 Mar 2026 00:00:00 +0100

We improved support for PDFs that already contain metadata. If the PDF already contains metadata, we will now merge the generated PDF's metadata.

1.8.13 (2026-03-04)

Wed, 04 Mar 2026 00:00:00 +0100

We added translations for error messages when process ZUGFeRD files to JSON. Furthermore we added a more clear error message for unsupported ZUGFeRD versions.

1.8.14 (2026-03-11)

Wed, 11 Mar 2026 00:00:00 +0100

We improved the parsing of IBAN (cleaning of whitespaces).
We improved conformance validation for ZUGFeRD / Factur-X.

1.8.15 (2026-03-16)

Mon, 16 Mar 2026 00:00:00 +0100

We fixed the programming examples for the CII XML generation endpoint in the documentation (removed XRechnung Extension fields).
We fixed a regression which made it possible to submit certain required fields with null values.

1.8.16 (2026-03-17)

Tue, 17 Mar 2026 00:00:00 +0100

We improved the collection of error messages. HTTP 422 error messages now summarize multiple mixing field or type errors in one request.

1.8.17 (2026-03-25)

Wed, 25 Mar 2026 00:00:00 +0100

We added a new error message for missing VAT scheme_id / codes (only HTTP 422).
We added an explicit error message for ZUGFeRD 1.0 files.

1.8.18 (2026-04-07)

Tue, 07 Apr 2026 00:00:00 +0200

We fixed an issue with the validation of delivery information for tax category "K" (BR-IC-11).