ERP tramite l'API
Da Premium
Il tuo ERP o software di fatturazione prende le registrazioni tramite la REST API e comunica quali registrazioni sono fatturate. Il delta sync restituisce solo ciò che è cambiato dall'ultima chiamata; un ciclo di fatturazione contrassegna le registrazioni con il tuo numero di fattura e le blocca. Entrambi sono inclusi in Premium.
- Come titolare o admin, crea un token con le ability
readebillingin Impostazioni, API e dispositivi. Viene mostrato una sola volta. - Alla prima chiamata prendi tutte le registrazioni senza cursore e conserva
meta.next_cursordalla risposta. - Da quel momento chiedi sempre con il cursore salvato. Ricevi solo le registrazioni modificate, quelle eliminate con
deleted_atvalorizzato. Se l'API risponde 410, il cursore ha più di 90 giorni: ricomincia senza cursore e sostituisci la tua copia. - Dopo la fatturazione crea un ciclo di fatturazione, prima con
"dry_run": trueper provare. Le registrazioni risultano poi fatturate e bloccate.
Prendere le registrazioni, prima senza, poi con cursore:
curl "https://api.horaka.com/v1/time-entries/changes?cursor=0" -H "Authorization: Bearer IL_TUO_TOKEN"
curl "https://api.horaka.com/v1/time-entries/changes?cursor=CURSOR" -H "Authorization: Bearer IL_TUO_TOKEN"Clienti con i loro ID, poi fatturare tutto l'aperto di un cliente fino a fine mese:
curl https://api.horaka.com/v1/clients -H "Authorization: Bearer IL_TUO_TOKEN"
curl -X POST https://api.horaka.com/v1/billing-runs \
-H "Authorization: Bearer IL_TUO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"filter": {"client_id": 4, "until": "2026-10-31"}, "invoice_ref": "RE-2026-0042", "dry_run": true}'Invece di chiedere regolarmente, Horaka può anche avvisare il tuo ERP a ogni modifica: crea un webhook in Impostazioni, Webhook. Ogni campo, filtro e codice di errore è descritto nella documentazione API.