@fin.cx/einvoice 5.0.2 → 5.1.2

package/dist_ts/formats/utils/currency.calculator.decimal.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Currency Calculator using Decimal Arithmetic
+ * EN16931-compliant monetary calculations with exact precision
+ */
+import { Decimal, RoundingMode } from './decimal.js';
+import type { TCurrency } from '@tsclass/tsclass/dist_ts/finance/index.js';
+/**
+ * Currency-aware calculator using decimal arithmetic for EN16931 compliance
+ */
+export declare class DecimalCurrencyCalculator {
+    private readonly currency;
+    private readonly minorUnits;
+    private readonly roundingMode;
+    constructor(currency: TCurrency, roundingMode?: RoundingMode);
+    /**
+     * Round a decimal value according to currency rules
+     */
+    round(value: Decimal | number | string): Decimal;
+    /**
+     * Calculate line net amount: (quantity × unitPrice) - discount
+     */
+    calculateLineNet(quantity: Decimal | number | string, unitPrice: Decimal | number | string, discount?: Decimal | number | string): Decimal;
+    /**
+     * Calculate VAT amount from base and rate
+     */
+    calculateVAT(baseAmount: Decimal | number | string, vatRate: Decimal | number | string): Decimal;
+    /**
+     * Calculate total with VAT
+     */
+    calculateGrossAmount(netAmount: Decimal | number | string, vatAmount: Decimal | number | string): Decimal;
+    /**
+     * Calculate sum of line items
+     */
+    sumLineItems(items: Array<{
+        quantity: Decimal | number | string;
+        unitPrice: Decimal | number | string;
+        discount?: Decimal | number | string;
+    }>): Decimal;
+    /**
+     * Calculate VAT breakdown by rate
+     */
+    calculateVATBreakdown(items: Array<{
+        netAmount: Decimal | number | string;
+        vatRate: Decimal | number | string;
+    }>): Array<{
+        rate: Decimal;
+        baseAmount: Decimal;
+        vatAmount: Decimal;
+    }>;
+    /**
+     * Check if two amounts are equal within currency precision
+     */
+    areEqual(amount1: Decimal | number | string, amount2: Decimal | number | string): boolean;
+    /**
+     * Calculate payment terms discount
+     */
+    calculatePaymentDiscount(amount: Decimal | number | string, discountRate: Decimal | number | string): Decimal;
+    /**
+     * Distribute a total amount across items proportionally
+     */
+    distributeAmount(totalToDistribute: Decimal | number | string, items: Array<{
+        value: Decimal | number | string;
+    }>): Decimal[];
+    /**
+     * Calculate compound amount (e.g., for multiple charges/allowances)
+     */
+    calculateCompoundAmount(baseAmount: Decimal | number | string, adjustments: Array<{
+        type: 'charge' | 'allowance';
+        value: Decimal | number | string;
+        isPercentage?: boolean;
+    }>): Decimal;
+    /**
+     * Validate monetary calculation according to EN16931 rules
+     */
+    validateCalculation(expected: Decimal | number | string, calculated: Decimal | number | string, ruleName: string): {
+        valid: boolean;
+        expected: string;
+        calculated: string;
+        difference?: string;
+        rule: string;
+    };
+    /**
+     * Format amount for display
+     */
+    formatAmount(amount: Decimal | number | string): string;
+    /**
+     * Get currency information
+     */
+    getCurrencyInfo(): {
+        code: TCurrency;
+        minorUnits: number;
+        roundingMode: RoundingMode;
+    };
+}
+/**
+ * Factory function to create a decimal currency calculator
+ */
+export declare function createDecimalCalculator(currency: TCurrency, roundingMode?: RoundingMode): DecimalCurrencyCalculator;

package/dist_ts/formats/utils/currency.calculator.decimal.js

@@ -0,0 +1,212 @@
+/**
+ * Currency Calculator using Decimal Arithmetic
+ * EN16931-compliant monetary calculations with exact precision
+ */
+import { Decimal, decimal, RoundingMode } from './decimal.js';
+import { getCurrencyMinorUnits } from './currency.utils.js';
+/**
+ * Currency-aware calculator using decimal arithmetic for EN16931 compliance
+ */
+export class DecimalCurrencyCalculator {
+    constructor(currency, roundingMode = 'HALF_UP') {
+        this.currency = currency;
+        this.minorUnits = getCurrencyMinorUnits(currency);
+        this.roundingMode = roundingMode;
+    }
+    /**
+     * Round a decimal value according to currency rules
+     */
+    round(value) {
+        const decimalValue = value instanceof Decimal ? value : new Decimal(value);
+        return decimalValue.round(this.minorUnits, this.roundingMode);
+    }
+    /**
+     * Calculate line net amount: (quantity × unitPrice) - discount
+     */
+    calculateLineNet(quantity, unitPrice, discount = '0') {
+        const qty = quantity instanceof Decimal ? quantity : new Decimal(quantity);
+        const price = unitPrice instanceof Decimal ? unitPrice : new Decimal(unitPrice);
+        const disc = discount instanceof Decimal ? discount : new Decimal(discount);
+        const gross = qty.multiply(price);
+        const net = gross.subtract(disc);
+        return this.round(net);
+    }
+    /**
+     * Calculate VAT amount from base and rate
+     */
+    calculateVAT(baseAmount, vatRate) {
+        const base = baseAmount instanceof Decimal ? baseAmount : new Decimal(baseAmount);
+        const rate = vatRate instanceof Decimal ? vatRate : new Decimal(vatRate);
+        const vat = base.percentage(rate);
+        return this.round(vat);
+    }
+    /**
+     * Calculate total with VAT
+     */
+    calculateGrossAmount(netAmount, vatAmount) {
+        const net = netAmount instanceof Decimal ? netAmount : new Decimal(netAmount);
+        const vat = vatAmount instanceof Decimal ? vatAmount : new Decimal(vatAmount);
+        return this.round(net.add(vat));
+    }
+    /**
+     * Calculate sum of line items
+     */
+    sumLineItems(items) {
+        let total = Decimal.ZERO;
+        for (const item of items) {
+            const lineNet = this.calculateLineNet(item.quantity, item.unitPrice, item.discount);
+            total = total.add(lineNet);
+        }
+        return this.round(total);
+    }
+    /**
+     * Calculate VAT breakdown by rate
+     */
+    calculateVATBreakdown(items) {
+        // Group by VAT rate
+        const groups = new Map();
+        for (const item of items) {
+            const net = item.netAmount instanceof Decimal ? item.netAmount : new Decimal(item.netAmount);
+            const rate = item.vatRate instanceof Decimal ? item.vatRate : new Decimal(item.vatRate);
+            const rateKey = rate.toString();
+            if (groups.has(rateKey)) {
+                const group = groups.get(rateKey);
+                group.baseAmount = group.baseAmount.add(net);
+            }
+            else {
+                groups.set(rateKey, {
+                    rate,
+                    baseAmount: net
+                });
+            }
+        }
+        // Calculate VAT for each group
+        const breakdown = [];
+        for (const group of groups.values()) {
+            breakdown.push({
+                rate: group.rate,
+                baseAmount: this.round(group.baseAmount),
+                vatAmount: this.calculateVAT(group.baseAmount, group.rate)
+            });
+        }
+        return breakdown;
+    }
+    /**
+     * Check if two amounts are equal within currency precision
+     */
+    areEqual(amount1, amount2) {
+        const a1 = amount1 instanceof Decimal ? amount1 : new Decimal(amount1);
+        const a2 = amount2 instanceof Decimal ? amount2 : new Decimal(amount2);
+        // Round both to currency precision before comparing
+        const rounded1 = this.round(a1);
+        const rounded2 = this.round(a2);
+        return rounded1.equals(rounded2);
+    }
+    /**
+     * Calculate payment terms discount
+     */
+    calculatePaymentDiscount(amount, discountRate) {
+        const amt = amount instanceof Decimal ? amount : new Decimal(amount);
+        const rate = discountRate instanceof Decimal ? discountRate : new Decimal(discountRate);
+        const discount = amt.percentage(rate);
+        return this.round(discount);
+    }
+    /**
+     * Distribute a total amount across items proportionally
+     */
+    distributeAmount(totalToDistribute, items) {
+        const total = totalToDistribute instanceof Decimal ? totalToDistribute : new Decimal(totalToDistribute);
+        // Calculate sum of all item values
+        const itemSum = items.reduce((sum, item) => {
+            const value = item.value instanceof Decimal ? item.value : new Decimal(item.value);
+            return sum.add(value);
+        }, Decimal.ZERO);
+        if (itemSum.isZero()) {
+            // Can't distribute if sum is zero
+            return items.map(() => Decimal.ZERO);
+        }
+        const distributed = [];
+        let distributedSum = Decimal.ZERO;
+        // Distribute proportionally
+        for (let i = 0; i < items.length; i++) {
+            const itemValue = items[i].value instanceof Decimal ? items[i].value : new Decimal(items[i].value);
+            if (i === items.length - 1) {
+                // Last item gets the remainder to avoid rounding errors
+                distributed.push(total.subtract(distributedSum));
+            }
+            else {
+                const itemDecimal = itemValue instanceof Decimal ? itemValue : new Decimal(itemValue);
+                const proportion = itemDecimal.divide(itemSum);
+                const distributedAmount = this.round(total.multiply(proportion));
+                distributed.push(distributedAmount);
+                distributedSum = distributedSum.add(distributedAmount);
+            }
+        }
+        return distributed;
+    }
+    /**
+     * Calculate compound amount (e.g., for multiple charges/allowances)
+     */
+    calculateCompoundAmount(baseAmount, adjustments) {
+        let result = baseAmount instanceof Decimal ? baseAmount : new Decimal(baseAmount);
+        for (const adjustment of adjustments) {
+            const value = adjustment.value instanceof Decimal ? adjustment.value : new Decimal(adjustment.value);
+            let adjustmentAmount;
+            if (adjustment.isPercentage) {
+                adjustmentAmount = result.percentage(value);
+            }
+            else {
+                adjustmentAmount = value;
+            }
+            if (adjustment.type === 'charge') {
+                result = result.add(adjustmentAmount);
+            }
+            else {
+                result = result.subtract(adjustmentAmount);
+            }
+        }
+        return this.round(result);
+    }
+    /**
+     * Validate monetary calculation according to EN16931 rules
+     */
+    validateCalculation(expected, calculated, ruleName) {
+        const exp = expected instanceof Decimal ? expected : new Decimal(expected);
+        const calc = calculated instanceof Decimal ? calculated : new Decimal(calculated);
+        const roundedExp = this.round(exp);
+        const roundedCalc = this.round(calc);
+        const valid = roundedExp.equals(roundedCalc);
+        return {
+            valid,
+            expected: roundedExp.toFixed(this.minorUnits),
+            calculated: roundedCalc.toFixed(this.minorUnits),
+            difference: valid ? undefined : roundedExp.subtract(roundedCalc).abs().toFixed(this.minorUnits),
+            rule: ruleName
+        };
+    }
+    /**
+     * Format amount for display
+     */
+    formatAmount(amount) {
+        const amt = amount instanceof Decimal ? amount : new Decimal(amount);
+        const rounded = this.round(amt);
+        return `${rounded.toFixed(this.minorUnits)} ${this.currency}`;
+    }
+    /**
+     * Get currency information
+     */
+    getCurrencyInfo() {
+        return {
+            code: this.currency,
+            minorUnits: this.minorUnits,
+            roundingMode: this.roundingMode
+        };
+    }
+}
+/**
+ * Factory function to create a decimal currency calculator
+ */
+export function createDecimalCalculator(currency, roundingMode) {
+    return new DecimalCurrencyCalculator(currency, roundingMode);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3VycmVuY3kuY2FsY3VsYXRvci5kZWNpbWFsLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvZm9ybWF0cy91dGlscy9jdXJyZW5jeS5jYWxjdWxhdG9yLmRlY2ltYWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxFQUFFLE9BQU8sRUFBRSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBRTlELE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRTVEOztHQUVHO0FBQ0gsTUFBTSxPQUFPLHlCQUF5QjtJQUtwQyxZQUNFLFFBQW1CLEVBQ25CLGVBQTZCLFNBQVM7UUFFdEMsSUFBSSxDQUFDLFFBQVEsR0FBRyxRQUFRLENBQUM7UUFDekIsSUFBSSxDQUFDLFVBQVUsR0FBRyxxQkFBcUIsQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUNsRCxJQUFJLENBQUMsWUFBWSxHQUFHLFlBQVksQ0FBQztJQUNuQyxDQUFDO0lBRUQ7O09BRUc7SUFDSCxLQUFLLENBQUMsS0FBZ0M7UUFDcEMsTUFBTSxZQUFZLEdBQUcsS0FBSyxZQUFZLE9BQU8sQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxJQUFJLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUMzRSxPQUFPLFlBQVksQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLFVBQVUsRUFBRSxJQUFJLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDaEUsQ0FBQztJQUVEOztPQUVHO0lBQ0gsZ0JBQWdCLENBQ2QsUUFBbUMsRUFDbkMsU0FBb0MsRUFDcEMsV0FBc0MsR0FBRztRQUV6QyxNQUFNLEdBQUcsR0FBRyxRQUFRLFlBQVksT0FBTyxDQUFDLENBQUMsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLElBQUksT0FBTyxDQUFDLFFBQVEsQ0FBQyxDQUFDO1FBQzNFLE1BQU0sS0FBSyxHQUFHLFNBQVMsWUFBWSxP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

package/dist_ts/formats/utils/currency.utils.d.ts

@@ -0,0 +1,99 @@
+/**
+ * ISO 4217 Currency utilities for EN16931 compliance
+ * Provides currency-aware rounding and decimal handling
+ */
+/**
+ * ISO 4217 Currency minor units (decimal places)
+ * Based on ISO 4217:2015 standard
+ *
+ * Most currencies use 2 decimal places, but there are exceptions:
+ * - 0 decimals: JPY, KRW, CLP, etc.
+ * - 3 decimals: BHD, IQD, JOD, KWD, OMR, TND
+ * - 4 decimals: CLF (Chilean Unit of Account)
+ */
+export declare const ISO4217MinorUnits: Record<string, number>;
+/**
+ * Rounding modes for currency calculations
+ */
+export declare enum RoundingMode {
+    HALF_UP = "HALF_UP",// Round half values up (0.5 → 1, -0.5 → -1)
+    HALF_DOWN = "HALF_DOWN",// Round half values down (0.5 → 0, -0.5 → 0)
+    HALF_EVEN = "HALF_EVEN",// Banker's rounding (0.5 → 0, 1.5 → 2)
+    UP = "UP",// Always round up
+    DOWN = "DOWN",// Always round down (truncate)
+    CEILING = "CEILING",// Round toward positive infinity
+    FLOOR = "FLOOR"
+}
+/**
+ * Currency configuration for calculations
+ */
+export interface CurrencyConfig {
+    code: string;
+    minorUnits: number;
+    roundingMode: RoundingMode;
+    tolerance?: number;
+}
+/**
+ * Get minor units (decimal places) for a currency
+ */
+export declare function getCurrencyMinorUnits(currencyCode: string): number;
+/**
+ * Round a value according to currency rules
+ */
+export declare function roundToCurrency(value: number, currencyCode: string, mode?: RoundingMode): number;
+/**
+ * Get tolerance for currency comparison
+ * Based on the smallest representable unit for the currency
+ */
+export declare function getCurrencyTolerance(currencyCode: string): number;
+/**
+ * Compare two monetary values with currency-aware tolerance
+ */
+export declare function areMonetaryValuesEqual(value1: number, value2: number, currencyCode: string): boolean;
+/**
+ * Format a value according to currency decimal places
+ */
+export declare function formatCurrencyValue(value: number, currencyCode: string): string;
+/**
+ * Validate if a value has correct decimal places for a currency
+ */
+export declare function hasValidDecimalPlaces(value: number, currencyCode: string): boolean;
+/**
+ * Currency calculation context for EN16931 compliance
+ */
+export declare class CurrencyCalculator {
+    private currency;
+    private minorUnits;
+    private roundingMode;
+    constructor(config: CurrencyConfig | string);
+    /**
+     * Round a value according to configured rules
+     */
+    round(value: number): number;
+    /**
+     * Calculate line net amount with rounding
+     * EN16931: Line net = (quantity × unit price) - line discounts
+     */
+    calculateLineNet(quantity: number, unitPrice: number, discount?: number): number;
+    /**
+     * Calculate VAT amount with rounding
+     * EN16931: VAT amount = taxable amount × (rate / 100)
+     */
+    calculateVAT(taxableAmount: number, rate: number): number;
+    /**
+     * Compare values with currency-aware tolerance
+     */
+    areEqual(value1: number, value2: number): boolean;
+    /**
+     * Get the tolerance for comparisons
+     */
+    getTolerance(): number;
+    /**
+     * Format value for display
+     */
+    format(value: number): string;
+}
+/**
+ * Get version info for ISO 4217 data
+ */
+export declare function getISO4217Version(): string;