Cérès recouvrement

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

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
ChampObligatoireContenu
creancier.denomination, creancier.contact_emailouiL’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.denominationouiL’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_creancenoncommerciale, 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_creancierouitrue : 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_partenaireconseillé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).
commentairenonCe 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)
etatSignification
en_examenReçue, en cours d’examen par l’agence.
devis_envoyeLe créancier n’était pas encore client : un devis lui a été envoyé.
dossier_ouvertDossier de recouvrement ouvert : numéro, montant réclamé et montant recouvré.
termineDossier soldé ou clos.
refuseNon retenu (motif indiqué), ou devis refusé par le créancier.
retireRetiré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

AppelUsage
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