Récupérer des factures via l'API SOAP legacy : GetInboxDocuments, GetInboxDocument, gestion des statuts et téléchargement PDF.
Avec l'API SOAP legacy, vous récupérez les documents reçus par polling. Vous vérifiez périodiquement si de nouveaux documents se trouvent dans votre boîte de réception, vous les téléchargez et vous mettez à jour le statut. Cet article décrit le flux de réception complet.
Important : Ceci est l'API SOAP legacy. Pour les nouvelles intégrations, nous recommandons l'API REST. L'API REST propose des webhooks, ce qui vous évite de devoir faire du polling.
Appelez GetInboxDocuments avec le filtre CreatedOn.From pour ne récupérer que les nouveaux documents. Après chaque appel, enregistrez la valeur CreatedOn la plus élevée et utilisez-la comme point de départ pour la vérification suivante.
<GetInboxDocuments>
<Filter>
<CreatedOn>
<From>2026-03-01T00:00:00</From>
</CreatedOn>
</Filter>
</GetInboxDocuments>
La response contient les métadonnées de tous les documents de la boîte de réception. Filtrez sur Template/MasterId pour ne sélectionner que le type de document souhaité. Pour les factures standard, utilisez le MasterTemplateId :
GLDT9223370666504283001RA000000006DTP2000001
Utilisez toujours le MasterTemplateId et non un identifiant spécifique à une version, car celui-ci ne change pas lors des mises à jour de template.
Récupérez le payload complet de chaque document avec GetInboxDocument, en utilisant l'ExternalId de la liste de métadonnées :
<GetInboxDocument>
<ExternalId>het-external-id-uit-stap-1</ExternalId>
</GetInboxDocument>
Utilisez GetDocumentPdf pour récupérer la version PDF du document. Le PDF est retourné sous forme de chaîne encodée en base64.
Attention : si le PDF est encore en cours de génération, l'API retourne le code d'erreur ERRDMN8000003. Dans ce cas, attendez quelques secondes et réessayez.
Mettez à jour le statut du document avec SetInboxDocumentStatus. Cette étape est importante pour le flux de traitement et pour la visibilité du statut dans la plateforme.
La boîte de réception utilise les codes de statut suivants. Utilisez toujours le code (et non le nom) lors du filtrage et de la mise à jour.
Lors de la récupération de documents, vous pouvez utiliser différents filtres pour limiter les résultats :
ExternalIdCreatedOnModifiedOnSender / ReceiverTemplate/MasterIdStatusEn plus des documents inbox, vous pouvez également consulter vos propres documents envoyés. Utilisez pour cela GetOutboxDocuments et GetOutboxDocument. Le fonctionnement est comparable aux endpoints inbox, mais pour les documents que vous avez envoyés vous-même.
Pour les documents qui n'ont pas encore été envoyés (drafts), utilisez GetDocuments et GetDocument. Ces endpoints fonctionnent avec un DocumentId au lieu d'un ExternalId. Les drafts ont leurs propres codes de statut :
Intervalle : ne faites pas de polling plus d'une fois par minute. Pour la plupart des intégrations, une fois toutes les 5 à 15 minutes est suffisant.
Récupération incrémentale : enregistrez toujours la valeur CreatedOn la plus élevée et utilisez-la comme filtre From lors de l'appel suivant. Vous évitez ainsi de récupérer plusieurs fois les mêmes documents.
Détecter les changements de statut : utilisez le filtre ModifiedOn si vous souhaitez détecter quand le statut de documents existants a changé, par exemple après une approbation ou un paiement.
Avec l'API REST, le polling n'est pas nécessaire : les webhooks envoient automatiquement une notification dès qu'un nouveau document arrive. Consultez psb.econnect.eu pour l'approche moderne.
Passer à l'API REST