payroll

Cancel Expense Claim

Cancel a claim. A draft/submitted claim simply becomes cancelled; an approved one has its posting reversed through the guarded storno door first — VAT postings mirrored negated, the employee-payable open item cancelled.

body.posting_date dates that reversal; omitted, it reuses the approval's own posting date, and it is ignored for a claim that posted nothing. Refusals: 422 while the claim is fed into a payroll run (reverse the run first) or its open item carries live payment allocations (reverse the payment first); 409 when the reversal date falls in a filed/paid VAT period, or when the accounting period covering it is closed — re-send the cancel with a posting_date in an open VAT period to clear either.

post/companies/{company_id}/expenses/claims/{claim_id}/cancel

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}/expenses/claims/{claim_id}/cancel
  • Auth: none declared

Path parameters

company_idstring required
claim_idstring required

Headers

authorizationstring nullable

Cookies

access_tokenstring nullable

Request body

posting_datestring date nullable

Response

Successful Response

idstring required
employee_idstring required
claim_nointeger required
status'draft' | 'submitted' | 'approved' | 'rejected' | 'reimbursed' | 'cancelled' required

Expense-claim lifecycle (SP9; guide §5.5 "locked, auditable approval states"): immutable from approved on — corrections only via cancel (reverse) + a new claim.

reimburse_via'payroll' | 'ap' required

How an approved claim's employee-payable open item settles: fed to a payroll run (6000 line + clearing settlement, MASTER R5) or paid directly via e-banking + bank reconciliation (MASTER R21).

currencystring required
purposestring nullable required
total_grossstring required
reimbursable_grossstring required
submitted_atstring date-time nullable required
approved_atstring date-time nullable required
rejected_reasonstring nullable required
commercial_document_idstring nullable required
open_item_idstring nullable required
journal_entry_idstring nullable required
payroll_run_idstring nullable required
reimbursed_atstring date-time nullable required
created_atstring date-time required

Changes

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