Aperçu du Procurement Service Bus (PSB) API d'eConnect : architecture, fonctionnalités et types de documents.
Le Procurement Service Bus (PSB) est la passerelle API centrale d'eConnect qui vous permet d'envoyer, de recevoir et de traiter des factures électroniques, des commandes et d'autres documents électroniques. Le PSB connecte votre logiciel au réseau Peppol et à d'autres réseaux de facturation électronique via une API REST moderne sécurisée par OAuth2.
Que vous soyez un éditeur de logiciels souhaitant intégrer la facturation électronique, ou une organisation cherchant à automatiser ses flux documentaires, le PSB offre l'infrastructure nécessaire pour le faire de manière fiable et évolutive.
Le PSB est bien plus qu'un simple canal d'envoi. C'est une plateforme complète de traitement de documents électroniques, couvrant l'ensemble du processus purchase-to-pay.
La facturation électronique est au cœur du système. Via l'API, vous envoyez des factures de vente aux destinataires sur le réseau Peppol et recevez des factures d'achat de vos fournisseurs. Le PSB achemine automatiquement les documents vers le bon Access Point et confirme la livraison avec des mises à jour de statut en temps réel.
La commande électronique va au-delà de la facturation. Le PSB prend en charge l'envoi et la réception de commandes, de confirmations de commande, de modifications et d'annulations. Par défaut, seules les commandes Peppol sont prises en charge (Order Only et Advanced Ordering) ; les messages DICO (y compris le message de maintenance) sont disponibles le cas échéant, et les commandes Coupa (cXML) sur demande. L'order-flip (conversion d'une commande en facture en une seule action) n'est pas une fonctionnalité PSB ; elle est exclusivement disponible sur la plateforme Collabrr.
Le self-billing permet de créer et d'envoyer des factures au nom d'un fournisseur. Cela concerne les organisations qui établissent elles-mêmes les factures d'achat sur la base de marchandises ou de services reçus.
La validation offre un endpoint autonome permettant de vérifier la conformité de documents XML sans les envoyer. L'API Validate reconnaît automatiquement le format du document, le teste contre les artefacts les plus récents et fournit un retour détaillé et multilingue par règle de validation.
La transformation convertit des documents d'un format de facturation électronique à un autre. Vous livrez dans le format que votre logiciel produit et le PSB se charge automatiquement de la bonne conversion vers le destinataire. Le PSB prend en charge plus de 20 standards, dont UBL 2.1, NLCIUS, Peppol BIS Billing V3, PINT, CII, XRechnung, Factur-X/ZUGFeRD, FatturaPA, ebInterface, Svefaktura, e-FFF, OIOUBL, Finvoice, ISDOC et des formats sectoriels comme DICO, SETU et SEEF. Le format est détecté automatiquement lors de l'upload ; vous n'avez pas besoin d'indiquer quel format vous livrez.
Validated Party Data (VPD) est une API GraphQL permettant de consulter et de vérifier les données de parties. Vérifiez si un numéro KvK, OIN ou TVA correspond bien à une organisation donnée avant d'envoyer une facture. Dans In Control, la même fonctionnalité est connue sous le nom commercial Purple Pages.
Intelligent Document Recognition (IDR) convertit des factures PDF en XML structuré via OCR et IA. L'IDR est directement pilotable via l'API PSB, avec des niveaux de qualité et des priorités configurables.
Le PSB est construit sur le modèle Actor au sein d'un cluster Microsoft Azure Service Fabric. Cela peut sembler technique, mais les avantages sont concrets : les documents sont traités en parallèle sur plusieurs serveurs, sans attendre les uns les autres. En cas de panne d'un serveur, le traitement se poursuit automatiquement sur un autre nœud, sans perte de données.
En pratique, cela signifie un temps de traitement inférieur à 100 millisecondes par document à l'envoi, une capacité éprouvée de 200 000 messages par heure et une disponibilité de 99,99 % (plus de huit ans sans interruption non planifiée).
Le PSB opère en tant que Peppol Access Point avec plusieurs Access Points dans la configuration standard. Le volume est réparti dynamiquement via des files d'attente fiables. Chaque tenant est logiquement isolé : il est techniquement impossible d'accéder aux documents d'un autre tenant. Le PSB s'exécute sur Microsoft Azure (régions Pays-Bas et Irlande) ; tout le traitement des données a lieu au sein de l'UE/EEE.
Avec une seule intégration API, vous accédez à plusieurs réseaux. Le PSB achemine automatiquement les documents vers le bon canal en fonction du destinataire.
Le PSB est préparé pour la directive européenne ViDA (VAT in the Digital Age), qui rend les Digital Reporting Requirements (DRR) obligatoires pour les transactions B2B transfrontalières à compter du 1er juillet 2030. Lors de l'envoi d'une facture, le PSB génère automatiquement le résumé DRR à partir des données de la facture et le transmet à l'administration fiscale compétente. En tant qu'intégrateur, vous n'avez rien de plus à faire : vous envoyez votre facture via l'API habituelle et le PSB gère la déclaration.
Le PSB implémente pour cela le modèle Peppol 5-corner, dans lequel l'Access Point assure le reporting CTC (Continuous Transaction Controls) pour le compte de l'expéditeur. Les messages de statut, les fichiers de preuve et les messages de reporting CTC sont inclus dans le prix du document, sans frais supplémentaires par message.
Le PSB fonctionne de manière événementielle. Au lieu de vérifier périodiquement s'il y a de nouveaux documents, vous pouvez configurer des webhooks qui notifient directement votre application lors d'événements pertinents : une facture reçue, une facture livrée avec succès, une erreur d'envoi, une Invoice Response du destinataire.
Les hooks prennent en charge plusieurs types d'actions : webhooks HTTPS, notifications par e-mail, push SFTP, et même le traitement par lots où les documents sont proposés périodiquement sous forme d'archive ZIP. Chaque type de hook est sécurisé par des signatures HMAC SHA256.
Le PSB utilise OAuth 2.0 pour l'authentification, avec la prise en charge des flux Client Credentials et Resource Owner Password Credentials. Toutes les communications s'effectuent via TLS 1.2 ou supérieur. Les uploads binaires sont automatiquement analysés contre les virus et les malwares, et les documents XML sont validés selon des jeux de règles standard.
Chaque tenant opère dans un environnement logiquement isolé. Le PSB est approuvé par des clients sous supervision DNB et traite des documents pour plus de 20 000 organisations.
L'API REST PSB (v1) est organisée autour des groupes d'endpoints suivants :
La documentation complète des endpoints avec les formats de requête et de réponse est disponible sous forme de Swagger UI interactif. Le fichier swagger.json correspondant peut être téléchargé pour générer du code client.
Vous êtes prêt à commencer ? Les articles ci-dessous vous guident, de la demande d'un compte de test à votre premier appel API.
Le PSB propose des endpoints pour la facturation électronique (envoi et réception), la commande électronique, le self-billing, la validation, la transformation, les données de parties (VPD) et la reconnaissance PDF (IDR). Avec une seule intégration API, vous accédez à Peppol et à d'autres réseaux de procurement tels que Coupa et SAP Ariba.
Le PSB traite les documents en moins de 100 millisecondes à l'envoi, avec une capacité avérée de 200 000 messages par heure. La disponibilité est de 99,99 %, avec plus de huit ans sans interruption non planifiée.
Le PSB utilise OAuth 2.0 pour l'authentification, avec prise en charge des flux Client Credentials et Resource Owner Password Credentials. Toutes les communications s'effectuent via TLS 1.2 ou supérieur.
Vous livrez dans le format que votre logiciel produit. Le PSB détecte automatiquement le format du document et le transforme vers le format attendu par le destinataire. Plus de 20 standards sont pris en charge, dont UBL, NLCIUS, BIS Billing V3, PINT, CII, XRechnung, Factur-X, FatturaPA et des formats sectoriels comme DICO et SETU. Vous n'avez pas besoin de vous soucier du format du destinataire.
Le PSB est ViDA-ready. Lors de l'envoi d'une facture, le PSB génère automatiquement le résumé DRR (Digital Reporting Requirement) à partir des données de la facture et le transmet à l'administration fiscale compétente. En tant qu'intégrateur, vous n'avez rien de plus à faire. Les messages de statut, les fichiers de preuve et les messages de reporting CTC sont inclus dans le prix du document.
Consulter la documentation API interactive