ERP a través de la API
Desde Premium
Tu ERP o programa de facturación recoge los registros de tiempo a través de la API REST e informa de qué registros están facturados. La sincronización delta solo devuelve lo que ha cambiado desde la última llamada; un ciclo de facturación marca los registros con tu número de factura y los bloquea. Ambas cosas forman parte de Premium.
- Como propietario o administrador, añade un token con los permisos
readybillingen Ajustes, API y dispositivos. Solo se muestra una vez. - En la primera llamada, recoge todos los registros sin cursor y guarda
meta.next_cursorde la respuesta. - A partir de ahí, pregunta siempre con el cursor guardado. Solo recibes los registros modificados; los eliminados, con
deleted_atinformado. Si la API responde 410, el cursor tiene más de 90 días: empieza de nuevo sin cursor y sustituye tu copia. - Tras facturar, crea un ciclo de facturación, primero con
"dry_run": truepara probarlo. Después los registros quedan facturados y bloqueados.
Recoger registros de tiempo, primero sin cursor y después con él:
curl "https://api.horaka.com/v1/time-entries/changes?cursor=0" -H "Authorization: Bearer TU_TOKEN"
curl "https://api.horaka.com/v1/time-entries/changes?cursor=CURSOR" -H "Authorization: Bearer TU_TOKEN"Clientes con sus ID y, después, facturar todo lo abierto de un cliente hasta final de mes:
curl https://api.horaka.com/v1/clients -H "Authorization: Bearer TU_TOKEN"
curl -X POST https://api.horaka.com/v1/billing-runs \
-H "Authorization: Bearer TU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filter": {"client_id": 4, "until": "2026-10-31"}, "invoice_ref": "RE-2026-0042", "dry_run": true}'En lugar de preguntar con regularidad, Horaka también puede avisar a tu ERP de cada cambio: añade un webhook en Ajustes, Webhooks. Todos los campos, filtros y códigos de error se describen en la documentación de la API.