Introduction à l'API

Piloter votre recouvrement depuis vos propres outils (CRM, ERP, scripts) grâce à l'API REST publique Société Recouvrement.

Une API pour vos outils

L'API REST publique permet d'intégrer et piloter votre recouvrement depuis vos propres outils (CRM, ERP, scripts internes) : créer des débiteurs et des factures, lancer et suivre les dossiers, répondre aux actions, déclarer des paiements.

URL de base : https://api.rec-societe.com/api/v1/public — Format JSON (UTF-8), dates ISO 8601.

💡 Si vous utilisez Pennylane, une intégration prête à l'emploi existe déjà, sans aucune ligne de code.

Les concepts

Concept	Description
Débiteur	L'entreprise ou le particulier qui vous doit de l'argent. Porte les coordonnées et contacts.
Facture	Une créance rattachée à un dossier : montants, échéance, PDF justificatif.
Dossier (case)	L'unité de recouvrement. Créé en statut `DRAFT`, il ne démarre jamais tout seul : le workflow ne commence qu'au lancement explicite (`POST /cases/{id}/launch`).
Stock	Les factures « en réserve » (dossier `STOCK`) : suivies mais sans relances.
Action	Une décision attendue de votre part : contestation, échéancier, paiement déclaré, validation d'escalade.
Escalade	Le passage d'une étape de relance à la suivante (1 → 2 → 3 → 4).

Prochaines étapes

Questions fréquentes

À qui s'adresse l'API ?+

Aux utilisateurs ayant des compétences techniques (ou accompagnés d'un développeur) qui veulent connecter leurs propres outils. Si vous utilisez Pennylane, une intégration prête à l'emploi existe déjà, sans code.

L'API est-elle incluse dans mon abonnement ?+

L'accès API est inclus dans les abonnements payants, à partir du palier Access TPE. Il n'est pas disponible sur le palier gratuit (FREE).

Quelle est l'URL de base de l'API ?+

https://api.rec-societe.com/api/v1/public — les échanges sont en JSON (UTF-8), avec des dates au format ISO 8601.

Dernière mise à jour : 22/07/2026

PrécédentMon Wallet Suivant Créer et gérer mes clés API