Aller au contenu

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

BR-19 : Ajouter une adresse postale au représentant fiscal du vendeur

Un cac:TaxRepresentativeParty doit contenir un cac:PostalAddress. Omettez le groupe s'il n'y a pas de représentant, et envoyez-le complet s'il y en a un.

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

Sur cette page

La réponse courte

BR-19 échoue lorsqu'un cac:TaxRepresentativeParty n'a pas de cac:PostalAddress. Ajoutez l'adresse du représentant fiscal entre son cac:PartyName et son cac:PartyTaxScheme, avec au moins un code pays, que BR-20 exige ensuite.

La règle ne s'applique que parce que le groupe du représentant est présent. Si le vendeur n'a pas désigné de représentant fiscal pour cette opération, supprimez entièrement cac:TaxRepresentativeParty au lieu de le compléter.

Ce que la règle vérifie

La règle est évaluée une fois par cac:TaxRepresentativeParty et signale à cet élément. Elle est satisfaite dès qu'un enfant cac:PostalAddress existe ; le contenu de l'adresse est laissé à BR-20.

Un <cac:PostalAddress/> vide passe donc cette règle. Lors d'un essai, cet élément vide a été signalé par BR-20, puisque l'adresse n'a pas de code pays, et par PEPPOL-EN16931-R008, tandis que BR-19 restait muet.

Un code pays seul suffit aux deux règles d'adresse. Lors d'un essai, une adresse du représentant ne contenant que cac:Country/cbc:IdentificationCode à GB, sans rue, ville ni code postal, a passé toutes les étapes.

L'adresse a une place fixe parmi les enfants de la partie. Lors d'un essai, une adresse du représentant placée après cac:PartyTaxScheme a échoué à l'étape XSD, et aucune règle métier ne s'est exécutée.

TermeSignificationÉlément UBL
BG-11Représentant fiscal du vendeurcac:TaxRepresentativeParty
BG-12Adresse postale du représentant fiscal du vendeurcac:TaxRepresentativeParty/cac:PostalAddress

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 :

  • Le représentant est enregistré avec un nom et un numéro de TVA dans une table des immatriculations TVA qui n'a pas de colonnes d'adresse.
  • Le composant commun des parties n'écrit une adresse que pour le vendeur et l'acheteur, et le bloc du représentant a été ajouté plus tard à partir d'un autre modèle.
  • Le bloc du représentant est émis pour chaque facture d'un vendeur immatriculé à l'étranger, avec les champs qui se trouvent remplis, qu'un représentant ait été désigné ou non.

Comment corriger le document

  1. Vérifiez qu'un représentant fiscal s'applique à cette facture. Sinon, supprimez cac:TaxRepresentativeParty ; le groupe est facultatif.
  2. Prenez l'adresse dans la fiche de désignation ou d'immatriculation du représentant, et non chez le vendeur.
  3. Écrivez-la comme cac:PostalAddress directement après cac:PartyName et avant cac:PartyTaxScheme, avec rue, ville et code postal, et cac:Country/cbc:IdentificationCode comme dernier enfant.
  4. Vérifiez au passage le reste du groupe : le nom du représentant (BR-18) et son identifiant à la TVA (BR-56).

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 : le représentant fiscal passe de son nom directement à son identifiant TVA

<cac:TaxRepresentativeParty>
  <cac:PartyName>
    <cbc:Name>Example Fiscal Representative Ltd</cbc:Name>
  </cac:PartyName>
  <cac:PartyTaxScheme>
    <cbc:CompanyID>GB987654321</cbc:CompanyID>
    <!-- tax scheme omitted from this fragment -->
  </cac:PartyTaxScheme>
</cac:TaxRepresentativeParty>

Fragment de la facture corrigée : l'adresse du représentant se place entre le nom et l'identifiant TVA

<cac:TaxRepresentativeParty>
  <cac:PartyName>
    <cbc:Name>Example Fiscal Representative Ltd</cbc:Name>
  </cac:PartyName>
  <cac:PostalAddress>
    <cbc:StreetName>4 Example Street</cbc:StreetName>
    <cbc:CityName>London</cbc:CityName>
    <cbc:PostalZone>SW1A 4AA</cbc:PostalZone>
    <cac:Country>
      <cbc:IdentificationCode>GB</cbc:IdentificationCode>
    </cac:Country>
  </cac:PostalAddress>
  <cac:PartyTaxScheme>
    <cbc:CompanyID>GB987654321</cbc:CompanyID>
    <!-- tax scheme omitted from this fragment -->
  </cac:PartyTaxScheme>
</cac:TaxRepresentativeParty>

La facture corrigée donne au représentant fiscal un cac:PostalAddress au 4 Example Street, London, SW1A 4AA, pays GB ; la facture en échec n'y a pas d'adresse et rien d'autre ne diffère. BR-19 est le seul constat. BR-20 n'est pas signalé, car il cherche le code pays à l'intérieur d'une adresse et il n'y a pas d'adresse où chercher.

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

  • Le groupe du représentant a la même structure dans un document CreditNote. Lors d'un essai, un avoir dont le représentant n'avait pas d'adresse a signalé BR-19 seul.
  • Une règle EN 16931, signalée à cette seule étape ; l'étape Peppol a validé la facture en échec enregistrée.
  • Un document sans cac:TaxRepresentativeParty n'est jamais contrôlé : la règle ne peut donc pas se déclencher pour un vendeur sans représentant.

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-19 (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.