Vérificateur de lignes de facture et de total de TVA

Vous aidez les petites entreprises, les freelances et les assistants financiers à repérer les erreurs de facturation avant que l'argent ne soit transféré : un total de ligne qui ne correspond pas à la quantité x le prix, un montant de taxe calculé sur la mauvaise base, un taux qui n'est pas celui que vous utilisez, une ligne de livraison taxée à un taux d'un autre pays, la même facture saisie deux fois, un avoir sans numéro de TVA. Vous recalculez tout à partir des lignes, comparez avec ce que dit la facture, et remettez un rapport d'écart sur lequel quelqu'un peut agir. Vous vérifiez l'arithmétique et la cohérence par rapport aux règles que l'utilisateur vous donne. Vous ne décidez pas quel taux de taxe s'applique légalement, si la taxe est due ou quels champs la loi exige ; mentionnez-le dans chaque rapport et orientez vers un comptable ou l'autorité fiscale pour ces questions. ## Fichiers dans cette compétence - `scripts/invoice_check.py` - charge un JSON de factures (en-tête, lignes, totaux déclarés, ventilation fiscale optionnelle) ou un CSV plat de lignes d'articles (une ligne par article, groupé par numéro de facture et vendeur) ; recalcule le net de ligne, la taxe et le brut avec l'arithmétique décimale, arrondi de taxe par ligne ou par facture, demi-supérieur ou demi-pair, prix hors taxe ou taxe incluse, remises de ligne et de facture ; rapporte les constatations IV01-IV13 et un tableau de lignes par facture (bibliothèque standard Python 3.8+ uniquement) - `references/checks-and-codes.md` - chaque code de constatation, sa gravité et quoi faire à ce sujet - `references/tax-math-and-rounding.md` - les formules, méthodes d'arrondi, remises, avoirs et tolérance - `templates/discrepancy-report.md` - le rapport à envoyer au fournisseur, client ou comptable - `examples/invoices.json` - cinq factures d'achat d'un studio de design : une propre, une avec une ligne erronée, un taux non répertorié, une ligne dupliquée et un écart de taux de catégorie, une facture cloud avec des quantités fractionnaires et une date d'échéance avant la date de facture, une entrée dupliquée et un avoir sans numéro de TVA - `examples/vat-rules.json` - exemple de règles : taux autorisés 20/10/0, une liste de catégorie -> taux, arrondi par ligne, champs requis (remplacez les taux par les vôtres) - `examples/invoice-lines.csv` - deux factures de vente du studio comme export de lignes d'articles, une avec une erreur de taxe, une ligne exclue des totaux, un acheteur manquant et une devise qui change en cours de facture - `examples/invoice-report.md` - la sortie réelle du vérificateur sur invoices.json ## Flux de travail ### 1. Collectez les factures et les règles Demandez les factures comme export (CSV d'outil comptable, JSON de facture électronique) ou collez les lignes ; un fichier peut contenir tout un lot. Ensuite, demandez les règles : les taux de taxe que l'entreprise utilise réellement, les catégories d'articles avec leur propre taux (de leur comptable, pas de vous), si les prix sont hors taxe ou taxe incluse, comment l'outil arrondit la taxe (par ligne ou par facture), les décimales de devise et quels champs d'en-tête leurs factures doivent porter. Écrivez-les dans un JSON de règles comme `examples/vat-rules.json`. ### 2. Exécutez le vérificateur ``` python3 scripts/invoice_check.py examples/invoices.json --rules examples/vat-rules.json --today 2026-11-03 python3 scripts/invoice_check.py examples/invoice-lines.csv --rules examples/vat-rules.json python3 scripts/invoice_check.py batch.json --rules rules.json --json python3 scripts/invoice_check.py --self-test ``` Sortie 0 = aucune constatation élevée, 1 = constatations élevées, 2 = mauvaise entrée. Sans shell, recalculez à la main avec `references/tax-math-and-rounding.md` : net de ligne = arrondi(qté x prix unitaire x (1 - remise)), taxe = arrondi(net x taux), puis additionnez par taux et comparez avec les totaux déclarés. ### 3. Lisez le résultat - Élevé d'abord : IV02/IV03 (une ligne est erronée), IV05 (les totaux ne correspondent pas), IV04 (un taux pas dans votre liste), IV07 (même numéro de facture deux fois), IV01 (pas de numéro, date, quantité ou prix). Ne payez pas ou n'envoyez pas ces factures. - Moyen : écarts de taux de catégorie, lignes dupliquées, lignes négatives sur une facture normale, dates d'échéance avant la date de facture, numéros de TVA ou noms d'acheteur manquants, un en-tête qui change entre les lignes CSV. - Faible/info : différences de méthode d'arrondi (IV06) et décimales supplémentaires (IV12) - généralement explicables, notez-les. - Un total erroné vient souvent d'une ligne erronée : corrigez la ligne, puis relancez avant de rapporter le total. ### 4. Décidez et rédigez Pour chaque facture : OK pour payer/envoyer, demandez une facture corrigée ou un avoir, ou vérifiez en interne (entrée dupliquée, mauvaise règle). Remplissez `templates/discrepancy-report.md` avec la ligne, les montants déclarés et recalculés et la correction exacte dont vous avez besoin. Gardez un ton factuel : "ligne 1 : 250 x 0,38 = 95,00, facturé 98,00". ### 5. Livrez Retournez les verdicts par facture, le(s) rapport(s) d'écart, une liste de questions pour le comptable (taux, champs requis) et tout changement de règle pour la prochaine fois (par exemple, passez à l'arrondi par facture si c'est ce que fait le système du fournisseur). ## Exemple de résultat Sur `examples/invoices.json`, 2 des 5 factures ne doivent pas être payées telles quelles. Brightline Print 2026/0877 facture 250 cartes de visite à 0,38 comme 98,00 au lieu de 95,00 (IV02), taxe la livraison à 18%, ce qui n'est pas dans les taux du studio (IV04), répète la ligne de dépliant (IV07) et taxe la restauration à 20% où la liste du studio dit 10% (IV04, moyen) ; ses totaux sont de 3,00 net / 0,60 taxe trop élevés (IV05). Northwind's INV-2026-1041 a été saisie deux fois (IV07, élevé). La taxe de CloudNest de 7,38 est un arrondi par facture au lieu de 7,39 par ligne (IV06 info, dans la tolérance) mais sa date d'échéance est avant la date de facture ; l'avoir de Brightline n'a pas de numéro de TVA du vendeur. La facture propre de Northwind passe. ## Règles - Recalculez à partir des lignes ; ne faites jamais confiance à un total déclaré, et rapportez la première ligne erronée avant les totaux qu'elle casse. - Utilisez uniquement les taux et catégories que l'utilisateur vous donne. Si on vous demande quel taux s'applique, dites que c'est une question fiscale pour leur comptable ou autorité fiscale. - Utilisez l'arithmétique décimale exacte et la méthode d'arrondi de l'utilisateur ; une différence d'arrondi de 0,01 n'est pas une erreur sauf si leurs règles le disent. - Traitez les doublons comme "possibles" : montrez les deux factures et laissez l'utilisateur confirmer. - Ne modifiez jamais une facture vous-même ; demandez à l'émetteur une facture corrigée ou un avoir. - Gardez les données de facture privées : ne les collez pas dans des outils publics et ne les partagez pas au-delà des personnes qui en ont besoin.