agency-time

POST `/v1/agency/time/billing-runs`

Bill now — turn unbilled time into a draft invoice.

Uthibitishaji

Tuma ufunguo wa API kama tokeni ya kubeba. Sehemu hii ya mwisho haitaji ruhusa maalum katika maelezo, kwa hivyo ipe ufunguo wako kiwango cha chini kabisa kinachohitajika na uangalie jibu badala ya kukisia.

Mahali ambapo kitambulisho cha shirika lako huwekwa

Sehemu hii ya mwisho inachukua org_id kama uwanja katika mwili wa JSON.

Kitambulisho cha shirika lako kipo kwenye skrini ya funguo za API katika dashibodi yako, kando ya ufunguo wenyewe. Ni kitambulisho kile kile katika kila ombi unalofanya.

Jaribu

Badilisha chochote kilicho ndani ya mabano ya pembe na maadili yako mwenyewe, na kishikiliaji cha ufunguo na ufunguo kutoka kwa dashibodi yako.

curl -X POST https://api.zinndigital.com/v1/agency/time/billing-runs \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "client_id": <string>, "currency": <string> }'

Umeingia kwenye akaunti? Dashibodi yako ya kiweko cha API inajaza kitambulisho chako halisi cha shirika na ufunguo wako mwenyewe, na kuendesha ombi dhidi ya API ya moja kwa moja ili uweze kuona jibu halisi. Fungua sehemu hii ya mwisho (endpoint) kwenye konsole ya API

Maelezo

The owner's *"as well as sending on demand invoices"*. Claims the client's unbilled, priced work, hands it to the agency invoicing suite as a **draft**, and records what came back. ⛔ The entries are claimed in a committed transaction **before** the invoicing suite is called, so no other trigger can select them while the call is in flight. The idempotency key handed to the suite is derived from the sorted entry ids rather than minted, so a retry after a crash is given back the invoice that already exists instead of raising a second one for the same hours. `reconcile_state` is `ok` only when the invoice's total for these lines equals our own exact arithmetic. `mismatch` means do not send it.

Mwili wa ombi

Jina	Aina	Inayohitajika	Kilicho hiki
`client_id`	`string`	Ndiyo	—
`currency`	`string`	Ndiyo	—
`until`	`string`	Hapana	Bill work up to and including this date — "everything to the end of last month".
`notes`	`string`	Hapana	—
`org_id`	`string`	Hapana	—

Majibu

Jina	Aina	Inayohitajika	Kilicho hiki
`id`	`string`	Ndiyo	—
`client_id`	`string`	Hapana	—
`currency`	`string`	Ndiyo	—
`period_start`	`string`	Hapana	—
`period_end`	`string`	Hapana	—
`trigger`	`string<manual, on_log, day_of_month, threshold>`	Ndiyo	—
`status`	`string<claimed, invoiced, failed, released>`	Ndiyo	`claimed` is the state between claiming the time and the invoicing suite's reply — a process that dies there leaves one, and the recovery pass finishes it with the same derived…
`subtotal_minor`	`integer`	Ndiyo	Our own exact arithmetic, before tax. What the invoice is reconciled against.
`minutes_total`	`integer`	Ndiyo	—
`duration_label`	`string`	Hapana	—
`entry_count`	`integer`	Hapana	—
`fixed_line_count`	`integer`	Hapana	—
`invoice_id`	`string`	Hapana	—
`invoice_number`	`string`	Hapana	—
`invoice_created`	`boolean`	Hapana	FALSE means the invoicing suite's idempotency key fired and handed back an invoice an earlier attempt had already raised. Surfaced rather than hidden: it is the observable that…
`reconcile_state`	`string<pending, ok, mismatch, unavailable>`	Hapana	Whether the invoice's total for these lines equals our own arithmetic exactly. There is no "close enough": both sides compute from the same two integers, so any difference i…
`reconcile_detail`	`string`	Hapana	—
`invoiced_at`	`string`	Hapana	—
`released_at`	`string`	Hapana	—
`last_error`	`string`	Hapana	—
`created_at`	`string`	Ndiyo	—
`actual`	`object`	Hapana	What this run actually consumed, derived from the time entries rather than read off the run's stored columns — so a divergence is visible on the screen.

Hitilafu ambazo mwisho huu unaweza kurudisha

401 · 403 · 422