Rendiciones API
API pública para integrar Rendiciones con ERP y otros sistemas. Autenticación con una llave de API (Configuración → API e integraciones) en el header Authorization: Bearer rk_live_…. Límite: 120 peticiones por minuto por llave. Montos como texto decimal; fechas en ISO 8601.
get/api/v1/expenses
expenses:read
Lista gastos. Ordenados del más reciente al más antiguo. Permiso: expenses:read.
| Parámetro | En | Tipo | Descripción |
|---|---|---|---|
cursor | consulta | string | Cursor devuelto como nextCursor en la página anterior. |
limit | consulta | integer | Entre 1 y 200. Por defecto 50. |
from | consulta | string | Fecha del gasto desde (incluida). |
to | consulta | string | Fecha del gasto hasta (incluida). |
status | consulta | string: unreported | DRAFT | SUBMITTED | RETURNED | APPROVED | REJECTED | PAID | Estado de la rendición del gasto, o unreported si no está en ninguna. |
ExpensePage
data | array<ExpenseOut> | |
nextCursor | string | null |
Errores: 400 parámetros inválidos · 401 llave inválida, revocada o vencida · 403 falta el permiso · 404 no existe en tu empresa · 429 demasiadas peticiones (ver Retry-After).
get/api/v1/reports
reports:read
Lista rendiciones. Ordenadas por última actualización. Permiso: reports:read.
| Parámetro | En | Tipo | Descripción |
|---|---|---|---|
cursor | consulta | string | Cursor devuelto como nextCursor en la página anterior. |
limit | consulta | integer | Entre 1 y 200. Por defecto 50. |
status | consulta | string: DRAFT | SUBMITTED | RETURNED | APPROVED | REJECTED | PAID | |
updatedFrom | consulta | string | Actualizadas desde esta fecha. |
ReportPage
data | array<ReportOut> | |
nextCursor | string | null |
Errores: 400 parámetros inválidos · 401 llave inválida, revocada o vencida · 403 falta el permiso · 404 no existe en tu empresa · 429 demasiadas peticiones (ver Retry-After).
get/api/v1/reports/{id}
reports:read
Detalle de una rendición con sus gastos. Permiso: reports:read.
| Parámetro | En | Tipo | Descripción |
|---|---|---|---|
id * | ruta | string |
ReportDetailOut
id | string | |
number | integer | Ej. 12 |
title | string | |
status | string | DRAFT | SUBMITTED | RETURNED | APPROVED | REJECTED | PAID |
userId | string | |
total | string | Ej. 185500.00 |
approvedTotal | string | null | |
submittedAt | string | null | |
approvedAt | string | null | |
paidAt | string | null | |
updatedAt | string | |
expenses | array<ExpenseOut> |
Errores: 400 parámetros inválidos · 401 llave inválida, revocada o vencida · 403 falta el permiso · 404 no existe en tu empresa · 429 demasiadas peticiones (ver Retry-After).
post/api/v1/reports/{id}/mark-exported
reports:write
Marca una rendición como importada por el ERP. Queda en el historial de la rendición y en la bitácora. Permiso: reports:write.
| Parámetro | En | Tipo | Descripción |
|---|---|---|---|
id * | ruta | string |
Cuerpo (JSON, opcional): reference (string) — Identificador del comprobante en el ERP.
ExportedOut
ok | boolean | |
reportId | string |
Errores: 400 parámetros inválidos · 401 llave inválida, revocada o vencida · 403 falta el permiso · 404 no existe en tu empresa · 429 demasiadas peticiones (ver Retry-After).
get/api/v1/users
users:read
Lista personas. Sin datos bancarios ni de seguridad. Permiso: users:read.
UserOut[]
id | string | |
email | string | |
name | string | |
rut | string | null | |
position | string | null | |
role | string | ADMIN | FINANCE | APPROVER | EMPLOYEE |
active | boolean | |
managerId | string | null | |
costCenterCode | string | null |
Errores: 400 parámetros inválidos · 401 llave inválida, revocada o vencida · 403 falta el permiso · 404 no existe en tu empresa · 429 demasiadas peticiones (ver Retry-After).
get/api/v1/catalog
catalog:read
Categorías (con cuenta contable), centros de costo y monedas. Permiso: catalog:read.
CatalogOut
categories | array<object> | Ej. [{"id":"uuid","name":"Alimentación","glAccount":"5101-01","active":true}] |
costCenters | array<object> | Ej. [{"id":"uuid","code":"COM","name":"Comercial","active":true}] |
currencies | array<object> | Ej. [{"code":"USD","name":"Dólar estadounidense","rate":"948.500000","active":true}] |
Errores: 400 parámetros inválidos · 401 llave inválida, revocada o vencida · 403 falta el permiso · 404 no existe en tu empresa · 429 demasiadas peticiones (ver Retry-After).