@fin.cx/einvoice 8.2.1 → 8.2.2

package/ts/einvoice.ts

@@ -46,6 +46,7 @@ import {
 // Import enhanced validators
 import { EN16931Validator } from './formats/validation/en16931.validator.js';
 import { EN16931BusinessRulesValidator } from './formats/validation/en16931.business-rules.validator.js';
+import { computeDocumentTotals } from './formats/utils/document.totals.js';
 import { CodeListValidator } from './formats/validation/codelist.validator.js';
 import type { ValidationOptions } from './formats/validation/validation.types.js';
 
@@ -211,7 +212,7 @@ export class EInvoice implements TAccountingDocEnvelope<TAccountingDocType, {}>
   }
   
   public get totalGross(): number {
-    return this.totalNet + this.totalVat;
+    return computeDocumentTotals(this).grandTotal.toNumber();
   }
   
   public get taxBreakdown(): Array<{ taxPercent: number; netAmount: number; taxAmount: number }> {
@@ -795,42 +796,27 @@ export class EInvoice implements TAccountingDocEnvelope<TAccountingDocType, {}>
    * Calculates the total net amount
    */
   private calculateTotalNet(): number {
-    return this.items.reduce((sum, item) => {
-      return sum + (item.unitQuantity * item.unitNetPrice);
-    }, 0);
+    // the sum of line net amounts (BT-106) the encoders write
+    return computeDocumentTotals(this).lineTotal.toNumber();
   }
 
   /**
    * Calculates the total VAT amount
    */
   private calculateTotalVat(): number {
-    return this.items.reduce((sum, item) => {
-      const net = item.unitQuantity * item.unitNetPrice;
-      return sum + (net * item.vatPercentage / 100);
-    }, 0);
+    // the total VAT (BT-110) the encoders write
+    return computeDocumentTotals(this).taxTotal.toNumber();
   }
 
   /**
    * Calculates tax breakdown by rate
    */
   private calculateTaxBreakdown(): Array<{ taxPercent: number; netAmount: number; taxAmount: number }> {
-    const breakdown = new Map<number, { net: number; tax: number }>();
-    
-    this.items.forEach(item => {
-      const net = item.unitQuantity * item.unitNetPrice;
-      const tax = net * item.vatPercentage / 100;
-      
-      const current = breakdown.get(item.vatPercentage) || { net: 0, tax: 0 };
-      breakdown.set(item.vatPercentage, {
-        net: current.net + net,
-        tax: current.tax + tax
-      });
-    });
-    
-    return Array.from(breakdown.entries()).map(([rate, amounts]) => ({
-      taxPercent: rate,
-      netAmount: amounts.net,
-      taxAmount: amounts.tax
+    // the VAT breakdown (BG-23) the encoders write
+    return computeDocumentTotals(this).vatGroups.map((group) => ({
+      taxPercent: group.rate,
+      netAmount: group.taxableAmount.toNumber(),
+      taxAmount: group.taxAmount.toNumber(),
     }));
   }
 

package/ts/formats/cii/facturx/facturx.encoder.ts

@@ -2,10 +2,8 @@ import { CIIBaseEncoder } from '../cii.encoder.js';
 import type { TAccountingDoc, TCreditNote, TInvoiceDocument } from '../../../interfaces/common.js';
 import { FACTURX_PROFILE_IDS } from './facturx.types.js';
 import { DOMParser, XMLSerializer } from '../../../plugins.js';
-import { Decimal } from '../../utils/decimal.js';
-import { DecimalCurrencyCalculator } from '../../utils/currency.calculator.decimal.js';
-import { getCurrencyMinorUnits } from '../../utils/currency.utils.js';
 import { getDocumentTypeCode } from '../../utils/document.typecode.js';
+import { computeDocumentTotals } from '../../utils/document.totals.js';
 import { getWritableDate, getWritableDueDate } from '../../utils/date.value.js';
 
 /**
@@ -316,6 +314,26 @@ export class FacturXEncoder extends CIIBaseEncoder {
     currencyElement.textContent = invoice.currency;
     settlementElement.appendChild(currencyElement);
 
+    // the EN 16931 totals in decimal arithmetic, rounded as the business rules check them
+    const totals = computeDocumentTotals(invoice);
+
+    // VAT breakdown (BG-23), one per rate, before the payment terms as the CII schema orders them;
+    // the category is the one the lines carry
+    for (const { rate, taxableAmount, taxAmount } of totals.vatGroups) {
+      const taxElement = doc.createElement('ram:ApplicableTradeTax');
+      const appendText = (name: string, text: string) => {
+        const element = doc.createElement(name);
+        element.textContent = text;
+        taxElement.appendChild(element);
+      };
+      appendText('ram:CalculatedAmount', taxAmount.toFixed(totals.minorUnits)); // BT-117
+      appendText('ram:TypeCode', 'VAT');
+      appendText('ram:BasisAmount', taxableAmount.toFixed(totals.minorUnits)); // BT-116
+      appendText('ram:CategoryCode', 'S'); // BT-118
+      appendText('ram:RateApplicablePercent', rate.toString()); // BT-119
+      settlementElement.appendChild(taxElement);
+    }
+
     // Add payment terms
     const paymentTermsElement = doc.createElement('ram:SpecifiedTradePaymentTerms');
 
@@ -333,50 +351,21 @@ export class FacturXEncoder extends CIIBaseEncoder {
 
     settlementElement.appendChild(paymentTermsElement);
 
-    // Add totals
+    // Add totals, in the order of the CII schema
     const monetarySummationElement = doc.createElement('ram:SpecifiedTradeSettlementHeaderMonetarySummation');
-
-    // Calculate totals with decimal arithmetic to avoid floating point drift.
-    const calculator = new DecimalCurrencyCalculator(invoice.currency);
-    const minorUnits = getCurrencyMinorUnits(invoice.currency);
-    let totalNetAmount = Decimal.ZERO;
-    let totalTaxAmount = Decimal.ZERO;
-
-    // Calculate from items
-    if (invoice.items) {
-      for (const item of invoice.items) {
-        const itemNetAmount = calculator.calculateLineNet(item.unitQuantity, item.unitNetPrice);
-        const itemTaxAmount = calculator.calculateVAT(itemNetAmount, item.vatPercentage);
-
-        totalNetAmount = totalNetAmount.add(itemNetAmount);
-        totalTaxAmount = totalTaxAmount.add(itemTaxAmount);
+    const appendAmount = (name: string, value: { toFixed(decimalPlaces: number): string }, withCurrency = false) => {
+      const element = doc.createElement(name);
+      element.textContent = value.toFixed(totals.minorUnits);
+      if (withCurrency) {
+        element.setAttribute('currencyID', invoice.currency);
       }
-    }
-
-    totalNetAmount = calculator.round(totalNetAmount);
-    totalTaxAmount = calculator.round(totalTaxAmount);
-    const totalGrossAmount = calculator.calculateGrossAmount(totalNetAmount, totalTaxAmount);
-
-    // Add line total amount
-    const lineTotalElement = doc.createElement('ram:LineTotalAmount');
-    lineTotalElement.textContent = totalNetAmount.toFixed(minorUnits);
-    monetarySummationElement.appendChild(lineTotalElement);
-
-    // Add tax total amount
-    const taxTotalElement = doc.createElement('ram:TaxTotalAmount');
-    taxTotalElement.textContent = totalTaxAmount.toFixed(minorUnits);
-    taxTotalElement.setAttribute('currencyID', invoice.currency);
-    monetarySummationElement.appendChild(taxTotalElement);
-
-    // Add grand total amount
-    const grandTotalElement = doc.createElement('ram:GrandTotalAmount');
-    grandTotalElement.textContent = totalGrossAmount.toFixed(minorUnits);
-    monetarySummationElement.appendChild(grandTotalElement);
-
-    // Add due payable amount
-    const duePayableElement = doc.createElement('ram:DuePayableAmount');
-    duePayableElement.textContent = totalGrossAmount.toFixed(minorUnits);
-    monetarySummationElement.appendChild(duePayableElement);
+      monetarySummationElement.appendChild(element);
+    };
+    appendAmount('ram:LineTotalAmount', totals.lineTotal); // BT-106
+    appendAmount('ram:TaxBasisTotalAmount', totals.taxBasisTotal); // BT-109
+    appendAmount('ram:TaxTotalAmount', totals.taxTotal, true); // BT-110
+    appendAmount('ram:GrandTotalAmount', totals.grandTotal); // BT-112
+    appendAmount('ram:DuePayableAmount', totals.duePayable); // BT-115
 
     settlementElement.appendChild(monetarySummationElement);
   }
@@ -388,12 +377,12 @@ export class FacturXEncoder extends CIIBaseEncoder {
    * @param invoice Invoice data
    */
   private addLineItems(doc: Document, transactionElement: Element, invoice: TAccountingDoc): void {
-    const calculator = new DecimalCurrencyCalculator(invoice.currency);
-    const minorUnits = getCurrencyMinorUnits(invoice.currency);
+    // the line net amounts of the one EN 16931 totals computation
+    const totals = computeDocumentTotals(invoice);
 
     // Add each line item
     if (invoice.items) {
-      for (const item of invoice.items) {
+      for (const [index, item] of invoice.items.entries()) {
         // Create line item element
         const lineItemElement = doc.createElement('ram:IncludedSupplyChainTradeLineItem');
 
@@ -464,15 +453,12 @@ export class FacturXEncoder extends CIIBaseEncoder {
 
         settlementElement.appendChild(taxElement);
 
-        // Add monetary summation
-        const monetarySummationElement = doc.createElement('ram:SpecifiedLineTradeSettlementMonetarySummation');
-
-        // Calculate item total with decimal arithmetic and currency rounding.
-        const itemNetAmount = calculator.calculateLineNet(item.unitQuantity, item.unitNetPrice);
+        // Line monetary summation, as the CII schema names it
+        const monetarySummationElement = doc.createElement('ram:SpecifiedTradeSettlementLineMonetarySummation');
 
-        // Add line total amount
+        // Invoice line net amount (BT-131): quantity × net price, rounded
         const lineTotalElement = doc.createElement('ram:LineTotalAmount');
-        lineTotalElement.textContent = itemNetAmount.toFixed(minorUnits);
+        lineTotalElement.textContent = totals.lineNetAmounts[index].toFixed(totals.minorUnits);
         monetarySummationElement.appendChild(lineTotalElement);
 
         settlementElement.appendChild(monetarySummationElement);

package/ts/formats/cii/zugferd/zugferd.encoder.ts

@@ -6,6 +6,7 @@ import { DOMParser, XMLSerializer } from '../../../plugins.js';
 import { getDocumentTypeCode } from '../../utils/document.typecode.js';
 import { getWritableDate, getWritableDueDate } from '../../utils/date.value.js';
 import { getPaymentTermsNote } from '../../utils/payment.terms.js';
+import { computeDocumentTotals } from '../../utils/document.totals.js';
 
 /**
  * Encoder for ZUGFeRD invoice format
@@ -456,30 +457,16 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
    * @param invoice Invoice data
    */
   private addTaxDetails(doc: Document, settlementElement: Element, invoice: TAccountingDoc): void {
-    // Calculate tax categories and totals
-    const taxCategories = new Map<number, number>(); // Map of VAT rate to net amount
+    // the EN 16931 totals in decimal arithmetic, rounded as the business rules check them
+    const totals = computeDocumentTotals(invoice);
 
-    // Calculate from items
-    if (invoice.items) {
-      for (const item of invoice.items) {
-        const itemNetAmount = item.unitNetPrice * item.unitQuantity;
-        const vatRate = item.vatPercentage;
-        
-        const currentAmount = taxCategories.get(vatRate) || 0;
-        taxCategories.set(vatRate, currentAmount + itemNetAmount);
-      }
-    }
-
-    // Add each tax category
-    for (const [rate, baseAmount] of taxCategories.entries()) {
+    // VAT breakdown (BG-23), one per rate
+    for (const { rate, taxableAmount, taxAmount } of totals.vatGroups) {
       const taxElement = doc.createElement('ram:ApplicableTradeTax');
-      
-      // Calculate tax amount
-      const taxAmount = baseAmount * (rate / 100);
-      
-      // Add calculated amount
+
+      // VAT category tax amount (BT-117)
       const calculatedAmountElement = doc.createElement('ram:CalculatedAmount');
-      calculatedAmountElement.textContent = taxAmount.toFixed(2);
+      calculatedAmountElement.textContent = taxAmount.toFixed(totals.minorUnits);
       taxElement.appendChild(calculatedAmountElement);
       
       // Add type code (VAT)
@@ -487,9 +474,9 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
       typeCodeElement.textContent = 'VAT';
       taxElement.appendChild(typeCodeElement);
       
-      // Add basis amount
+      // VAT category taxable amount (BT-116)
       const basisAmountElement = doc.createElement('ram:BasisAmount');
-      basisAmountElement.textContent = baseAmount.toFixed(2);
+      basisAmountElement.textContent = taxableAmount.toFixed(totals.minorUnits);
       taxElement.appendChild(basisAmountElement);
       
       // Add category code
@@ -515,43 +502,23 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
   private addMonetarySummation(doc: Document, settlementElement: Element, invoice: TAccountingDoc): void {
     const monetarySummationElement = doc.createElement('ram:SpecifiedTradeSettlementHeaderMonetarySummation');
 
-    // Calculate totals
-    let totalNetAmount = 0;
-    let totalTaxAmount = 0;
-
-    // Calculate from items
-    if (invoice.items) {
-      for (const item of invoice.items) {
-        const itemNetAmount = item.unitNetPrice * item.unitQuantity;
-        const itemTaxAmount = itemNetAmount * (item.vatPercentage / 100);
-
-        totalNetAmount += itemNetAmount;
-        totalTaxAmount += itemTaxAmount;
+    // the EN 16931 totals in decimal arithmetic, rounded as the business rules check them
+    const totals = computeDocumentTotals(invoice);
+    const appendAmount = (name: string, value: { toFixed(decimalPlaces: number): string }, withCurrency = false) => {
+      const element = doc.createElement(name);
+      element.textContent = value.toFixed(totals.minorUnits);
+      if (withCurrency) {
+        element.setAttribute('currencyID', invoice.currency);
       }
-    }
-
-    const totalGrossAmount = totalNetAmount + totalTaxAmount;
+      monetarySummationElement.appendChild(element);
+    };
 
-    // Add line total amount
-    const lineTotalElement = doc.createElement('ram:LineTotalAmount');
-    lineTotalElement.textContent = totalNetAmount.toFixed(2);
-    monetarySummationElement.appendChild(lineTotalElement);
-
-    // Add tax total amount
-    const taxTotalElement = doc.createElement('ram:TaxTotalAmount');
-    taxTotalElement.textContent = totalTaxAmount.toFixed(2);
-    taxTotalElement.setAttribute('currencyID', invoice.currency);
-    monetarySummationElement.appendChild(taxTotalElement);
-
-    // Add grand total amount
-    const grandTotalElement = doc.createElement('ram:GrandTotalAmount');
-    grandTotalElement.textContent = totalGrossAmount.toFixed(2);
-    monetarySummationElement.appendChild(grandTotalElement);
-
-    // Add due payable amount
-    const duePayableElement = doc.createElement('ram:DuePayableAmount');
-    duePayableElement.textContent = totalGrossAmount.toFixed(2);
-    monetarySummationElement.appendChild(duePayableElement);
+    // in the order of the CII schema
+    appendAmount('ram:LineTotalAmount', totals.lineTotal); // BT-106
+    appendAmount('ram:TaxBasisTotalAmount', totals.taxBasisTotal); // BT-109
+    appendAmount('ram:TaxTotalAmount', totals.taxTotal, true); // BT-110
+    appendAmount('ram:GrandTotalAmount', totals.grandTotal); // BT-112
+    appendAmount('ram:DuePayableAmount', totals.duePayable); // BT-115
 
     settlementElement.appendChild(monetarySummationElement);
   }
@@ -565,7 +532,8 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
   private addLineItems(doc: Document, transactionElement: Element, invoice: TAccountingDoc): void {
     // Add each line item
     if (invoice.items) {
-      for (const item of invoice.items) {
+      const totals = computeDocumentTotals(invoice);
+      for (const [index, item] of invoice.items.entries()) {
         // Create line item element
         const lineItemElement = doc.createElement('ram:IncludedSupplyChainTradeLineItem');
 
@@ -636,15 +604,12 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
 
         settlementElement.appendChild(taxElement);
 
-        // Add monetary summation
-        const monetarySummationElement = doc.createElement('ram:SpecifiedLineTradeSettlementMonetarySummation');
-
-        // Calculate item total
-        const itemNetAmount = item.unitNetPrice * item.unitQuantity;
+        // Line monetary summation, as the CII schema names it
+        const monetarySummationElement = doc.createElement('ram:SpecifiedTradeSettlementLineMonetarySummation');
 
-        // Add line total amount
+        // Invoice line net amount (BT-131): quantity × net price, rounded
         const lineTotalElement = doc.createElement('ram:LineTotalAmount');
-        lineTotalElement.textContent = itemNetAmount.toFixed(2);
+        lineTotalElement.textContent = totals.lineNetAmounts[index].toFixed(totals.minorUnits);
         monetarySummationElement.appendChild(lineTotalElement);
 
         settlementElement.appendChild(monetarySummationElement);

package/ts/formats/semantic/semantic.validator.ts

@@ -3,6 +3,7 @@
  * Validates invoices against EN16931 Business Terms and Business Groups
  */
 
+import { findInvalidItemAmounts, getTotalsSkippedResult } from '../utils/document.totals.js';
 import type { ValidationResult } from '../validation/validation.types.js';
 import type { EN16931SemanticModel, BusinessTerms, BusinessGroups } from './bt-bg.model.js';
 import type { EInvoice } from '../../einvoice.js';
@@ -36,6 +37,25 @@ export class SemanticModelValidator {
    */
   public validate(invoice: EInvoice): ValidationResult[] {
     const results: ValidationResult[] = [];
+
+    // The semantic model carries the totals, which are computed from the line amounts; while
+    // one is no number the model cannot be built, so each such line is reported (BR-24 for the
+    // net amount, BR-CO-04 for the VAT rate) and the model rules are skipped
+    const invalidAmounts = findInvalidItemAmounts(invoice.items);
+    if (invalidAmounts.length > 0) {
+      for (const entry of invalidAmounts) {
+        results.push({
+          ruleId: entry.field === 'vatPercentage' ? 'BR-CO-04' : 'BR-24',
+          source: 'SEMANTIC',
+          severity: 'error',
+          message: `Invoice line ${entry.index + 1}: ${entry.field} is no number`,
+          field: `items[${entry.index}].${entry.field}`,
+          value: entry.value,
+        });
+      }
+      results.push(getTotalsSkippedResult(invalidAmounts, 'SEMANTIC'));
+      return results;
+    }
     
     // Convert to semantic model
     const model = this.adapter.toSemanticModel(invoice);

package/ts/formats/ubl/generic/ubl.encoder.ts

@@ -6,6 +6,7 @@ import { getDocumentTypeCode } from '../../utils/document.typecode.js';
 import { getPrecedingInvoiceReferences } from '../../utils/preceding.invoice.js';
 import { getWritableDueDate } from '../../utils/date.value.js';
 import { getPaymentTermsNote } from '../../utils/payment.terms.js';
+import { computeDocumentTotals } from '../../utils/document.totals.js';
 
 /**
  * UBL Encoder implementation
@@ -383,48 +384,31 @@ export class UBLEncoder extends UBLBaseEncoder {
   private addTaxTotal(doc: Document, parentElement: Element, invoice: TAccountingDoc): void {
     const taxTotalNode = doc.createElement('cac:TaxTotal');
     parentElement.appendChild(taxTotalNode);
-    
-    // Calculate total tax amount
-    let totalTaxAmount = 0;
-    const taxCategories = new Map<number, number>(); // Map of VAT rate to net amount
-    
-    // Calculate from items
-    if (invoice.items) {
-      for (const item of invoice.items) {
-        const itemNetAmount = item.unitNetPrice * item.unitQuantity;
-        const itemTaxAmount = itemNetAmount * (item.vatPercentage / 100);
-        const vatRate = item.vatPercentage;
-        
-        totalTaxAmount += itemTaxAmount;
-        
-        // Aggregate by VAT rate
-        const currentAmount = taxCategories.get(vatRate) || 0;
-        taxCategories.set(vatRate, currentAmount + itemNetAmount);
-      }
-    }
-    
-    // Add total tax amount
+
+    // the EN 16931 totals in decimal arithmetic, rounded as the business rules check them
+    const totals = computeDocumentTotals(invoice);
+
+    // Invoice total VAT amount (BT-110)
     const taxAmountElement = doc.createElement('cbc:TaxAmount');
     taxAmountElement.setAttribute('currencyID', invoice.currency);
-    taxAmountElement.textContent = totalTaxAmount.toFixed(2);
+    taxAmountElement.textContent = totals.taxTotal.toFixed(totals.minorUnits);
     taxTotalNode.appendChild(taxAmountElement);
-    
-    // Add tax subtotals
-    for (const [rate, baseAmount] of taxCategories.entries()) {
+
+    // VAT breakdown (BG-23), one subtotal per rate
+    for (const { rate, taxableAmount, taxAmount } of totals.vatGroups) {
       const taxSubtotalNode = doc.createElement('cac:TaxSubtotal');
       taxTotalNode.appendChild(taxSubtotalNode);
-      
-      // Taxable amount
+
+      // VAT category taxable amount (BT-116)
       const taxableAmountElement = doc.createElement('cbc:TaxableAmount');
       taxableAmountElement.setAttribute('currencyID', invoice.currency);
-      taxableAmountElement.textContent = baseAmount.toFixed(2);
+      taxableAmountElement.textContent = taxableAmount.toFixed(totals.minorUnits);
       taxSubtotalNode.appendChild(taxableAmountElement);
-      
-      // Tax amount
-      const taxAmount = baseAmount * (rate / 100);
+
+      // VAT category tax amount (BT-117)
       const subtotalTaxAmountElement = doc.createElement('cbc:TaxAmount');
       subtotalTaxAmountElement.setAttribute('currencyID', invoice.currency);
-      subtotalTaxAmountElement.textContent = taxAmount.toFixed(2);
+      subtotalTaxAmountElement.textContent = taxAmount.toFixed(totals.minorUnits);
       taxSubtotalNode.appendChild(subtotalTaxAmountElement);
       
       // Tax category
@@ -460,46 +444,33 @@ export class UBLEncoder extends UBLBaseEncoder {
   private addLegalMonetaryTotal(doc: Document, parentElement: Element, invoice: TAccountingDoc): void {
     const legalMonetaryTotalNode = doc.createElement('cac:LegalMonetaryTotal');
     parentElement.appendChild(legalMonetaryTotalNode);
-    
-    // Calculate totals
-    let totalNetAmount = 0;
-    let totalTaxAmount = 0;
-    
-    // Calculate from items
-    if (invoice.items) {
-      for (const item of invoice.items) {
-        const itemNetAmount = item.unitNetPrice * item.unitQuantity;
-        const itemTaxAmount = itemNetAmount * (item.vatPercentage / 100);
-        
-        totalNetAmount += itemNetAmount;
-        totalTaxAmount += itemTaxAmount;
-      }
-    }
-    
-    const totalGrossAmount = totalNetAmount + totalTaxAmount;
+
+    // the EN 16931 totals in decimal arithmetic, rounded as the business rules check them
+    const totals = computeDocumentTotals(invoice);
+    const amount = (value: { toFixed(decimalPlaces: number): string }) => value.toFixed(totals.minorUnits);
     
     // Line extension amount (sum of line net amounts)
     const lineExtensionAmountElement = doc.createElement('cbc:LineExtensionAmount');
     lineExtensionAmountElement.setAttribute('currencyID', invoice.currency);
-    lineExtensionAmountElement.textContent = totalNetAmount.toFixed(2);
+    lineExtensionAmountElement.textContent = amount(totals.lineTotal);
     legalMonetaryTotalNode.appendChild(lineExtensionAmountElement);
     
     // Tax exclusive amount
     const taxExclusiveAmountElement = doc.createElement('cbc:TaxExclusiveAmount');
     taxExclusiveAmountElement.setAttribute('currencyID', invoice.currency);
-    taxExclusiveAmountElement.textContent = totalNetAmount.toFixed(2);
+    taxExclusiveAmountElement.textContent = amount(totals.taxBasisTotal);
     legalMonetaryTotalNode.appendChild(taxExclusiveAmountElement);
     
     // Tax inclusive amount
     const taxInclusiveAmountElement = doc.createElement('cbc:TaxInclusiveAmount');
     taxInclusiveAmountElement.setAttribute('currencyID', invoice.currency);
-    taxInclusiveAmountElement.textContent = totalGrossAmount.toFixed(2);
+    taxInclusiveAmountElement.textContent = amount(totals.grandTotal);
     legalMonetaryTotalNode.appendChild(taxInclusiveAmountElement);
     
     // Payable amount
     const payableAmountElement = doc.createElement('cbc:PayableAmount');
     payableAmountElement.setAttribute('currencyID', invoice.currency);
-    payableAmountElement.textContent = totalGrossAmount.toFixed(2);
+    payableAmountElement.textContent = amount(totals.duePayable);
     legalMonetaryTotalNode.appendChild(payableAmountElement);
   }
   
@@ -512,8 +483,9 @@ export class UBLEncoder extends UBLBaseEncoder {
   private addInvoiceLines(doc: Document, parentElement: Element, invoice: TAccountingDoc, documentType: UBLDocumentType = UBLDocumentType.INVOICE): void {
     if (!invoice.items) return;
     const creditNote = documentType === UBLDocumentType.CREDIT_NOTE;
+    const totals = computeDocumentTotals(invoice);
     
-    for (const item of invoice.items) {
+    for (const [index, item] of invoice.items.entries()) {
       const invoiceLineNode = doc.createElement(creditNote ? 'cac:CreditNoteLine' : 'cac:InvoiceLine');
       parentElement.appendChild(invoiceLineNode);
       
@@ -529,11 +501,10 @@ export class UBLEncoder extends UBLBaseEncoder {
       quantityElement.textContent = item.unitQuantity.toString();
       invoiceLineNode.appendChild(quantityElement);
       
-      // Line extension amount (line net amount)
-      const itemNetAmount = item.unitNetPrice * item.unitQuantity;
+      // Invoice line net amount (BT-131): quantity × net price, rounded
       const lineExtensionAmountElement = doc.createElement('cbc:LineExtensionAmount');
       lineExtensionAmountElement.setAttribute('currencyID', invoice.currency);
-      lineExtensionAmountElement.textContent = itemNetAmount.toFixed(2);
+      lineExtensionAmountElement.textContent = totals.lineNetAmounts[index].toFixed(totals.minorUnits);
       invoiceLineNode.appendChild(lineExtensionAmountElement);
       
       // Item information

package/ts/formats/utils/currency.calculator.decimal.ts

@@ -15,12 +15,20 @@ export class DecimalCurrencyCalculator {
   private readonly minorUnits: number;
   private readonly roundingMode: RoundingMode;
   
+  /**
+   * @param currency The currency, whose minor unit sets the rounding scale
+   * @param roundingMode How values are rounded
+   * @param options.maxDecimals The most decimals an amount may have, when fewer than the
+   *   currency's minor unit (EN 16931 allows two, BR-DEC-*)
+   */
   constructor(
     currency: TCurrency,
-    roundingMode: RoundingMode = 'HALF_UP'
+    roundingMode: RoundingMode = 'HALF_UP',
+    options: { maxDecimals?: number } = {}
   ) {
     this.currency = currency;
-    this.minorUnits = getCurrencyMinorUnits(currency);
+    const minorUnits = getCurrencyMinorUnits(currency);
+    this.minorUnits = options.maxDecimals === undefined ? minorUnits : Math.min(minorUnits, options.maxDecimals);
     this.roundingMode = roundingMode;
   }