Construire votre propre intégration avec le PSB eConnect

Aperçu des méthodes de connexion pour les développeurs : API REST, SFTP et HTTPS. Avec des liens directs vers la documentation PSB.

Votre logiciel ne figure pas dans la liste des connexions prêtes à l'emploi, ou vous développez vous-même une application qui doit envoyer et recevoir des factures via Peppol ? Vous pouvez alors intégrer directement le Procurement Service Bus (PSB) d'eConnect. Le PSB est le système technique derrière toutes les connexions eConnect, accessible via psb.econnect.eu. La plateforme eConnect (platform.econnect.eu) est l'interface client où vous créez notamment vos clés de connexion et gérez vos paramètres. Le PSB propose trois méthodes de connexion : une API REST moderne, SFTP et HTTPS.

Méthodes de connexion

Le choix optimal dépend de votre architecture, de vos exigences de sécurité et du volume prévu. Pour chaque méthode, la documentation technique est disponible sur le portail de développement PSB.

API REST

La méthode la plus utilisée pour les nouvelles intégrations. L'API REST du PSB offre des endpoints pour l'envoi, la réception et la gestion des factures, des commandes et des réponses. L'authentification s'effectue via OAuth2, avec deux flows disponibles : Resource Owner Password Credentials et Client Credentials. Les tokens sont demandés via POST /connect/token sur identity.econnect.eu. Un header Subscription-Key peut optionnellement être inclus pour un accès spécifique à l'organisation.

Adaptée pour : applications SaaS, applications web, microservices et architectures modernes.

Documentation : PSB API & Swagger UI : documentation API interactive, spécification OpenAPI et Swagger Editor.

SFTP

Échange de fichiers via une connexion SFTP sécurisée. Le PSB prend en charge deux flux : From SFTP (récupération périodique de fichiers depuis votre serveur SFTP) et To SFTP (envoi de documents vers votre serveur à la réception). Les deux flux sont configurés via des hooks SFTP dans le PSB.

Adapté pour : environnements d'entreprise avec traitement par lots, systèmes ERP comme SAP et Unit4 ERP CR.

Documentation : PSB API & hooks : recherchez les hooks SFTP dans les endpoints Hook.

HTTPS

Une connexion HTTPS directe pour l'échange de factures. Le PSB reçoit des documents via HTTPS POST et les livre via des webhooks ou HTTPS inbound. Prend en charge le filtrage IP et OAuth2.

Adapté pour : connexions d'entreprise avec des exigences de sécurité spécifiques.

Documentation : PSB API & webhooks : HTTPS inbound/outbound et configuration des webhooks.

Technique : Le PSB communique en interne via le protocole Peppol AS4 avec d'autres Access Points. Il ne s'agit pas d'une méthode de connexion que vous choisissez en tant que client ; elle est utilisée automatiquement lorsque vous envoyez des factures via Peppol.

De quoi avez-vous besoin ?

Pour toute intégration avec le PSB, vous avez besoin de :

  • Un compte eConnect avec au minimum un abonnement Professional pour SFTP et HTTPS (les intégrations sur mesure nécessitent un abonnement Enterprise)
  • Identifiants OAuth2 (client_id et client_secret) pour l'API REST du PSB
  • Pour les protocoles d'entreprise : une subscription key via le service commercial
Commencer

La façon la plus rapide de démarrer est via l'API REST : ouvrez psb.econnect.eu, explorez la Swagger UI et effectuez votre premier appel API. Vous trouverez plus d'explications dans la section API & intégration de cette documentation.

Pour les connexions SFTP ou HTTPS, contactez le service commercial d'eConnect pour un entretien d'accueil. Au cours de cet entretien, les détails techniques, le volume prévu et les exigences de sécurité seront discutés. Les spécifications techniques se trouvent dans la documentation de l'API PSB.

Conseil : vous développez une intégration pour un logiciel utilisé par plusieurs clients ? Contactez alors l'équipe partenaires d'eConnect. En tant que partenaire, vous pouvez construire la connexion une seule fois et la rendre disponible pour tous vos clients.


Prêt à commencer ? Ouvrez la documentation de l'API PSB ou lisez l'aperçu du PSB pour plus de contexte.

Consultez la documentation API