/cpro/factures/v1/rechercher/fournisseurLister les factures
Renvoie une liste de factures pour le fournisseur. Les résultats sont paginés.
Authentification multiple requise
TOUTES REQUISESCe point de terminaison nécessite toutes les méthodes d'authentification suivantes :
OAuth2 Bearer token
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_TOKENVous 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ètre | Requis | Description |
|---|---|---|
typeFacture Type: string | Requis | Type of invoice (FACTURE, AVOIR). |
numeroFacture Type: string | Optionnel | Invoice 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 | Optionnel | Number of results per page (200 is a safe value). |
rechercheFactureParFournisseur.pageResultatDemandee Type: number | Optionnel | Page number, starting at 1. |
Exemple de corps de requête
{
"typeFacture": "FACTURE",
"numeroFacture": "F001",
"rechercheFactureParFournisseur": {
"nbResultatsParPage": 50,
"pageResultatDemandee": 1
}
}Réponses
⚠️ 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é).
/cpro/factures/v1/rechercher/fournisseurLister les factures
Renvoie une liste de factures pour le fournisseur. Les résultats sont paginés.
Authentification multiple requise
TOUTES REQUISESCe point de terminaison nécessite toutes les méthodes d'authentification suivantes :
OAuth2 Bearer token
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_TOKENVous 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ètre | Requis | Description |
|---|---|---|
typeFacture Type: string | Requis | Type of invoice (FACTURE, AVOIR). |
numeroFacture Type: string | Optionnel | Invoice 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 | Optionnel | Number of results per page (200 is a safe value). |
rechercheFactureParFournisseur.pageResultatDemandee Type: number | Optionnel | Page number, starting at 1. |
Exemple de corps de requête
{
"typeFacture": "FACTURE",
"numeroFacture": "F001",
"rechercheFactureParFournisseur": {
"nbResultatsParPage": 50,
"pageResultatDemandee": 1
}
}Réponses
⚠️ 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é).