開立折讓

開立折讓證明單(G0401),用於不能作廢原發票的銷貨退回或折讓。

POSThttps://invoice.workat.studio/api/v1/allowances

Header

名稱值
X-Api-Key、X-Timestamp、X-Nonce、X-Signature簽章驗證,算法見簽章算法
Content-Typeapplication/json

請求內容

欄位型別說明
invoice_numberstring必填原發票號碼,例如 KZ10000000
external_idstring ≤ 64選填你的系統的單號,同一間公司不可重複
prices_include_taxboolean選填單價與金額是否含稅,預設 true
itemsarray,1–9999 項必填折讓明細
items[].original_sequenceinteger選填對應原發票明細的序號(從 1 開始);有填時品名與單位沿用原發票
items[].descriptionstring ≤ 500條件必填品名;沒有填 original_sequence 時必填
items[].quantitynumber > 0必填數量
items[].unit_pricenumber ≥ 0必填單價
items[].amountnumber ≥ 0選填折讓金額,預設為數量 × 單價
items[].unitstring ≤ 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 + 日期 + 當日流水號
statusissued 排隊中(等原發票存證)、sent 已交給 Turnkey、uploaded 平台已確認、failed 上傳失敗(見 upload_error)
total_amount/tax_amount不含稅金額合計/營業稅額合計;grand_total 為兩者相加(含稅折讓總額)
items[].unit_price不含稅單價

錯誤

狀態碼原因
401/403/429見錯誤回應
422欄位格式錯誤、找不到原發票、原發票已作廢、原明細序號不存在、折讓金額超過可折讓餘額