Quantity Promotion
Description
滿量促銷
Resource
POST /v1/promotion/quantity
Authorization
採用 OAuth 2.0 Bearer Token，詳細使用流程請參考 Auth Login。
Request Body Parameters
| Name | Type | Description |
|---|---|---|
| weborder00 | object | 訂單主檔 |
| weborder01 | object | 訂單菜品檔 |
| weborder014 | object | 訂單資料明細促銷檔 |
Request Example
{
"weborder00": [
{
"shop_id": "000030",
"worder_id": "00003023102700006",
"source_id": "00003023102700006",
"input_date": "2023-10-27 11:11:27",
"memo": "",
"rec_name": "",
"vip_id": "",
"last_update": "2023-10-27 11:11:37",
"pos_id": "K1",
"meal_date": "2023-10-27 11:41:27",
"storefrom": "KIOSK",
"company_id": "18090377",
"sale_method": "2",
"method_name": "外帶",
"rec_tel": "",
"rec_addr": "",
"rec_mobile": "",
"vipgrp_id": "",
"cust_code": "",
"payment_terms": 0,
"npoban": "",
"buyer_number": "",
"buyer_type": "",
"tot_sales": 0.0,
"table_no": "",
"pretime": "0",
"tot_point": "0",
"tot_discharge": 0.0,
"project_pre_order_id": "",
"get_point": 0,
"type": 0,
"requestinvoice": 0,
"mod_date": "2023-10-27 11:11:37",
"mod_user": "lafresh",
"cn_orders": "",
"tour_id": "",
"get_type": "0",
"tot_extra": 0.0,
"sale_shop_id": "",
"sale_type": "0",
"tip": 0.0,
"external_data": null,
"status": "0",
"adultcnt": "1",
"childcnt": "0",
"personcount": "1",
"transfer_status": "0",
"send_web": "0",
"exported": "F",
"takeno": "",
"invo_no": "",
"secretary_id": "",
"source_type": "2",
"fare": 0
}
],
"weborder01": [
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "去冰;小杯;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "1",
"prod_id": "UC05000005",
"prod_name": "蜂蜜香檸茶",
"sale_price": "25.0",
"item_disc": 0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": null,
"comb_sno": null,
"comb_type": "0",
"comb_qty": "0",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "1698223740953-574678427",
"szfprod_id": null,
"limited_prod": ""
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "大陸妹;炸排骨;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "2",
"prod_id": "UC10000004",
"prod_name": "A餐-紅糟肉飯",
"sale_price": "0.0",
"item_disc": 0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": null,
"comb_sno": null,
"comb_type": "1",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "1698223740953-574678427",
"szfprod_id": null,
"limited_prod": ""
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "3",
"prod_id": "UC07000003",
"prod_name": "炸紅糟肉麵●",
"sale_price": "85.0",
"item_disc": 0,
"dis_number": 100,
"qty": 2,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2,
"comb_sno": 1,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": ""
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "加豆腐;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "4",
"prod_id": "UC03000009",
"prod_name": "蘿蔔貢丸湯-U",
"sale_price": "39.0",
"item_disc": 0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2,
"comb_sno": 2,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": ""
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "5",
"prod_id": "UC04100002",
"prod_name": "香滷油豆腐",
"sale_price": "20.0",
"item_disc": 0,
"dis_number": 100,
"qty": 3,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2,
"comb_sno": 3,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": ""
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "正常;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "6",
"prod_id": "UC05000001",
"prod_name": "檸檬紅茶",
"sale_price": "0.0",
"item_disc": 0,
"dis_number": 100,
"qty": 3,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2,
"comb_sno": 4,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": ""
}
],
"weborder014": []
}
Response Body Parameters
| Name | Type | Description |
|---|---|---|
| weborder01 | object | 訂單菜品檔 |
| weborder014 | object | 訂單資料明細促銷檔 |
Response Example
{
"weborder01": [
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "去冰;小杯;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "1",
"prod_id": "UC05000005",
"prod_name": "蜂蜜香檸茶",
"sale_price": "25.0",
"item_disc": 0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": NaN,
"comb_sno": NaN,
"comb_type": "0",
"comb_qty": "0",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "1698223740953-574678427",
"szfprod_id": null,
"limited_prod": "",
"tkno": null,
"max_promotion_quantity": 0
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "大陸妹;炸排骨;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "2",
"prod_id": "UC10000004",
"prod_name": "A餐-紅糟肉飯",
"sale_price": "0.0",
"item_disc": 0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": NaN,
"comb_sno": NaN,
"comb_type": "1",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "1698223740953-574678427",
"szfprod_id": null,
"limited_prod": "",
"tkno": null,
"max_promotion_quantity": 0
}
],
"weborder014": [
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "去冰;小杯;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "1",
"prod_id": "UC05000005",
"prod_name": "蜂蜜香檸茶",
"sale_price": "25.0",
"item_disc": -12.0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": NaN,
"comb_sno": NaN,
"comb_type": "0",
"comb_qty": "0",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "1698223740953-574678427",
"szfprod_id": null,
"limited_prod": "",
"tkno": null
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "大陸妹;炸排骨;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "2",
"prod_id": "UC10000004",
"prod_name": "A餐-紅糟肉飯",
"sale_price": "0.0",
"item_disc": 0.0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": NaN,
"comb_sno": NaN,
"comb_type": "1",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "1698223740953-574678427",
"szfprod_id": null,
"limited_prod": "",
"tkno": null
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "3",
"prod_id": "UC07000003",
"prod_name": "炸紅糟肉麵●",
"sale_price": "85.0",
"item_disc": 0.0,
"dis_number": 100,
"qty": 2,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2.0,
"comb_sno": 1.0,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": "",
"tkno": null
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "加豆腐;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "4",
"prod_id": "UC03000009",
"prod_name": "蘿蔔貢丸湯-U",
"sale_price": "39.0",
"item_disc": 0.0,
"dis_number": 100,
"qty": 1,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2.0,
"comb_sno": 2.0,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": "",
"tkno": null
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "5",
"prod_id": "UC04100002",
"prod_name": "香滷油豆腐",
"sale_price": "20.0",
"item_disc": 0.0,
"dis_number": 100,
"qty": 3,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2.0,
"comb_sno": 3.0,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": "",
"tkno": null
},
{
"prom_id": null,
"prom_sno": 0,
"free_emp": null,
"free_memo": null,
"tk_bno": null,
"tk_eno": null,
"dis_type": "0",
"prom_qty_type": "0",
"prom_qty_id": null,
"prom_qty_sno": null,
"prom_qty_qty": "0",
"proptype": "0",
"itemdisc_total": 0,
"taste_memo": "正常;",
"cxlqty": 0,
"shop_id": "000030",
"worder_id": "00003023102700006",
"worder_sno": "6",
"prod_id": "UC05000001",
"prod_name": "檸檬紅茶",
"sale_price": "0.0",
"item_disc": 0.0,
"dis_number": 100,
"qty": 3,
"request_memo": "",
"company_id": "18090377",
"comb_sale_sno": 2.0,
"comb_sno": 4.0,
"comb_type": "2",
"comb_qty": "1",
"pack_sale_sno": 0,
"pack_sno": null,
"pack_type": "0",
"pack_qty": "0",
"pack_suit_id": null,
"pack_id": "",
"redeem_point": 0,
"price_type": "0",
"tour_car": "",
"must_buy": 0,
"fresh_weight": 0,
"fresh_prod": false,
"tax": 0.0,
"unique_code": "",
"szfprod_id": null,
"limited_prod": "",
"tkno": null
}
]
}
Quantity Promotion Workflow
sequenceDiagram
participant C as Client
participant O as Omniplatform
participant DB as Database
C->>O: POST /v1/promotion/quantity
activate O
O->>DB: Get Quantity Promotion Data
activate DB
DB->>O: Return data
alt if data is empty
O->>C: Return response(200)
end
O->>O: Get Can Promotion Order Data
alt if data is empty
O->>C: Return response(200)
end
O->>O: Calculate Quantity Promotion
O->>C: Return response(200)
deactivate O
Calculate Promotion General Workflow
sequenceDiagram
participant O as Omniplatform
O->>O: Call Calculate Promotion Function
O->>O: 根據促銷規則過濾出可促銷的商品
alt if filtered_data is empty
O->>O: Return datas
end
O->>O: 根據促銷規則進行折抵/折扣
O->>O: Update Order01 Data
O->>O: Insert Order014 Data
O->>O: Return datas