Validateur SBDH PEPPOL

Validateur d'enveloppe SBDH (Standard Business Document Header) côté client. Vérifie sender / receiver ICD, document type, process ID PEPPOL BIS 3.0, RFC 3339, présence du payload — sans envoyer la moindre donnée à un serveur.

Comment ça marche

SBDH (Standard Business Document Header) est l'enveloppe XML normalisée par ISO/IEC 9735 et profilée par UN/CEFACT puis par GS1 XML 3.0 pour encapsuler un document métier (UBL Invoice, UBL CreditNote, EDIFACT INVOIC…) pendant son transport. Sur le réseau OpenPEPPOL, chaque document échangé entre Access Points via AS4 est emballé dans un <StandardBusinessDocument> qui transporte :

• Les identifiants ISO 6523 du sender et du receiver (ex. 0192:991825827).
• La nature exacte du payload (Standard URI, TypeVersion, Type local).
• Un GUID d'instance (InstanceIdentifier) pour la traçabilité.
• Le BusinessScope DOCUMENTID et PROCESSID PEPPOL.

Le pipeline du validateur :

1. Parsing XML (DOMParser côté navigateur, fast-xml-parser fallback).
2. Recherche de la racine StandardBusinessDocument.
3. Extraction de chaque bloc d'en-tête (Sender, Receiver, DocumentIdentification, BusinessScope).
4. Application des contrôles ci-dessous.

Règles vérifiées

• Élément racine : StandardBusinessDocument (préfixe libre). Le namespace canonique est http://www.unece.org/cefact/namespaces/StandardBusinessDocumentHeader — un namespace différent déclenche un avertissement, pas une erreur.
• HeaderVersion : doit valoir exactement 1.0 (SBDH 1.3 reste sur le tag 1.0). Toute autre valeur ou absence déclenche une erreur bloquante.
• Sender / Receiver : au moins un de chaque, avec <Identifier> non vide. Le scheme ICD (préfixe avant le :) est confronté à la liste ISO 6523 ci-dessous ; un ICD non reconnu déclenche un avertissement.
• DocumentIdentification : les cinq champs Standard, TypeVersion, InstanceIdentifier, Type, CreationDateAndTime sont obligatoires. CreationDateAndTime doit être au format RFC 3339 (YYYY-MM-DDThh:mm:ssZ ou avec offset).
• BusinessScope : PEPPOL exige deux entrées <Scope> — l'une de type DOCUMENTID, l'autre de type PROCESSID. L'absence de l'une ou de l'autre déclenche un avertissement. Les InstanceIdentifier au format urn:peppol:bis:… sont confrontés à la liste embarquée.
• Loopback : si Sender et Receiver portent exactement la même valeur, un avertissement est émis (configuration souvent involontaire en intégration).
• Présence du payload : un élément métier doit suivre le <StandardBusinessDocumentHeader> ; un StandardBusinessDocument sans corps déclenche un avertissement.

Schémas ISO 6523 ICD supportés

La liste suivante couvre les ICD activement utilisés sur le réseau OpenPEPPOL. Le registre OASIS complet contient ~250 codes ; nous en embarquons les 68 principaux pour la reconnaissance et l'étiquetage.

Identifiants PEPPOL BIS 3.0 reconnus

Le validateur reconnaît les identifiants courants de la suite PEPPOL BIS 3.0 et leur attache un libellé :

• urn:peppol:bis:billing:3.0:invoice — Invoice.
• urn:peppol:bis:billing:3.0:creditnote — CreditNote.
• urn:peppol:bis:ordering:3.0:order — Order.
• urn:peppol:bis:ordering:3.0:orderresponse — OrderResponse.
• urn:peppol:bis:despatch:3.0:despatchadvice — DespatchAdvice.
• urn:peppol:bis:catalogue:3.0:catalogue — Catalogue.
• urn:peppol:bis:mlr:3.0:mlr — Message Level Response.

Côté process :

• urn:peppol:bis:billing:3.0 — Process Billing 3.0.
• urn:peppol:bis:ordering:3.0 — Process Ordering 3.0.
• urn:peppol:bis:despatch:3.0 — Process Despatch 3.0.

Limites

• Pas de validation XSD complète de l'enveloppe — uniquement les règles listées ci-dessus. Le schéma officiel StandardBusinessDocumentHeader.xsd est strict sur quelques cardinalités secondaires que nous ne couvrons pas.
• Pas de validation du payload wrappé. Si le corps est un UBL Invoice, utilisez Validateur UBL 2.1 ou Validateur PEPPOL en aval.
• Pas de vérification de signature ni de chaîne TLS — l'enveloppe est examinée en clair, sans couche AS4.

Confidentialité

Documentation associée

• UBL / PEPPOL — la vue d'ensemble du réseau OpenPEPPOL.
• PEPPOL BIS Billing 3.0 — la spécification de référence pour les factures sur PEPPOL.
• PEPPOL Code Lists — la liste à jour des document type IDs et process IDs.
• UN/CEFACT SBDH 1.3 — le schéma XSD officiel et son guide d'implémentation.