@stackforge-eu/factur-x 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [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 +257,7 @@ 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.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) {

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) {

package/package.json

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