ERP pela API
A partir do Premium
O teu ERP ou software de faturação vai buscar os registos de tempo através da API REST e comunica de volta que registos estão faturados. A sincronização delta só devolve o que mudou desde a última chamada; uma faturação marca os registos com o teu número de fatura e bloqueia-os. Ambos fazem parte do Premium.
- Como proprietário ou admin, cria em Definições, API e dispositivos um token com as abilities
readebilling. Só é mostrado uma vez. - Na primeira chamada, vai buscar todos os registos sem cursor e guarda
meta.next_cursorda resposta. - A partir daí pergunta sempre com o cursor guardado. Só recebes registos alterados, os eliminados com
deleted_atpreenchido. Se a API responder 410, o cursor tem mais de 90 dias: recomeça sem cursor e substitui a tua cópia. - Depois de faturar, cria uma faturação, primeiro com
"dry_run": truepara testar. Os registos ficam depois faturados e bloqueados.
Ir buscar registos de tempo, primeiro sem e depois com cursor:
curl "https://api.horaka.com/v1/time-entries/changes?cursor=0" -H "Authorization: Bearer O_TEU_TOKEN"
curl "https://api.horaka.com/v1/time-entries/changes?cursor=CURSOR" -H "Authorization: Bearer O_TEU_TOKEN"Clientes com os seus IDs, depois faturar tudo o que está em aberto de um cliente até ao fim do mês:
curl https://api.horaka.com/v1/clients -H "Authorization: Bearer O_TEU_TOKEN"
curl -X POST https://api.horaka.com/v1/billing-runs \
-H "Authorization: Bearer O_TEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filter": {"client_id": 4, "until": "2026-10-31"}, "invoice_ref": "RE-2026-0042", "dry_run": true}'Em vez de perguntar regularmente, o Horaka também pode avisar o teu ERP a cada alteração: cria um webhook em Definições, Webhooks. Cada campo, filtro e código de erro está descrito na documentação da API.