@fin.cx/einvoice 5.0.3 → 5.1.2

package/dist_ts/formats/validation/codelist.validator.js

@@ -0,0 +1,188 @@
+import { CodeLists } from './validation.types.js';
+/**
+ * Code List Validator for EN16931 compliance
+ * Validates against standard code lists (ISO, UNCL, UNECE)
+ */
+export class CodeListValidator {
+    constructor() {
+        this.results = [];
+    }
+    /**
+     * Validate all code lists in an invoice
+     */
+    validate(invoice) {
+        this.results = [];
+        // Currency validation
+        this.validateCurrency(invoice);
+        // Country codes
+        this.validateCountryCodes(invoice);
+        // Document type
+        this.validateDocumentType(invoice);
+        // Tax categories
+        this.validateTaxCategories(invoice);
+        // Payment means
+        this.validatePaymentMeans(invoice);
+        // Unit codes
+        this.validateUnitCodes(invoice);
+        return this.results;
+    }
+    /**
+     * Validate currency codes (ISO 4217)
+     */
+    validateCurrency(invoice) {
+        // Document currency (BT-5)
+        if (invoice.currency) {
+            if (!CodeLists.ISO4217.codes.has(invoice.currency.toUpperCase())) {
+                this.addError('BR-CL-03', `Invalid currency code: ${invoice.currency}. Must be ISO 4217`, 'EN16931', 'currency', 'BT-5', invoice.currency, Array.from(CodeLists.ISO4217.codes).join(', '));
+            }
+        }
+        // VAT accounting currency (BT-6)
+        const vatCurrency = invoice.metadata?.vatAccountingCurrency;
+        if (vatCurrency && !CodeLists.ISO4217.codes.has(vatCurrency.toUpperCase())) {
+            this.addError('BR-CL-04', `Invalid VAT accounting currency: ${vatCurrency}. Must be ISO 4217`, 'EN16931', 'metadata.vatAccountingCurrency', 'BT-6', vatCurrency, Array.from(CodeLists.ISO4217.codes).join(', '));
+        }
+    }
+    /**
+     * Validate country codes (ISO 3166-1 alpha-2)
+     */
+    validateCountryCodes(invoice) {
+        // Seller country (BT-40)
+        const sellerCountry = invoice.from?.address?.countryCode;
+        if (sellerCountry && !CodeLists.ISO3166.codes.has(sellerCountry.toUpperCase())) {
+            this.addError('BR-CL-14', `Invalid seller country code: ${sellerCountry}. Must be ISO 3166-1 alpha-2`, 'EN16931', 'from.address.countryCode', 'BT-40', sellerCountry, 'Two-letter country code (e.g., DE, FR, IT)');
+        }
+        // Buyer country (BT-55)
+        const buyerCountry = invoice.to?.address?.countryCode;
+        if (buyerCountry && !CodeLists.ISO3166.codes.has(buyerCountry.toUpperCase())) {
+            this.addError('BR-CL-15', `Invalid buyer country code: ${buyerCountry}. Must be ISO 3166-1 alpha-2`, 'EN16931', 'to.address.countryCode', 'BT-55', buyerCountry, 'Two-letter country code (e.g., DE, FR, IT)');
+        }
+        // Delivery country (BT-80)
+        const deliveryCountry = invoice.metadata?.deliveryAddress?.countryCode;
+        if (deliveryCountry && !CodeLists.ISO3166.codes.has(deliveryCountry.toUpperCase())) {
+            this.addError('BR-CL-16', `Invalid delivery country code: ${deliveryCountry}. Must be ISO 3166-1 alpha-2`, 'EN16931', 'metadata.deliveryAddress.countryCode', 'BT-80', deliveryCountry, 'Two-letter country code (e.g., DE, FR, IT)');
+        }
+    }
+    /**
+     * Validate document type code (UNCL1001)
+     */
+    validateDocumentType(invoice) {
+        const typeCode = invoice.metadata?.documentTypeCode ||
+            (invoice.accountingDocType === 'invoice' ? '380' :
+                invoice.accountingDocType === 'creditnote' ? '381' :
+                    invoice.accountingDocType === 'debitnote' ? '383' : null);
+        if (typeCode && !CodeLists.UNCL1001.codes.has(typeCode)) {
+            this.addError('BR-CL-01', `Invalid document type code: ${typeCode}. Must be UNCL1001`, 'EN16931', 'metadata.documentTypeCode', 'BT-3', typeCode, Array.from(CodeLists.UNCL1001.codes.entries()).map(([k, v]) => `${k} (${v})`).join(', '));
+        }
+    }
+    /**
+     * Validate tax category codes (UNCL5305)
+     */
+    validateTaxCategories(invoice) {
+        // Document level tax breakdown
+        // Note: taxBreakdown is a computed property that doesn't have metadata
+        // We would need to access the raw tax breakdown data from metadata if it exists
+        invoice.taxBreakdown?.forEach((breakdown, index) => {
+            // Since the computed taxBreakdown doesn't have metadata, 
+            // we'll skip the tax category code validation for now
+            // This would need to be implemented differently to access the raw data
+            // TODO: Access raw tax breakdown data with metadata from invoice.metadata.taxBreakdown
+            // when that structure is implemented
+        });
+        // Line level tax categories
+        invoice.items?.forEach((item, index) => {
+            // Cast to extended type to access metadata
+            const extendedItem = item;
+            const categoryCode = extendedItem.metadata?.vatCategoryCode;
+            if (categoryCode && !CodeLists.UNCL5305.codes.has(categoryCode)) {
+                this.addError('BR-CL-10', `Invalid line tax category: ${categoryCode}. Must be UNCL5305`, 'EN16931', `items[${index}].metadata.vatCategoryCode`, 'BT-151', categoryCode, Array.from(CodeLists.UNCL5305.codes.entries()).map(([k, v]) => `${k} (${v})`).join(', '));
+            }
+        });
+    }
+    /**
+     * Validate payment means codes (UNCL4461)
+     */
+    validatePaymentMeans(invoice) {
+        const paymentMeans = invoice.metadata?.paymentMeansCode;
+        if (paymentMeans && !CodeLists.UNCL4461.codes.has(paymentMeans)) {
+            this.addError('BR-CL-16', `Invalid payment means code: ${paymentMeans}. Must be UNCL4461`, 'EN16931', 'metadata.paymentMeansCode', 'BT-81', paymentMeans, Array.from(CodeLists.UNCL4461.codes.entries()).map(([k, v]) => `${k} (${v})`).join(', '));
+        }
+        // Validate payment requirements based on means code
+        if (paymentMeans === '30' || paymentMeans === '58') { // Credit transfer
+            if (!invoice.metadata?.paymentAccount?.iban) {
+                this.addWarning('BR-CL-16-1', `Payment means ${paymentMeans} (${CodeLists.UNCL4461.codes.get(paymentMeans)}) typically requires IBAN`, 'EN16931', 'metadata.paymentAccount.iban', 'BT-84');
+            }
+        }
+    }
+    /**
+     * Validate unit codes (UNECE Rec 20)
+     */
+    validateUnitCodes(invoice) {
+        invoice.items?.forEach((item, index) => {
+            const unitCode = item.unitType;
+            if (unitCode && !CodeLists.UNECERec20.codes.has(unitCode)) {
+                this.addError('BR-CL-23', `Invalid unit code: ${unitCode}. Must be UNECE Rec 20`, 'EN16931', `items[${index}].unitCode`, 'BT-130', unitCode, 'Common codes: C62 (one), KGM (kilogram), HUR (hour), DAY (day), MTR (metre)');
+            }
+            // Validate quantity is positive for standard units
+            if (unitCode && item.unitQuantity <= 0 && unitCode !== 'LS') { // LS = Lump sum can be 1
+                this.addError('BR-25', `Quantity must be positive for unit ${unitCode}`, 'EN16931', `items[${index}].quantity`, 'BT-129', item.unitQuantity, '> 0');
+            }
+        });
+    }
+    /**
+     * Add validation error
+     */
+    addError(ruleId, message, source, field, btReference, value, expected) {
+        this.results.push({
+            ruleId,
+            source,
+            severity: 'error',
+            message,
+            field,
+            btReference,
+            value,
+            expected,
+            codeList: this.getCodeListForRule(ruleId)
+        });
+    }
+    /**
+     * Add validation warning
+     */
+    addWarning(ruleId, message, source, field, btReference, value, expected) {
+        this.results.push({
+            ruleId,
+            source,
+            severity: 'warning',
+            message,
+            field,
+            btReference,
+            value,
+            expected,
+            codeList: this.getCodeListForRule(ruleId)
+        });
+    }
+    /**
+     * Get code list metadata for a rule
+     */
+    getCodeListForRule(ruleId) {
+        if (ruleId.includes('CL-03') || ruleId.includes('CL-04')) {
+            return { name: 'ISO4217', version: CodeLists.ISO4217.version };
+        }
+        if (ruleId.includes('CL-14') || ruleId.includes('CL-15') || ruleId.includes('CL-16')) {
+            return { name: 'ISO3166', version: CodeLists.ISO3166.version };
+        }
+        if (ruleId.includes('CL-01')) {
+            return { name: 'UNCL1001', version: CodeLists.UNCL1001.version };
+        }
+        if (ruleId.includes('CL-10')) {
+            return { name: 'UNCL5305', version: CodeLists.UNCL5305.version };
+        }
+        if (ruleId.includes('CL-16')) {
+            return { name: 'UNCL4461', version: CodeLists.UNCL4461.version };
+        }
+        if (ruleId.includes('CL-23')) {
+            return { name: 'UNECERec20', version: CodeLists.UNECERec20.version };
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29kZWxpc3QudmFsaWRhdG9yLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvZm9ybWF0cy92YWxpZGF0aW9uL2NvZGVsaXN0LnZhbGlkYXRvci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFLbEQ7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLGlCQUFpQjtJQUE5QjtRQUNVLFlBQU8sR0FBdUIsRUFBRSxDQUFDO0lBaVQzQyxDQUFDO0lBL1NDOztPQUVHO0lBQ0ksUUFBUSxDQUFDLE9BQWlCO1FBQy9CLElBQUksQ0FBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1FBRWxCLHNCQUFzQjtRQUN0QixJQUFJLENBQUMsZ0JBQWdCLENBQUMsT0FBTyxDQUFDLENBQUM7UUFFL0IsZ0JBQWdCO1FBQ2hCLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUVuQyxnQkFBZ0I7UUFDaEIsSUFBSSxDQUFDLG9CQUFvQixDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBRW5DLGlCQUFpQjtRQUNqQixJQUFJLENBQUMscUJBQXFCLENBQUMsT0FBTyxDQUFDLENBQUM7UUFFcEMsZ0JBQWdCO1FBQ2hCLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUVuQyxhQUFhO1FBQ2IsSUFBSSxDQUFDLGlCQUFpQixDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBRWhDLE9BQU8sSUFBSSxDQUFDLE9BQU8sQ0FBQztJQUN0QixDQUFDO0lBRUQ7O09BRUc7SUFDSyxnQkFBZ0IsQ0FBQyxPQUFpQjtRQUN4QywyQkFBMkI7UUFDM0IsSUFBSSxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDckIsSUFBSSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLFdBQVcsRUFBRSxDQUFDLEVBQUUsQ0FBQztn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

package/dist_ts/formats/validation/conformance.harness.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Conformance Test Harness for EN16931 Validation
+ * Tests validators against official samples and generates coverage reports
+ */
+/**
+ * Coverage report for all rules
+ */
+interface CoverageReport {
+    totalRules: number;
+    coveredRules: number;
+    coveragePercentage: number;
+    ruleDetails: Map<string, {
+        covered: boolean;
+        samplesCovering: string[];
+        errorCount: number;
+        warningCount: number;
+    }>;
+    uncoveredRules: string[];
+    byCategory: {
+        document: {
+            total: number;
+            covered: number;
+        };
+        calculation: {
+            total: number;
+            covered: number;
+        };
+        vat: {
+            total: number;
+            covered: number;
+        };
+        lineLevel: {
+            total: number;
+            covered: number;
+        };
+        codeLists: {
+            total: number;
+            covered: number;
+        };
+    };
+}
+/**
+ * Conformance Test Harness
+ */
+export declare class ConformanceTestHarness {
+    private integratedValidator;
+    private businessRulesValidator;
+    private codeListValidator;
+    private vatCategoriesValidator;
+    private xmlConverter;
+    private testSamples;
+    private results;
+    constructor();
+    /**
+     * Load test samples from directory
+     */
+    loadTestSamples(baseDir?: string): Promise<void>;
+    /**
+     * Run all validators against a single test sample
+     */
+    private runTestSample;
+    /**
+     * Run conformance tests on all samples
+     */
+    runConformanceTests(): Promise<void>;
+    /**
+     * Generate BR coverage matrix
+     */
+    generateCoverageMatrix(): CoverageReport;
+    /**
+     * Print test summary
+     */
+    private printSummary;
+    /**
+     * Generate HTML coverage report
+     */
+    generateHTMLReport(outputPath?: string): Promise<void>;
+    /**
+     * Get all EN16931 business rules
+     */
+    private getAllEN16931Rules;
+    /**
+     * Get category for a rule
+     */
+    private getRuleCategory;
+    /**
+     * Get description from filename
+     */
+    private getDescriptionFromFilename;
+    /**
+     * Get focus rules from filename
+     */
+    private getFocusRulesFromFilename;
+}
+/**
+ * Export convenience function to run conformance tests
+ */
+export declare function runConformanceTests(samplesDir?: string, generateReport?: boolean): Promise<void>;
+export {};