Stable Pro API · v1
Stable Pro API
Lisez les faits économiques d'une écurie — débits, corrections, encaissements, crédits, reçus — pour émettre les factures dans votre propre logiciel.
Stable Pro est le logiciel de gestion des écuries. Il tient les faits économiques de chaque écurie : ce que doit chaque client (les débits), chaque correction de ces montants (les corrections), l'argent encaissé et l'argent remboursé (les encaissements), le crédit des clients et les reçus de Stable Pro.
L'API permet aux logiciels de facturation et de comptabilité de lire ces faits et d'émettre leurs propres documents : factures, avoirs, déclarations fiscales. Stable Pro n'émet jamais de documents fiscaux : c'est votre logiciel qui les émet. Un seul contrat pour chaque logiciel et chaque pays : il n'y a pas de module pour un logiciel particulier, ni de champ valable pour un seul pays.
Ce que vous pouvez construire
- Facturation : lire un débit, émettre la facture ; lire une correction, émettre un avoir ; lire un encaissement, marquer la facture comme payée.
- Synchronisation : lire le journal des événements (
GET /events) à partir de votre curseur enregistré, et traiter ce qui a changé depuis la dernière fois. - Rapprochement : lire les listes filtrées par client ou par mois comptable et les comparer avec votre comptabilité.
Pour commencer
- Le titulaire de l'écurie crée une connexion dans Stable Pro (Paramètres → Connexions) et vous remet sa clé. Une clé de test commence par
sp_test_et fonctionne sur le staging, avec des données de test (voir Environnement de test). - Appelez l'API avec la clé :
curl https://staging.stable-pro.com/api/v1/organization \
-H "Authorization: Bearer sp_test_…"
- Lisez l'historique de l'écurie depuis le début, puis continuez à lire depuis votre curseur :
curl "https://staging.stable-pro.com/api/v1/events?limit=100" \
-H "Authorization: Bearer sp_test_…"
Chaque événement pointe vers un objet (data.url) : lisez-le, traitez-le, et enregistrez next_cursor quand la page est terminée.
URL de base
| Environnement | URL de base | Clés |
|---|---|---|
| Production | https://app.stable-pro.com/api/v1 | sp_live_… |
| Staging, avec des données de test | https://staging.stable-pro.com/api/v1 | sp_test_… |
À lire ensuite
- Authentification et autorisations
- Conventions : montants, dates, codes, listes et filtres, langues
- Événements : rester synchronisé
- Erreurs
- Référence : chaque endpoint et chaque champ, générés à partir du contrat OpenAPI