agency-time

GET `/v1/agency/time/unbilled`

What is outstanding, per client and currency.

Hitelesítés

Küldjön egy API-kulcsot bearer tokenként. Ez a végpont nem határoz meg konkrét jogosultságot a specifikációban, ezért adja meg a kulcsnak a legkevesebbet, amire szüksége van, és a feltételezés helyett ellenőrizze a választ.

A szervezet azonosítójának helye

Ez a végpont a(z) org_id paramétert lekérdezési paraméterként várja. Hagyja ki, ha a hívás az Ön teljes bérlői részfáját lefedje; küldje el a hívás egyetlen szervezetre történő szűkítéséhez.

A szervezeted azonosítója a vezérlőpult API-kulcsok képernyőjén található, közvetlenül a kulcs mellett. Ez ugyanaz az azonosító minden indított hívásban.

Próbálja ki

Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.

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

Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban

Részletek

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.

Paraméterek

Név	Típus	Kötelező	Mi ez
`org_id (query)`	`string`	Nem	—
`client_id (query)`	`string`	Nem	—
`until (query)`	`string`	Nem	Only count work up to and including this date.

Válasz

Név	Típus	Kötelező	Mi ez
`data`	`UnbilledBucket[]`	Igen	—
`can_bill`	`boolean`	Igen	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>`	Nem	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`	Nem	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`	Nem	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.

Hibák, amelyeket ez a végpont visszaadhattatlan

401 · 403 · 422