開立折讓
開立折讓證明單(G0401),用於不能作廢原發票的銷貨退回或折讓。
POSThttps://invoice.workat.studio/api/v1/allowances
- 什麼時候用:銷貨退回或折讓,且不能作廢原發票時(例如發票所屬的期別已經結束)。同一期內的整張退貨,請直接作廢發票。
- 一張折讓證明單對應一張原發票,買方就是原發票的買方。
- 金額預設含稅(與開立發票相同,
prices_include_tax)。系統依 MIG 規定拆成「不含稅金額(整數)」與「營業稅額(整數,四捨五入)」;零稅率、免稅的發票稅額為 0。
- 折讓總額(含稅)不能超過原發票總計扣除已開立、未作廢的折讓,超過回應
422。
- 財政部平台必須先有原發票:原發票還在上傳中時,折讓會先排隊(
status 為 issued),原發票存證成功後由系統自動送出。
- 帶
external_id(例如退貨單號)可避免重複開立:同一個值重送時回傳第一次開立的折讓證明單(200)。
- 依統一發票使用辦法,折讓須經買受人同意;請保留同意紀錄,或列印折讓證明單請買方簽收。
| 名稱 | 值 |
X-Api-Key、X-Timestamp、X-Nonce、X-Signature | 簽章驗證,算法見簽章算法 |
Content-Type | application/json |
請求內容
| 欄位 | 型別 | | 說明 |
invoice_number | string | 必填 | 原發票號碼,例如 KZ10000000 |
external_id | string ≤ 64 | 選填 | 你的系統的單號,同一間公司不可重複 |
prices_include_tax | boolean | 選填 | 單價與金額是否含稅,預設 true |
items | array,1–9999 項 | 必填 | 折讓明細 |
items[].original_sequence | integer | 選填 | 對應原發票明細的序號(從 1 開始);有填時品名與單位沿用原發票 |
items[].description | string ≤ 500 | 條件必填 | 品名;沒有填 original_sequence 時必填 |
items[].quantity | number > 0 | 必填 | 數量 |
items[].unit_price | number ≥ 0 | 必填 | 單價 |
items[].amount | number ≥ 0 | 選填 | 折讓金額,預設為數量 × 單價 |
items[].unit | string ≤ 6 | 選填 | 單位 |
範例
{
"invoice_number": "KZ10000000",
"external_id": "RETURN-20261105-001",
"items": [
{ "original_sequence": 1, "quantity": 2, "unit_price": 25 }
]
}
回應
201 Created(同一個 external_id 重送時為 200 OK)
{
"data": {
"allowance_number": "AL202611050001",
"allowance_date": "2026-11-05",
"invoice_number": "KZ10000000",
"invoice_date": "2026-10-04",
"status": "sent",
"void": null,
"external_id": "RETURN-20261105-001",
"seller_ban": "85426409",
"buyer_ban": null,
"tax_amount": 2,
"total_amount": 48,
"grand_total": 50,
"items": [
{ "sequence": 1, "original_sequence": 1, "description": "綠茶", "quantity": 2, "unit_price": 23.8095238,
"amount": 48, "tax": 2, "tax_type": "1" }
]
}
}
| 欄位 | 說明 |
allowance_number | 折讓證明單號碼:AL + 日期 + 當日流水號 |
status | issued 排隊中(等原發票存證)、sent 已交給 Turnkey、uploaded 平台已確認、failed 上傳失敗(見 upload_error) |
total_amount/tax_amount | 不含稅金額合計/營業稅額合計;grand_total 為兩者相加(含稅折讓總額) |
items[].unit_price | 不含稅單價 |
錯誤
| 狀態碼 | 原因 |
401/403/429 | 見錯誤回應 |
422 | 欄位格式錯誤、找不到原發票、原發票已作廢、原明細序號不存在、折讓金額超過可折讓餘額 |