Guide · 26

Devis et factures

Génère un devis ou une facture (Markdown ou HTML) depuis un JSON : lignes, remises, TVA, total arrondi selon la devise, échéance.

En une ligne

node scripts/26-quote-invoice.mjs mon-devis.json --format html --out devis.html

À quoi ça sert

Un devis ou une facture se refait à chaque fois dans un traitement de texte, avec le risque d'une erreur de calcul ou d'une TVA oubliée. Ce script produit le document à partir d'un petit fichier JSON : lignes, remises, TVA, total, date de validité ou d'échéance. Vous gardez la donnée (le JSON) et générez la mise en forme à volonté.

Avant de commencer

  • Un fichier JSON décrivant le document (voir samples/devis.json).
  • La devise (XOF, EUR…) : les montants sont arrondis selon ses décimales (0 pour le franc CFA, 2 pour l'euro).

Pas à pas

  1. Copiez l'exemple et adaptez émetteur, client et lignes :
    cp samples/devis.json mon-devis.json
    
  2. Générez un document Markdown, ou une page HTML à imprimer en PDF depuis le navigateur :
    node scripts/26-quote-invoice.mjs mon-devis.json --format html --out devis.html
    
  3. Pour une facture, mettez "type": "facture" : l'intitulé devient « FACTURE » et la date limite devient une « échéance ».

Lire le résultat

Chaque ligne = quantité × prix, moins la remise en %. Le sous-total est la somme des lignes ; la TVA s'applique sur le sous-total ; le total à payer est la somme des deux. La date limite est date + dueDays.

L'automatiser

Reliez-le à votre outil de saisie : une ligne par prestation dans un tableur → JSON → document. La numérotation (number) reste à votre charge : respectez une suite continue, sans trou.

Pièges à éviter

  • Les mentions légales obligatoires (identifiant fiscal, conditions de paiement) dépendent de votre pays : ajoutez-les dans notes et seller.
  • Le script calcule, il ne conserve rien : archivez vos documents émis.

Ce guide accompagne un script libre (licence MIT). Essayez-le d'abord sur une copie de vos données.