Create New Order

Description

建立新訂單。

Resource

POST /v2/order

Authorization

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

Request Body Parameters

Name	Type	Description
id	string	訂單編號，第一次進購物車不用帶， 例如:STORE2005010001 (optional)
placed_at	string	提交時間 ISO 8601 format EXAMPLE "2020-01-01 15:16:54"
pickup_at	string	取貨時間/預計入園日期 ISO 8601 format EXAMPLE "2020-01-01 15:16:54"
type	string (enum)	銷售方式 ALLOWED VALUES: DINE_IN PICK_UP DELIVERY DEFAULT
sale_type	string (enum)	銷售型態 ALLOWED VALUES: GENERAL_ORDER：一般訂單 POS_SALES：POS銷售 POS_SELL_OFF：POS銷退 (optional)
client_device	string (enum)	客戶端裝置 ALLOWED VALUES: APP KIOSK RETAIL 掃碼下單 掃碼下單後結 EC_STD EC_QUICK_ORDER EC_BUY_GOOD EC_8WAY EC_Just_Kitchen EC_HAO_SPEED EC_CTI 3SPOS CUSTOMER_TICKET TOUR_TICKET MPOS EC_Leezen HSA_EXTRA OHSA_EXTRA WPOS
store	Store	接單門市
customer	Customer	消費者資訊，若非會員則必填 (optional)
purchaser	Customer	訂購人資訊 (optional)
payments	Payment[]	付款資訊 (optional)
charges	Charges	費用
cart	Cart	購物車中的商品資訊
receipt	Receipt	發票資訊，發票組合詳細範例 (optional)
special_instructions	string	特殊要求 (optional) 備註：限制100個字
display_id	string	取餐號 (optional)
table_number	string	桌號 (optional)
kiosk_id	string	KIOSK的機號 (optional)
tickets	Ticket	票劵資訊 (optional)
exchang_points_for_cash	bool	扣點折抵 (optional)
pre_order_project_id	string	預購專案編號 (optional)
external_id	string	外部編號 (optional) 外部廠商串接時為必填
accumulated_points	integer	累積點數 (optional)
modified_user_id	string	異動人員編號 (optional)
admission_ticket_type	string (enum)	門票類型 ALLOWED VALUES: PAPER ELECTRONIC (optional)
tour	Tour	導覽資訊 (optional)
pickup_method	Pickup Method	取貨方式 (optional)
purchase_type	string (enum)	購物方式 ALLOWED VALUES: RESTAURANT SHOPPING (optional)
auto_run_confirm_order	bool	自動執行確認訂單 (optional)
external_data	string	訂單額外資訊 (optional)
unique_code	string	訂單唯一碼 (optional)
enable_ticket_taste_processing	bool	啟用票券商品加值流程 (optional)
credential_id	string	憑證編號 (optional)
line_id	string	LINE UID (optional)

Request Body Parameters - ExternalInvoiceInfo

Name	Type	Description
invoice_number	string	開立的發票號碼
invoice_buy	InvoiceBuy	發票購買資訊
invoice_rec	InvoiceRec	發票記錄資訊

Request Body Parameters - InvoiceBuy

Name	Type	Description
begin_ym	string	起始年月
end_ym	string	截止年月
invo_no_b	string	發票起始號碼
invo_no_e	string	發票截止號碼
memo	string	備註
num	integer	發票張數
pos_id	string	機號

Request Body Parameters - InvoiceRec

Name	Type	Description
inv_no_b	string	發票號碼起
inv_no_e	string	發票號碼訖
input_date	string	開立時間
cust_code	string	統一編號 (填此欄位必須receipt.tax_ID_number也要填寫)
amount	float	開立金額
tax	float	應稅金額
taxtype	string	稅別 1:應稅; 2:免稅
pos_id	string	機號
random_no	string	隨機碼
npoban	string	捐贈碼 (填此欄位必須receipt.npoban也要填寫)
buyer_number	string	買方載具號碼 (填此欄位必須receipt.carrier也要填寫)
invrec_namt	string	免稅金額
invrec_uamt	string	未稅金額
printmark	string	電子發票列印註記 0:未列印 1:已列印
buyer_type	string	買方載具類別 (填此欄位必須receipt.carrier_type也要填寫)
creditcard_no	string	信用卡號末4碼
sell_code	string	賣方統編

Request Body Parameters - Store

Name	Type	Description
id	string	門市代碼
name	string	門市名稱
sale_store_id	string	銷售門市代碼 (optional)

Request Body Parameters - Customer

Name	Type	Description
id	string	會員編號 (optional)
name	string	姓名
mobile	string	手機號碼 (optional)
address	string	地址，銷售方式為外送時必填 (order.type is DELIVERY) (optional)

Request Body Parameters - Purchaser

Name	Type	Description
name	string	姓名 (optional)
mobile	string	手機號碼 (optional)

Request Body Parameters - Payment

Name	Type	Description
type	Payment	付款方式
payment_amount	integer	支付金額
customize	Customize	自定義金流 (optional) *若type為CUSTOMIZE需必填

Request Body Parameters - Customize

name	type
id	自定義金流代碼
name	自定義金流名稱

Request Body Parameters - Payment Instruction

type	name
LINE_PAY	LINE Pay
PI_PAY	Pi Pay
CREDIT_CARD	信用卡
EASY_CARD	悠遊卡
CASH	臨櫃結帳
MWD_PAY	麥味登Pay
Easy_Wallet	悠遊付
APPLE_PAY	Apple Pay
GOOGLE_PAY	Google Pay
NCCC_EASY_CARD	NCCC悠遊卡
NCCC_IPASS	NCCC一卡通
NCCC_ICASH	NCCC iCash
NCCC_HAPPY_CASH	NCCC有錢卡
CASH_CAR	現金
CHARGE_CARD	簽帳
MOTORCADE	車隊
CREDIT_CARD_CAR	信用卡
CTBC_CARD	中信卡
BARCODE_PAY	條碼支付
TAIWAN_PAY	台灣 Pay
JkoPay	街口支付
CUSTOMIZE	自定義金流
TK01	門票折抵
HAO_SPEED	全家外送自取
EC	EC
HSA_EXTRA	異質POS
PX_PAY	全支付
CASH_ON_DELIVERY	貨到付款
NEWEB_PAY	藍新金流
CASH_MODULE	現金模組
I_CASH_PAY	愛金卡支付
DD_PAY	信用卡(DD_PAY)

Request Body Parameters - Charges

Name	Type	Description
total	Money	整張訂單總金額
sub_total	Money	所有品項實際金額
discount	Money	折扣金額
total_fee	Money	實際付款金額
total_extra	Money	總溢收金額 (optional)
total_discharge	Money	尾數折讓 (optional)
accumulable_total	Money	可以累積點數的金額 (optional)

Request Body Parameters - Cart

Name	Type	Description
items	Item[]	品項資料

Request Body Parameters - Receipt

Name	Type	Description
type	string (enum)	發票類型 ALLOWED VALUES: PAPER ELECTRONIC (optional)
tax_ID_number	string	統一編號 (optional)
npoban	string	捐贈碼 (https://i.imgur.com/5LAsOF4.jpg) (optional)
carrier_type	string	買方載具類別 (optional)
carrier	string	買方載具 (optional)
take_number	bool	是否開立發票 (optional)
use_member_carrier	bool	使用會員載具 (optional)
external_invoice_info	ExternalInvoiceInfo	外部發票資訊 (optional)

Request Body Parameters - Item

Name	Type	Description
id	string	編號
title	string	名稱
quantity	integer	數量
special_instructions	string	特殊要求 (optional)
price	ItemPrice	售價
selected_modifier_groups	ModifierGroup[]	可選群組 (optional)
car	Car	汽車資訊 (optional)
course	Course	課程資訊 (optional)
fresh	Fresh	生鮮資訊 (optional)
is_must_buy	bool	是否為必買項目 (optional)
combo_no	integer	套餐序號 (optional)
size_main_product_id	string	尺寸主商品編號 商品為尺寸商品時，此欄位必填 (optional)
unique_code	string	商品唯一碼 (optional)
ai_recommend	bool	是否為ai推薦 (optional)

Request Body Parameters - Fresh

Name	Type	Description
is_fresh	bool	是否為生鮮商品
weight	float	生鮮重量

Request Body Parameters - ItemPrice

Name	Type	Description
unit_price	Money	單價(單品不含加值、數量)
total_price	Money	合計售價(單品+加值*數量)
spend_points	integer	消費點數 (option)

Request Body Parameters - ModifierGroup

Name	Type	Description
type	string	類型 ALLOWED VALUES: TASTE COMBO PACK (optional)
id	string	編號
title	string	名稱
pack_suit_id	string	系列組合編號 (optional) 當類型為PACK，為必填
selected_items	Item[]	被選擇的品項
removed_items	Item[]	原本為預設選取，但被消費者移除的品項
combo_taste	bool	是否為套餐加值 (optional)
tax	Money	稅額 (optional)

Request Body Parameters - Money

Name	Type	Description
amount	integer	最小單位金額
currency_code	string	貨幣代碼 ISO 4217 code
formatted_amount	string	顯示用金額

Request Body Parameters - Car

Name	Type	Description
id	string	車號
name	string	車名

Request Body Parameters - Course

Name	Type	Description
classroom_id	string	教室編號
classroom_name	string	教室名稱
class_time	string	上課時間 EXAMPLE "2020-01-01 12:00:00"

Request Body Parameters - Ticket

Name	Type	Description
number	string	票劵號碼
encrypt_number	string	加密券號 (optional)
pre_order_id	string	預訂單號 (optional)
guide_id	string	導遊編號 (optional)
car_no	string	車號 (optional)
discount_amount	Discount Amount	門票折抵金額 (optional)
redeem_product_id	string	兌換商品編號 (optional)
external_product_name	string	外部票券名稱 (optional)
external_ticket_price	float	外部票券售價 (optional)
sale_from	string	外部票券商品銷售來源 (optional)
type	string (enum)	票券類型 ALLOWED VALUES: LAFRESH KKDAY KLOOK (optional)

Request Body Parameters - Discount Amount

Name	Type	Description
money_id	string	貨幣編號
money_value	integer	貨幣金額
quantity	integer	數量

Request Body Parameters - Tour

Name	Type	Description
travel_agency_id	string	旅行社編號
travel_agency_name	string	旅行社名稱
group_name	string	團體名稱
group_type_id	string	團體類別編號
group_type_name	string	團體類別名稱
need_tour	boolean	是否需要導覽

Request Body Parameters - Pickup Method

Name	Type	Description
id	string	取貨方式編號
name	string	取貨方式名稱

Request Example

{
  "id": "STORE2005010001",
  "placed_at": "2020-05-01 22:25:49",
  "pickup_at": "2020-05-01 22:25:49",
  "type": "DELIVERY",
  "client_device": "RETAIL",
  "store": {
    "id": "A01",
    "name": "台南店"
  },
  "customer": {
    "name": "王大明",
    "mobile": "0910123456",
    "address": "台南市安平區健康三街999號"
  },
  "payments": [
    {
      "type": "CASH",
      "payment_amount": 1000
    }
  ],
  "charges": {
    "total": {
      "amount": 1100,
      "currency_code": "TWD",
      "formatted_amount": "1100"
    },
    "sub_total": {
      "amount": 1100,
      "currency_code": "TWD",
      "formatted_amount": "1100"
    },
    "discount": {
      "amount": 100,
      "currency_code": "TWD",
      "formatted_amount": "100"
    },
    "total_fee": {
      "amount": 1000,
      "currency_code": "TWD",
      "formatted_amount": "1000"
    },
    "total_extra": {
      "amount": 0,
      "currency_code": "TWD",
      "formatted_amount": "0"
    },
    "accumulable_total": {
      "amount": 220,
      "currency_code": "TWD",
      "formatted_amount": "220"
    }
  },
  "cart": {
    "items": [
      {
        "id": "P001",
        "title": "番茄泡菜炒豆包",
        "quantity": 2,
        "price": {
          "unit_price": {
            "amount": 40000,
            "currency_code": "TWD",
            "formatted_amount": "400"
          },
          "total_price": {
            "amount": 80000,
            "currency_code": "TWD",
            "formatted_amount": "800"
          }
        },
        "selected_modifier_groups": [
          {
            "combo_taste": false,
            "type": "TASTE",
            "id": "1",
            "title": "辣度",
            "selected_items": [
              {
                "id": "1",
                "title": "小辣",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              }
            ],
            "removed_items": null
          }
        ]
      },
      {
        "id": "P002",
        "title": "紫蘇籽油腐乳炒飯",
        "special_instructions": "不要洋蔥",
        "quantity": 1,
        "price": {
          "unit_price": {
            "amount": 20000,
            "currency_code": "TWD",
            "formatted_amount": "200"
          },
          "total_price": {
            "amount": 20000,
            "currency_code": "TWD",
            "formatted_amount": "200"
          }
        },
        "selected_modifier_groups": [
          {
            "combo_taste": false,
            "type": "TASTE",
            "id": "2",
            "title": "加飯",
            "selected_items": [
              {
                "id": "1",
                "title": "白飯",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              }
            ],
            "removed_items": null
          },
          {
            "combo_taste": false,
            "type": "TASTE",
            "id": "3",
            "title": "加胡椒",
            "selected_items": [
              {
                "id": "1",
                "title": "胡椒",
                "quantity": 0,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              }
            ],
            "removed_items": null
          }
        ]
      }
    ]
  },
  "receipt": {
    "type": "PAPER",
    "tax_ID_number": "24436074",
    "npoban": "",
    "carrier_type": "",
    "carrier": "",
    "external_invoice_info": {
      "invoice_number": "GB00000001",
      "invoice_buy": {
        "begin_ym": "202507",
        "end_ym": "202508",
        "invo_no_b": "WI00000001",
        "invo_no_e": "WI00000100",
        "memo": "",
        "num": 100,
        "pos_id": "K2"
      },
      "invoice_rec": {
        "inv_no_b": "WI00000001",
        "inv_no_e": "WI00000001",
        "input_date": "2025-09-01 10:13:30.000",
        "cust_code": "",
        "amount": 1.00,
        "tax": 1.00,
        "taxtype": "1",
        "pos_id": "K2",
        "random_no": "1234",
        "npoban": "",
        "buyer_number": "",
        "invrec_namt": "",
        "invrec_uamt": "",
        "printmark": "0",
        "buyer_type": "",
        "creditcard_no": "",
        "sell_code": ""
      }
    }
  },
  "special_instructions": "訂單備註內容",
  "table_number": "12",
  "kiosk_id": "k1",
  "tickets": [
    {
      "number": "A776479",
      "pre_order_id": "MCSF0221051300006",
      "guide_id": "G001",
      "car_no": "2",
      "discount_amount": [
        {
          "money_id": "001",
          "money_value": 50,
          "quantity": 1
        },
        {
          "money_id": "002",
          "money_value": 100,
          "quantity": 1
        }
      ]
    }
  ],
  "exchang_points_for_cash": false,
  "external_id": "",
  "accumulated_points": 10,
  "line_id": "",
  "modified_user_id": "",
  "admission_ticket_type": "PAPER",
  "tour": {
    "travel_agency_id": "group_a",
    "travel_agency_name": "雄獅旅行社",
    "group_name": "ABC旅行團",
    "group_type_id": "A001",
    "group_type_name": "國內社客團",
    "need_tour": false
  },
  "pickup_method": {
    "id": "1", 
    "name": "現場取貨"
  },
  "purchase_type": "RESTAURANT",
  "external_data": {
    "test1": "msg1",
    "test2": "msg2",
    "test3": "msg3"
  }
}

Combo Request Example

{
  "id": "",
  "pickup_at": "2020-05-01 22:25:49",
  "type": "PICK_UP",
  "placed_at": "2020-05-01 22:25:49",
  "client_device": "KIOSK",
  "charges": {
    "total": {
      "amount": 165,
      "currency_code": "TWD",
      "formatted_amount": "165"
    },
    "sub_total": {
      "amount": 165,
      "currency_code": "TWD",
      "formatted_amount": "165"
    },
    "discount": {
      "amount": 0,
      "currency_code": "TWD",
      "formatted_amount": "0"
    },
    "total_fee": {
      "amount": 165,
      "currency_code": "TWD",
      "formatted_amount": "165"
    },
    "total_extra": {
      "amount": 0,
      "currency_code": "TWD",
      "formatted_amount": "0"
    },
    "accumulable_total": {
      "amount": 220,
      "currency_code": "TWD",
      "formatted_amount": "220"
    }
  },
  "customer": {
    "name": "hi",
    "mobile": "0911111111",
    "address": ""
  },
  "store": {
    "id": "000030",
    "name": "台北訓練機"
  },
  "cart": {
    "items": [
      {
        "id": "UC10000001",
        "title": "A餐-炸雞腿飯",
        "quantity": 1,
        "price": {
          "unit_price": {
            "amount": 165,
            "currency_code": "TWD",
            "formatted_amount": "165"
          },
          "total_price": {
            "amount": 245,
            "currency_code": "TWD",
            "formatted_amount": "245"
          }
        },
        "selected_modifier_groups": [
          {
            "combo_taste": false,
            "type": "COMBO",
            "title": "主食選擇",
            "selected_items": [
              {
                "id": "UC06000002",
                "title": "炸雞腿飯",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": [
                  {
                    "combo_taste": false,
                    "type": "TASTE",
                    "id": "3",
                    "title": "飯類選擇",
                    "selected_items": [
                      {
                        "id": "6",
                        "title": "飯多",
                        "quantity": 1,
                        "price": {
                          "unit_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          },
                          "total_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          }
                        },
                        "selected_modifier_groups": null
                      }
                    ]
                  },
                  {
                    "combo_taste": false,
                    "type": "TASTE",
                    "id": "4",
                    "title": "切塊選擇",
                    "selected_items": [
                      {
                        "id": "2",
                        "title": "切小塊",
                        "quantity": 1,
                        "price": {
                          "unit_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          },
                          "total_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          }
                        },
                        "selected_modifier_groups": null
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "combo_taste": false,
            "type": "COMBO",
            "title": "選擇配菜",
            "selected_items": [
              {
                "id": "UC03000004",
                "title": "竹筍湯",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": [
                  {
                    "combo_taste": false,
                    "type": "TASTE",
                    "id": "6",
                    "title": "湯選擇",
                    "selected_items": [
                      {
                        "id": "1",
                        "title": "不加蔥",
                        "quantity": 1,
                        "price": {
                          "unit_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          },
                          "total_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          }
                        },
                        "selected_modifier_groups": null
                      }
                    ]
                  }
                ]
              },
              {
                "id": "UC02300001",
                "title": "香滷鴨蛋",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              },
              {
                "id": "UC04100002",
                "title": "香滷油豆腐",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              },
              {
                "id": "UC05000005",
                "title": "蜂蜜香檸茶",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              }
            ]
          },
          {
            "combo_taste": true,
            "type": "TASTE",
            "id": "3",
            "title": "飯類選擇",
            "selected_items": [
              {
                "id": "6",
                "title": "飯多",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              }
            ]
          },
          {
            "combo_taste": true,
            "type": "TASTE",
            "id": "4",
            "title": "切塊選擇",
            "selected_items": [
              {
                "id": "2",
                "title": "切小塊",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              }
            ]
          }
        ]
      }
    ]
  },
  "special_instructions": "測試",
  "payments": [
    {
      "type": "CASH",
      "payment_amount": 165
    }
  ],
  "receipt": {
    "carrier": "",
    "carrier_type": "",
    "npoban": "",
    "tax_ID_number": "111",
    "external_invoice_info": {
      "invoice_number": "GB00000001",
      "invoice_buy": {
        "begin_ym": "202507",
        "end_ym": "202508",
        "invo_no_b": "WI00000001",
        "invo_no_e": "WI00000100",
        "memo": "",
        "num": 100,
        "pos_id": "K2"
      },
      "invoice_rec": {
        "inv_no_b": "WI00000001",
        "inv_no_e": "WI00000001",
        "input_date": "2025-09-01 10:13:30.000",
        "cust_code": "",
        "amount": 1.00,
        "tax": 1.00,
        "taxtype": "1",
        "pos_id": "K2",
        "random_no": "1234",
        "npoban": "",
        "buyer_number": "",
        "invrec_namt": "",
        "invrec_uamt": "",
        "printmark": "0",
        "buyer_type": "",
        "creditcard_no": "",
        "sell_code": ""
      }
    }
  },
  "table_number": "12",
  "kiosk_id": "k1",
  "tickets": [
    {
      "number": "A776479"
    }
  ],
  "exchang_points_for_cash": false,
  "external_id": "TEST03000001",
  "accumulated_points": 10,
  "external_data": {
    "test1": "msg1",
    "test2": "msg2",
    "test3": "msg3"
  }
}

Pack Request Example

{
  "id": "",
  "pickup_at": "2020-05-01 22:25:49",
  "type": "PICK_UP",
  "placed_at": "2020-05-01 22:25:49",
  "client_device": "KIOSK",
  "charges": {
    "total": {
      "amount": 420,
      "currency_code": "TWD",
      "formatted_amount": "165"
    },
    "sub_total": {
      "amount": 420,
      "currency_code": "TWD",
      "formatted_amount": "165"
    },
    "discount": {
      "amount": 0,
      "currency_code": "TWD",
      "formatted_amount": "0"
    },
    "total_fee": {
      "amount": 420,
      "currency_code": "TWD",
      "formatted_amount": "165"
    },
    "total_extra": {
      "amount": 0,
      "currency_code": "TWD",
      "formatted_amount": "0"
    },
    "accumulable_total": {
      "amount": 220,
      "currency_code": "TWD",
      "formatted_amount": "220"
    }
  },
  "customer": {
    "name": "hi",
    "mobile": "0911111111",
    "address": ""
  },
  "store": {
    "id": "000030",
    "name": "台北訓練機"
  },
  "cart": {
    "items": [
      {
        "id": "J01002",
        "title": "JTT特供套餐(早鳥)",
        "quantity": 1,
        "price": {
          "unit_price": {
            "amount": 420,
            "currency_code": "TWD",
            "formatted_amount": "420"
          },
          "total_price": {
            "amount": 420,
            "currency_code": "TWD",
            "formatted_amount": "420"
          }
        },
        "selected_modifier_groups": [
          {
            "type": "PACK",
            "title": "套餐主餐",
            "pack_suit_id": "01",
            "selected_items": [
              {
                "id": "J15001",
                "title": "碳烤紐西蘭菲力",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": [
                  { 
                    "type": "TASTE",
                    "id": "4",
                    "title": "切塊選擇",
                    "selected_items": [
                      {
                        "id": "2",
                        "title": "切小塊",
                        "quantity": 1,
                        "price": {
                          "unit_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          },
                          "total_price": {
                            "amount": 0,
                            "currency_code": "TWD",
                            "formatted_amount": "0"
                          }
                        },
                        "selected_modifier_groups": null
                      }
                    ]
                  }
                ]
              }
            ]
          },
          {
            "type": "PACK",
            "title": "套餐附餐",
            "pack_suit_id": "02",
            "selected_items": [
              {
                "id": "J07001",
                "title": "紅茶",
                "quantity": 1,
                "price": {
                  "unit_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  },
                  "total_price": {
                    "amount": 0,
                    "currency_code": "TWD",
                    "formatted_amount": "0"
                  }
                },
                "selected_modifier_groups": null
              }
            ]
          }
        ]
      }
    ]
  },
  "special_instructions": "測試",
  "payments": [
    {
      "type": "CASH",
      "payment_amount": 420
    }
  ],
  "receipt": {
    "carrier": "",
    "carrier_type": "",
    "npoban": "",
    "tax_ID_number": "111",
    "external_invoice_info": {
      "invoice_number": "GB00000001",
      "invoice_buy": {
        "begin_ym": "202507",
        "end_ym": "202508",
        "invo_no_b": "WI00000001",
        "invo_no_e": "WI00000100",
        "memo": "",
        "num": 100,
        "pos_id": "K2"
      },
      "invoice_rec": {
        "inv_no_b": "WI00000001",
        "inv_no_e": "WI00000001",
        "input_date": "2025-09-01 10:13:30.000",
        "cust_code": "",
        "amount": 1.00,
        "tax": 1.00,
        "taxtype": "1",
        "pos_id": "K2",
        "random_no": "1234",
        "npoban": "",
        "buyer_number": "",
        "invrec_namt": "",
        "invrec_uamt": "",
        "printmark": "0",
        "buyer_type": "",
        "creditcard_no": "",
        "sell_code": ""
      }
    }
  },
  "table_number": "12",
  "kiosk_id": "k1",
  "tickets": [
    {
      "number": "A776479"
    }
  ],
  "exchang_points_for_cash": false,
  "external_id": "TEST03000001",
  "accumulated_points": 10,
  "external_data": {
    "test1": "msg1",
    "test2": "msg2",
    "test3": "msg3"
  }
}

Response Body Parameters

Name	Type	Description
id	string	訂單編號
current_state	string (enum)	訂單狀態，手動接單時回傳 CREATED，自動接單時回傳 ACCEPTED，拒絕接單時回傳 CANCELLED ALLOWED VALUES: CREATED ACCEPTED CANCELLED COMPLETED
create_at	string	建立時間 ISO 8601 format EXAMPLE "2020-01-01 15:16:54"
is_get_receipt	bool	是否取得發票

Response

{
  "id": "STORE2005010001",
  "current_state": "CREATED",
  "create_at": "2020-05-01 22:25:49",
  "is_get_receipt": false
}