Aller au contenu

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

NL-R-001 : Faire référence à la facture corrigée dans un avoir d'un fournisseur néerlandais

Lorsque l'adresse du vendeur est aux Pays-Bas, un avoir doit porter le numéro de la facture qu'il corrige dans cac:BillingReference.

Peppol BIS BillingErreur : le document n'est pas valideProcessus et références

Sur cette page

La réponse courte

NL-R-001 échoue lorsqu'un document UBL CreditNote émis par un vendeur dont l'adresse postale est aux Pays-Bas n'a pas de cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID. Ajoutez la référence de facturation avec le numéro de la facture que l'avoir corrige.

Le constat est signalé sur cbc:CreditNoteTypeCode, car c'est l'élément auquel la règle est rattachée. Ce qui manque, c'est la référence de facturation.

Ce que la règle vérifie

La règle ne s'applique qu'aux documents CreditNote, et seulement lorsque le code pays de l'adresse postale du vendeur est NL. Le préfixe du numéro de TVA ne joue aucun rôle : lors d'un essai, l'avoir néerlandais avec un numéro de TVA GB a encore signalé la règle, et avec une adresse postale GB et un numéro de TVA NL, il est passé.

Elle cherche ensuite un cbc:ID dans cac:InvoiceDocumentReference au sein d'une cac:BillingReference au niveau du document. Une référence de commande ne compte pas, pas plus qu'une cac:SelfBilledInvoiceDocumentReference ; lors d'un essai, les deux ont encore signalé NL-R-001.

La présence est tout ce qu'elle demande. Un cbc:ID vide à cet endroit satisfait cette règle, mais lors d'un essai il a été signalé à la place par PEPPOL-EN16931-R008.

Un document Invoice n'est jamais contrôlé, quel que soit son code de type. Un avoir envoyé comme Invoice avec le code de type 381 est de toute façon rejeté : lors d'un essai, il a signalé BR-CL-01 et PEPPOL-EN16931-P0100.

TermeSignificationÉlément UBL
BT-3Code de type de facturecbc:CreditNoteTypeCode
BT-25Référence à une facture antérieurecac:BillingReference/cac:InvoiceDocumentReference/cbc:ID
BT-40Code de pays du vendeurcac:AccountingSupplierParty/cac:Party/cac:PostalAddress/cac:Country/cbc:IdentificationCode

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 :

  • Les avoirs sont émis comme remboursements autonomes ou avoirs commerciaux, sans lien avec une facture d'origine dans la source.
  • Le lien vers la facture d'origine existe dans la source mais n'est mappé que vers une note ou vers cac:OrderReference.
  • Un système au service de plusieurs entités juridiques n'écrit la référence de facturation que là où elle a été configurée, et l'entité néerlandaise n'a jamais été paramétrée pour cela.

Comment corriger le document

  1. Retrouvez dans le système source la facture que l'avoir corrige. Si l'avoir porte sur plusieurs factures, donnez à chacune sa propre cac:BillingReference.
  2. Écrivez son numéro, exactement tel qu'émis, dans cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID, avec sa date d'émission dans cbc:IssueDate à côté.
  3. Placez cac:BillingReference après cbc:BuyerReference et une éventuelle cac:OrderReference, et avant les autres références de document et les parties, comme l'exige l'ordre UBL.
  4. Si l'avoir n'a pas de facture sous-jacente dans vos registres, déterminez à la source à quelle facture il se rattache. Un numéro inventé passerait le contrôle et induirait l'acheteur en erreur.

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 l'avoir en échec : un vendeur aux Pays-Bas et aucune référence de facturation

<cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>BUYER-REF-001</cbc:BuyerReference>
<cac:AccountingSupplierParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
    <cac:PostalAddress>
      <!-- street, city and postcode omitted from this fragment -->
      <cac:Country>
        <cbc:IdentificationCode>NL</cbc:IdentificationCode>
      </cac:Country>
    </cac:PostalAddress>
    <!-- VAT and legal entity details omitted from this fragment -->
  </cac:Party>
</cac:AccountingSupplierParty>

Fragment de l'avoir corrigé : la référence de facturation nomme la facture créditée

<cbc:CreditNoteTypeCode>381</cbc:CreditNoteTypeCode>
<cbc:DocumentCurrencyCode>GBP</cbc:DocumentCurrencyCode>
<cbc:BuyerReference>BUYER-REF-001</cbc:BuyerReference>
<cac:BillingReference>
  <cac:InvoiceDocumentReference>
    <cbc:ID>EXAMPLE-INV-001</cbc:ID>
    <cbc:IssueDate>2026-09-08</cbc:IssueDate>
  </cac:InvoiceDocumentReference>
</cac:BillingReference>
<cac:AccountingSupplierParty>
  <cac:Party>
    <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
    <cac:PostalAddress>
      <!-- street, city and postcode omitted from this fragment -->
      <cac:Country>
        <cbc:IdentificationCode>NL</cbc:IdentificationCode>
      </cac:Country>
    </cac:PostalAddress>
    <!-- VAT and legal entity details omitted from this fragment -->
  </cac:Party>
</cac:AccountingSupplierParty>

L'avoir corrigé a une cac:BillingReference qui nomme la facture EXAMPLE-INV-001 du 2026-09-08 ; l'avoir en échec n'en a pas. NL-R-001 est son seul constat : sans aucune référence de facturation, BR-55 n'a rien à examiner, et l'étape EN 16931 est réussie.

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 uniquement aux documents UBL CreditNote. Un document Invoice d'un vendeur néerlandais n'est pas contrôlé par cette règle.
  • Une règle nationale néerlandaise de Peppol BIS Billing 3.0, signalée à l'étape Peppol. Son application dépend uniquement du fait que l'adresse postale du vendeur se trouve aux Pays-Bas.
  • Le même vendeur néerlandais doit aussi respecter NL-R-003 pour son identifiant d'entité juridique et NL-R-007 pour les moyens de paiement lorsque l'acheteur a une somme à payer.
  • Dès qu'une référence de facturation est présente, EN 16931 la contrôle aussi : BR-55 rejette celle à laquelle manque le numéro de facture.

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-24.1 : source vérifiée le 2026-09-24, explication mise à jour le 2026-09-24.

La définition officielle de NL-R-001 (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.