Aller au contenu

Ironfang Finance - Référence des règles

BR-Z-02 : Ajouter l'identifiant TVA du vendeur lorsque des lignes sont au taux zéro

Le taux zéro suppose un vendeur identifié sur le plan fiscal : un document comportant une ligne au taux zéro doit porter un identifiant fiscal du vendeur ou l'identifiant TVA d'un représentant fiscal.

EN 16931Erreur : le document n'est pas valideTVAParties et adresses

Sur cette page

La réponse courte

BR-Z-02 échoue lorsque la cac:ClassifiedTaxCategory d'une ligne a un cbc:ID égal à Z sous le schéma VAT et que le document ne porte ni identifiant fiscal du vendeur, sous quelque schéma que ce soit, ni identifiant TVA de représentant fiscal. Ajoutez le numéro de TVA du vendeur, GB123456789 dans l'exemple enregistré, dans cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID avec le schéma fiscal VAT.

Une livraison ou prestation au taux zéro est une opération imposable au taux de 0. Aucune taxe n'est due sur la facture, mais l'immatriculation du vendeur à la TVA y a toujours sa place.

Ce que la règle vérifie

Une seule ligne au taux zéro, dans cac:InvoiceLine ou cac:CreditNoteLine, déclenche la règle. Le document a alors besoin soit d'un cbc:CompanyID dans n'importe quel cac:PartyTaxScheme du vendeur, soit d'un cbc:CompanyID de représentant fiscal sous le schéma VAT.

Les deux voies ont fonctionné lors d'un essai sur la facture au taux zéro : un cac:PartyTaxScheme du vendeur sous le schéma TAX au lieu de VAT, et, sans identifiant du vendeur, un représentant fiscal avec GB987654321 sous VAT ; chacune a passé toutes les étapes.

Un identifiant manquant est signalé une fois pour chaque type de contenu qui l'exige. Lors d'un essai, la facture complète de référence privée de son cac:PartyTaxScheme du vendeur a signalé ensemble BR-S-02, BR-S-03, BR-S-04 et cette règle ; rétablir l'identifiant lève les quatre.

L'identifiant d'immatriculation légale du vendeur ne remplace pas l'identifiant TVA, mais il maintient BR-CO-26 silencieux. Une fois 12345678 retiré aussi de cac:PartyLegalEntity, la facture en échec a signalé BR-CO-26 à côté de cette règle.

TermeSignificationÉlément UBL
BT-151Code de catégorie de TVA de l'article facturécac:InvoiceLine/cac:Item/cac:ClassifiedTaxCategory/cbc:ID (cac:CreditNoteLine/cac:Item/cac:ClassifiedTaxCategory/cbc:ID in a credit note)
BT-31Identifiant à la TVA du vendeurcac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID (tax scheme VAT)
BT-32Identifiant d'enregistrement fiscal du vendeurcac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID (a tax scheme other than VAT)
BT-63Identifiant à la TVA du représentant fiscal du vendeurcac:TaxRepresentativeParty/cac:PartyTaxScheme/cbc:CompanyID

Comment une intégration en arrive là

Causes possibles, déduites de la forme de la règle et non d'une utilisation mesurée :

  • La partie vendeur est remplie à partir de paramètres fiscaux configurés uniquement pour les ventes au taux normal, si bien qu'un document ne comportant que des lignes au taux zéro part sans numéro de TVA.
  • L'export omet cac:PartyTaxScheme lorsque le total de TVA vaut 0.00, en pensant à tort qu'aucune identification à la TVA n'est nécessaire sans TVA facturée.
  • Un vendeur qui agit par un représentant fiscal envoie le représentant sans son cac:PartyTaxScheme.
  • Le numéro de TVA est écrit dans les éléments d'entité juridique ou d'identification de la partie, où il ne compte pas.

Comment corriger le document

  1. Prenez le numéro de TVA du vendeur, préfixe compris, dans la fiche entreprise du vendeur.
  2. Écrivez-le dans la partie vendeur en tant que cac:PartyTaxScheme/cbc:CompanyID avec cac:TaxScheme/cbc:ID à VAT, après cac:PostalAddress et avant cac:PartyLegalEntity.
  3. Émettez le cac:PartyTaxScheme du vendeur chaque fois que le vendeur a un numéro de TVA, quel que soit le total de TVA du document.
  4. Si le vendeur n'est pas immatriculé à la TVA, c'est la catégorie Z qu'il faut remettre en question. Convenez du bon traitement avec la personne responsable du paramétrage fiscal ; non soumis à la TVA (O) est une autre catégorie, avec ses propres règles.

Valider votre facture corrigée

Avant et après

Ce sont des extraits, pas des documents complets. Les documents synthétiques complets dont ils proviennent sont liés ci-dessous.

Fragment de la facture en échec : une ligne au taux zéro, et une partie vendeur sans PartyTaxScheme

<cac:AccountingSupplierParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
    <!-- postal address omitted from this fragment -->
    <cac:PartyLegalEntity>
      <cbc:RegistrationName>Example Supplier Ltd</cbc:RegistrationName>
      <cbc:CompanyID>12345678</cbc:CompanyID>
    </cac:PartyLegalEntity>
  </cac:Party>
</cac:AccountingSupplierParty>

<cac:InvoiceLine>
  <cbc:ID>1</cbc:ID>
  <!-- quantity and line amount omitted from this fragment -->
  <cac:Item>
    <cbc:Name>Example service</cbc:Name>
    <cac:ClassifiedTaxCategory>
      <cbc:ID>Z</cbc:ID>
      <cbc:Percent>0</cbc:Percent>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:ClassifiedTaxCategory>
  </cac:Item>
  <!-- price omitted from this fragment -->
</cac:InvoiceLine>

Fragment de la facture corrigée : le vendeur est identifié à la TVA bien que la facture ne porte aucune TVA

<cac:AccountingSupplierParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
    <!-- postal address omitted from this fragment -->
    <cac:PartyTaxScheme>
      <cbc:CompanyID>GB123456789</cbc:CompanyID>
      <cac:TaxScheme>
        <cbc:ID>VAT</cbc:ID>
      </cac:TaxScheme>
    </cac:PartyTaxScheme>
    <cac:PartyLegalEntity>
      <cbc:RegistrationName>Example Supplier Ltd</cbc:RegistrationName>
      <cbc:CompanyID>12345678</cbc:CompanyID>
    </cac:PartyLegalEntity>
  </cac:Party>
</cac:AccountingSupplierParty>

La facture corrigée a le cac:PartyTaxScheme du vendeur avec GB123456789 sous le schéma VAT, et la facture en échec n'a aucun cac:PartyTaxScheme dans la partie vendeur ; rien d'autre ne diffère. Le document en échec ne signale que BR-Z-02, car sa ligne unique est au taux zéro et rien n'y est au taux normal.

Ce que le validateur a signalé

Enregistré avec phive 12.1.0 / phive-rules-peppol 4.5.6 / Saxon-HE 12.10, le moteur du validateur gratuit, sur des données synthétiques. Un résultat enregistré est une preuve de non-régression pour ces documents ; ce n'est pas une certification.

Où la règle s'applique

  • S'applique aux documents UBL Invoice et CreditNote. Un avoir au taux zéro sans identifiant du vendeur a signalé cette seule règle lors d'un essai.
  • Signalée par l'étape EN 16931 comme constat fatal à la racine du document, une seule fois quel que soit le nombre de lignes au taux zéro.
  • Les remises et frais au niveau du document au taux zéro ont leurs propres versions, BR-Z-03 et BR-Z-04. Les lignes au taux normal ont BR-S-02.

Portée et source

Rédigé pour Peppol BIS Billing 3.0.21 (May 2026), EN 16931 1.3.16, tel qu'appliqué aux documents Invoice et CreditNote en UBL 2.1. D'autres profils, syntaxes et versions peuvent définir cet identifiant autrement. Version du catalogue d'aide 2026-09-28.1 : source vérifiée le 2026-09-28, explication mise à jour le 2026-09-28.

La définition officielle de BR-Z-02 (en anglais) contient le texte normatif et le test. Cette page en est notre explication, pas une copie.

Cette aide ne modifie pas le verdict du moteur. Corriger ce constat ne signifie pas que le document passe toutes les étapes de validation, et la validation ne certifie pas la conformité juridique ou fiscale et ne transmet aucun document via Peppol.