Skip to content

Checkout Tickets

Description

核銷票券。

Resource

POST /v1/ticket/checkout

Authorization

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

Request Body Parameters

Name Type Description
status string 狀態
ALLOWED VALUES:
  • CONFIRM
  • CANCEL
ticket_check_out_password string 票券核銷密碼
(option)
checkout_data_list CheckoutData 核銷資料列表

Request Body Parameters - CheckoutData

Name Type Description
vip_id string 會員編號
shop_id string 門市代號
ticket_id string 異動單據號碼
input_date string 異動日期
type string 異動類型
ALLOWED VALUES:
  • 0：銷貨
  • 1：銷退
  • 2：補登
  • 3：反銷退
user_id string 異動人員
vip02_list Vip 貴賓預繳資料列表
vippoint_list Point 點數歷程列表
vippresale_list PreSale 補銷貨單資料列表
tick_list Ticket 票券資料列表
vipstamp_list Stamp 集章歷程

Request Body Parameters - Vip

Name Type Description
vip_id string 會員編號
shop_id string 門市代號
ticket_id string 異動單據號碼
store_kind string 預繳類型
ALLOWED VALUES:
  • 1：消費新增
  • 2：銷退減少
  • 3：點數兌換商品
input_date string 銷售日期
last_balance float 上期結存
store_deal float 本期預繳
store_balance float 本期結存
crt_date string 建檔日期
crt_user string 建檔人員代號
memo string 備註
store_amt float 實繳金額
isexec string 計算執行過
exec_date string 執行時間
online_upt string 連線執行
issend string 拋轉ERP
transfer_status string 傳輸標誌
last_update string 傳輸異動日

Request Body Parameters - Point

Name Type Description
vip_id string 會員編號
shop_id string 門市代號
ticket_id string 異動單據號碼
input_date string 單據日期
point_type string 點數異動類型
ALLOWED VALUES:
  • 1：消費新增
  • 2：銷退減少
  • 3：點數兌換商品
  • 4：點數兌換商品銷退
  • 5：點數轉出
  • 6：點數轉入
  • Z：點數歸零
bonuspt_point string 點數
crt_date string 建檔日期
crt_user string 建檔人員
isexec string 計算執行過
exec_date string 執行時間
online_upt string 連線執行
issend string 拋轉ERP
transfer_status string 傳輸標誌
last_update string 傳輸異動日
deadline string 有效期限
group_id string 原銷單號碼
gift_vipid string 點數轉換貴賓編號

Request Body Parameters - PreSale

Name Type Description
shop_id string 門市代號
vip_id string 會員編號
pay_id string 付款代號
store_date string 交易日期
store_relateid string 支付條碼
store_prodid string 支付商品代碼
store_deal float 預繳金額
store_amt float 實繳金額
bonuspt_point integer 消費者換算點數
tot_point integer 總兌換點數

Request Body Parameters - Ticket

Name Type Description
tkbno string 開始券號
tkeno string 結束券號
stype string 票券類型
ALLOWED VALUES:
  • 0：票券銷售
  • 1：票券銷退
  • 2：票券兌回
  • 3：票券兌回還原
  • D：入場券取號正式單號回填 
  • E：入場券退貨銷毀
  • F：入場券取號還原
  • R：入場券取號還原
mobile string 手機號碼
isbal bool 是否為餘額券
bal_value double 餘額券金額
tk_pno string 餘額券主券號

Request Body Parameters - Stamp

Name Type Description
vip_id string 會員編號
vipgrp string 會員群組編號
shop_id string 門市代號
ticket_id string 異動單據號碼
input_date string 單據日期
stamp_type string 集章異動類型
ALLOWED VALUES:
  • 1：銷售新增
  • 2：銷退返還
  • 3：兌換集章
  • Z：印章數歸零
stamp integer 集章數
crt_date string 建檔日期
crt_user string 建檔人員
isexec string 計算執行過
exec_date string 執行時間
online_upt string 連線執行
transfer_status string 傳輸標誌
last_update string 傳輸異動日
stamp_memo string 備註

Request Body Example

{
  "status": "CONFIRM",
  "checkout_data_list": [
    {
      "vip_id": "0000000000101",
      "shop_id": "zzz",
      "ticket_id": "zzz21081700026",
      "input_date": "2021-08-18",
      "type": "0",
      "user_id": "1234",
      "vip02_list": [],
      "vippoint_list": [],
      "vippresale_list": [],
      "tick_list": [
        {
          "tkbno": "A031000000",
          "tkeno": "A031000000",
          "stype": "2",
          "mobile": "0911111111",
          "isbal": false,
          "bal_value": 0,
          "tk_pno": ""
        },
        {
          "tkbno": "A032000000",
          "tkeno": "A032000000",
          "stype": "2",
          "mobile": "0911111111",
          "isbal": false,
          "bal_value": 0,
          "tk_pno": ""
        }
      ],
      "vipstamp_list": []
    }
  ]
}

Response

Status-Code: 204 No Content