Résoudre les codes d'erreur Peppol avec D Soft

Sien Jans
il y a 7 jours
3 min de lecture

Les développeurs qui connectent notre solution Peppol reçoivent de nombreux commentaires via des notifications d'état et des codes d'erreur. Vous trouverez ci-dessous un aperçu des messages d'erreur courants, comment les reconnaître et les mesures à prendre. Tous les exemples sont basés sur les processus décrits sur notre page Peppol.

Approche générale du débogage

Vérifiez le format du document : les validations sont effectuées conformément à la norme EN 16931/Peppol BIS. Un IBAN manquant ou un code TVA incorrect entraîne rapidement une erreur.
Vérifiez vos données SMP : le registre détermine les types de documents que vous pouvez recevoir. Si de nouveaux processus ne sont pas encore enregistrés, vous recevrez un rejet. Utilisez ce lien pour valider vos documents : https://ecosio.com/en/peppol-e-invoice-xml-document-validator/ (choisissez Openpeppol UBL Invoice/Creditnote)
Utilisez DocTrails monitoring : notre solution affiche des messages d'état afin que les développeurs puissent voir exactement à quel niveau du modèle à 4 niveaux l'erreur s'est produite.

Codes d'erreur fréquents

Champs obligatoires manquants

Cette erreur se produit lorsqu'un champ obligatoire (par exemple, « cbc:ID » ou « cbc:EndpointID ») est manquant. Le validateur du point d'accès interrompt l'envoi.

Solution : vérifiez le mappage dans votre ERP ou votre connecteur d'intégration. Remplissez le champ et renvoyez le message.

Numéro CBE invalide

Ce message s'affiche lorsque le numéro CBE ne respecte pas la structure requise (10 chiffres) ou ne correspond pas à celui indiqué dans le SMP.

Solution : validez le numéro CBE via les données de base ERP. Si le numéro a récemment changé, demandez à nos consultants de mettre à jour le SMP.

Valeur de liste de codes incorrecte

Peppol utilise des listes de codes fixes pour les codes TVA, les codes pays et les types de documents. Une valeur inconnue entraîne un rejet.

Solution : remplacez la valeur par un code autorisé (par exemple, « S » pour la TVA standard). Consultez la documentation sur notre page Peppol ou dans DocTrails.

ID Peppol incorrect

Si votre participant n'est pas trouvé dans le SMP ou si votre jeton JWT lié à notre API a expiré, vous recevrez ce message.

Solution : vérifiez que l'ID Peppol (= numéro CBE) est correct et que l'enregistrement du participant est actif.

Destinataire inaccessible

Ce statut apparaît lorsque le point d'accès du destinataire est inaccessible ou lorsque le type de document n'est pas autorisé pour cette partie.

Solution : vérifiez auprès du client s'il prend en charge le type de document. Notre service SMP peut éventuellement l'enregistrer rapidement pour vous.

Règle commerciale bloquée

DocTrails peut contenir des règles personnalisées (par exemple, mention obligatoire du bon de commande). Si une règle échoue, cette erreur apparaît.

Solution : vérifiez dans DocTrails quelle règle a échoué. Ajoutez les informations manquantes ou modifiez la règle via le portail de gestion.

Bonnes pratiques pour les développeurs

Nouvelles tentatives automatiques : renvoyez les documents en cas d'erreur réseau temporaire, mais limitez le nombre de nouvelles tentatives à trois.
Journalisation + identifiants de corrélation : utilisez le même identifiant que dans DocTrails afin que le service d'assistance puisse retrouver rapidement le message.
Environnement de test : utilisez notre environnement d'acceptation pour valider les nouveaux mappages avant de passer en production.
Utilisez notre liste de contrôle : combinez cet article avec la liste de contrôle Peppol Readiness Checklist 2026 pour déterminer si votre configuration est prête.