meta {
  name: Cancel Salary Advance
  type: POST
  body: none
}

headers {
  Authorization: Bearer {{token}}
  X-Company-Id: {{company_uuid}}
  Accept: application/json
}

url: {{base_url}}/api/v1/payroll/salary-advances/{{advance_id}}/cancel

note: |
  Allowed from draft, pending_approval and approved. A paid advance cannot be
  cancelled — the money is gone, so it must settle or carry forward (409).
  Cancelling frees the amount back into the month's headroom.