@stackforge-eu/factur-x 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -7,6 +7,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.4.2] — 2026-09-25
+
+- **Fixed the embedded XML MIME type back to `text/xml`.** 1.2.1 switched the
+  `factur-x.xml` filespec `/Subtype` to `application/xml` (#7), but the
+  Factur-X specification requires `text/xml`, and the official FNFE-MPE
+  validator rejects anything else. PDFs generated with 1.2.1 through 1.4.1
+  should be regenerated. A test now pins the value (#19).
+
+## [1.4.1] — 2026-09-14
+
+- **Added the rounding amount (BT-114).** A new optional `roundingAmount`
+  field on `InvoiceTotalsInput` emits `ram:RoundingAmount` between the tax
+  total and the grand total, so an invoice can state the amount that takes
+  the grand total (BT-112) to the payable figure (BT-115). Emitted for
+  EN 16931 and EXTENDED only, as the lower-profile XSDs do not define the
+  element. `validateInput` now also checks BR-CO-16
+  (`duePayableAmount = grandTotal - prepaidAmount + roundingAmount`), which
+  the schematron already enforced. Omitting the field keeps the output
+  byte-for-byte identical (#17).
+
 ## [1.4.0] — 2026-09-03
 
 - **Added the item price discount (BT-147).** A new optional `priceDiscount`
@@ -245,6 +265,8 @@ This element is not expected`. Reordered the three blocks in
 - Deno compatibility test suite
 
 [Unreleased]: https://github.com/StackForge-EU/factur-x/commits/main
+[1.4.2]: https://github.com/StackForge-EU/factur-x/compare/v1.4.1...v1.4.2
+[1.4.1]: https://github.com/StackForge-EU/factur-x/compare/v1.4.0...v1.4.1
 [1.4.0]: https://github.com/StackForge-EU/factur-x/compare/v1.3.1...v1.4.0
 [1.3.1]: https://github.com/StackForge-EU/factur-x/compare/v1.3.0...v1.3.1
 [1.3.0]: https://github.com/StackForge-EU/factur-x/compare/v1.2.1...v1.3.0

package/dist/index.cjs

@@ -496,6 +496,8 @@ function buildMonetarySummation(t, profile) {
   x += tag("ram:TaxTotalAmount", fmtAmt(t.taxTotal), {
     currencyID: t.currency
   });
+  if (atLeast(profile, "EN16931" /* EN16931 */) && t.roundingAmount !== void 0)
+    x += tag("ram:RoundingAmount", fmtAmt(t.roundingAmount));
   x += tag("ram:GrandTotalAmount", fmtAmt(t.grandTotal));
   if (atLeast(profile, "BASIC_WL" /* BASIC_WL */) && t.prepaidAmount !== void 0)
     x += tag("ram:TotalPrepaidAmount", fmtAmt(t.prepaidAmount));
@@ -936,6 +938,22 @@ function validateInput(input, profile, flavor) {
       }
     }
   }
+  if (req("BASIC_WL" /* BASIC_WL */) && input.totals) {
+    const t = input.totals;
+    if (t.grandTotal != null && t.duePayableAmount != null) {
+      const prepaid = t.prepaidAmount ?? 0;
+      const rounding = t.roundingAmount ?? 0;
+      const expected = round2(t.grandTotal - prepaid + rounding);
+      if (Math.abs(round2(t.duePayableAmount) - expected) > 0.01) {
+        addError(
+          errors,
+          "totals.duePayableAmount",
+          `duePayableAmount ${t.duePayableAmount} does not equal grandTotal - prepaidAmount + roundingAmount (${expected}) (BR-CO-16).`,
+          "BASIC_WL" /* BASIC_WL */
+        );
+      }
+    }
+  }
   if (req("BASIC_WL" /* BASIC_WL */) && input.totals) {
     const t = input.totals;
     if (t.lineTotal != null && t.taxBasisTotal != null) {
@@ -1424,7 +1442,8 @@ async function embedFacturX(options) {
   const xmlBytes = new TextEncoder().encode(xml);
   const afRel = resolveAfRelationship(profile, options.afRelationship);
   await pdfDoc.attach(xmlBytes, flavorConfig.attachmentFilename, {
-    mimeType: "application/xml",
+    // Factur-X mandates text/xml on the filespec; the FNFE validator rejects application/xml.
+    mimeType: "text/xml",
     afRelationship: afRel,
     description: "Factur-X Invoice"
   });

package/dist/index.d.cts

@@ -859,6 +859,14 @@ interface InvoiceTotalsInput {
      * @see EN 16931 BT-113
      */
     prepaidAmount?: number;
+    /**
+     * Rounding amount — the amount added to the grand total (BT-112) to round
+     * the amount due (BT-115) to a payable figure, e.g. `0.02` to take
+     * `29.95` to `29.97`. Emitted as `ram:RoundingAmount` for EN 16931 and
+     * EXTENDED only; the BASIC / BASIC WL XSDs do not define the element.
+     * @see EN 16931 BT-114, BR-CO-16
+     */
+    roundingAmount?: number;
     /**
      * Due payable amount.
      * @see EN 16931 BT-115

package/dist/index.d.ts

@@ -859,6 +859,14 @@ interface InvoiceTotalsInput {
      * @see EN 16931 BT-113
      */
     prepaidAmount?: number;
+    /**
+     * Rounding amount — the amount added to the grand total (BT-112) to round
+     * the amount due (BT-115) to a payable figure, e.g. `0.02` to take
+     * `29.95` to `29.97`. Emitted as `ram:RoundingAmount` for EN 16931 and
+     * EXTENDED only; the BASIC / BASIC WL XSDs do not define the element.
+     * @see EN 16931 BT-114, BR-CO-16
+     */
+    roundingAmount?: number;
     /**
      * Due payable amount.
      * @see EN 16931 BT-115

package/dist/index.js

@@ -466,6 +466,8 @@ function buildMonetarySummation(t, profile) {
   x += tag("ram:TaxTotalAmount", fmtAmt(t.taxTotal), {
     currencyID: t.currency
   });
+  if (atLeast(profile, "EN16931" /* EN16931 */) && t.roundingAmount !== void 0)
+    x += tag("ram:RoundingAmount", fmtAmt(t.roundingAmount));
   x += tag("ram:GrandTotalAmount", fmtAmt(t.grandTotal));
   if (atLeast(profile, "BASIC_WL" /* BASIC_WL */) && t.prepaidAmount !== void 0)
     x += tag("ram:TotalPrepaidAmount", fmtAmt(t.prepaidAmount));
@@ -906,6 +908,22 @@ function validateInput(input, profile, flavor) {
       }
     }
   }
+  if (req("BASIC_WL" /* BASIC_WL */) && input.totals) {
+    const t = input.totals;
+    if (t.grandTotal != null && t.duePayableAmount != null) {
+      const prepaid = t.prepaidAmount ?? 0;
+      const rounding = t.roundingAmount ?? 0;
+      const expected = round2(t.grandTotal - prepaid + rounding);
+      if (Math.abs(round2(t.duePayableAmount) - expected) > 0.01) {
+        addError(
+          errors,
+          "totals.duePayableAmount",
+          `duePayableAmount ${t.duePayableAmount} does not equal grandTotal - prepaidAmount + roundingAmount (${expected}) (BR-CO-16).`,
+          "BASIC_WL" /* BASIC_WL */
+        );
+      }
+    }
+  }
   if (req("BASIC_WL" /* BASIC_WL */) && input.totals) {
     const t = input.totals;
     if (t.lineTotal != null && t.taxBasisTotal != null) {
@@ -1394,7 +1412,8 @@ async function embedFacturX(options) {
   const xmlBytes = new TextEncoder().encode(xml);
   const afRel = resolveAfRelationship(profile, options.afRelationship);
   await pdfDoc.attach(xmlBytes, flavorConfig.attachmentFilename, {
-    mimeType: "application/xml",
+    // Factur-X mandates text/xml on the filespec; the FNFE validator rejects application/xml.
+    mimeType: "text/xml",
     afRelationship: afRel,
     description: "Factur-X Invoice"
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stackforge-eu/factur-x",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "type": "module",
   "description": "Embed Factur-X, ZUGFeRD, and XRechnung structured invoice XML into PDF/A-3 documents",
   "keywords": [