agency-time

GET `/v1/agency/time/unbilled`

What is outstanding, per client and currency.

Autentifikacija

Pošaljite API ključ kao bearer token. Ova krajnja točka ne navodi određenu dozvolu u specifikaciji, stoga dajte svom ključu najmanje što mu je potrebno i provjerite odgovor umjesto da pretpostavljate.

Gdje dolazi ID vaše organizacije

Ova krajnja točka uzima org_id kao parametar upita. Izostavite ga i poziv obuhvaćett cijelo stablo vašeg najma; pošaljite ga kako biste suzili poziv na jednu organizaciju.

ID vaše organizacije nalazi se na zaslonu API ključeva u vašoj nadzornoj ploči, pored samog ključa. To je isti ID u svakom pozivu koji uputite.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

curl -X GET https://api.zinndigital.com/v1/agency/time/unbilled \
  -H "Authorization: Bearer zdk_live_…"

Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

The same figure a threshold trigger fires on — one function, deliberately, because two implementations of "how much is outstanding" is how a client is shown £900 and invoiced £1,100. unpriced_minutes is reported separately from the money: hours logged against work with no rate card are not worth zero, they are unpriced, and an agency that cannot see them will not fix them. can_bill says whether the invoicing suite is reachable at all, so the console never offers a Bill-now button that can only refuse.

Parametri

Naziv	Vrsta	Obavezno	Što je to
`org_id (query)`	`string`	Ne	—
`client_id (query)`	`string`	Ne	—
`until (query)`	`string`	Ne	Only count work up to and including this date.

Odgovor

Naziv	Vrsta	Obavezno	Što je to
`data`	`UnbilledBucket[]`	Da	—
`can_bill`	`boolean`	Da	Whether the agency invoicing suite is reachable at all. Told to the console rather than discovered by pressing the button, so it never offers a Bill-now that can only refuse.
`billing_target`	`string<agency_invoicing, platform_checkout>`	Ne	Where Bill now sends the work. `platform_checkout` only for Zinn Digital®'s own organisation, whose client work is billed on Zinn®'s checkout (docs/670 §3).
`can_start_from_quote`	`boolean`	Ne	Whether this caller may list quote requests and start projects from them here — the issuer organisation AND the same `quotes.manage` staff permission the admin queue requires.
`can_manage_checkout_bills`	`boolean`	Ne	Whether this caller may send and void checkout bills here — the issuer organisation AND the same `billing.entitlement.manage` staff permission the admin console requires.

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 422