@fin.cx/einvoice 5.0.2

package/dist_ts/formats/factories/validator.factory.js

@@ -0,0 +1,110 @@
+import { BaseValidator } from '../base/base.validator.js';
+import { InvoiceFormat, ValidationLevel } from '../../interfaces/common.js';
+import { FormatDetector } from '../utils/format.detector.js';
+// Import specific validators
+import { EN16931UBLValidator } from '../ubl/en16931.ubl.validator.js';
+import { XRechnungValidator } from '../ubl/xrechnung.validator.js';
+import { FacturXValidator } from '../cii/facturx/facturx.validator.js';
+import { ZUGFeRDValidator } from '../cii/zugferd/zugferd.validator.js';
+// The EN16931UBLValidator handles all UBL-based formats with proper business rules
+// No need for legacy validator implementations here
+/**
+ * FatturaPA validator implementation
+ * Basic implementation for Italian electronic invoices
+ */
+class FatturaPAValidator extends BaseValidator {
+    validate(level = ValidationLevel.SYNTAX) {
+        // Reset errors
+        this.errors = [];
+        let valid = true;
+        if (level === ValidationLevel.SYNTAX) {
+            valid = this.validateSchema();
+        }
+        else if (level === ValidationLevel.SEMANTIC || level === ValidationLevel.BUSINESS) {
+            valid = this.validateSchema() && this.validateBusinessRules();
+        }
+        return {
+            valid,
+            errors: this.errors,
+            level
+        };
+    }
+    validateSchema() {
+        // Basic schema validation for FatturaPA
+        if (!this.xml.includes('<FatturaElettronica')) {
+            this.addError('FATT-SCHEMA-1', 'Root element must be FatturaElettronica', '/');
+            return false;
+        }
+        return true;
+    }
+    validateBusinessRules() {
+        // Basic placeholder implementation - would need more detailed rules
+        // for a real implementation
+        return this.validateSchema();
+    }
+}
+/**
+ * Factory to create the appropriate validator based on the XML format
+ */
+export class ValidatorFactory {
+    /**
+     * Creates a validator for the specified XML content
+     * @param xml XML content to validate
+     * @returns Appropriate validator instance
+     */
+    static createValidator(xml) {
+        try {
+            const format = FormatDetector.detectFormat(xml);
+            switch (format) {
+                case InvoiceFormat.UBL:
+                    return new EN16931UBLValidator(xml);
+                case InvoiceFormat.XRECHNUNG:
+                    return new XRechnungValidator(xml);
+                case InvoiceFormat.CII:
+                    // For now, use Factur-X validator for generic CII
+                    return new FacturXValidator(xml);
+                case InvoiceFormat.ZUGFERD:
+                    return new ZUGFeRDValidator(xml);
+                case InvoiceFormat.FACTURX:
+                    return new FacturXValidator(xml);
+                case InvoiceFormat.FATTURAPA:
+                    return new FatturaPAValidator(xml);
+                default:
+                    // For unknown formats, provide a generic validator that will
+                    // mark the document as invalid but won't throw an exception
+                    return new GenericValidator(xml, format);
+            }
+        }
+        catch (error) {
+            // If an error occurs during validator creation, return a generic validator
+            // that will provide meaningful error information instead of throwing
+            console.error(`Error creating validator: ${error}`);
+            return new GenericValidator(xml, 'unknown');
+        }
+    }
+}
+/**
+ * Generic validator for unknown or unsupported formats
+ * Provides meaningful validation errors instead of throwing exceptions
+ */
+class GenericValidator extends BaseValidator {
+    constructor(xml, format) {
+        super(xml);
+        this.format = format;
+        this.addError('GEN-1', `Unsupported invoice format: ${format}`, '/');
+    }
+    validate(level = ValidationLevel.SYNTAX) {
+        return {
+            valid: false,
+            errors: this.errors,
+            level
+        };
+    }
+    validateSchema() {
+        return false;
+    }
+    validateBusinessRules() {
+        return false;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdG9yLmZhY3RvcnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9mb3JtYXRzL2ZhY3Rvcmllcy92YWxpZGF0b3IuZmFjdG9yeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDMUQsT0FBTyxFQUFFLGFBQWEsRUFBRSxlQUFlLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUU1RSxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFN0QsNkJBQTZCO0FBQzdCLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLGlDQUFpQyxDQUFDO0FBQ3RFLE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQ25FLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBQ3ZFLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLHFDQUFxQyxDQUFDO0FBRXZFLG1GQUFtRjtBQUNuRixvREFBb0Q7QUFFcEQ7OztHQUdHO0FBQ0gsTUFBTSxrQkFBbUIsU0FBUSxhQUFhO0lBQzVDLFFBQVEsQ0FBQyxRQUF5QixlQUFlLENBQUMsTUFBTTtRQUN0RCxlQUFlO1FBQ2YsSUFBSSxDQUFDLE1BQU0sR0FBRyxFQUFFLENBQUM7UUFFakIsSUFBSSxLQUFLLEdBQUcsSUFBSSxDQUFDO1FBRWpCLElBQUksS0FBSyxLQUFLLGVBQWUsQ0FBQyxNQUFNLEVBQUUsQ0FBQztZQUNyQyxLQUFLLEdBQUcsSUFBSSxDQUFDLGNBQWMsRUFBRSxDQUFDO1FBQ2hDLENBQUM7YUFBTSxJQUFJLEtBQUssS0FBSyxlQUFlLENBQUMsUUFBUSxJQUFJLEtBQUssS0FBSyxlQUFlLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDcEYsS0FBSyxHQUFHLElBQUksQ0FBQyxjQUFjLEVBQUUsSUFBSSxJQUFJLENBQUMscUJBQXFCLEVBQUUsQ0FBQztR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

package/dist_ts/formats/factorx.decoder.d.ts

@@ -0,0 +1,18 @@
+import * as plugins from '../plugins.js';
+import { BaseDecoder } from './base.decoder.js';
+/**
+ * A decoder for Factur-X/ZUGFeRD XML format (based on UN/CEFACT CII).
+ * Converts XML into structured ILetter with invoice data.
+ */
+export declare class FacturXDecoder extends BaseDecoder {
+    private xmlDoc;
+    constructor(xmlString: string);
+    /**
+     * Extracts text from the first element matching the tag name
+     */
+    private getElementText;
+    /**
+     * Converts Factur-X/ZUGFeRD XML to a structured letter object
+     */
+    getLetterData(): Promise<plugins.tsclass.business.ILetter>;
+}

package/dist_ts/formats/factorx.decoder.js

@@ -0,0 +1,178 @@
+import * as plugins from '../plugins.js';
+import * as xmldom from 'xmldom';
+import { BaseDecoder } from './base.decoder.js';
+/**
+ * A decoder for Factur-X/ZUGFeRD XML format (based on UN/CEFACT CII).
+ * Converts XML into structured ILetter with invoice data.
+ */
+export class FacturXDecoder extends BaseDecoder {
+    constructor(xmlString) {
+        super(xmlString);
+        this.xmlDoc = null;
+        // Parse XML to DOM for easier element extraction
+        try {
+            const parser = new xmldom.DOMParser();
+            this.xmlDoc = parser.parseFromString(this.xmlString, 'text/xml');
+        }
+        catch (error) {
+            console.error('Error parsing Factur-X XML:', error);
+        }
+    }
+    /**
+     * Extracts text from the first element matching the tag name
+     */
+    getElementText(tagName) {
+        if (!this.xmlDoc) {
+            return '';
+        }
+        try {
+            // Basic handling for namespaced tags
+            let namespace = '';
+            let localName = tagName;
+            if (tagName.includes(':')) {
+                const parts = tagName.split(':');
+                namespace = parts[0];
+                localName = parts[1];
+            }
+            // Find all elements with this name
+            const elements = this.xmlDoc.getElementsByTagName(tagName);
+            if (elements.length > 0) {
+                return elements[0].textContent || '';
+            }
+            // Try with just the local name if we didn't find it with the namespace
+            if (namespace) {
+                const elements = this.xmlDoc.getElementsByTagName(localName);
+                if (elements.length > 0) {
+                    return elements[0].textContent || '';
+                }
+            }
+            return '';
+        }
+        catch (error) {
+            console.error(`Error extracting element ${tagName}:`, error);
+            return '';
+        }
+    }
+    /**
+     * Converts Factur-X/ZUGFeRD XML to a structured letter object
+     */
+    async getLetterData() {
+        try {
+            // Extract invoice ID
+            let invoiceId = this.getElementText('ram:ID');
+            if (!invoiceId) {
+                // Try alternative locations
+                invoiceId = this.getElementText('rsm:ExchangedDocument ram:ID') || 'Unknown';
+            }
+            // Extract seller name
+            let sellerName = this.getElementText('ram:Name');
+            if (!sellerName) {
+                sellerName = this.getElementText('ram:SellerTradeParty ram:Name') || 'Unknown Seller';
+            }
+            // Extract buyer name
+            let buyerName = '';
+            // Try to find BuyerTradeParty Name specifically
+            if (this.xmlDoc) {
+                const buyerParties = this.xmlDoc.getElementsByTagName('ram:BuyerTradeParty');
+                if (buyerParties.length > 0) {
+                    const nameElements = buyerParties[0].getElementsByTagName('ram:Name');
+                    if (nameElements.length > 0) {
+                        buyerName = nameElements[0].textContent || '';
+                    }
+                }
+            }
+            if (!buyerName) {
+                buyerName = 'Unknown Buyer';
+            }
+            // Create seller
+            const seller = {
+                name: sellerName,
+                type: 'company',
+                description: sellerName,
+                address: {
+                    streetName: this.getElementText('ram:LineOne') || 'Unknown',
+                    houseNumber: '0', // Required by IAddress interface
+                    city: this.getElementText('ram:CityName') || 'Unknown',
+                    country: this.getElementText('ram:CountryID') || 'Unknown',
+                    postalCode: this.getElementText('ram:PostcodeCode') || 'Unknown',
+                },
+            };
+            // Create buyer
+            const buyer = {
+                name: buyerName,
+                type: 'company',
+                description: buyerName,
+                address: {
+                    streetName: 'Unknown',
+                    houseNumber: '0',
+                    city: 'Unknown',
+                    country: 'Unknown',
+                    postalCode: 'Unknown',
+                },
+            };
+            // Extract invoice type
+            let invoiceType = 'debitnote';
+            const typeCode = this.getElementText('ram:TypeCode');
+            if (typeCode === '381') {
+                invoiceType = 'creditnote';
+            }
+            // Create invoice data
+            const invoiceData = {
+                id: invoiceId,
+                status: null,
+                type: invoiceType,
+                billedBy: seller,
+                billedTo: buyer,
+                deliveryDate: Date.now(),
+                dueInDays: 30,
+                periodOfPerformance: null,
+                printResult: null,
+                currency: (this.getElementText('ram:InvoiceCurrencyCode') || 'EUR'),
+                notes: [],
+                items: [
+                    {
+                        name: 'Item from Factur-X XML',
+                        unitQuantity: 1,
+                        unitNetPrice: 0,
+                        vatPercentage: 0,
+                        position: 0,
+                        unitType: 'units',
+                    }
+                ],
+                reverseCharge: false,
+            };
+            // Return a letter
+            return {
+                versionInfo: {
+                    type: 'draft',
+                    version: '1.0.0',
+                },
+                type: 'invoice',
+                date: Date.now(),
+                subject: `Invoice: ${invoiceId}`,
+                from: seller,
+                to: buyer,
+                content: {
+                    invoiceData: invoiceData,
+                    textData: null,
+                    timesheetData: null,
+                    contractData: null,
+                },
+                needsCoverSheet: false,
+                objectActions: [],
+                pdf: null,
+                incidenceId: null,
+                language: null,
+                legalContact: null,
+                logoUrl: null,
+                pdfAttachments: null,
+                accentColor: null,
+            };
+        }
+        catch (error) {
+            console.error('Error converting Factur-X XML to letter data:', error);
+            return this.createDefaultLetter();
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFjdG9yeC5kZWNvZGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZm9ybWF0cy9mYWN0b3J4LmRlY29kZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxLQUFLLE1BQU0sTUFBTSxRQUFRLENBQUM7QUFDakMsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBRWhEOzs7R0FHRztBQUNILE1BQU0sT0FBTyxjQUFlLFNBQVEsV0FBVztJQUc3QyxZQUFZLFNBQWlCO1FBQzNCLEtBQUssQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUhYLFdBQU0sR0FBb0IsSUFBSSxDQUFDO1FBS3JDLGlEQUFpRDtRQUNqRCxJQUFJLENBQUM7WUFDSCxNQUFNLE1BQU0sR0FBRyxJQUFJLE1BQU0sQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUN0QyxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQyxlQUFlLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxVQUFVLENBQUMsQ0FBQztRQUNuRSxDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLE9BQU8sQ0FBQyxLQUFLLENBQUMsNkJBQTZCLEVBQUUsS0FBSyxDQUFDLENBQUM7UUFDdEQsQ0FBQztJQUNILENBQUM7SUFFRDs7T0FFRztJQUNLLGNBQWMsQ0FBQyxPQUFlO1FBQ3BDLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7WUFDakIsT0FBTyxFQUFFLENBQUM7UUFDWixDQUFDO1FBRUQsSUFBSSxDQUFDO1lBQ0gscUNBQXFDO1lBQ3JDLElBQUksU0FBUyxHQUFHLEVBQUUsQ0FBQztZQUNuQixJQUFJLFNBQVMsR0FBRyxPQUFPLENBQUM7WUFFeEIsSUFBSSxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQzFCLE1BQU0sS0FBSyxHQUFHLE9BQU8s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

package/dist_ts/formats/factorx.encoder.d.ts

@@ -0,0 +1,51 @@
+import * as plugins from '../plugins.js';
+/**
+ * A class to convert a given ILetter with invoice data
+ * into a Factur-X compliant XML (also compatible with ZUGFeRD and EN16931).
+ *
+ * Factur-X is the French implementation of the European e-invoicing standard EN16931,
+ * which is also implemented in Germany as ZUGFeRD. Both formats are based on
+ * UN/CEFACT Cross Industry Invoice (CII) XML schemas.
+ */
+export declare class FacturXEncoder {
+    constructor();
+    /**
+     * Alias for createFacturXXml to maintain backward compatibility
+     */
+    createZugferdXml(letterArg: plugins.tsclass.business.ILetter): string;
+    /**
+     * Creates a Factur-X compliant XML based on the provided letter data.
+     * This XML is also compliant with ZUGFeRD and EN16931 standards.
+     */
+    createFacturXXml(letterArg: plugins.tsclass.business.ILetter): string;
+    /**
+     * Helper: Determine if the letter is in draft or final.
+     */
+    private isDraft;
+    /**
+     * Helper: Format date to certain patterns (very minimal example).
+     * e.g. 'yyyyMMdd' => '20231231'
+     */
+    private formatDate;
+    /**
+     * Helper: Map your custom 'unitType' to an ISO code or similar.
+     */
+    private mapUnitType;
+    /**
+     * Example: Sum all VAT amounts from items.
+     */
+    private sumAllVat;
+    /**
+     * Example: Extract main (or highest) VAT rate from items as representative.
+     * In reality, you might list multiple 'ApplicableTradeTax' blocks by group.
+     */
+    private extractMainVatRate;
+    /**
+     * Example: Sum net amounts (without VAT).
+     */
+    private calcLineTotalNet;
+    /**
+     * Example: net + VAT = grand total
+     */
+    private calcGrandTotal;
+}