@fin.cx/einvoice 8.2.0 → 8.2.2

package/ts/formats/cii/cii.decoder.ts

@@ -127,6 +127,37 @@ export abstract class CIIBaseDecoder extends BaseDecoder {
     return references;
   }
 
+  /**
+   * Reads the invoice issue date (BT-2); a missing or invalid one is refused
+   * with an `EInvoiceParsingError`, as no other date can stand in for it.
+   */
+  protected extractIssueDate(): number {
+    const issueDatePath = '/rsm:CrossIndustryInvoice/rsm:ExchangedDocument/ram:IssueDateTime/udt:DateTimeString';
+    return this.parseRequiredCIIDate(this.getText(issueDatePath), this.getText(`${issueDatePath}/@format`).trim());
+  }
+
+  /**
+   * Reads the payment due date (BT-9) of the header payment terms; undefined
+   * when the document states none.
+   */
+  protected extractDueDate(): number | undefined {
+    const dueDatePath =
+      '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:SpecifiedTradePaymentTerms/ram:DueDateDateTime/udt:DateTimeString';
+    const dueDate = this.getText(dueDatePath).trim();
+    if (!dueDate) {
+      return undefined;
+    }
+    return this.parseRequiredCIIDate(dueDate, this.getText(`${dueDatePath}/@format`).trim());
+  }
+
+  /**
+   * The payment term in days from the issue date to the stated due date, or
+   * `absentDueInDays` when the document states no due date.
+   */
+  protected dueInDaysOf(issueDate: number, dueDate: number | undefined, absentDueInDays: number): number {
+    return dueDate === undefined ? absentDueInDays : Math.round((dueDate - issueDate) / (1000 * 60 * 60 * 24));
+  }
+
   /**
    * Reads the actual delivery date (BT-72) of the header delivery; undefined
    * when the document does not state one.

package/ts/formats/cii/facturx/facturx.decoder.ts

@@ -67,10 +67,8 @@ export class FacturXDecoder extends CIIBaseDecoder {
     const items = this.extractItems();
 
     // Extract due date
-    const dueDateStr = this.getText('//ram:SpecifiedTradePaymentTerms/ram:DueDateDateTime/udt:DateTimeString');
-    const dueDateFormat = this.getText('//ram:SpecifiedTradePaymentTerms/ram:DueDateDateTime/udt:DateTimeString/@format');
-    const dueDate = dueDateStr ? this.parseCIIDate(dueDateStr, dueDateFormat) : issueDate;
-    const dueInDays = Math.round((dueDate - issueDate) / (1000 * 60 * 60 * 24));
+    // no due date stated: `dueInDays` cannot express it yet (required field in @tsclass/tsclass); value unchanged: 0 days
+    const dueInDays = this.dueInDaysOf(issueDate, this.extractDueDate(), 0);
 
     // Extract currency
     const currencyCode = this.getText('//ram:InvoiceCurrencyCode') || 'EUR';

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

@@ -2,11 +2,9 @@ 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 { getWritableDate } from '../../utils/date.value.js';
+import { computeDocumentTotals } from '../../utils/document.totals.js';
+import { getWritableDate, getWritableDueDate } from '../../utils/date.value.js';
 
 /**
  * Encoder for Factur-X invoice format
@@ -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');
 
@@ -325,8 +343,7 @@ export class FacturXEncoder extends CIIBaseEncoder {
     dateStringElement.setAttribute('format', '102'); // YYYYMMDD format
 
     // Calculate due date
-    const dueDate = new Date(invoice.date);
-    dueDate.setDate(dueDate.getDate() + invoice.dueInDays);
+    const dueDate = getWritableDueDate(invoice.date, invoice.dueInDays, 'cii');
 
     dateStringElement.textContent = this.formatDateYYYYMMDD(dueDate.getTime(), 'BT-9 payment due date');
     dueDateElement.appendChild(dateStringElement);
@@ -334,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);
   }
@@ -389,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');
 
@@ -465,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);
@@ -493,9 +478,10 @@ export class FacturXEncoder extends CIIBaseEncoder {
    */
   private formatDateYYYYMMDD(timestamp: number, field: string): string {
     const date = getWritableDate(timestamp, field, 'cii');
-    const year = date.getFullYear();
-    const month = (date.getMonth() + 1).toString().padStart(2, '0');
-    const day = date.getDate().toString().padStart(2, '0');
+    // the UTC fields: a calendar day is its UTC midnight, whatever the server's zone
+    const year = date.getUTCFullYear();
+    const month = (date.getUTCMonth() + 1).toString().padStart(2, '0');
+    const day = date.getUTCDate().toString().padStart(2, '0');
     return `${year}${month}${day}`;
   }
 }

package/ts/formats/cii/zugferd/zugferd.decoder.ts

@@ -44,9 +44,7 @@ export class ZUGFeRDDecoder extends CIIBaseDecoder {
     const invoiceId = this.getText('//rsm:ExchangedDocument/ram:ID');
 
     // Extract issue date
-    const issueDateStr = this.getText('//ram:IssueDateTime/udt:DateTimeString');
-    const issueDateFormat = this.getText('//ram:IssueDateTime/udt:DateTimeString/@format');
-    const issueDate = this.parseCIIDate(issueDateStr, issueDateFormat);
+    const issueDate = this.extractIssueDate();
 
     // Extract seller information
     const seller = this.extractParty('//ram:SellerTradeParty');
@@ -58,9 +56,8 @@ export class ZUGFeRDDecoder extends CIIBaseDecoder {
     const items = this.extractItems();
 
     // Extract due date
-    const dueDateStr = this.getText('//ram:SpecifiedTradePaymentTerms/ram:DueDateDateTime/udt:DateTimeString');
-    const dueDate = dueDateStr ? new Date(dueDateStr).getTime() : Date.now();
-    const dueInDays = Math.round((dueDate - issueDate) / (1000 * 60 * 60 * 24));
+    // no due date stated: `dueInDays` cannot express it yet (required field in @tsclass/tsclass); value unchanged: the days from the issue date to the moment of decoding
+    const dueInDays = this.dueInDaysOf(issueDate, this.extractDueDate(), Math.round((Date.now() - issueDate) / (1000 * 60 * 60 * 24)));
 
     // Extract currency
     const currencyCode = this.getText('//ram:InvoiceCurrencyCode') || 'EUR';

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

@@ -4,7 +4,9 @@ import { ZUGFERD_PROFILE_IDS } from './zugferd.types.js';
 import { CIIProfile } from '../cii.types.js';
 import { DOMParser, XMLSerializer } from '../../../plugins.js';
 import { getDocumentTypeCode } from '../../utils/document.typecode.js';
-import { getWritableDate } from '../../utils/date.value.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
@@ -382,7 +384,10 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
     if (invoice.paymentOptions) {
       // Add payment instructions as description - this is generic enough to work with any payment type
       const descriptionElement = doc.createElement('ram:Description');
-      descriptionElement.textContent = `Due in ${invoice.dueInDays} days. ${invoice.paymentOptions.description || ''}`;
+      descriptionElement.textContent = [
+        getPaymentTermsNote(invoice.date, invoice.dueInDays, invoice.language, 'cii'),
+        invoice.paymentOptions.description,
+      ].filter(Boolean).join('. ');
       paymentTermsElement.appendChild(descriptionElement);
     }
 
@@ -392,8 +397,7 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
     dateStringElement.setAttribute('format', '102'); // YYYYMMDD format
 
     // Calculate due date
-    const dueDate = new Date(invoice.date);
-    dueDate.setDate(dueDate.getDate() + invoice.dueInDays);
+    const dueDate = getWritableDueDate(invoice.date, invoice.dueInDays, 'cii');
 
     dateStringElement.textContent = this.formatDateYYYYMMDD(dueDate.getTime(), 'BT-9 payment due date');
     dueDateElement.appendChild(dateStringElement);
@@ -453,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)
@@ -484,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
@@ -512,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);
   }
@@ -562,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');
 
@@ -633,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);
@@ -661,9 +629,10 @@ export class ZUGFeRDEncoder extends CIIBaseEncoder {
    */
   private formatDateYYYYMMDD(timestamp: number, field: string): string {
     const date = getWritableDate(timestamp, field, 'cii');
-    const year = date.getFullYear();
-    const month = (date.getMonth() + 1).toString().padStart(2, '0');
-    const day = date.getDate().toString().padStart(2, '0');
+    // the UTC fields: a calendar day is its UTC midnight, whatever the server's zone
+    const year = date.getUTCFullYear();
+    const month = (date.getUTCMonth() + 1).toString().padStart(2, '0');
+    const day = date.getUTCDate().toString().padStart(2, '0');
     return `${year}${month}${day}`;
   }
 }

package/ts/formats/cii/zugferd/zugferd.v1.decoder.ts

@@ -35,6 +35,31 @@ export class ZUGFeRDV1Decoder extends CIIBaseDecoder {
     };
   }
 
+  /**
+   * Reads the issue date of the v1 header (`rsm:HeaderExchangedDocument`); a
+   * missing or invalid one is refused with an `EInvoiceParsingError`.
+   */
+  protected override extractIssueDate(): number {
+    const issueDatePath = '/rsm:CrossIndustryDocument/rsm:HeaderExchangedDocument/ram:IssueDateTime/udt:DateTimeString';
+    return this.parseRequiredCIIDate(this.v1Text(issueDatePath), this.v1Text(`${issueDatePath}/@format`));
+  }
+
+  /**
+   * Reads the payment due date of the v1 header payment terms; undefined when
+   * the document states none.
+   */
+  protected override extractDueDate(): number | undefined {
+    const dueDatePath =
+      '/rsm:CrossIndustryDocument/rsm:SpecifiedSupplyChainTradeTransaction/ram:ApplicableSupplyChainTradeSettlement/ram:SpecifiedTradePaymentTerms/ram:DueDateDateTime/udt:DateTimeString';
+    const dueDate = this.v1Text(dueDatePath);
+    return dueDate ? this.parseRequiredCIIDate(dueDate, this.v1Text(`${dueDatePath}/@format`)) : undefined;
+  }
+
+  /** The trimmed text of the first node a v1 path selects, or '' */
+  private v1Text(path: string): string {
+    return String(zugferdV1Select(`string(${path})`, this.doc)).trim();
+  }
+
   /**
    * Reads the actual delivery date of the v1 header delivery
    * (`ram:ApplicableSupplyChainTradeDelivery`); undefined when the document
@@ -82,9 +107,7 @@ export class ZUGFeRDV1Decoder extends CIIBaseDecoder {
     const invoiceId = this.getText('//ram:ID');
 
     // Extract issue date
-    const issueDateStr = this.getText('//ram:IssueDateTime/udt:DateTimeString');
-    const issueDateFormat = this.getText('//ram:IssueDateTime/udt:DateTimeString/@format');
-    const issueDate = this.parseCIIDate(issueDateStr, issueDateFormat);
+    const issueDate = this.extractIssueDate();
 
     // Extract seller information
     const seller = this.extractParty('//ram:SellerTradeParty');
@@ -96,9 +119,8 @@ export class ZUGFeRDV1Decoder extends CIIBaseDecoder {
     const items = this.extractItems();
 
     // Extract due date
-    const dueDateStr = this.getText('//ram:SpecifiedTradePaymentTerms/ram:DueDateDateTime/udt:DateTimeString');
-    const dueDate = dueDateStr ? new Date(dueDateStr).getTime() : Date.now();
-    const dueInDays = Math.round((dueDate - issueDate) / (1000 * 60 * 60 * 24));
+    // no due date stated: `dueInDays` cannot express it yet (required field in @tsclass/tsclass); value unchanged: 0 days, what this decoder returned before it read the v1 dates
+    const dueInDays = this.dueInDaysOf(issueDate, this.extractDueDate(), 0);
 
     // Extract currency
     const currencyCode = this.getText('//ram:InvoiceCurrencyCode') || 'EUR';

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