POST/cpro/factures/v1/rechercher/fournisseur

Lister les factures

Renvoie une liste de factures pour le fournisseur. Les résultats sont paginés.

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
typeFacture
Type: string
RequisType of invoice (FACTURE, AVOIR).
numeroFacture
Type: string
OptionnelInvoice number to search for (numeroFactureSaisi at submission). ⚠️ Must be at the ROOT of the body : inside rechercheFactureParFournisseur the gateway answers HTTP 400 « properties which are not allowed by the schema ». Re-check the match on your side, the search may be broader than the criterion.
rechercheFactureParFournisseur.nbResultatsParPage
Type: number
OptionnelNumber of results per page (200 is a safe value).
rechercheFactureParFournisseur.pageResultatDemandee
Type: number
OptionnelPage number, starting at 1.

Exemple de corps de requête

{
  "typeFacture": "FACTURE",
  "numeroFacture": "F001",
  "rechercheFactureParFournisseur": {
    "nbResultatsParPage": 50,
    "pageResultatDemandee": 1
  }
}

Réponses

Loading...
Loading...

⚠️ Constaté sur le terrain

  • Vérifié dans le bac à sable (09/09/2026) : pour rechercher par numéro de facture, placez numeroFacture à la RACINE du corps, à côté de typeFacture : dans le bloc rechercheFactureParFournisseur, la passerelle le refuse en HTTP 400 « object instance has properties which are not allowed by the schema: [numeroFacture] » (numeroFactureSaisi n'est pas un critère de recherche, même 400).
  • « Aucun résultat » n'est pas une erreur : HTTP 200 avec codeRetour 20002 / GDP_MSG_11.046 et pas de listeFactures.
  • Chaque élément de listeFactures porte identifiantFactureCPP, numeroFacture, codeDestinataire, statut, dateFacture, dateDepot, montantHT / montantTTC / montantAPayer, codeServiceExecutant… Cette recherche est le seul moyen de savoir si un soumettre terminé en 504 a réellement créé la facture (voir « Soumettre une facture PDF »).
  • Filtres, tous à la RACINE du corps (vérifié le 09/09/2026) : periodeDateDepotDu / periodeDateDepotAu (AAAA-MM-JJ, inclus) fonctionnent et sont le moyen pratique de retrouver une facture dont on ignore le numéro (numérotation attribuée par Chorus) ; numeroBonCommande est accepté ; codeDestinataire est REFUSÉ (400), filtrez le destinataire de votre côté. Dans le bloc de pagination, tout filtre de date est refusé (400). Les résultats arrivent du plus récent au plus ancien par défaut ; triColonne n'accepte qu'une liste fermée de colonnes (TypeDemandePaiement, CodeFournisseur…) sans dateDepot.
  • Ordre, constaté en production (12/09/2026, fournisseur à 4 370 factures) : les lignes arrivent à peu près par identifiantFactureCPP décroissant (les plus récentes d'abord) mais PAS strictement : parmi les 4 014 lignes des 20 premières pages de 200, 11 lignes avaient un CPP plus petit que des factures totalement absentes de ces pages. Ne pas déduire « au-delà des pages lues » d'une comparaison de CPP ; mémoriser par facture ce qui a déjà été vérifié.
  • typeFacture est une partition stricte : un avoir (AVOIR) n'apparaît jamais dans la liste FACTURE et inversement, un fournisseur avec des avoirs demande donc les deux recherches (la liste AVOIR tient en général sur une page : l'interroger en premier quand on arrête la pagination dès que tout ce qu'on suit est trouvé).