À 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
- Copiez l'exemple et adaptez émetteur, client et lignes :
cp samples/devis.json mon-devis.json - 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 - 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
notesetseller. - Le script calcule, il ne conserve rien : archivez vos documents émis.