@byteinnov/fiscal-invoice

Calcul des totaux d'une facture fiscale : cascade par ligne (remise → accise → TVA) puis document (impôts de sécurité, timbre).

Port TypeScript de fiscal-invoice-starter (Kotlin), à la virgule près : mêmes règles, mêmes arrondis (HALF_UP, échelle 2), mêmes tests. Arithmétique décimale exacte (decimal.js), aucune dépendance métier — le module ne connaît ni PDV, ni certification, ni paiement.

Installation

npm install @byteinnov/fiscal-invoice

Utilisation

import { calculateInvoice } from '@byteinnov/fiscal-invoice';

const result = calculateInvoice({
  lines: [
    {
      description: 'Ordinateur portable',
      quantity: 2,
      price: '3000',                    // prix unitaire
      priceDefinitionMode: 'TTC',       // ... défini TTC (accise comprise)
      taxGroup: { code: 'B', vatRatePercent: 18 },
      taxSpecific: { amount: '10' },    // accise forfaitaire par unité
      discountPercent: '5',             // remise de ligne
    },
  ],
  discountPercent: '3',                          // remise document
  securityTaxes: [{ code: 'AIB1', ratePercent: 1 }], // surcharge sur la base taxable
  stamp: '100',                                   // timbre
});

result.total.total.ttc.toFixed(2); // total toutes taxes comprises
result.total.securityTaxAmount;    // montant de l'AIB
result.taxBreakdown;               // ventilation par groupe de TVA (taux décroissant)

Les montants d'entrée acceptent number, string ou Decimal ; les montants de sortie sont des Decimal (decimal.js) — utilisez .toFixed(2) ou .toNumber() selon le besoin.

Règles de calcul

Par ligne

| Mode de prix | HT unitaire dérivé | Accise | |---|---|---| | HT | le prix est le HT | valeur forfaitaire, ou % du HT | | TTC (accise en valeur) | prix / (1 + tva) − accise | la valeur forfaitaire | | TTC (accise en %) | prix / ((1 + accise%) × (1 + tva)) | HT × accise% |

Cascade : HT brut → remise de ligne → remise document → HT net. Base TVA = HT net + accise (l'accise n'est pas remisée).

En mode TTC, le TTC prime : le TTC de la ligne vaut exactement quantité × prix saisi (moins les remises converties en TTC) et la TVA est le complément (TTC − base taxable). Sans cela, recomposer base + arrondi(base × taux) dérive d'un centime.

Au niveau document

• Impôts de sécurité (AIRSI, AIB…) : taux toujours appliqué sur la base taxable (HT net + accise), plusieurs surcharges possibles.
• TTC document = TTC des biens + impôts de sécurité + timbre.
• Ventilation TVA triée par taux décroissant.

Développement

npm test        # tests (portés depuis le starter Kotlin)
npm run build   # ESM + CJS + déclarations de types