Aller au contenu principal

Catégories de TVA

L'onglet VAT configure la classification TVA portée sur chaque ligne et sur les sous-totaux TVA au niveau document — BT-118 (catégorie TVA de ligne) / BT-151 (catégorie TVA de l'article facturé) et BT-121 (code motif d'exonération). Il expose une catégorie par défaut, un code de taux zéro, un mapping de catégorie et un mapping d'exonération.

Le mécanisme de surcharge est décrit dans la Vue d'ensemble. Les quatre sections de cet onglet sont gouvernées par une bascule de surcharge unique — l'activer fait basculer l'intégralité du groupe dans le fichier document, et la suppression retire le bloc de surcharge en totalité.

Catégorie TVA par défaut​

ChampDescription
Default categoryCatégorie TVA UBL émise quand le code source ne possède pas de ligne de mapping. Texte libre — typiquement une lettre (S standard, Z taux zéro, E exonéré, K intracommunautaire, G export, AE autoliquidation, O non soumis à la TVA).
Zero rateCatégorie TVA UBL appliquée quand le montant de TVA d'une ligne est nul. Utile pour distinguer une ligne réellement à taux zéro (Z) d'une ligne exonérée (E) quand le XML source ne fournit que le pourcentage.

Mapping des codes de catégorie TVA​

Un éditeur à deux colonnes associe les codes de catégorie TVA de la source aux codes UBL définis par la liste de référence vat-categories.

ColonneDescription
Code sourceTexte libre — code tel qu'il apparaît dans le XML amont (par ex. une catégorie JDE, un code taxe SAP, une valeur alphanumérique personnalisée).
Code de catégorie TVAValeur UBL choisie dans la liste de référence vat-categories (S, Z, E, K, G, AE, O).

Résolution du mapping de catégorie​

code TVA source du XML
    │
    ├─ ligne de mapping présente ? ─► catégorie UBL de la ligne
    │
    └─ pas de ligne de mapping ?    ─► catégorie par défaut

Le paramètre de taux zéro l'emporte quand le montant de TVA calculé sur la ligne est nul — il prime sur le mapping dans ce cas.

Mapping des codes d'exonération VATEX​

La seconde table de mapping couvre le BT-121 — le code motif d'exonération de TVA (VATEX-EU-79-C, VATEX-EU-IC, VATEX-FR-FRANCHISE, etc.). Chaque ligne associe une catégorie UBL (la colonne source est ici la catégorie TVA, et non un code libre) au code VATEX-* qui explicite l'exonération dans le document UBL.

ColonneDescription
Code de catégorie TVACatégorie UBL nécessitant un code VATEX (typiquement E, K, G, AE, O — S et Z sont filtrés car les catégories standard et taux zéro ne portent jamais de motif d'exonération).
Code VATEXCode d'exonération issu de la liste de référence vatex-codes.

Quand NomaUBL émet une catégorie qui demande un motif d'exonération, le code VATEX-* correspondant est recherché dans ce mapping. Sans ligne pour une catégorie non standard, la Plateforme Agréée destinataire rejette typiquement le document via un échec de règle Schematron.

Conseils & bonnes pratiques​

  • Couvrir au moins une fois chaque catégorie non standard. S (standard) et Z (taux zéro) sont dispensées de l'exigence VATEX. Toutes les autres catégories (E, K, G, AE, O) doivent disposer d'une ligne VATEX, sous peine d'un rejet par les règles Schematron BR-FR / BR-CO.
  • AE est la catégorie correcte pour la facturation en autoliquidation. À associer à VATEX-EU-AE dans le mapping VATEX. Le montant de taxe et le taux de TVA de la ligne doivent être nuls ; l'acheteur déclare la TVA.
  • K (intracommunautaire) couvre le B2B transfrontalier au sein de l'UE. À associer à VATEX-EU-IC. Les identifiants à la TVA du vendeur (BT-31) et de l'acheteur (BT-48) doivent tous deux figurer dans le document UBL.
  • VATEX-FR-FRANCHISE cible la franchise micro-entrepreneur (article 293 B CGI). À utiliser sur la catégorie E (exonérée) pour les factures sous le seuil de franchise ; la mention « TVA non applicable, art. 293 B du CGI » doit également apparaître dans French Legal Notes.
  • Réserver le paramètre de taux zéro aux cas où la source n'arrive pas à distinguer. Quand le XML amont émet correctement la catégorie, laisser le champ Zero rate vide — s'y appuyer relève du repli, pas du mécanisme principal.
  • Ajouter les codes dans les listes de référence, pas ici. Les codes cibles manquants s'ajoutent dans les listes vat-categories ou vatex-codes ; les déroulantes les récupèrent au prochain rechargement.