agency-time

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

Bill now — turn unbilled time into a draft invoice.

ავტორიზაცია

API გასაღები გაგზავნეთ როგორც bearer token. ეს ენდპოინტი სპეციფიკაციაში არ მიუთითებს კონკრეტულ ნებართვას, ამიტომ მიანიჭეთ თქვენს გასაღებს მინიმალური საჭირო უფლებები და ვარაუდის ნაცვლად შეამოწმეთ პასუხი.

სwhere your organisation id goes-ის ადგილი

ესენდპოინტი იღებს org_id-ს JSON ტანის ველად.

თქვენი ორგანიზაციის ID მითითებულია თქვენი სამართავი პანელის API გასაღებების ეკრანზე, თავად გასაღებთან ახლოს. ის ერთნაირია თქვენ მიერ განხორციელებულ ყველა გამოძახებაში.

სცადეთ

შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.

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> }'

შესული ხართ? თქვენი სამართავ პანელში არსებული API კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი API კონსოლში

დეტალები

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.

მოთხოვნის სხეული

სახელი	ტიპი	სავალდებულო	რა არის ეს
`client_id`	`string`	დიახ	—
`currency`	`string`	დიახ	—
`until`	`string`	არა	Bill work up to and including this date — "everything to the end of last month".
`notes`	`string`	არა	—
`org_id`	`string`	არა	—

პასუხი

სახელი	ტიპი	სავალდებულო	რა არის ეს
`id`	`string`	დიახ	—
`client_id`	`string`	არა	—
`currency`	`string`	დიახ	—
`period_start`	`string`	არა	—
`period_end`	`string`	არა	—
`trigger`	`string<manual, on_log, day_of_month, threshold>`	დიახ	—
`status`	`string<claimed, invoiced, failed, released>`	დიახ	`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`	დიახ	Our own exact arithmetic, before tax. What the invoice is reconciled against.
`minutes_total`	`integer`	დიახ	—
`duration_label`	`string`	არა	—
`entry_count`	`integer`	არა	—
`fixed_line_count`	`integer`	არა	—
`invoice_id`	`string`	არა	—
`invoice_number`	`string`	არა	—
`invoice_created`	`boolean`	არა	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>`	არა	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`	არა	—
`invoiced_at`	`string`	არა	—
`released_at`	`string`	არა	—
`last_error`	`string`	არა	—
`created_at`	`string`	დიახ	—
`actual`	`object`	არა	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.

შეცდომები, რომლებიც ამ ენდპოინტს შეუძლია დააბრუნოს

401 · 403 · 422

POST /v1/agency/time/billing-runs