Stable Pro API · v1
Stable Pro API
Lee los hechos económicos de una cuadra — cargos, correcciones, cobros, saldos a favor, recibos — para emitir las facturas con tu propio programa.
Stable Pro es el programa de gestión de las cuadras. Lleva los hechos económicos de cada cuadra: lo que debe cada cliente (los cargos), cada corrección de esos importes (las correcciones), el dinero cobrado y el devuelto (los cobros), el saldo a favor de los clientes y los recibos de Stable Pro.
La API permite a los programas de facturación y contabilidad leer esos hechos y emitir sus propios documentos: facturas, facturas rectificativas, declaraciones fiscales. Stable Pro nunca emite documentos fiscales: los emite tu programa. Un solo contrato para cada programa y cada país: no hay un módulo para un programa concreto, ni un campo que valga solo para un país.
Qué puedes construir
- Facturación: lee un cargo, emite la factura; lee una corrección, emite una factura rectificativa; lee un cobro, marca la factura como pagada.
- Sincronización: lee el registro de eventos (
GET /events) desde tu cursor guardado y procesa lo que ha cambiado desde la última vez. - Conciliación: lee las listas filtradas por cliente o por mes contable y compáralas con tu contabilidad.
Para empezar
- El titular de la cuadra crea una conexión en Stable Pro (Ajustes → Conexiones) y te da su clave. Una clave de prueba empieza por
sp_test_y funciona en staging, con datos de prueba (consulta Entorno de pruebas). - Llama a la API con la clave:
curl https://staging.stable-pro.com/api/v1/organization \
-H "Authorization: Bearer sp_test_…"
- Lee la historia de la cuadra desde el principio y luego sigue leyendo desde tu cursor:
curl "https://staging.stable-pro.com/api/v1/events?limit=100" \
-H "Authorization: Bearer sp_test_…"
Cada evento apunta a un objeto (data.url): léelo, procésalo y guarda next_cursor cuando termines la página.
URL base
| Entorno | URL base | Claves |
|---|---|---|
| Producción | https://app.stable-pro.com/api/v1 | sp_live_… |
| Staging, con datos de prueba | https://staging.stable-pro.com/api/v1 | sp_test_… |
Para seguir leyendo
- Autenticación y permisos
- Convenciones: importes, fechas, códigos, listas y filtros, idiomas
- Eventos: cómo mantenerse sincronizado
- Errores
- Referencia: cada endpoint y cada campo, generados a partir del contrato OpenAPI