API de Integración Contable

Obtén rendiciones aprobadas de forma segura

Consulta gastos y paquetes contables de una sola empresa mediante un token Bearer. Leer datos no marca un gasto como contabilizado.

Descargar Especificación OpenAPI 3.1

Inicio Rápido

El administrador crea el único token activo desde el panel de ERP.
Guárdalo de forma segura como secreto de servidor.
Prueba la conectividad llamando a GET /me.
Consume /changes y conserva el cursor tras procesar cada lote.

Autenticación

Envía el token en cabecera HTTP estándar exclusivamente mediante HTTPS:

curl https://api.indexpense.com/api/public/v1/me \
  -H "Authorization: Bearer ixp_live_..."

Importante: El token se genera y muestra una sola vez. Nunca lo incluyas en URLs públicas, código frontend, aplicaciones móviles ni registros de trazas de logs.

Probar Credencial

La respuesta HTTP aparecerá aquí tras presionar el botón.

Endpoints Disponibles (v1)

GET /api/public/v1/me

Información de la empresa, aplicación conectada, permisos autorizados y vencimiento.

GET /api/public/v1/expenses?limit=100&cursor=...

Listado de gastos con aprobación final. Los importes decimales se entregan como texto para máxima precisión.

GET /api/public/v1/expenses/{id}

Detalle completo de un gasto particular perteneciente a la empresa vinculada al token.

GET /api/public/v1/exports

Listado de paquetes preparados y su estado de procesamiento contable.

GET /api/public/v1/changes?cursor=...

Feed incremental de documentos de integración para sincronización continua.

GET /api/public/v1/integration-results/{exportId}

Referencias y estados devueltos por el ERP sin credenciales ni payloads confidenciales.

Permisos y Alcance (Scopes)

Scope	Acceso Concedido
`expenses:read`	Consulta de gastos con aprobación contable final
`exports:read`	Consulta de paquetes preparados para integración
`integration-status:read`	Consulta incremental de cambios y estados de envío

Paginación y Manejo de Respuestas

El cursor entregado es opaco y determinístico. Repetir una página con el mismo cursor es una operación segura e idempotente. Códigos de respuesta: 401 para token inválido o revocado, 403 para falta de permisos, 404 para recurso no encontrado, 429 por tasa de solicitudes y 5xx para errores del servidor.

{
  "data": [],
  "nextCursor": null,
  "hasMore": false
}