Skip to content

Create Receipt

Description

開立發票。

同一訂單於同一機台 5 分鐘內重複請求時: - 前一次請求已開立完成:回傳同一張發票號碼,不會重新開立。 - 前一次請求仍在處理中:回傳 400、code 為 1123(訂單處理中,請稍後再試)。

Resource

POST /v2/receipt

Authorization

採用 OAuth 2.0 Bearer Token,詳細使用流程請參考 Auth Login。

Request Body Parameters

Name Type Description
shop_id string 門市編號
order_id string 訂單編號
request_invoice string 索取發票
amount integer 開立金額
tax integer 應稅金額
pos_id string 機號
(optional)
start_month string 起始年月
(optional)
tax_id_number string 客戶統編
(optional)
donation_code string 捐贈碼
(optional)
buyer_type string 買方載具類別
(optional)
buyer_number string 買方載具編號
(optional)
credit_card_no string 信用卡卡號末4碼
(optional)

Request

{
  "shop_id": "000030",
  "order_id": "00003021090300001",
  "request_invoice": "1",
  "amount": 20,
  "tax": 20,
  "pos_id": "K1",
  "start_month": "202109",
  "tax_id_number": "",
  "donation_code": "",
  "buyer_type": "",
  "buyer_number": "",
  "credit_card_no": ""
}

Response Body Parameters

Name Type Description
receipt_no string 發票號碼

Response

{
  "receipt_no": "VH10001577"
}