@fin.cx/einvoice 8.1.0 → 8.2.0

package/dist_ts/formats/utils/preceding.invoice.js

@@ -0,0 +1,52 @@
+/**
+ * The preceding invoice references (BG-3) an encoder writes for a document,
+ * taken only from what the document states:
+ * - a corrected invoice: the invoice it corrects (`correctedInvoice`);
+ * - a corrected invoice or a credit note: every related document with the
+ *   relation `'corrects'`.
+ * Other documents and other relations write none.
+ */
+export const getPrecedingInvoiceReferences = (accountingDoc) => {
+    const references = [];
+    if (accountingDoc.accountingDocType === 'corrected-invoice' && accountingDoc.correctedInvoice) {
+        references.push(accountingDoc.correctedInvoice);
+    }
+    if (accountingDoc.accountingDocType === 'corrected-invoice' ||
+        accountingDoc.accountingDocType === 'creditnote') {
+        for (const relatedDocument of accountingDoc.relatedDocuments ?? []) {
+            if (relatedDocument.relationType === 'corrects') {
+                references.push(relatedDocument.issueDate === undefined
+                    ? { documentId: relatedDocument.documentId }
+                    : { documentId: relatedDocument.documentId, issueDate: relatedDocument.issueDate });
+            }
+        }
+    }
+    return references;
+};
+/**
+ * The envelope fields for the preceding invoice references a decoder read, the
+ * inverse of {@link getPrecedingInvoiceReferences}: on a corrected invoice the
+ * first reference is the invoice it corrects and further ones are related
+ * documents it corrects; on a credit note every reference is a related
+ * document it corrects. Other documents keep no reference, as before.
+ */
+export const getPrecedingInvoiceFields = (accountingDocType, references) => {
+    const asRelated = (reference) => ({
+        relationType: 'corrects',
+        ...reference,
+    });
+    if (references.length === 0) {
+        return {};
+    }
+    if (accountingDocType === 'corrected-invoice') {
+        const [correctedInvoice, ...furtherReferences] = references;
+        return furtherReferences.length === 0
+            ? { correctedInvoice }
+            : { correctedInvoice, relatedDocuments: furtherReferences.map(asRelated) };
+    }
+    if (accountingDocType === 'creditnote') {
+        return { relatedDocuments: references.map(asRelated) };
+    }
+    return {};
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJlY2VkaW5nLmludm9pY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9mb3JtYXRzL3V0aWxzL3ByZWNlZGluZy5pbnZvaWNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWFBOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsTUFBTSw2QkFBNkIsR0FBRyxDQUMzQyxhQUE2QixFQUNDLEVBQUU7SUFDaEMsTUFBTSxVQUFVLEdBQWlDLEVBQUUsQ0FBQztJQUNwRCxJQUFJLGFBQWEsQ0FBQyxpQkFBaUIsS0FBSyxtQkFBbUIsSUFBSSxhQUFhLENBQUMsZ0JBQWdCLEVBQUUsQ0FBQztRQUM5RixVQUFVLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxnQkFBZ0IsQ0FBQyxDQUFDO0lBQ2xELENBQUM7SUFDRCxJQUNFLGFBQWEsQ0FBQyxpQkFBaUIsS0FBSyxtQkFBbUI7UUFDdkQsYUFBYSxDQUFDLGlCQUFpQixLQUFLLFlBQVksRUFDaEQsQ0FBQztRQUNELEtBQUssTUFBTSxlQUFlLElBQUksYUFBYSxDQUFDLGdCQUFnQixJQUFJLEVBQUUsRUFBRSxDQUFDO1lBQ25FLElBQUksZUFBZSxDQUFDLFlBQVksS0FBSyxVQUFVLEVBQUUsQ0FBQztnQkFDaEQsVUFBVSxDQUFDLElBQUksQ0FDYixlQUFlLENBQUMsU0FBUyxLQUFLLFNBQVM7b0JBQ3JDLENBQUMsQ0FBQyxFQUFFLFVBQVUsRUFBRSxlQUFlLENBQUMsVUFBVSxFQUFFO29CQUM1QyxDQUFDLENBQUMsRUFBRSxVQUFVLEVBQUUsZUFBZSxDQUFDLFVBQVUsRUFBRSxTQUFTLEVBQUUsZUFBZSxDQUFDLFNBQVMsRUFBRSxDQUNyRixDQUFDO1lBQ0osQ0FBQztRQUNILENBQUM7SUFDSCxDQUFDO0lBQ0QsT0FBTyxVQUFVLENBQUM7QUFDcEIsQ0FBQyxDQUFDO0FBRUY7Ozs7OztHQU1HO0FBQ0gsTUFBTSxDQUFDLE1BQU0seUJBQXlCLEdBQUcsQ0FDdkMsaUJBQXFDLEVBQ3JDLFVBQXdDLEVBQ2tELEVBQUU7SUFDNUYsTUFBTSxTQUFTLEdBQUcsQ0FBQyxTQUFxQyxFQUFvQixFQUFFLENBQUMsQ0FBQztRQUM5RSxZQUFZLEVBQUUsVUFBVTtRQUN4QixHQUFHLFNBQVM7S0FDYixDQUFDLENBQUM7SUFDSCxJQUFJLFVBQVUsQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDNUIsT0FBTyxFQUFFLENBQUM7SUFDWixDQUFDO0lBQ0QsSUFBSSxpQkFBaUIsS0FBSyxtQkFBbUIsRUFBRSxDQUFDO1FBQzlDLE1BQU0sQ0FBQyxnQkFBZ0IsRUFBRSxHQUFHLGlCQUFpQixDQUFDLEdBQUcsVUFBVSxDQUFDO1FBQzVELE9BQU8saUJBQWlCLENBQUMsTUFBTSxLQUFLLENBQUM7WUFDbkMsQ0FBQyxDQUFDLEVBQUUsZ0JBQWdCLEVBQUU7WUFDdEIsQ0FBQyxDQUFDLEVBQUUsZ0JBQWdCLEVBQUUsZ0JBQWdCLEVBQUUsaUJBQWlCLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUM7SUFDL0UsQ0FBQztJQUNELElBQUksaUJBQWlCLEtBQUssWUFBWSxFQUFFLENBQUM7UUFDdkMsT0FBTyxFQUFFLGdCQUFnQixFQUFFLFVBQVUsQ0FBQyxHQUFHLENBQUMsU0FBUyxDQUFDLEVBQUUsQ0FBQztJQUN6RCxDQUFDO0lBQ0QsT0FBTyxFQUFFLENBQUM7QUFDWixDQUFDLENBQUMifQ==

package/dist_ts/index.d.ts

@@ -27,7 +27,7 @@ import { ZUGFeRDDecoder } from './formats/cii/zugferd/zugferd.decoder.js';
 import { ZUGFeRDEncoder } from './formats/cii/zugferd/zugferd.encoder.js';
 import { ZUGFeRDValidator } from './formats/cii/zugferd/zugferd.validator.js';
 import { ZUGFeRDV1Decoder } from './formats/cii/zugferd/zugferd.v1.decoder.js';
-export type { TInvoice, TCreditNote, TDebitNote, TSelfBilledInvoice, TAccountingDoc, TAccountingDocType, TAccountingDocEnvelope, TInvoiceDocument, TContact, TLetterEnvelope, TDocumentEnvelope, IPdf, ValidationError, ValidationResult, IValidator, ExportFormat, EInvoiceOptions } from './interfaces/common.js';
+export type { TInvoice, TCorrectedInvoice, TCorrectedInvoiceReference, TInvoiceCorrection, TCreditNote, TDebitNote, TSelfBilledInvoice, TAccountingDoc, TAccountingDocType, TAccountingDocEnvelope, TInvoiceDocument, TContact, TLetterEnvelope, TDocumentEnvelope, IPdf, ValidationError, ValidationResult, IValidator, ExportFormat, EInvoiceOptions } from './interfaces/common.js';
 export { ValidationLevel, InvoiceFormat } from './interfaces/common.js';
 export { common as interfaces };
 export { EInvoice };

package/dist_ts/index.js

@@ -98,4 +98,4 @@ export function validateXml(xml, level = common.ValidationLevel.SYNTAX) {
 export function createEInvoice() {
     return new EInvoice();
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxvQkFBb0I7QUFDcEIsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUV6QyxvQkFBb0I7QUFDcEIsT0FBTyxLQUFLLE1BQU0sTUFBTSx3QkFBd0IsQ0FBQztBQUVqRCxtQkFBbUI7QUFDbkIsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLHdDQUF3QyxDQUFDO0FBQ3hFLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSx3Q0FBd0MsQ0FBQztBQUN4RSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwwQ0FBMEMsQ0FBQztBQUU1RSxzQkFBc0I7QUFDdEIsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQzdELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUM3RCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFFakUsMEJBQTBCO0FBQzFCLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDOUQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFbEUsMEJBQTBCO0FBQzFCLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDOUQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFbEUsdUJBQXVCO0FBQ3ZCLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUM1RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDOUQsT0FBTyxFQUNMLGdCQUFnQixF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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxvQkFBb0I7QUFDcEIsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUV6QyxvQkFBb0I7QUFDcEIsT0FBTyxLQUFLLE1BQU0sTUFBTSx3QkFBd0IsQ0FBQztBQUVqRCxtQkFBbUI7QUFDbkIsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLHdDQUF3QyxDQUFDO0FBQ3hFLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSx3Q0FBd0MsQ0FBQztBQUN4RSxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSwwQ0FBMEMsQ0FBQztBQUU1RSxzQkFBc0I7QUFDdEIsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQzdELE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUM3RCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFFakUsMEJBQTBCO0FBQzFCLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDOUQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFbEUsMEJBQTBCO0FBQzFCLE9BQU8sRUFBRSxjQUFjLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDOUQsT0FBTyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFFbEUsdUJBQXVCO0FBQ3ZCLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUM1RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDOUQsT0FBTyxFQUNMLGdCQUFnQixF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

package/dist_ts/interfaces/common.d.ts

@@ -72,8 +72,12 @@ export interface IPdf {
     };
     buffer: Uint8Array;
 }
-import type { TInvoice, TDebitNote, TSelfBilledInvoice } from '@tsclass/tsclass/dist_ts/finance/index.js';
+import type { TInvoice, TCorrectedInvoice, TDebitNote, TSelfBilledInvoice } from '@tsclass/tsclass/dist_ts/finance/index.js';
 export type { TInvoice } from '@tsclass/tsclass/dist_ts/finance/index.js';
+export type { TCorrectedInvoice } from '@tsclass/tsclass/dist_ts/finance/index.js';
+export type { TCorrectedInvoiceReference } from '@tsclass/tsclass/dist_ts/finance/index.js';
+export type { TInvoiceCorrection } from '@tsclass/tsclass/dist_ts/finance/index.js';
+export type { TRelatedDocument } from '@tsclass/tsclass/dist_ts/finance/index.js';
 export type { TCreditNote } from '@tsclass/tsclass/dist_ts/finance/index.js';
 export type { TDebitNote } from '@tsclass/tsclass/dist_ts/finance/index.js';
 export type { TSelfBilledInvoice } from '@tsclass/tsclass/dist_ts/finance/index.js';
@@ -85,7 +89,7 @@ export type { TAccountingDocEnvelope } from '@tsclass/tsclass/dist_ts/finance/in
  * `Invoice` root and the CII type codes of the invoice family. Only a credit
  * note has a document shape of its own.
  */
-export type TInvoiceDocument = TInvoice | TDebitNote | TSelfBilledInvoice;
+export type TInvoiceDocument = TInvoice | TCorrectedInvoice | TDebitNote | TSelfBilledInvoice;
 export type { TContact } from '@tsclass/tsclass/dist_ts/business/index.js';
 export type { TLetterEnvelope } from '@tsclass/tsclass/dist_ts/business/index.js';
 export type { TDocumentEnvelope } from '@tsclass/tsclass/dist_ts/business/index.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fin.cx/einvoice",
-  "version": "8.1.0",
+  "version": "8.2.0",
   "private": false,
   "description": "A TypeScript module for creating, manipulating, and embedding XML data within PDF files specifically tailored for electronic invoice (einvoice) packages.",
   "main": "dist_ts/index.js",
@@ -22,7 +22,7 @@
   },
   "dependencies": {
     "@push.rocks/smartxml": "^2.1.0",
-    "@tsclass/tsclass": "^9.5.0",
+    "@tsclass/tsclass": "^9.8.0",
     "@xmldom/xmldom": "^0.9.10",
     "pako": "^2.1.0",
     "pdf-lib": "^1.17.1",
@@ -67,7 +67,7 @@
   ],
   "scripts": {
     "test": "pnpm run test:unit",
-    "test:unit": "tstest test/test.cii-xrechnung.node.ts --verbose --logfile --timeout 60 && tstest test/test.einvoice.ts --verbose --logfile --timeout 60 && tstest test/test.decimal.ts --verbose --logfile --timeout 60 && tstest test/test.decimal-currency-calculator.ts --verbose --logfile --timeout 60 && tstest test/test.currency-utils.ts --verbose --logfile --timeout 60 && tstest test/test.en16931-validators.ts --verbose --logfile --timeout 60 && tstest test/test.schematron-validator.ts --verbose --logfile --timeout 60 && tstest test/test.xrechnung-creditnote.node.ts --verbose --logfile --timeout 60 && tstest test/test.accountingdoc-types.node.ts --verbose --logfile --timeout 60 && tstest test/test.en16931-unitcodes.node.ts --verbose --logfile --timeout 60 && tstest test/test.en16931-lineunit.node.ts --verbose --logfile --timeout 60",
+    "test:unit": "tstest test/test.cii-xrechnung.node.ts --verbose --logfile --timeout 60 && tstest test/test.einvoice.ts --verbose --logfile --timeout 60 && tstest test/test.decimal.ts --verbose --logfile --timeout 60 && tstest test/test.decimal-currency-calculator.ts --verbose --logfile --timeout 60 && tstest test/test.currency-utils.ts --verbose --logfile --timeout 60 && tstest test/test.en16931-validators.ts --verbose --logfile --timeout 60 && tstest test/test.schematron-validator.ts --verbose --logfile --timeout 60 && tstest test/test.xrechnung-creditnote.node.ts --verbose --logfile --timeout 60 && tstest test/test.accountingdoc-types.node.ts --verbose --logfile --timeout 60 && tstest test/test.corrected-invoice.node.ts --verbose --logfile --timeout 60 && tstest test/test.en16931-unitcodes.node.ts --verbose --logfile --timeout 60 && tstest test/test.en16931-lineunit.node.ts --verbose --logfile --timeout 60",
     "test:format": "tstest test/test.format-detection.ts --verbose --logfile --timeout 60",
     "test:corpus": "tstest test/suite/einvoice_corpus-validation/ --verbose --logfile --timeout 60",
     "test:performance": "NODE_OPTIONS=--expose-gc tstest test/suite/einvoice_performance/ --verbose --logfile --timeout 60",

package/readme.md

@@ -147,7 +147,7 @@ invoice.items = [
 const xml = await invoice.exportXml('facturx');
 ```
 
-### Credit notes, debit notes and self-billed invoices
+### Credit notes, debit notes, corrected invoices and self-billed invoices
 
 One class holds every accounting document. `accountingDocType` is the tsclass
 `TAccountingDocType` and defaults to `invoice`; `invoiceType` is an alias for it.
@@ -163,24 +163,72 @@ creditNote.relatedDocuments = [{ relationType: 'corrects', documentId: 'INV-2026
 | `accountingDocType` | Type code (BT-3) | UBL / XRechnung | CII / Factur-X / ZUGFeRD |
 | --- | --- | --- | --- |
 | `invoice` | 380 | `Invoice` with `cbc:InvoiceTypeCode` | `ram:TypeCode` |
+| `corrected-invoice` | 384 | `Invoice` with `cbc:InvoiceTypeCode` | `ram:TypeCode` |
 | `creditnote` | 381 | `CreditNote` with `cbc:CreditNoteTypeCode`, `cac:CreditNoteLine`, no `cbc:DueDate` | `ram:TypeCode` |
 | `debitnote` | 383 | `Invoice` with `cbc:InvoiceTypeCode` | `ram:TypeCode` |
 | `self-billed-invoice` | 389 | `Invoice` with `cbc:InvoiceTypeCode` | `ram:TypeCode` |
 
 Import reads the type back from the code in UBL, XRechnung, Factur-X and
-ZUGFeRD v2: 383 is a debit note, 389 a self-billed invoice, the credit note
-related codes of EN16931 rule BR-CL-01 (381, 396, 261, ...) a credit note, and
-every other code an invoice, which covers 380, 384 and the invoice related codes
-the envelope has no name for (326, 386, 875, ...). A UBL `CreditNote` root is
-always a credit note. The code itself is not kept: a 384 that is exported again
-is written as 380. A value outside `TAccountingDocType`, a missing one included,
-is refused with an `EInvoiceFormatError` by the `invoiceType` setter and at export.
+ZUGFeRD v2: 383 is a debit note, 384 a corrected invoice, 389 a self-billed
+invoice, the credit note related codes of EN16931 rule BR-CL-01 (381, 396, 261,
+...) a credit note, and every other code an invoice, which covers 380 and the
+invoice related codes the envelope has no name for (326, 386, 875, ...). A UBL
+`CreditNote` root is always a credit note. Those other codes are not kept: a 326
+that is exported again is written as 380. A value outside `TAccountingDocType`,
+a missing one included, is refused with an `EInvoiceFormatError` by the
+`invoiceType` setter and at export.
 
 ZUGFeRD v1 is the one exception: a v1 document always reads as `invoice`,
 whatever its type code says, because `ZUGFeRDV1Decoder` does not read the v1
 header at all. This is a known defect and will be fixed separately; until then
 do not rely on the type of an imported ZUGFeRD v1 document.
 
+### Corrected invoices and preceding invoice references (BG-3)
+
+A corrected invoice (`TCorrectedInvoice`, type code 384) corrects an issued
+invoice that lacked a mandatory detail or stated one incorrectly (§ 31 Abs. 5
+UStDV). It is a complete invoice, and `correctedInvoice` names the invoice it
+corrects:
+
+```ts
+const correction = new EInvoice();
+correction.accountingDocType = 'corrected-invoice';
+correction.correctedInvoice = { documentId: 'INV-2026-001', issueDate: Date.UTC(2026, 8, 1) };
+correction.corrections = [{ detail: 'supply-date', defect: 'missing' }];
+correction.deliveryDate = Date.UTC(2026, 7, 28);
+correction.notes = ['Berichtigung der Rechnung INV-2026-001 vom 01.09.2026: Leistungsdatum ergänzt.'];
+```
+
+The encoders write a preceding invoice reference (BG-3) with the number (BT-25)
+and, when stated, the issue date (BT-26) for:
+
+- the `correctedInvoice` of a corrected invoice;
+- every entry of `relatedDocuments` with `relationType: 'corrects'` on a
+  corrected invoice or a credit note.
+
+UBL and XRechnung write `cac:BillingReference/cac:InvoiceDocumentReference`
+(`cbc:ID`, `cbc:IssueDate`); Factur-X and ZUGFeRD write
+`ram:InvoiceReferencedDocument` (`ram:IssuerAssignedID`,
+`ram:FormattedIssueDateTime`) after the header monetary summation. Import reads
+them back the same way: on a corrected invoice the first reference is
+`correctedInvoice` and further ones are `relatedDocuments` with `'corrects'`; on
+a credit note every reference is such a related document.
+
+The encoders write only what the document states:
+
+- A corrected invoice without `correctedInvoice` is written without BG-3. The
+  XRechnung rules then report the warning BR-DE-26; stating the reference is the
+  issuer's duty (§ 31 Abs. 5 Satz 2 UStDV), which the issuing application has
+  to enforce.
+- `corrections` has no element in EN 16931 and is not written. State what is
+  corrected as a note (`notes`, BT-22); the encoders add no text of their own.
+- The Factur-X MINIMUM profile has no BG-3. A document with a preceding invoice
+  reference is refused there with an `EInvoiceFormatError`.
+
+With the reference stated, the XRechnung output of a corrected invoice passes
+the official EN 16931 1.3.16 and KoSIT XRechnung Schematron 2.6.0 rules without
+BR-DE-17 or BR-DE-26.
+
 An `EInvoice` is a `TAccountingDoc`, not a `TInvoice`: narrow on
 `accountingDocType` where a function takes one document type only.
 
@@ -196,6 +244,7 @@ import {
 
 getDocumentTypeCode('debitnote'); // '383'; throws EInvoiceFormatError for an unknown type
 getAccountingDocType('396');      // 'creditnote'; an unlisted or empty code is 'invoice'
+getAccountingDocType('384');      // 'corrected-invoice'
 isAccountingDocType('proforma');  // false
 ```
 
@@ -311,7 +360,8 @@ required archival profile.
 - XRechnung import routes UBL and CII by the namespace-qualified XML root.
   Missing or invalid document-level invoice IDs and issue dates are rejected.
 - `FatturaPA` should be documented as detection-only right now.
-- Credit notes, debit notes and self-billed invoices share the `EInvoice` class; see the type code table above. Credit and debit amounts are written as given, the encoders do not change signs.
+- The day of supply: UBL and XRechnung write `deliveryDate` as `cac:Delivery/cbc:ActualDeliveryDate` (BT-72) and `periodOfPerformance` as `cac:InvoicePeriod` (BG-14), and read both back. Factur-X and ZUGFeRD write `deliveryDate` as `ram:ActualDeliverySupplyChainEvent` and read it back only when the document states it.
+- Credit notes, debit notes, corrected invoices and self-billed invoices share the `EInvoice` class; see the type code table above. Credit and debit amounts are written as given, the encoders do not change signs.
 - ZUGFeRD v1 input is detected and routed, but the v1 decoder does not read the v1 header, so such a document always arrives as an `invoice`. Known defect, to be fixed separately.
 
 ## Public API overview
@@ -330,7 +380,7 @@ Top-level exports from `@fin.cx/einvoice` include:
 - `UBLBase*` and `CIIBase*` extension classes
 - `FacturX*` and `ZUGFeRD*` format-specific classes
 - `ValidationLevel`, `InvoiceFormat`
-- exported types like `TAccountingDoc`, `TAccountingDocType`, `TInvoice`, `TCreditNote`, `TDebitNote`, `TSelfBilledInvoice`, `IEn16931UnitCodeList`, `ValidationResult`, `ValidationError`, `ExportFormat`, `IPdf`, `EInvoiceOptions`
+- exported types like `TAccountingDoc`, `TAccountingDocType`, `TInvoice`, `TCorrectedInvoice`, `TCorrectedInvoiceReference`, `TInvoiceCorrection`, `TCreditNote`, `TDebitNote`, `TSelfBilledInvoice`, `IEn16931UnitCodeList`, `ValidationResult`, `ValidationError`, `ExportFormat`, `IPdf`, `EInvoiceOptions`
 
 ## Validation resources and install-time behavior
 

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@fin.cx/einvoice',
-  version: '8.1.0',
+  version: '8.2.0',
   description: 'A TypeScript module for creating, manipulating, and embedding XML data within PDF files specifically tailored for electronic invoice (einvoice) packages.'
 }

package/ts/einvoice.ts

@@ -56,7 +56,8 @@ import type { IEInvoiceMetadata } from './interfaces/en16931-metadata.js';
  * Main class for working with electronic invoices.
  * Supports various invoice formats including Factur-X, ZUGFeRD, UBL, and XRechnung
  * Implements the tsclass accounting document envelope: one class holds an invoice,
- * a credit note, a debit note or a self-billed invoice, told apart by `accountingDocType`
+ * a corrected invoice, a credit note, a debit note or a self-billed invoice, told
+ * apart by `accountingDocType`
  */
 export class EInvoice implements TAccountingDocEnvelope<TAccountingDocType, {}> {
   private static sharedPdfEmbedder?: import('./formats/pdf/pdf.embedder.js').PDFEmbedder;
@@ -152,6 +153,20 @@ export class EInvoice implements TAccountingDocEnvelope<TAccountingDocType, {}>
     documentId: string;
     issueDate?: number;
   }>;
+
+  /**
+   * On a corrected invoice (type code 384): the invoice it corrects, written
+   * as the first preceding invoice reference (BG-3). A received corrected
+   * invoice may lack it.
+   */
+  public correctedInvoice?: finance.TCorrectedInvoiceReference;
+
+  /**
+   * On a corrected invoice: the details it supplies or corrects, as the
+   * issuer states them. EN 16931 has no element for them, so they are not
+   * written to the XML; an issuer states them as a note in `notes`.
+   */
+  public corrections?: finance.TCorrectedInvoice['corrections'];
   public printResult?: {
     pdfBufferString: string;
     totalNet: number;
@@ -447,6 +462,8 @@ export class EInvoice implements TAccountingDocEnvelope<TAccountingDocType, {}>
       electronicAddress: this.electronicAddress,
       paymentOptions: this.paymentOptions,
       relatedDocuments: this.relatedDocuments,
+      correctedInvoice: this.correctedInvoice,
+      corrections: this.corrections,
       printResult: this.printResult
     };
     

package/ts/formats/base/base.encoder.ts

@@ -6,7 +6,7 @@ import type { TAccountingDoc } from '../../interfaces/common.js';
  */
 export abstract class BaseEncoder {
   /**
-   * Encodes an accounting document (invoice, credit note, debit note or self-billed invoice) into XML
+   * Encodes an accounting document (invoice, corrected invoice, credit note, debit note or self-billed invoice) into XML
    * @param invoice Accounting document to encode
    * @returns XML string
    */

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

@@ -4,12 +4,14 @@ import { CII_NAMESPACES, CIIProfile } from './cii.types.js';
 import { DOMParser, xpath } from '../../plugins.js';
 import { EInvoiceParsingError } from '../../errors.js';
 import { getAccountingDocType } from '../utils/document.typecode.js';
+import type { TPrecedingInvoiceReference } from '../utils/preceding.invoice.js';
 
 const ciiParser = new DOMParser();
 const ciiNamespaces = {
   rsm: CII_NAMESPACES.RSM,
   ram: CII_NAMESPACES.RAM,
   udt: CII_NAMESPACES.UDT,
+  qdt: CII_NAMESPACES.QDT,
 };
 const ciiSelect = xpath.useNamespaces(ciiNamespaces);
 
@@ -91,7 +93,7 @@ export abstract class CIIBaseDecoder extends BaseDecoder {
   protected abstract decodeCreditNote(): Promise<TCreditNote>;
 
   /**
-   * Decodes a CII invoice document: an invoice, a debit note or a self-billed invoice
+   * Decodes a CII invoice document: an invoice, a corrected invoice, a debit note or a self-billed invoice
    * @param accountingDocType The type the document type code stands for
    * @returns Promise resolving to the invoice document
    */
@@ -99,6 +101,46 @@ export abstract class CIIBaseDecoder extends BaseDecoder {
     accountingDocType: TInvoiceDocument['accountingDocType'],
   ): Promise<TInvoiceDocument>;
 
+  /**
+   * Reads the preceding invoice references (BG-3) of the header settlement:
+   * the number (BT-25) and, when stated, the issue date (BT-26) of each.
+   */
+  protected extractPrecedingInvoiceReferences(): TPrecedingInvoiceReference[] {
+    const referenceNodes = this.select(
+      '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeSettlement/ram:InvoiceReferencedDocument',
+      this.doc,
+    );
+    const references: TPrecedingInvoiceReference[] = [];
+    for (const referenceNode of Array.isArray(referenceNodes) ? referenceNodes : []) {
+      const documentId = this.getText('./ram:IssuerAssignedID', referenceNode as Node).trim();
+      if (!documentId) {
+        continue;
+      }
+      const issueDate = this.getText('./ram:FormattedIssueDateTime/qdt:DateTimeString', referenceNode as Node).trim();
+      const issueDateFormat = this.getText('./ram:FormattedIssueDateTime/qdt:DateTimeString/@format', referenceNode as Node).trim();
+      references.push(
+        issueDate
+          ? { documentId, issueDate: this.parseRequiredCIIDate(issueDate, issueDateFormat) }
+          : { documentId },
+      );
+    }
+    return references;
+  }
+
+  /**
+   * Reads the actual delivery date (BT-72) of the header delivery; undefined
+   * when the document does not state one.
+   */
+  protected extractDeliveryDate(): number | undefined {
+    const deliveryDatePath =
+      '/rsm:CrossIndustryInvoice/rsm:SupplyChainTradeTransaction/ram:ApplicableHeaderTradeDelivery/ram:ActualDeliverySupplyChainEvent/ram:OccurrenceDateTime/udt:DateTimeString';
+    const deliveryDate = this.getText(deliveryDatePath).trim();
+    if (!deliveryDate) {
+      return undefined;
+    }
+    return this.parseRequiredCIIDate(deliveryDate, this.getText(`${deliveryDatePath}/@format`).trim());
+  }
+
   /**
    * Gets a text value from an XPath expression
    * @param xpath XPath expression

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

@@ -1,5 +1,8 @@
 import { BaseEncoder } from '../base/base.encoder.js';
 import type { TAccountingDoc, TCreditNote, TInvoiceDocument } from '../../interfaces/common.js';
+import { EInvoiceFormatError } from '../../errors.js';
+import { getPrecedingInvoiceReferences } from '../utils/preceding.invoice.js';
+import { getWritableDate } from '../utils/date.value.js';
 import { CII_NAMESPACES, CIIProfile } from './cii.types.js';
 
 /**
@@ -22,6 +25,13 @@ export abstract class CIIBaseEncoder extends BaseEncoder {
    * @returns CII XML string
    */
   public async encode(invoice: TAccountingDoc): Promise<string> {
+    // MINIMUM has no preceding invoice reference (BG-3): a reference the document states cannot be written there
+    if (this.profile === CIIProfile.MINIMUM && getPrecedingInvoiceReferences(invoice).length > 0) {
+      throw new EInvoiceFormatError(
+        'The MINIMUM profile has no preceding invoice reference (BG-3); a document that refers to a preceding invoice needs a profile that carries it',
+        { targetFormat: 'cii', unsupportedFeatures: ['BG-3 in profile MINIMUM'] },
+      );
+    }
     // CII has one root for every document; the two paths differ in the type code they write
     if (invoice.accountingDocType === 'creditnote') {
       return this.encodeCreditNote(invoice);
@@ -37,7 +47,7 @@ export abstract class CIIBaseEncoder extends BaseEncoder {
   protected abstract encodeCreditNote(creditNote: TCreditNote): Promise<string>;
 
   /**
-   * Encodes an invoice document (invoice, debit note or self-billed invoice) into CII XML
+   * Encodes an invoice document (invoice, corrected invoice, debit note or self-billed invoice) into CII XML
    * @param invoice Invoice document to encode
    * @returns CII XML string
    */
@@ -51,17 +61,63 @@ export abstract class CIIBaseEncoder extends BaseEncoder {
     return `<?xml version="1.0" encoding="UTF-8"?>
 <rsm:CrossIndustryInvoice xmlns:rsm="${CII_NAMESPACES.RSM}"
   xmlns:ram="${CII_NAMESPACES.RAM}"
-  xmlns:udt="${CII_NAMESPACES.UDT}">
+  xmlns:udt="${CII_NAMESPACES.UDT}"
+  xmlns:qdt="${CII_NAMESPACES.QDT}">
 </rsm:CrossIndustryInvoice>`;
   }
 
   /**
-   * Formats a date as an ISO string (YYYY-MM-DD)
+   * Writes one preceding invoice reference (BG-3) per invoice the document
+   * states it corrects: the number (BT-25) and, when stated, the issue date
+   * (BT-26). In the header settlement they follow the monetary summation, as
+   * the CII schema orders them.
+   * @param doc XML document
+   * @param invoice Accounting document
+   */
+  protected addPrecedingInvoiceReferences(doc: Document, invoice: TAccountingDoc): void {
+    const references = getPrecedingInvoiceReferences(invoice);
+    if (references.length === 0) {
+      return;
+    }
+    const settlement = doc.getElementsByTagName('ram:ApplicableHeaderTradeSettlement')[0];
+    if (!settlement) {
+      throw new EInvoiceFormatError('The document has no header trade settlement to carry its preceding invoice reference', {
+        targetFormat: 'cii',
+        unsupportedFeatures: ['BG-3'],
+      });
+    }
+    let summation: Element | undefined;
+    for (let node = settlement.firstChild; node; node = node.nextSibling) {
+      if (node.nodeType === 1 && node.nodeName === 'ram:SpecifiedTradeSettlementHeaderMonetarySummation') {
+        summation = node as Element;
+      }
+    }
+    const anchor = summation ? summation.nextSibling : null;
+    for (const reference of references) {
+      const referencedDocument = doc.createElement('ram:InvoiceReferencedDocument');
+      const issuerAssignedId = doc.createElement('ram:IssuerAssignedID');
+      issuerAssignedId.textContent = reference.documentId;
+      referencedDocument.appendChild(issuerAssignedId);
+      if (reference.issueDate !== undefined) {
+        const formattedIssueDateTime = doc.createElement('ram:FormattedIssueDateTime');
+        const dateTimeString = doc.createElement('qdt:DateTimeString');
+        dateTimeString.setAttribute('format', '102');
+        dateTimeString.textContent = this.formatDate(reference.issueDate, 'BT-26 preceding invoice issue date').replace(/-/g, '');
+        formattedIssueDateTime.appendChild(dateTimeString);
+        referencedDocument.appendChild(formattedIssueDateTime);
+      }
+      settlement.insertBefore(referencedDocument, anchor);
+    }
+  }
+
+  /**
+   * Formats a date as an ISO string (YYYY-MM-DD, UTC). A value that is no
+   * valid timestamp is refused with an `EInvoiceFormatError` naming the field.
    * @param timestamp Timestamp to format
+   * @param field The business term the date is written as
    * @returns Formatted date string
    */
-  protected formatDate(timestamp: number): string {
-    const date = new Date(timestamp);
-    return date.toISOString().split('T')[0];
+  protected formatDate(timestamp: number, field: string): string {
+    return getWritableDate(timestamp, field, 'cii').toISOString().split('T')[0];
   }
 }

package/ts/formats/cii/cii.types.ts

@@ -6,7 +6,8 @@
 export const CII_NAMESPACES = {
   RSM: 'urn:un:unece:uncefact:data:standard:CrossIndustryInvoice:100',
   RAM: 'urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:100',
-  UDT: 'urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100'
+  UDT: 'urn:un:unece:uncefact:data:standard:UnqualifiedDataType:100',
+  QDT: 'urn:un:unece:uncefact:data:standard:QualifiedDataType:100'
 };
 
 // ZUGFeRD v1 namespaces

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

@@ -8,6 +8,7 @@ import type {
 import { FACTURX_PROFILE_IDS } from './facturx.types.js';
 import { business, finance, general } from '../../../plugins.js';
 import { EN16931Validator } from '../../validation/en16931.validator.js';
+import { getPrecedingInvoiceFields } from '../../utils/preceding.invoice.js';
 
 /**
  * Decoder for Factur-X invoice format
@@ -22,7 +23,7 @@ export class FacturXDecoder extends CIIBaseDecoder {
   }
 
   /**
-   * Decodes a Factur-X invoice document: an invoice, a debit note or a self-billed invoice
+   * Decodes a Factur-X invoice document: an invoice, a corrected invoice, a debit note or a self-billed invoice
    * @param accountingDocType The type the document type code stands for
    * @returns Promise resolving to the invoice document
    */
@@ -92,6 +93,9 @@ export class FacturXDecoder extends CIIBaseDecoder {
       notes = allNotes.slice(1); // Remove subject from notes
     }
 
+    // Extract the actual delivery date, if stated
+    const deliveryDate = this.extractDeliveryDate();
+
     // Check for reverse charge
     const reverseCharge = this.exists('//ram:SpecifiedTradeAllowanceCharge/ram:ReasonCode[text()="62"]');
 
@@ -119,8 +123,10 @@ export class FacturXDecoder extends CIIBaseDecoder {
       reverseCharge: reverseCharge,
       currency: currencyCode as finance.TCurrency,
       notes: notes,
-      deliveryDate: issueDate,
-      objectActions: []
+      // the day of supply as the document states it (BT-72)
+      ...(deliveryDate === undefined ? {} : { deliveryDate }),
+      objectActions: [],
+      ...getPrecedingInvoiceFields(accountingDocType, this.extractPrecedingInvoiceReferences()),
     };
     
     // Validate mandatory EN16931 fields unless validation is skipped

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

@@ -6,6 +6,7 @@ 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';
 
 /**
  * Encoder for Factur-X invoice format
@@ -31,7 +32,7 @@ export class FacturXEncoder extends CIIBaseEncoder {
   }
 
   /**
-   * Encodes an invoice document (invoice, debit note or self-billed invoice) into Factur-X XML
+   * Encodes an invoice document (invoice, corrected invoice, debit note or self-billed invoice) into Factur-X XML
    * @param invoice Invoice document to encode
    * @returns Factur-X XML string
    */
@@ -39,7 +40,7 @@ export class FacturXEncoder extends CIIBaseEncoder {
     // Create base XML
     const xmlDoc = this.createBaseXml();
 
-    // Set document type code (380 invoice, 383 debit note, 389 self-billed invoice)
+    // Set document type code (380 invoice, 383 debit note, 384 corrected invoice, 389 self-billed invoice)
     this.setDocumentTypeCode(xmlDoc, getDocumentTypeCode(invoice.accountingDocType));
 
     // Add common invoice data
@@ -101,7 +102,7 @@ export class FacturXEncoder extends CIIBaseEncoder {
   /**
    * Sets the document type code in the XML document
    * @param doc XML document
-   * @param typeCode Document type code (380 invoice, 381 credit note, 383 debit note, 389 self-billed invoice)
+   * @param typeCode Document type code (380 invoice, 381 credit note, 383 debit note, 384 corrected invoice, 389 self-billed invoice)
    */
   private setDocumentTypeCode(doc: Document, typeCode: string): void {
     // Get root element
@@ -145,7 +146,7 @@ export class FacturXEncoder extends CIIBaseEncoder {
     const issueDateElement = doc.createElement('ram:IssueDateTime');
     const dateStringElement = doc.createElement('udt:DateTimeString');
     dateStringElement.setAttribute('format', '102'); // YYYYMMDD format
-    dateStringElement.textContent = this.formatDateYYYYMMDD(invoice.date);
+    dateStringElement.textContent = this.formatDateYYYYMMDD(invoice.date, 'BT-2 invoice issue date');
     issueDateElement.appendChild(dateStringElement);
     documentElement.appendChild(issueDateElement);
 
@@ -183,6 +184,9 @@ export class FacturXEncoder extends CIIBaseEncoder {
     // Add settlement section with payment terms and totals
     this.addSettlementSection(doc, transactionElement, invoice);
 
+    // Add the preceding invoice references (BG-3) the document states
+    this.addPrecedingInvoiceReferences(doc, invoice);
+
     // Add line items
     this.addLineItems(doc, transactionElement, invoice);
   }
@@ -284,12 +288,12 @@ export class FacturXEncoder extends CIIBaseEncoder {
     transactionElement.appendChild(deliveryElement);
 
     // Add delivery date if available
-    if (invoice.deliveryDate) {
+    if (invoice.deliveryDate !== undefined) {
       const deliveryDateElement = doc.createElement('ram:ActualDeliverySupplyChainEvent');
       const occurrenceDateElement = doc.createElement('ram:OccurrenceDateTime');
       const dateStringElement = doc.createElement('udt:DateTimeString');
       dateStringElement.setAttribute('format', '102'); // YYYYMMDD format
-      dateStringElement.textContent = this.formatDateYYYYMMDD(invoice.deliveryDate);
+      dateStringElement.textContent = this.formatDateYYYYMMDD(invoice.deliveryDate, 'BT-72 actual delivery date');
       occurrenceDateElement.appendChild(dateStringElement);
       deliveryDateElement.appendChild(occurrenceDateElement);
       deliveryElement.appendChild(deliveryDateElement);
@@ -324,7 +328,7 @@ export class FacturXEncoder extends CIIBaseEncoder {
     const dueDate = new Date(invoice.date);
     dueDate.setDate(dueDate.getDate() + invoice.dueInDays);
 
-    dateStringElement.textContent = this.formatDateYYYYMMDD(dueDate.getTime());
+    dateStringElement.textContent = this.formatDateYYYYMMDD(dueDate.getTime(), 'BT-9 payment due date');
     dueDateElement.appendChild(dateStringElement);
     paymentTermsElement.appendChild(dueDateElement);
 
@@ -487,8 +491,8 @@ export class FacturXEncoder extends CIIBaseEncoder {
    * @param timestamp Timestamp to format
    * @returns Formatted date string
    */
-  private formatDateYYYYMMDD(timestamp: number): string {
-    const date = new Date(timestamp);
+  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');