Self-billing via l'API

Self-billing de bout en bout via l'API PSB : les deux variantes, l'enregistrement et le choix entre NLCIUS et BIS.

Le self-billing (autofacturation) est le processus par lequel l'acheteur établit la facture au nom du fournisseur. Cela se rencontre dans les secteurs où l'acheteur peut calculer les montants livrés plus précisément que le fournisseur, par exemple dans le secteur de l'intérim ou pour les services externalisés. Le PSB prend en charge le self-billing en deux variantes, chacune avec ses propres caractéristiques techniques.

Deux variantes

Le PSB offre deux manières d'envoyer des factures self-billing via le réseau Peppol :

1. NLCIUS / SI-UBL 2.0 (simplifié)

Avec cette variante, vous modifiez uniquement le InvoiceTypeCode dans votre facture NLCIUS existante :

  • InvoiceTypeCode 389 pour une facture self-billing
  • InvoiceTypeCode 261 pour une note de crédit self-billing

Le CustomizationID et le ProfileID restent identiques à ceux d'une facture NLCIUS standard. Le PSB reconnaît automatiquement le type de document sur la base de l'InvoiceTypeCode et route le document correctement. Si le fournisseur est déjà enregistré pour la réception de factures NLCIUS standard, aucune inscription supplémentaire n'est nécessaire.

C'est la variante la plus simple, adaptée à la plupart des intégrations néerlandaises.

2. Peppol BIS Self-Billing 3.0

Il s'agit d'un profil Peppol distinct avec ses propres identifiants :

ChampValeurCustomizationIDurn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:selfbilling:3.0ProfileIDurn:fdc:peppol.eu:2017:poacc:selfbilling:01:1.0InvoiceTypeCode389 (facture) ou 261 (note de crédit)

Avec cette variante, le fournisseur doit être enregistré séparément dans le Peppol SMP pour la réception de documents self-billing. L'acheteur (expéditeur) envoie le document via l'endpoint Generic du PSB.

Utilisez cette variante si le fournisseur prend explicitement en charge le profil BIS Self-Billing 3.0, ou si le destinataire se trouve en dehors des Pays-Bas et n'accepte pas le NLCIUS.

Quelle variante choisir ?
SituationRecommandationFournisseur néerlandais, déjà enregistré pour NLCIUSNLCIUS (variante 1)Fournisseur international ou support explicite BIS Self-BillingBIS Self-Billing 3.0 (variante 2)Incertain sur les capabilities du fournisseurVérifiez via queryRecipientParty
Vérifier les capabilities

Avant d'envoyer une facture self-billing, vérifiez si le fournisseur peut recevoir le type de document souhaité :

GET /api/v1/queryRecipientParty?identifier={schemeID}:{id} HTTP/1.1
Host: psb.econnect.eu
Authorization: Bearer {access_token}

La réponse contient les types de documents supportés par le fournisseur. Vérifiez si le profil self-billing (BIS Self-Billing 3.0) ou le profil de facture standard (NLCIUS) est disponible.

Envoi et réception

Les détails techniques pour l'envoi et la réception de factures self-billing sont décrits dans des articles séparés :

Points d'attention pratiques
  • En self-billing, l'acheteur est l'auteur et l'expéditeur de la facture, tandis que le fournisseur est le destinataire. C'est l'inverse d'une facture standard.
  • Sur les versions PDF des factures self-billing, le texte "Factuur uitgereikt door afnemer" est obligatoire.
  • La fourniture en UBL est toujours préférable au PDF. En cas d'UBL invalide, un éventuel PDF joint est utilisé comme solution de repli.
  • L'élément AccountingSupplierParty contient les données du fournisseur (qui "reçoit" la facture), et non celles de l'acheteur qui l'établit.
Questions fréquentes
Quelle est la différence entre la variante NLCIUS et BIS Self-Billing 3.0 ?

Avec NLCIUS, vous modifiez principalement le InvoiceTypeCode en 389 (facture) ou 261 (avoir) ; CustomizationID et ProfileID restent identiques au NLCIUS standard. BIS Self-Billing 3.0 utilise des valeurs fixes de CustomizationID et ProfileID pour le profil self-billing et exige que le fournisseur soit enregistré dans le SMP pour ce profil ; l'envoi se fait via l'endpoint Generic.

Comment choisir la bonne variante ?

Pour un fournisseur néerlandais recevant déjà du NLCIUS, la variante NLCIUS est généralement la plus simple. Choisissez BIS Self-Billing 3.0 si le fournisseur prend en charge explicitement ce profil ou opère à l'international sans NLCIUS. En cas de doute, vous pouvez utiliser queryRecipientParty pour voir quels types de documents la contrepartie prend en charge.

À quoi faut-il faire attention avec le PDF et l'UBL en self-billing ?

La livraison UBL est privilégiée ; en cas d'UBL invalide, un PDF joint peut servir de solution de repli. Les versions PDF doivent comporter la mention obligatoire "Facture émise par l'acheteur". Dans le XML, AccountingSupplierParty reste le fournisseur (destinataire de la facture), même si c'est l'acheteur qui établit le document.


Le PSB gère automatiquement le routage et la validation des documents self-billing. L'implémentation technique diffère selon la variante, mais dans les deux cas, vous envoyez le document via l'API PSB et le fournisseur le reçoit via son enregistrement Peppol.

Ouvrir la référence API