POST/cpro/factures/v1/telecharger/groupe

Télécharger des factures (PDF)

Télécharger le PDF d'une ou plusieurs factures. La réponse est en JSON : fichierResultat contient le fichier en base64, soit un PDF, soit une archive ZIP contenant les PDF.

Marre de gérer PISTE, les certificats et le XML ? Chorus Pay gère tout le flux à votre place - devis accepté, bon de commande, facture déposée sur Chorus Pro.Découvrir Chorus Pay →·Comparer les deux approches

Authentification multiple requise

TOUTES REQUISES

Ce point de terminaison nécessite toutes les méthodes d'authentification suivantes :

Token Bearer

OAuth2 Bearer token

En-tête personnalisé

Chorus Pro account credentials

En-tête requis

cpro-account: base64(login:password)
Comment s'authentifier

Incluez votre token Bearer dans l'en-tête Authorization :

Authorization: Bearer YOUR_API_TOKEN

Vous pouvez obtenir votre token API depuis votre tableau de bord.

Comment s'authentifier

Incluez l'en-tête personnalisé dans votre requête :

cpro-account: base64(login:password)

Paramètres du corps

ParamètreRequisDescription
idUtilisateurCourant
Type: number
RequisChorus Pro identifier of the technical user.
format
Type: string
RequisOutput format, "PDF".
avecPiecesJointesComplementaires
Type: string
Requis"Oui" or "Non". See the note on TRA_MSG_00.007 above.
listeFacture
Type: array
RequisInvoices to download, each as { idFacture } (the identifiantFactureCPP).

Exemple de corps de requête

{
  "idUtilisateurCourant": 50467405,
  "idEspace": 0,
  "format": "PDF",
  "avecPiecesJointesComplementaires": "Non",
  "listeFacture": [{ "idFacture": 611078020 }]
}

Réponses

Loading...
Loading...

⚠️ Constaté sur le terrain

  • Observé en production (01/10/2026) : le codeRetour 20006 / TRA_MSG_00.007 « Le SMA est indisponible ou a remonté une erreur » n'est pas toujours une panne générale. Sur deux factures, il est revenu à chaque essai pendant 40 heures (61 échecs) avec avecPiecesJointesComplementaires: "Non", alors que toutes les autres factures du même fournisseur se téléchargeaient normalement dans les mêmes minutes. La même requête avec avecPiecesJointesComplementaires: "Oui" a renvoyé aussitôt le PDF de la facture (2 pages, même document).
  • Avec "Oui", la réponse est en général un ZIP (22 factures vérifiées en recette le 01/10/2026, la production a renvoyé un PDF seul pour le même fournisseur). Dedans, les pièces jointes complémentaires gardent leur nom d'origine (RIB_REVOLUT.pdf, KBIS.pdf…), une facture déposée en PDF garde aussi le sien (facture_F-2026-183.pdf), et Chorus ajoute ses propres fichiers : PJ00FAC<…><numéro de facture>.pdf pour la facture qu'il a générée (factures saisies, SAISIE_API), PJ00XFAC<…>.pdf pour le duplicata Factur-X. Ne jamais prendre « le premier PDF » ni un nom qui contient FAC : prendre PJ00FAC, sinon PJ00XFAC.
  • consulter/fournisseur liste les pièces jointes (listeDesPiecesJointes : type, désignation, extension) mais pas leurs noms de fichier, il ne permet donc pas de les retrouver dans l'archive.
  • Règle pratique : sur un 20006, réessayer une fois avec "Oui" avant d'attendre le retour du service.