Order Create

Description

建立運送訂單

Resource

POST /v1/mete/create_delivery_order

Authorization

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

Request Body Parameters

Name	Type	Description
store_id	string	商店編號
order_id	string	訂單編號
direct_id	string	運送單號 (optional)
amount	number	訂單金額
recipient	Recipient	收件人資訊
delivery_options	Delivery Options	配送選項
notes	Notes	備註

Request Body Parameters Recipient

Name	Type	Description
name	string	姓名
phone	string	電話
address	string	地址

Request Body Parameters Delivery Options

Name	Type	Description
number_of_drivers	int	司機數量
scheduled_pickup_time	string	預計取件時間，格式為 YYYY-MM-DD HH:mm:ss

Request Body Parameters Notes

Name	Type	Description
for_driver	string	給司機的備註
from_customer	string	來自顧客的備註

Request CURL

curl --location 'https://omni-dev.wixtar.com/v1/mete/create_delivery_order' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer JtUgk1eOigrvj0BqdhMlaGqJJvolKec3stmGcnkAyGs2huBw0efboIEDiqrh+FBl5VIoFCjLXyOoWFjcvIvABOWR2Tu1yDFLMgLvWIfWAOjBdvFWCri1SU+oK86kwEA+eQbCqzWtQ7SEI2LsVKcKmWHG2S/CGXYTQpdMLjaxktBdgBXl4kNURHLyY2Y6xedrCbtlDEhh3nLGLm48myaH9PWzrZ8i4g/37ZY85/WU0hRtfTLF3x8+t2rXbivz1kZWZqSWy1Qu39EcqdEY9u3s6IZ0Q9WTCtu/imdsbFvZPfFH13bCTa2zN+0wkezx1xdMb+LA5N3ZCfKU9COJNySort2oN5hr0xs0hk7kz2U9kYAvi0hWLMMmUg8nQaU7lHVwKvYTdRlMqcnhguKuYxBhXg==' \
--data '{
  "store_id": "000030",
  "order_id": "00003025102000001",
  "direct_id": "000030251020000019G142G",
  "amount": 50,
  "recipient": {
    "name": "星先生",
    "phone": "+886918524999",
    "address": "台北市中正區信義路二段81號"
  },
  "delivery_options": {
    "number_of_drivers": 3, 
    "scheduled_pickup_time": "2025-10-20 16:30:00", 
    "handover_option": "LEAVE_AT_DOOR"
  },
  "notes": {
    "for_driver": "請到右邊取餐窗口取餐",
    "from_customer": "送達前請先打電話"
  }
}'

Response Body Parameters

Name	Type	Description
pay_party	string	付款方
est_delivery_fee	number	預估運費
est_pickup_time	string	預估取件時間
est_delivery_time	string	預估送達時間
est_distance	string	預估距離
store_id	string	商店編號
order_id	string	訂單編號
direct_id	string	運送單號
number_of_drivers	integer	司機數量
total_delivery_fee	number	總運費

Response Example

Status-Code: 200

{
  "pay_party": "門店",
  "est_delivery_fee": 95,
  "est_pickup_time": "2025-10-15 17:30:00",
  "est_delivery_time": "2025-10-15 17:46:11",
  "est_distance": "1.5341",
  "store_id": "000030",
  "order_id": "TWNe01CU202108081330",
  "direct_id": "TWNe01CU202108081330",
  "number_of_drivers": 3,
  "total_delivery_fee": 285
}

業務規則 (Business Rules)

1. 預估時間處理 (Estimated Time)：
2. 傳送給米特的 est_ready_time 必須與 est_pickup_time 保持一致。
3. 若 Request 中的 delivery_options.scheduled_pickup_time 未提供指定時間，系統將預設取門市設定的取餐時間間隔 shop00_config.meal_gap 計算（現在系統時間 + meal_gap）；若門市未設定則預設使用 現在系統時間 + 10 分鐘 作為預估取件/備餐時間。
4. 若有提供指定時間，該時間不得早於系統現在時間，否則將拋出 ValueError。