Stable Pro API

Stable Pro è il gestionale delle scuderie. Tiene i fatti economici di ogni scuderia: cosa deve ogni cliente (gli addebiti), ogni correzione a quegli importi (le correzioni), il denaro incassato e quello restituito (gli incassi), il credito dei clienti e le ricevute di Stable Pro.

L'API permette ai programmi di fatturazione e di contabilità di leggere quei fatti ed emettere i propri documenti: fatture, note di credito, dichiarazioni fiscali. Stable Pro non emette mai documenti fiscali: li emette il tuo programma. Un solo contratto per ogni programma e ogni paese: non c'è un modulo per un programma particolare, né un campo che valga per un paese solo.

Cosa puoi costruire

• Fatturazione: leggi un addebito, emetti la fattura; leggi una correzione, emetti una nota di credito; leggi un incasso, segna la fattura come pagata.
• Sincronizzazione: leggi il registro delle novità (GET /events) dal cursore che hai salvato, ed elabora cosa è cambiato dall'ultima volta.
• Riconciliazione: leggi gli elenchi filtrati per cliente o per mese contabile e confrontali con la tua contabilità.

Per cominciare

1. Il titolare della scuderia crea un collegamento in Stable Pro (Impostazioni → Collegamenti) e ti consegna la sua chiave. Una chiave di prova comincia con sp_test_ e funziona sullo staging, con dati di prova (vedi Ambiente di prova).
2. Chiama l'API con la chiave:

curl https://staging.stable-pro.com/api/v1/organization \
  -H "Authorization: Bearer sp_test_…"

1. Leggi la storia della scuderia dall'inizio, poi continua a leggere dal tuo cursore:

curl "https://staging.stable-pro.com/api/v1/events?limit=100" \
  -H "Authorization: Bearer sp_test_…"

Ogni novità punta a un oggetto (data.url): leggilo, elaboralo, e salva next_cursor quando hai finito la pagina.

Indirizzi di base

Da leggere poi

• Autenticazione e permessi
• Convenzioni: importi, date, codici, elenchi e filtri, lingue
• Novità: come restare allineati
• Errori
• Riferimento: ogni endpoint e ogni campo, generati dal contratto OpenAPI