payroll

Run Payroll Run With Ai

Enqueue on-demand AI execution of this run (ai-on-demand plan §D2/D3).

Only enqueues an ai_task row (202) — the ai-tasks worker drives calculate→validate→approve→post with the JE stamped origin=ai; poll GET …/ai-tasks/{task_id} for the outcome. 422 unless the run is draft/calculated/approved; 409 while an AI task for this run is already active (ConflictError passes through _tx to the global handler). mark-paid and lock stay human.

post/companies/{company_id}/payroll/runs/{run_id}/run-with-ai

Request

  • Base URL: https://app.zeno-works.ch (the document declares no server; this is the origin it was published from)
  • URL: https://app.zeno-works.ch/companies/{company_id}/payroll/runs/{run_id}/run-with-ai
  • Auth: none declared

Path parameters

company_idstring required
run_idstring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Request body

posting_datestring date nullable

Response

Successful Response

idstring required
kind'payroll_run' | 'ar_draft' | 'period_close' | 'fixed_asset_review' | 'statement_review' required

Which "Run with AI" flow an ai_task row executes.

payroll_run — advance a draft payroll run calculate→approve→post; ar_draft — draft + ready an outgoing AR invoice from an instruction; period_close — run the close checks + the autopost accrual sweep; fixed_asset_review — apply the recognition settings to a fiscal year's asset inventory, post its due depreciation, accept the year's unambiguous held capitalization proposals, and (under auto only) finalize the review. statement_review — produce the AI-accountant narrative assessment for one statement-review finding (doc/pipeline.md §Statement review); the verdict stays deterministic, the task only explains and proposes.

status'pending' | 'processing' | 'done' | 'failed' required

Queue lifecycle of an ai_task row (doc/architecture.md §"Work queue").

pending → processing on claim (heartbeat claimed_at), then a terminal done/failed; the stuck-row sweep returns abandoned processing rows to pending.

target_idstring nullable
payloadobject required
resultunknown
errorstring nullable
requested_bystring nullable
created_atstring date-time required
finished_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.