作廢折讓
作廢一張折讓證明單(G0501)。
POSThttps://invoice.workat.studio/api/v1/allowances/{allowanceNumber}/void
- 作廢時間以呼叫當下為準。財政部平台必須先收到折讓證明單才能接受作廢;折讓還在上傳中時會先排隊(
void.status為pending),存證成功後由系統自動送出。 - 重複呼叫不會重複作廢。
- 原發票開立過折讓時,要先作廢所有折讓,才能作廢原發票。
請求內容
| 欄位 | 型別 | 說明 | |
|---|---|---|---|
reason | string,1–20 字 | 必填 | 作廢原因,會上傳財政部 |
remark | string ≤ 200 | 選填 | 備註,會上傳財政部 |
回應
200 OK 回傳折讓資料,void 為作廢資訊(voided_at、reason、remark、status)。
void.status:pending 排隊中、sent 已交給 Turnkey、uploaded 平台已確認、failed 上傳失敗。
錯誤
| 狀態碼 | 原因 |
|---|---|
404 | 折讓證明單不存在,或不屬於你的公司 |
422 | 缺少作廢原因或長度超過 |