@fin.cx/einvoice 5.0.2

package/dist_ts/formats/ubl/xrechnung.validator.js

@@ -0,0 +1,107 @@
+import { EN16931UBLValidator } from './en16931.ubl.validator.js';
+/**
+ * XRechnung-specific validator that extends EN16931 validation
+ * Implements additional German CIUS (Core Invoice Usage Specification) rules
+ */
+export class XRechnungValidator extends EN16931UBLValidator {
+    /**
+     * Validates XRechnung-specific structure requirements
+     */
+    validateStructure() {
+        // First validate EN16931 structure
+        let valid = super.validateStructure();
+        // XRechnung-specific: Check for proper customization ID
+        const customizationID = this.getText('//cbc:CustomizationID');
+        if (!customizationID || !customizationID.includes('xrechnung')) {
+            this.addError('XRECH-STRUCT-1', 'XRechnung customization ID is missing or invalid', '//cbc:CustomizationID');
+            valid = false;
+        }
+        return valid;
+    }
+    /**
+     * Validates XRechnung-specific business rules
+     */
+    validateBusinessRules() {
+        // First validate EN16931 business rules
+        let valid = super.validateBusinessRules();
+        // BR-DE-1: Payment terms (BT-20) or Payment due date (BT-9) shall be provided.
+        if (!this.exists('//cbc:PaymentDueDate') && !this.exists('//cac:PaymentTerms/cbc:Note')) {
+            this.addError('BR-DE-1', 'Payment terms or Payment due date shall be provided', '//cac:PaymentTerms');
+            valid = false;
+        }
+        // BR-DE-2: The element "Buyer reference" (BT-10) shall be provided.
+        if (!this.exists('//cbc:BuyerReference')) {
+            this.addError('BR-DE-2', 'Buyer reference is required in XRechnung', '//cbc:BuyerReference');
+            valid = false;
+        }
+        // BR-DE-5: In Germany, the element "Seller VAT identifier" (BT-31) shall be provided.
+        const sellerCountry = this.getText('//cac:AccountingSupplierParty//cac:PostalAddress//cac:Country/cbc:IdentificationCode');
+        if (sellerCountry === 'DE' && !this.exists('//cac:AccountingSupplierParty//cac:PartyTaxScheme[cac:TaxScheme/cbc:ID="VAT"]/cbc:CompanyID')) {
+            this.addError('BR-DE-5', 'Seller VAT identifier is required for German sellers', '//cac:AccountingSupplierParty//cac:PartyTaxScheme');
+            valid = false;
+        }
+        // BR-DE-6: In Germany, the element "Buyer VAT identifier" (BT-48) shall be provided.
+        const buyerCountry = this.getText('//cac:AccountingCustomerParty//cac:PostalAddress//cac:Country/cbc:IdentificationCode');
+        if (buyerCountry === 'DE' && !this.exists('//cac:AccountingCustomerParty//cac:PartyTaxScheme[cac:TaxScheme/cbc:ID="VAT"]/cbc:CompanyID')) {
+            this.addError('BR-DE-6', 'Buyer VAT identifier is required for German buyers', '//cac:AccountingCustomerParty//cac:PartyTaxScheme');
+            valid = false;
+        }
+        // BR-DE-7: The element "Seller city" (BT-37) shall be provided.
+        if (!this.exists('//cac:AccountingSupplierParty//cac:PostalAddress/cbc:CityName')) {
+            this.addError('BR-DE-7', 'Seller city is required', '//cac:AccountingSupplierParty//cac:PostalAddress');
+            valid = false;
+        }
+        // BR-DE-8: The element "Seller post code" (BT-38) shall be provided.
+        if (!this.exists('//cac:AccountingSupplierParty//cac:PostalAddress/cbc:PostalZone')) {
+            this.addError('BR-DE-8', 'Seller post code is required', '//cac:AccountingSupplierParty//cac:PostalAddress');
+            valid = false;
+        }
+        // BR-DE-9: The element "Buyer city" (BT-52) shall be provided.
+        if (!this.exists('//cac:AccountingCustomerParty//cac:PostalAddress/cbc:CityName')) {
+            this.addError('BR-DE-9', 'Buyer city is required', '//cac:AccountingCustomerParty//cac:PostalAddress');
+            valid = false;
+        }
+        // BR-DE-10: The element "Buyer post code" (BT-53) shall be provided.
+        if (!this.exists('//cac:AccountingCustomerParty//cac:PostalAddress/cbc:PostalZone')) {
+            this.addError('BR-DE-10', 'Buyer post code is required', '//cac:AccountingCustomerParty//cac:PostalAddress');
+            valid = false;
+        }
+        // BR-DE-11: The element "Seller contact telephone number" (BT-42) shall be provided.
+        if (!this.exists('//cac:AccountingSupplierParty//cac:Contact/cbc:Telephone')) {
+            this.addError('BR-DE-11', 'Seller contact telephone number is required', '//cac:AccountingSupplierParty//cac:Contact');
+            valid = false;
+        }
+        // BR-DE-12: The element "Seller contact email address" (BT-43) shall be provided.
+        if (!this.exists('//cac:AccountingSupplierParty//cac:Contact/cbc:ElectronicMail')) {
+            this.addError('BR-DE-12', 'Seller contact email address is required', '//cac:AccountingSupplierParty//cac:Contact');
+            valid = false;
+        }
+        // BR-DE-13: The element "Buyer electronic address" (BT-49) shall be provided.
+        if (!this.exists('//cac:AccountingCustomerParty//cac:Party/cbc:EndpointID')) {
+            this.addError('BR-DE-13', 'Buyer electronic address (EndpointID) is required', '//cac:AccountingCustomerParty//cac:Party');
+            valid = false;
+        }
+        // BR-DE-14: The element "Payment means type code" (BT-81) shall be provided.
+        if (!this.exists('//cac:PaymentMeans/cbc:PaymentMeansCode')) {
+            this.addError('BR-DE-14', 'Payment means type code is required', '//cac:PaymentMeans');
+            valid = false;
+        }
+        // BR-DE-15: The element "Invoice line identifier" (BT-126) shall be provided.
+        const invoiceLines = this.select('//cac:InvoiceLine | //cac:CreditNoteLine', this.doc);
+        for (let i = 0; i < invoiceLines.length; i++) {
+            const line = invoiceLines[i];
+            if (!this.exists('./cbc:ID', line)) {
+                this.addError('BR-DE-15', `Invoice line ${i + 1} is missing identifier`, `//cac:InvoiceLine[${i + 1}]`);
+                valid = false;
+            }
+        }
+        // German VAT ID format validation
+        const supplierVatId = this.getText('//cac:AccountingSupplierParty//cbc:CompanyID[../cac:TaxScheme/cbc:ID="VAT"]');
+        if (supplierVatId && supplierVatId.startsWith('DE') && !/^DE[0-9]{9}$/.test(supplierVatId)) {
+            this.addError('BR-DE-VAT', 'German VAT ID format is invalid (must be DE followed by 9 digits)', '//cac:AccountingSupplierParty//cbc:CompanyID');
+            valid = false;
+        }
+        return valid;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoieHJlY2hudW5nLnZhbGlkYXRvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2Zvcm1hdHMvdWJsL3hyZWNobnVuZy52YWxpZGF0b3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFFakU7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLGtCQUFtQixTQUFRLG1CQUFtQjtJQUN6RDs7T0FFRztJQUNPLGlCQUFpQjtRQUN6QixtQ0FBbUM7UUFDbkMsSUFBSSxLQUFLLEdBQUcsS0FBSyxDQUFDLGlCQUFpQixFQUFFLENBQUM7UUFFdEMsd0RBQXdEO1FBQ3hELE1BQU0sZUFBZSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsdUJBQXVCLENBQUMsQ0FBQztRQUM5RCxJQUFJLENBQUMsZUFBZSxJQUFJLENBQUMsZUFBZSxDQUFDLFFBQVEsQ0FBQyxXQUFXLENBQUMsRUFBRSxDQUFDO1lBQy9ELElBQUksQ0FBQyxRQUFRLENBQ1gsZ0JBQWdCLEVBQ2hCLGtEQUFrRCxFQUNsRCx1QkFBdUIsQ0FDeEIsQ0FBQztZQUNGLEtBQUssR0FBRyxLQUFLLENBQUM7UUFDaEIsQ0FBQztRQUVELE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztJQUVEOztPQUVHO0lBQ08scUJBQXFCO1FBQzdCLHdDQUF3QztRQUN4QyxJQUFJLEtBQUssR0FBRyxLQUFLLENBQUMscUJBQXFCLEVBQUUsQ0FBQztRQUUxQywrRUFBK0U7UUFDL0UsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsc0JBQXNCLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsNkJBQTZCLENBQUMsRUFBRSxDQUFDO1lBQ3hGLElBQUksQ0FBQyxRQUFRLENBQ1gsU0FBUyxFQUNULHFEQUFxRCxFQUNyRCxvQkFBb0IsQ0FDckIsQ0FBQztZQUNGLEtBQUssR0FBRyxLQUFLLENBQUM7UUFDaEIsQ0FBQztR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

package/dist_ts/formats/ubl.validator.d.ts

@@ -0,0 +1,82 @@
+import { BaseValidator } from './base.validator.js';
+import { ValidationLevel } from '../interfaces.js';
+import type { ValidationResult } from '../interfaces.js';
+/**
+ * Validator for UBL (Universal Business Language) invoice format
+ * Implements validation rules according to EN16931 and UBL 2.1 specification
+ */
+export declare class UBLValidator extends BaseValidator {
+    private static NS_INVOICE;
+    private static NS_CAC;
+    private static NS_CBC;
+    private xmlDoc;
+    private customizationId;
+    constructor(xml: string);
+    /**
+     * Validates the UBL invoice against the specified level
+     * @param level Validation level
+     * @returns Validation result
+     */
+    validate(level?: ValidationLevel): ValidationResult;
+    /**
+     * Validates XML against schema
+     * @returns True if schema validation passed
+     */
+    protected validateSchema(): boolean;
+    /**
+     * Validates structure of the XML document
+     * @returns True if structure validation passed
+     */
+    private validateStructure;
+    /**
+     * Validates business rules
+     * @returns True if business rule validation passed
+     */
+    protected validateBusinessRules(): boolean;
+    /**
+     * Gets the root node name (Invoice or CreditNote)
+     * @returns Root node name
+     */
+    private getRootNodeName;
+    /**
+     * Detects UBL customization ID from the XML
+     */
+    private detectCustomizationId;
+    /**
+     * Checks if invoice is an XRechnung
+     * @returns True if XRechnung customization ID is present
+     */
+    private isXRechnung;
+    /**
+     * Validates amount calculations in the invoice
+     * @returns True if amount validation passed
+     */
+    private validateAmounts;
+    /**
+     * Validates mutually exclusive fields
+     * @returns True if validation passed
+     */
+    private validateMutuallyExclusiveFields;
+    /**
+     * Validates seller VAT identifier requirements
+     * @returns True if validation passed
+     */
+    private validateSellerVatIdentifier;
+    /**
+     * Validates XRechnung specific rules
+     * @returns True if validation passed
+     */
+    private validateXRechnungRules;
+    /**
+     * Helper method to check if a node exists
+     * @param xpathExpression XPath to check
+     * @returns True if node exists
+     */
+    private exists;
+    /**
+     * Helper method to get a number value from XPath
+     * @param xpathExpression XPath to get number from
+     * @returns Number value or NaN if not found
+     */
+    private getNumberValue;
+}

package/dist_ts/formats/ubl.validator.js

@@ -0,0 +1,306 @@
+import { BaseValidator } from './base.validator.js';
+import { ValidationLevel } from '../interfaces.js';
+import * as xpath from 'xpath';
+import { DOMParser } from 'xmldom';
+/**
+ * Validator for UBL (Universal Business Language) invoice format
+ * Implements validation rules according to EN16931 and UBL 2.1 specification
+ */
+export class UBLValidator extends BaseValidator {
+    // XML namespaces for UBL
+    static { this.NS_INVOICE = 'urn:oasis:names:specification:ubl:schema:xsd:Invoice-2'; }
+    static { this.NS_CAC = 'urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2'; }
+    static { this.NS_CBC = 'urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2'; }
+    constructor(xml) {
+        super(xml);
+        // XML document for processing
+        this.xmlDoc = null;
+        // UBL profile or customization ID
+        this.customizationId = '';
+        try {
+            // Parse XML document
+            this.xmlDoc = new DOMParser().parseFromString(xml, 'application/xml');
+            // Determine UBL customization ID (e.g. EN16931, XRechnung)
+            this.detectCustomizationId();
+        }
+        catch (error) {
+            this.addError('UBL-PARSE', `Failed to parse XML: ${error}`, '/');
+        }
+    }
+    /**
+     * Validates the UBL invoice against the specified level
+     * @param level Validation level
+     * @returns Validation result
+     */
+    validate(level = ValidationLevel.SYNTAX) {
+        // Reset errors
+        this.errors = [];
+        // Check if document was parsed successfully
+        if (!this.xmlDoc) {
+            return {
+                valid: false,
+                errors: this.errors,
+                level: level
+            };
+        }
+        // Perform validation based on level
+        let valid = true;
+        if (level === ValidationLevel.SYNTAX) {
+            valid = this.validateSchema();
+        }
+        else if (level === ValidationLevel.SEMANTIC) {
+            valid = this.validateSchema() && this.validateStructure();
+        }
+        else if (level === ValidationLevel.BUSINESS) {
+            valid = this.validateSchema() &&
+                this.validateStructure() &&
+                this.validateBusinessRules();
+        }
+        return {
+            valid,
+            errors: this.errors,
+            level
+        };
+    }
+    /**
+     * Validates XML against schema
+     * @returns True if schema validation passed
+     */
+    validateSchema() {
+        // Basic schema validation (simplified for now)
+        if (!this.xmlDoc)
+            return false;
+        // Check for root element
+        const root = this.xmlDoc.documentElement;
+        if (!root || (root.nodeName !== 'Invoice' && root.nodeName !== 'CreditNote')) {
+            this.addError('UBL-SCHEMA-1', 'Root element must be Invoice or CreditNote', '/');
+            return false;
+        }
+        // Check for required namespaces
+        if (!root.lookupNamespaceURI('cac') || !root.lookupNamespaceURI('cbc')) {
+            this.addError('UBL-SCHEMA-2', 'Required namespaces cac and cbc must be declared', '/');
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Validates structure of the XML document
+     * @returns True if structure validation passed
+     */
+    validateStructure() {
+        if (!this.xmlDoc)
+            return false;
+        let valid = true;
+        // Check for required main sections
+        const sections = [
+            'cbc:ID',
+            'cbc:IssueDate',
+            'cac:AccountingSupplierParty',
+            'cac:AccountingCustomerParty',
+            'cac:LegalMonetaryTotal'
+        ];
+        for (const section of sections) {
+            if (!this.exists(`/${this.getRootNodeName()}/${section}`)) {
+                this.addError('UBL-STRUCT-1', `Required section ${section} is missing`, `/${this.getRootNodeName()}`);
+                valid = false;
+            }
+        }
+        // Check for TaxTotal section
+        if (this.exists(`/${this.getRootNodeName()}/cac:TaxTotal`)) {
+            const taxSubsections = [
+                'cbc:TaxAmount',
+                'cac:TaxSubtotal'
+            ];
+            for (const subsection of taxSubsections) {
+                if (!this.exists(`/${this.getRootNodeName()}/cac:TaxTotal/${subsection}`)) {
+                    this.addError('UBL-STRUCT-2', `Required subsection ${subsection} is missing`, `/${this.getRootNodeName()}/cac:TaxTotal`);
+                    valid = false;
+                }
+            }
+        }
+        return valid;
+    }
+    /**
+     * Validates business rules
+     * @returns True if business rule validation passed
+     */
+    validateBusinessRules() {
+        if (!this.xmlDoc)
+            return false;
+        let valid = true;
+        // BR-16: Amount due for payment (BT-115) = Invoice total amount with VAT (BT-112) - Paid amount (BT-113)
+        valid = this.validateAmounts() && valid;
+        // BR-CO-3: Value added tax point date (BT-7) and Value added tax point date code (BT-8) are mutually exclusive
+        valid = this.validateMutuallyExclusiveFields() && valid;
+        // BR-S-1: An Invoice that contains a line where the VAT category code is "Standard rated" 
+        // shall contain the Seller VAT Identifier or the Seller tax representative VAT identifier
+        valid = this.validateSellerVatIdentifier() && valid;
+        // XRechnung specific rules when customization ID matches
+        if (this.isXRechnung()) {
+            valid = this.validateXRechnungRules() && valid;
+        }
+        return valid;
+    }
+    /**
+     * Gets the root node name (Invoice or CreditNote)
+     * @returns Root node name
+     */
+    getRootNodeName() {
+        if (!this.xmlDoc || !this.xmlDoc.documentElement)
+            return 'Invoice';
+        return this.xmlDoc.documentElement.nodeName;
+    }
+    /**
+     * Detects UBL customization ID from the XML
+     */
+    detectCustomizationId() {
+        if (!this.xmlDoc)
+            return;
+        // Look for customization ID
+        const customizationNode = xpath.select1(`string(/${this.getRootNodeName()}/cbc:CustomizationID)`, this.xmlDoc);
+        if (customizationNode) {
+            this.customizationId = customizationNode.toString();
+        }
+    }
+    /**
+     * Checks if invoice is an XRechnung
+     * @returns True if XRechnung customization ID is present
+     */
+    isXRechnung() {
+        return this.customizationId.includes('xrechnung') ||
+            this.customizationId.includes('XRechnung');
+    }
+    /**
+     * Validates amount calculations in the invoice
+     * @returns True if amount validation passed
+     */
+    validateAmounts() {
+        if (!this.xmlDoc)
+            return false;
+        try {
+            // Extract amounts
+            const totalAmount = this.getNumberValue(`/${this.getRootNodeName()}/cac:LegalMonetaryTotal/cbc:TaxInclusiveAmount`);
+            const paidAmount = this.getNumberValue(`/${this.getRootNodeName()}/cac:LegalMonetaryTotal/cbc:PrepaidAmount`) || 0;
+            const dueAmount = this.getNumberValue(`/${this.getRootNodeName()}/cac:LegalMonetaryTotal/cbc:PayableAmount`);
+            // Calculate expected due amount
+            const expectedDueAmount = totalAmount - paidAmount;
+            // Compare with a small tolerance for rounding errors
+            if (Math.abs(dueAmount - expectedDueAmount) > 0.01) {
+                this.addError('BR-16', `Amount due for payment (${dueAmount}) must equal Invoice total amount with VAT (${totalAmount}) - Paid amount (${paidAmount})`, `/${this.getRootNodeName()}/cac:LegalMonetaryTotal`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            this.addError('UBL-AMOUNT', `Error validating amounts: ${error}`, '/');
+            return false;
+        }
+    }
+    /**
+     * Validates mutually exclusive fields
+     * @returns True if validation passed
+     */
+    validateMutuallyExclusiveFields() {
+        if (!this.xmlDoc)
+            return false;
+        try {
+            // Check for VAT point date and code (BR-CO-3)
+            const vatPointDate = this.exists(`/${this.getRootNodeName()}/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:TaxPointDate`);
+            const vatPointDateCode = this.exists(`/${this.getRootNodeName()}/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory/cbc:TaxExemptionReasonCode`);
+            if (vatPointDate && vatPointDateCode) {
+                this.addError('BR-CO-3', 'Value added tax point date and Value added tax point date code are mutually exclusive', `/${this.getRootNodeName()}/cac:TaxTotal/cac:TaxSubtotal/cac:TaxCategory`);
+                return false;
+            }
+            return true;
+        }
+        catch (error) {
+            this.addError('UBL-MUTUAL', `Error validating mutually exclusive fields: ${error}`, '/');
+            return false;
+        }
+    }
+    /**
+     * Validates seller VAT identifier requirements
+     * @returns True if validation passed
+     */
+    validateSellerVatIdentifier() {
+        if (!this.xmlDoc)
+            return false;
+        try {
+            // Check if there are any standard rated line items
+            const standardRatedItems = this.exists(`/${this.getRootNodeName()}/cac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:ID[text()="S"]`);
+            if (standardRatedItems) {
+                // Check for seller VAT identifier
+                const sellerVatId = this.exists(`/${this.getRootNodeName()}/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID`);
+                const sellerTaxRepId = this.exists(`/${this.getRootNodeName()}/cac:TaxRepresentativeParty/cac:PartyTaxScheme/cbc:CompanyID`);
+                if (!sellerVatId && !sellerTaxRepId) {
+                    this.addError('BR-S-1', 'An Invoice with standard rated items must contain the Seller VAT Identifier or Tax representative VAT identifier', `/${this.getRootNodeName()}/cac:AccountingSupplierParty/cac:Party`);
+                    return false;
+                }
+            }
+            return true;
+        }
+        catch (error) {
+            this.addError('UBL-VAT', `Error validating seller VAT identifier: ${error}`, '/');
+            return false;
+        }
+    }
+    /**
+     * Validates XRechnung specific rules
+     * @returns True if validation passed
+     */
+    validateXRechnungRules() {
+        if (!this.xmlDoc)
+            return false;
+        let valid = true;
+        try {
+            // BR-DE-1: Buyer reference must be present for German VAT compliance
+            if (!this.exists(`/${this.getRootNodeName()}/cbc:BuyerReference`)) {
+                this.addError('BR-DE-1', 'BuyerReference is mandatory for XRechnung', `/${this.getRootNodeName()}`);
+                valid = false;
+            }
+            // BR-DE-15: Contact information must be present
+            if (!this.exists(`/${this.getRootNodeName()}/cac:AccountingSupplierParty/cac:Party/cac:Contact`)) {
+                this.addError('BR-DE-15', 'Supplier contact information is mandatory for XRechnung', `/${this.getRootNodeName()}/cac:AccountingSupplierParty/cac:Party`);
+                valid = false;
+            }
+            // BR-DE-16: Electronic address identifier scheme (e.g. PEPPOL) must be present
+            if (!this.exists(`/${this.getRootNodeName()}/cac:AccountingSupplierParty/cac:Party/cbc:EndpointID`) ||
+                !this.exists(`/${this.getRootNodeName()}/cac:AccountingSupplierParty/cac:Party/cbc:EndpointID/@schemeID`)) {
+                this.addError('BR-DE-16', 'Supplier electronic address with scheme identifier is mandatory for XRechnung', `/${this.getRootNodeName()}/cac:AccountingSupplierParty/cac:Party`);
+                valid = false;
+            }
+            return valid;
+        }
+        catch (error) {
+            this.addError('UBL-XRECHNUNG', `Error validating XRechnung rules: ${error}`, '/');
+            return false;
+        }
+    }
+    /**
+     * Helper method to check if a node exists
+     * @param xpathExpression XPath to check
+     * @returns True if node exists
+     */
+    exists(xpathExpression) {
+        if (!this.xmlDoc)
+            return false;
+        const nodes = xpath.select(xpathExpression, this.xmlDoc);
+        // Handle different return types from xpath.select()
+        if (Array.isArray(nodes)) {
+            return nodes.length > 0;
+        }
+        return nodes ? true : false;
+    }
+    /**
+     * Helper method to get a number value from XPath
+     * @param xpathExpression XPath to get number from
+     * @returns Number value or NaN if not found
+     */
+    getNumberValue(xpathExpression) {
+        if (!this.xmlDoc)
+            return NaN;
+        const node = xpath.select1(`string(${xpathExpression})`, this.xmlDoc);
+        return node ? parseFloat(node.toString()) : NaN;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidWJsLnZhbGlkYXRvci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Zvcm1hdHMvdWJsLnZhbGlkYXRvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDcEQsT0FBTyxFQUFFLGVBQWUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBRW5ELE9BQU8sS0FBSyxLQUFLLE1BQU0sT0FBTyxDQUFDO0FBQy9CLE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxRQUFRLENBQUM7QUFFbkM7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLFlBQWEsU0FBUSxhQUFhO0lBQzdDLHlCQUF5QjthQUNWLGVBQVUsR0FBRyx3REFBd0QsQUFBM0QsQ0FBNEQ7YUFDdEUsV0FBTSxHQUFHLDBFQUEwRSxBQUE3RSxDQUE4RTthQUNwRixXQUFNLEdBQUcsc0VBQXNFLEFBQXpFLENBQTBFO0lBUS9GLFlBQVksR0FBVztRQUNyQixLQUFLLENBQUMsR0FBRyxDQUFDLENBQUM7UUFQYiw4QkFBOEI7UUFDdEIsV0FBTSxHQUFvQixJQUFJLENBQUM7UUFFdkMsa0NBQWtDO1FBQzFCLG9CQUFlLEdBQVcsRUFBRSxDQUFDO1FBS25DLElBQUksQ0FBQztZQUNILHFCQUFxQjtZQUNyQixJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksU0FBUyxFQUFFLENBQUMsZUFBZSxDQUFDLEdBQUcsRUFBRSxpQkFBaUIsQ0FBQyxDQUFDO1lBRXRFLDJEQUEyRDtZQUMzRCxJQUFJLENBQUMscUJBQXFCLEVBQUUsQ0FBQztRQUMvQixDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLElBQUksQ0FBQyxRQUFRLENBQUMsV0FBVyxFQUFFLHdCQUF3QixLQUFLLEVBQUUsRUFBRSxHQUFHLENBQUMsQ0FBQztRQUNuRSxDQUFDO0lBQ0gsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSxRQUFRLENBQUMsUUFBeUIsZUFBZSxD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

package/dist_ts/formats/utils/format.detector.d.ts

@@ -0,0 +1,62 @@
+import { InvoiceFormat } from '../../interfaces/common.js';
+/**
+ * Utility class for detecting invoice formats
+ */
+export declare class FormatDetector {
+    /**
+     * Detects the format of an XML document
+     * @param xml XML content to analyze
+     * @returns Detected invoice format
+     */
+    static detectFormat(xml: string): InvoiceFormat;
+    /**
+     * Performs a quick format check based on string content
+     * This is faster than full XML parsing for obvious cases
+     * @param xml XML string
+     * @returns Detected format or UNKNOWN if more analysis is needed
+     */
+    private static quickFormatCheck;
+    /**
+     * Checks if the document is a UBL format
+     * @param root Root element
+     * @returns True if it's a UBL format
+     */
+    private static isUBLFormat;
+    /**
+     * Checks if the document is an XRechnung format
+     * @param doc XML document
+     * @returns True if it's an XRechnung format
+     */
+    private static isXRechnungFormat;
+    /**
+     * Checks if the document is a CII format (Factur-X/ZUGFeRD v2+)
+     * @param root Root element
+     * @returns True if it's a CII format
+     */
+    private static isCIIFormat;
+    /**
+     * Checks if the document is a ZUGFeRD v1 format
+     * @param root Root element
+     * @returns True if it's a ZUGFeRD v1 format
+     */
+    private static isZUGFeRDV1Format;
+    /**
+     * Checks if the document is a FatturaPA format
+     * @param root Root element
+     * @returns True if it's a FatturaPA format
+     */
+    private static isFatturaPAFormat;
+    /**
+     * Detects the specific CII format (Factur-X vs ZUGFeRD)
+     * @param doc XML document
+     * @param xml Original XML string for fallback checks
+     * @returns Detected format
+     */
+    private static detectCIIFormat;
+    /**
+     * Fallback method to detect CII format from string content
+     * @param xml XML string
+     * @returns Detected format
+     */
+    private static detectCIIFormatFromString;
+}