API partenaires Cérès
Transmettez à Cérès recouvrement, depuis votre logiciel, les factures que vos utilisateurs n’arrivent pas à se faire payer, puis suivez ce qu’elles deviennent. Cérès est une agence de recouvrement amiable déclarée (art. L. 124-1 et R. 124-1 et suivants du code des procédures civiles d’exécution) : chaque demande est examinée par l’agence (pièces, prescription, conflits d’intérêts) avant toute démarche auprès du débiteur, et aucune démarche n’a lieu sans convention signée avec le créancier.
Accès
- Adresse :
https://client.ceres-recouvrement.fr/api/v1 - Authentification : en-tête
Authorization: Bearer <votre clé>. La clé vous est remise par Cérès ; elle peut être révoquée à tout moment. - Format : JSON en UTF-8 (
Content-Type: application/json,Accept: application/json). Dates au formatAAAA-MM-JJ, montants TTC en euros. - Limites : 60 appels par minute et 300 envois (POST) par jour et par clé.
- Clé de test (
ceres_test_…) : tout fonctionne et est contrôlé comme en production, mais rien n’est enregistré chez Cérès. Les transmissions de test ne se mélangent pas aux vraies. Construisez votre intégration avec elle, puis demandez une clé de production.
Vérifier la clé
GET https://client.ceres-recouvrement.fr/api/v1/moi
Transmettre une facture impayée
POST https://client.ceres-recouvrement.fr/api/v1/transmissions
| Champ | Obligatoire | Contenu |
|---|---|---|
creancier.denomination, creancier.contact_email | oui | L’entreprise qui n’est pas payée (votre utilisateur) et l’adresse où Cérès la contacte. SIREN conseillé : un créancier déjà client de Cérès est reconnu par son SIREN, sinon par cette adresse. |
debiteur.denomination | oui | L’entreprise qui doit payer. SIREN, adresse, e-mail et téléphone conseillés. |
factures[] | oui (1 à 30) | numero, date_facture, echeance, montant_ttc, et deja_regle s’il y a eu un acompte. |
nature_creance | non | commerciale, transport, transport_cmr, sous_traitance, personne_publique (par défaut : commerciale). |
pieces[] | non (10 au plus) | PDF ou images de 10 Mo au plus : en JSON {"nom", "contenu_base64"}, ou en multipart (pieces[]). |
consentement_creancier | oui | true : vous confirmez que le créancier a lui-même demandé à confier ces factures à Cérès. Aucune démarche n’a lieu ensuite sans convention signée avec lui. |
reference_partenaire | conseillé | Votre propre référence. Renvoyer la même référence ne crée pas de doublon : la transmission déjà reçue est renvoyée (200). |
commentaire | non | Ce qu’il faut savoir (relances déjà faites, litige…). |
Exemple
{
"reference_partenaire": "INV-2026-0412",
"creancier": {
"denomination": "Menuiserie Exemple SARL",
"siren": "123456782",
"contact_nom": "Marie Durand",
"contact_email": "compta@menuiserie-exemple.fr",
"contact_telephone": "05 46 00 00 00",
"adresse": "12 rue des Artisans",
"code_postal": "17000",
"ville": "La Rochelle"
},
"debiteur": {
"denomination": "Garage Exemple SAS",
"siren": null,
"adresse": "8 rue de l'Exemple",
"code_postal": "17300",
"ville": "Rochefort",
"email": "contact@garage-exemple.fr"
},
"nature_creance": "commerciale",
"factures": [
{
"numero": "FA-2026-0412",
"date_facture": "2026-06-12",
"echeance": "2026-07-12",
"montant_ttc": 3000,
"deja_regle": 0
}
],
"commentaire": "Trois relances sans réponse.",
"pieces": [
{
"nom": "FA-2026-0412.pdf",
"contenu_base64": "JVBERi0xLjQK…"
}
],
"consentement_creancier": true
}
Réponse (201)
{
"reference": "9b2f1c4e-6a1d-4b8e-9f3a-2c5d7e8f9a01",
"reference_partenaire": "INV-2026-0412",
"recue_le": "2026-11-11T10:42:00+01:00",
"etat": "en_examen",
"libelle": "Reçu, en cours d’examen par l’agence",
"message": "Bien reçu : l’agence examine la demande avant toute démarche."
}
Gardez la reference : elle sert à suivre la transmission. En cas d’erreur de saisie, la réponse est 422 avec le détail champ par champ.
Suivre les transmissions
GET https://client.ceres-recouvrement.fr/api/v1/transmissions/{reference}
GET https://client.ceres-recouvrement.fr/api/v1/transmissions (les 100 dernières)
etat | Signification |
|---|---|
en_examen | Reçue, en cours d’examen par l’agence. |
devis_envoye | Le créancier n’était pas encore client : un devis lui a été envoyé. |
dossier_ouvert | Dossier de recouvrement ouvert : numéro, montant réclamé et montant recouvré. |
termine | Dossier soldé ou clos. |
refuse | Non retenu (motif indiqué), ou devis refusé par le créancier. |
retire | Retirée par vous avant l’ouverture du dossier. |
Par confidentialité, le suivi ne donne que l’état du dossier et les montants globaux, jamais le détail des échanges avec le débiteur.
Pendant le dossier
| Appel | Usage |
|---|---|
POST …/transmissions/{reference}/paiement-direct{"montant": 1200.00, "date": "2026-11-20", "commentaire": "…"} | Le débiteur a payé directement votre utilisateur : l’agence est prévenue aussitôt et ne relance plus pour cette somme. |
POST …/transmissions/{reference}/pieces{"pieces": [{"nom", "contenu_base64"}]} | Ajouter une pièce oubliée (bon de livraison, relance…). |
POST …/transmissions/{reference}/retrait{"motif": "…"} | Retirer la demande. Avant l’ouverture du dossier : retrait immédiat (200). Dossier déjà ouvert : l’agence est prévenue et revient vers le créancier (202). |
POST …/transmissions/{reference}/messages{"texte": "…"} | Un message pour l’agence. |
POST …/transmissions/{reference}/simuler{"etat": "dossier_ouvert"} | Clé de test seulement : faire passer une transmission par un état, pour essayer votre écran de suivi et vos webhooks. |
Webhooks
Plutôt que d’interroger le suivi, donnez une adresse : Cérès l’appelle quand une transmission change d’état (dossier ouvert, montant recouvré, soldé, refus…), dans les cinq minutes, et réessaie en cas d’échec.
PUT https://client.ceres-recouvrement.fr/api/v1/webhook {"url": "https://votre-app.fr/webhooks/ceres"}
→ {"url": "…", "secret": "whsec_…"} (le secret n’est montré qu’une fois ; une URL vide désactive)
Chaque appel est un POST JSON {"evenement": "transmission.mise_a_jour", "envoye_le": "…", "transmission": {…même contenu que le suivi…}}, avec les en-têtes X-Ceres-Evenement et X-Ceres-Signature: sha256=<HMAC-SHA256 du corps avec votre secret>. Vérifiez la signature avant de traiter l’appel, et répondez par un code 2xx.
Contact
Cérès recouvrement · contact@ceres-recouvrement.fr · 06 08 45 53 47