# 訂單管理
# PA-API-3.1 訂單創建
POST /order/create
接口類型 | 請求接口 |
說明 | 創建訂單 |
# 請求參數
名稱 | 類型 | 必填 | 默認值 | 說明 | 備註 |
---|---|---|---|---|---|
quotation_key | string | N | - | 報價 ID | 請在 PA-API-3.6 訂單報價 獲取可使用的報價 ID。 |
merchant_id | string | Y | - | 商家 ID | |
client | object | Y | - | 商家信息 | |
client.order_id | string | Y | - | 第三方訂單號 | 在對接方系統內的訂單號 |
client.shipment_code | string | N | '' | 第三方運單號 | 在對接方系統內的運單號 |
product_code | string | Y | - | 產品代號 | - 可以傳入"DASH2HR" 、"DASH4HR" 或"MPOINTS" - 請與 Zeek 團隊查詢可以傳入的值。 |
preferences | array | N | [] | 下單偏好 | 請參閱下方的如何傳入 preferences 說明。 使用 "DASH2HR"、"DASH4HR" 的月結合約商家為 選填 月結商家或使用 "MPOINTS" 時為 必填 |
preferences.type | string | Y | - | 偏好類別 | 例子:"business_position" |
preferences.value | string | Y | - | 偏好值 | 例子:"mR" |
schedule_time | string | N | '' | 預約取件時間 | - 即時訂單時不用傳入 - 最早可預約時間 = 當前時間 + 30分鐘 - 最遲可預約時間 = 當前時間 + 31日 - 例子: "2020-09-08 16:00" |
cancel_time | string | N | - | 取消發佈時間 | - 如果一直沒有配送員接單,系統會在傳入的 cancel_time時自動取消訂單。 - 即時單默認是創建訂單 2 小時後自動取消;預約單默認是預約取件時間取消。 - 即時單最大值為當前時間 +24小時;預約單最大值為預約取件時間 +24小時 |
contact | object | N | - | 下單聯絡人信息 | - "DASH2HR", "DASH4HR : 不需要填寫 - "MPOINTS" : 必填 |
contact.name | string | N | '' | 下單聯絡人名字 | |
contact.country_code | string | N | * 請看備注 | 聯絡人電話區號 | 系統跟據 region 配對默認值,例如 region="HK" 時默認值是 "852" |
contact.phone | string | N | '' | 下單聯絡人電話號 | |
path | array | Y | - | 配送路線地點 | - 請按順序傳入取貨點及落貨點。 - "DASH2HR"、"DASH4HR 支持一個取貨點及一個落貨點 - "MPOINTS" 支持一個取貨點及最多二十個落貨點 |
path[].address | string | Y | - | 地址文字 | |
path[].postal_code | string | N | '' | 郵政編碼 | |
path[].description | string | N | - | 地址補充文字 | |
path[].coordinate | string | Y | - | 座標 | 參 地理位置座標 |
path[].contact | array | Y | - | 該配送點的聯絡人信息 | 可以多個聯絡人,至少有一個聯絡人 |
path[].contact[].name | string | Y | - | 聯絡人姓名 | |
path[].contact[].phone | string | Y | - | 聯絡人電話 | |
path[].contact[].country_code | string | N | * 請看備注 | 聯絡人電話區號 | 系統跟據 region 配對默認值,例如 region="HK" 時默認值是 "852" |
path[].contact[].company_name | string | N | '' | 聯絡人公司名稱 | |
vas | array | N | [] | VAS 服務 | 請在 PA-API-2.1 獲取可使用 VAS 獲取可以傳入的 VAS 參數值。 |
vas[].code | string | Y | - | VAS 服務代號 | |
vas[].count | string | Y | - | VAS 服務數量 | |
items | object | Y | - | 下單物品信息 | - "DASH2HR"、"DASH4HR 為必填 - "MPOINTS" 則無需傳入 |
items.amount | string | Y | - | 下單物品總值 | - 單位:元 - 最多兩個小數位 |
items.weight | string | Y | - | 下單物品總重量 | - 單位:KG - 最多兩個小數位 |
items.box | string | Y | - | 貨物容量 Code | 請參閱 Box size code 對應表 |
items.types | array | N | [] | 貨物類型 | - 可填:"Bouquet" 、"Food" 、"Wine" 、"Doc" |
items.detail | string | N | '' | 物品描述文字 | |
cod | object | N | - | 代收款項信息 | |
cod.service_fee | string | N | "0.00" | 代收運費金額 | - 單位:元 - 最多兩個小數位 |
cod.cash | string | N | "0.00" | 代收貨款金額 | - 單位:元 - 最多兩個小數位 |
remark | object | N | - | 備注信息 | |
remark.partner | string | N | '' | 訂單備註,供配送員查看。 |
例子 (DASH2HR)
{
"quotation_key": "33333",
"merchant_id": "999",
"client": {
"order_id": "11111111",
"shipment_code": "22222222"
},
"product_code": "DASH2HR",
"preferences": [
{
"type": "business_position",
"value": "mR"
}
],
"schedule_time": "",
"cancel_time": "",
"path": [
{
"address": "Langham Place, 638 Shanghai St, Mong Kok, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.31814, 114.16866",
"contact": [
{
"name": "Lee",
"phone": "98765431",
"country_code": "852",
"company_name": ""
}
]
},
{
"address": "New Town Plaza Phase One, 18-19 Sha Tin Centre Street, Sha Tin, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.38177, 114.18862",
"contact": [
{
"name": "Wong",
"phone": "98765430"
}
]
}
],
"vas": [
{
"code": "HKDASH_VDELIVERY",
"count": "1",
"fee": ""
}
],
"items": {
"amount": "123",
"weight": "10",
"box": "S",
"types": [
"Bouquet",
"Wine"
],
"detail": "Gift set"
},
"cod": {
"service_fee": "",
"cash": ""
},
"remark": {
"partner": "remark_partner"
}
}
例子 (MPOINTS)
{
"quotation_key": "99999",
"merchant_id": "999",
"client": {
"order_id": "11111111",
"shipment_code": "22222222"
},
"product_code": "MPOINTS",
"preferences": [
{
"type": "business_position",
"value": "mR"
}
],
"schedule_time": "",
"cancel_time": "",
"contact": {
"name": "Chan",
"country_code": "852",
"phone": "98765432"
},
"path": [
{
"address": "Langham Place, 638 Shanghai St, Mong Kok, Hong Kong",
"description": "Shop 999, 999/F",
"postal": "",
"coordinate": "22.31814, 114.16866",
"contact": [
{
"name": "Lee",
"country_code": "852",
"phone": "98765431",
"company_name": ""
}
]
},
{
"address": "New Town Plaza Phase One, 18-19 Sha Tin Centre Street, Sha Tin, Hong Kong",
"description": "Shop 999, 999/F",
"postal": "",
"coordinate": "22.38177, 114.18862",
"contact": [
{
"name": "Wong",
"country_code": "",
"phone": "98765433",
"company_name": ""
}
]
},
{
"address": "Tuen Mun Town Plaza, 1 Tuen Shun St, Tuen Mun, Hong Kong",
"description": "Shop 999, 999/F",
"postal": "",
"coordinate": "22.39302, 113.97660",
"contact": [
{
"name": "Cheng",
"country_code": "",
"phone": "98765430",
"company_name": ""
}
]
}
],
"vas": [
{
"code": "HKDASH_VDELIVERY_D",
"count": "1",
"fee": ""
}
],
"items": {
"amount": "123",
"weight": "10",
"box": "S",
"types": [
"Bouquet",
"Wine"
],
"detail": "Gift set"
},
"cod": {
"service_fee": "",
"cash": ""
},
"remark": {
"partner": "remark_partner"
}
}
# 如何傳入 preferences
你需要先調用 PA-API-2.2 獲取可使用的商家工種,然後傳入獲得的值。
如果你是打算創建串點 (MPOINTS) 訂單 或你 不是月結合約商家,必須在 preferences
參數傳入一個商家工種 "business_position"。
以下是一個例子:
"preferences": [
{
"type": "business_position",
"value": "mR"
}
]
請與 Zeek 團隊查詢使用方法。
# 返回結果
名稱 | 類型 | 說明 | 備註 |
---|---|---|---|
order_id | string | 訂單 ID |
例子:
{
"error": 0,
"data": {
"order_id": "DA-A-04844"
}
}
# PA-API-3.2 訂單查詢
POST /order/info
接口類型 | 請求接口 |
說明 | 查詢訂單詳細內容 |
# 請求參數
名稱 | 類型 | 必填 | 默認值 | 說明 | 備註 |
---|---|---|---|---|---|
merchant_id | string | Y | - | 商家 ID | |
order_id | string | Y | - | 訂單 ID |
{
"merchant_id": "111111",
"order_id": "DA-A-04844"
}
# 返回結果
名稱 | 類型 | 說明 | 備註 |
---|---|---|---|
order_id | string | 訂單 ID | |
merchant_id | string | 商家 ID | |
client | object | 商家信息 | |
client.order_id | string | 第三方訂單號 | 在對接方系統內的訂單號 |
client.shipment_code | string | 第三方運單號 | 在對接方系統內的運單號 |
product_code | string | 服務代號 | |
order_time | string | 下單時間 | |
schedule_time | string | 叫車/配送時間 | |
publish_until_time | string | 自動取消訂單時間 | |
accept_time | string | 接單時間 | |
complete_time | string | 完成時間 | |
cancel_time | string | 訂單實際取消時間 | |
contact | object | 下單聯絡人信息 | |
contact.name | string | 下單聯絡人名字 | |
contact.country_code | string | 聯絡人電話區號 | |
contact.phone | string | 下單聯絡人電話號 | |
path | array | 配送路線地點 | |
path[].address | string | 地址文字 | |
path[].description | string | 地址補充文字 | |
path[].coordinate | string | 座標 | |
path[].contact | array | 該配送點的聯絡人信息 | |
path[].contact[].name | string | 聯絡人姓名 | |
path[].contact[].phone | string | 聯絡人電話 | |
path[].contact[].country_code | string | 聯絡人電話區號 | |
path[].contact[].company_name | string | 聯絡人公司名稱 | |
vas | array | VAS 服務 | |
vas[].code | string | VAS 服務代號 | |
vas[].count | string | VAS 服務數量 | |
vas[].fee | string | VAS 服務費用 | |
items | object | 下單物品信息 | |
items.amount | string | 下單物品總值 | |
items.weight | string | 下單物品總重量 | |
items.box | string | 貨物容量 Code | |
items.types | array | 貨物類型 | |
items.detail | string | 物品描述文字 | |
cod | object | 代收款項信息 | |
cod.type | string | 收取款項方法 | |
cod.service_fee | string | 代收運費金額 | |
cod.cash | string | 代收貨款金額 | |
cod.total | string | 代收款項總金額 | |
payment | object | 商家支付運費給 Zeek 的信息 | |
payment.type | string | 商家支付運費的方式 | |
status | object | 訂單狀態 | |
status.code | string | 訂單狀態碼 | 參看訂單狀態碼 |
status.name | string | 訂單狀態描述文字 | |
status.lastmodify | string | 訂單狀態時間 | |
partner | object | 配送員信息 | |
partner.name | string | 配送員名字 | |
partner.country_code | string | 配送員電話區號 | |
partner.phone | string | 配送員電話號碼 | |
partner.position | object | 配送員工種信息 | |
partner.position.code | string | 配送員工種代號 | |
partner.position.name | string | 配送員工種名稱 | |
partner.position.vehicle_number | string | 配送員車輛的車牌 | |
receipts | array | 簽收圖片連結 | |
remark.partner | string | 下單備注,給配送員查看。 |
例子:
{
"error": 0,
"data": {
"order_id": "DA-A-04788",
"merchant_id": "1111111",
"client": {
"order_id": "order-12345",
"shipment_code": "ship-12345"
},
"product_code": "DASH2HR",
"order_time": "2020-07-22 15:59",
"schedule_time": "2020-07-22 15:59",
"publish_until_time": "2020-07-22 15:59",
"accept_time": "2020-07-22 16:06",
"complete_time": "2020-07-22 16:06",
"cancel_time": "2020-07-22 15:59",
"contact": {
"name": "Kevin Tsang",
"country_code": "852",
"phone": "91234567"
},
"path": [
{
"address": "JW Marriott Hotel Hong Kong, Queensway, Admiralty, Hong Kong",
"description": "Flat 27, 3/F",
"coordinate": "22.277495,114.166271",
"contact": [
{
"name": "Mr. Chan",
"phone": "91334455",
"country_code": "852",
"company_name": "ABC Company"
},
{
"name": "Mr. Li",
"phone": "91334459"
}
]
},
{
"address": "Hotel Icon, Tsim Sha Tsui, Kowloon",
"description": "Room 414",
"coordinate": "22.300813,114.179696",
"contact": [
{
"name": "Mr. Cheung",
"phone": "912345678"
}
]
}
],
"vas": [
{
"code": "HKDASH_HOURS",
"count": "3",
"fee": "6.00",
"name": "Hourly rental"
},
{
"code": "HKDASH_PASSENGER",
"count": "1",
"fee": "6.00",
"name": "Ride with passengers"
}
],
"items": {
"amount": "0.00",
"weight": "0.00",
"box": "S",
"type": "",
"detail": ""
},
"cod": {
"type": "cash",
"service_fee": "12.50",
"cash": "30.50",
"total": "43.00"
},
"payment": {
"type": "1",
},
"status": {
"code": "9005",
"name": "About to pickup",
"lastmodify": "2020-07-22 16:06"
},
"partner": {
"name": "Albert Chan",
"country_code": "852",
"phone": "17612008",
"position": {
"code": "R",
"name": "Motobike",
"vehicle_number": "RJ 456"
}
},
"receipts": [
"https://ap1-img.zeek.one/1.jpeg",
"https://ap1-img.zeek.one/2.jpeg",
"https://ap1-img.zeek.one/3.jpeg"
],
"remark": {
"partner": "This is the remark sent to partner"
}
}
}
# PA-API-3.3 訂單取消
POST /order/cancel
接口類型 | 請求接口 |
說明 | 取消訂單 |
當訂單狀態為 [9033 待發佈] 或 [9034 指派中] 時,可請求本接口取消訂單,當訂單為其他狀態時,如需取消請與客戶服務人員聯繫
# 請求參數
名稱 | 類型 | 必填 | 默認值 | 說明 | 備註 |
---|---|---|---|---|---|
merchant_id | string | Y | - | 商家 ID | |
order_id | string | Y | - | 訂單 ID | |
cancel_reason | string | N | '' | 取消原因 |
{
"merchant_id": "111111",
"order_id": "DA-A-04844",
"cancel_reason": "用戶取消訂單"
}
# 返回結果
例子:
{
"error": 0
}
# PA-API-3.4 訂單狀態回調
POST 由開發者提供
接口類型 | 回調接口 |
用途 | 當訂單狀態更新時,Zeek 平台調用由開發者提供的回調接口,實時通知。 |
# 請求失敗處理
當 Zeek 平台調用回調接口,收到的回應不是成功時,平台會判斷為通知失敗,此時平台會定期重新發起通知(重試),通知頻率為15/15/30/180/1800/1800/1800/1800/3600 秒。
# 接口授權
Zeek 平台會以 授權和簽名 的方式,在接口傳入簽名,開發者可透過這個方式驗證簽名。
# 請求參數
- 由 Zeek 平台向對接方系統請求
名稱 | 類型 | 必填 | 默認值 | 說明 | 備註 |
---|---|---|---|---|---|
order_id | string | Y | - | 訂單 ID | |
merchant_id | string | Y | - | 商家 ID | |
client | object | Y | - | 商家信息 | |
client.order_id | string | Y | '' | 第三方訂單號 | 在對接方系統內的訂單號 |
client.shipment_code | string | Y | '' | 第三方運單號 | 在對接方系統內的運單號 |
status | object | Y | - | 訂單狀態 | |
status.code | string | Y | - | 訂單狀態碼 | 參看訂單狀態碼 |
status.name | string | Y | - | 訂單狀態描述文字 | Zeek 平台會跟據開發者在創建訂單時傳入的語言,返回一樣語言的文字。 |
status.lastmodify | string | Y | - | 訂單狀態時間 |
{
"order_id": "DA-A-04844",
"merchant_id": "1111111",
"client": {
"order_id": "order-12345",
"shipment_code": "ship-12345"
},
"status": {
"code": "9005",
"name": "正在前往取件",
"lastmodify": "2020-07-22 16:06",
}
}
# 返回結果
- 在請求成功時,對接方平台需要返回以下數據。否則,Zeek 平台會視為請求失敗,並進行重試。
{
"error": 0
}
# PA-API-3.5 訂單狀態
POST /order/status
接口類型 | 請求接口 |
說明 | 查詢訂單的最新狀態 |
# 請求參數
名稱 | 類型 | 必填 | 默認值 | 說明 | 備註 |
---|---|---|---|---|---|
merchant_id | string | Y | - | 商家 ID | |
order_id | string | Y | - | 訂單 ID |
{
"merchant_id": "1111111",
"order_id": "DA-A-04844"
}
# 返回結果
名稱 | 類型 | 說明 | 備註 |
---|---|---|---|
status | object | 訂單狀態 | |
status.code | string | 訂單狀態碼 | 參看訂單狀態碼 |
status.name | string | 訂單狀態描述文字 | |
status.lastmodify | string | 訂單狀態時間 |
例子:
{
"error": 0,
"data": {
"status": {
"code": "9005",
"name": "正在前往取件",
"lastmodify": "2020-07-22 16:06"
}
}
}
# PA-API-3.6 訂單報價
POST /order/quote
接口類型 | 請求接口 |
說明 | 獲取訂單報價 |
# 請求參數
名稱 | 類型 | 必填 | 默認值 | 說明 | 備註 |
---|---|---|---|---|---|
merchant_id | string | Y | - | 商家 ID | |
client | object | Y | - | 商家信息 | |
client.order_id | string | Y | - | 第三方訂單號 | 在對接方系統內的訂單號 |
client.shipment_code | string | N | '' | 第三方運單號 | 在對接方系統內的運單號 |
product_code | string | Y | - | 產品代號 | - 可以傳入"DASH2HR" 、"DASH4HR" 或"MPOINTS" - 請與 Zeek 團隊查詢可以傳入的值。 |
preferences | array | N | [] | 下單偏好 | 請參閱下方的如何傳入 preferences 說明。 使用 "DASH2HR"、"DASH4HR" 的月結合約商家為 選填 月結商家或使用 "MPOINTS" 時為 必填 |
preferences.type | string | Y | - | 偏好類別 | 例子:"business_position" |
preferences.value | string | Y | - | 偏好值 | 例子:"mR" |
schedule_time | string | N | '' | 預約取件時間 | - 即時訂單時不用傳入 - 最早可預約時間 = 當前時間 + 30分鐘 - 最遲可預約時間 = 當前時間 + 31日 - 例子: "2020-09-08 16:00" |
cancel_time | string | N | - | 取消發佈時間 | - 如果一直沒有配送員接單,系統會在傳入的 cancel_time時自動取消訂單。 - 即時單默認是創建訂單 2 小時後自動取消;預約單默認是預約取件時間取消。 - 即時單最大值為當前時間 +24小時;預約單最大值為預約取件時間 +24小時 |
contact | object | N | - | 下單聯絡人信息 | - "DASH2HR", "DASH4HR : 不需要填寫 - "MPOINTS" : 必填 |
contact.name | string | N | '' | 下單聯絡人名字 | |
contact.country_code | string | N | * 請看備注 | 聯絡人電話區號 | 系統跟據 region 配對默認值,例如 region="HK" 時默認值是 "852" |
contact.phone | string | N | '' | 下單聯絡人電話號 | |
path | array | Y | - | 配送路線地點 | - 請按順序傳入取貨點及落貨點。 - "DASH2HR"、"DASH4HR 支持一個取貨點及一個落貨點 - "MPOINTS" 支持一個取貨點及最多二十個落貨點 |
path[].address | string | Y | - | 地址文字 | |
path[].postal_code | string | N | '' | 郵政編碼 | |
path[].description | string | N | - | 地址補充文字 | |
path[].coordinate | string | Y | - | 座標 | 參 地理位置座標 |
path[].contact | array | Y | - | 該配送點的聯絡人信息 | 可以多個聯絡人,至少有一個聯絡人 |
path[].contact[].name | string | Y | - | 聯絡人姓名 | |
path[].contact[].phone | string | Y | - | 聯絡人電話 | |
path[].contact[].country_code | string | N | * 請看備注 | 聯絡人電話區號 | 系統跟據 region 配對默認值,例如 region="HK" 時默認值是 "852" |
path[].contact[].company_name | string | N | '' | 聯絡人公司名稱 | |
vas | array | N | [] | VAS 服務 | 請在 PA-API-2.1 獲取可使用 VAS 獲取可以傳入的 VAS 參數值。 |
vas[].code | string | Y | - | VAS 服務代號 | |
vas[].count | string | Y | - | VAS 服務數量 | |
items | object | Y | - | 下單物品信息 | - "DASH2HR"、"DASH4HR 為必填 - "MPOINTS" 則無需傳入 |
items.amount | string | Y | - | 下單物品總值 | - 單位:元 - 最多兩個小數位 |
items.weight | string | Y | - | 下單物品總重量 | - 單位:KG - 最多兩個小數位 |
items.box | string | Y | - | 貨物容量 Code | 請參閱 Box size code 對應表 |
items.types | array | N | [] | 貨物類型 | - 可填:"Bouquet" 、"Food" 、"Wine" 、"Doc" |
items.detail | string | N | '' | 物品描述文字 | |
cod | object | N | - | 代收款項信息 | |
cod.service_fee | string | N | "0.00" | 代收運費金額 | - 單位:元 - 最多兩個小數位 |
cod.cash | string | N | "0.00" | 代收貨款金額 | - 單位:元 - 最多兩個小數位 |
remark | object | N | - | 備注信息 | |
remark.partner | string | N | '' | 訂單備註,供配送員查看。 |
例子:
{
"merchant_id": "999",
"client": {
"order_id": "1234567890",
"shipment_code": "S99999"
},
"product_code": "MPOINTS",
"preferences": [
{
"type": "business_position",
"value": "mR"
}
],
"schedule_time": "",
"cancel_time": "",
"contact": {
"name": "Chan",
"country_code": "852",
"phone": "98765432"
},
"path": [
{
"address": "Langham Place, 638 Shanghai St, Mong Kok, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.31814, 114.16866",
"contact": [
{
"name": "Lee",
"phone": "98765431",
"country_code": "852",
"company_name": ""
}
]
},
{
"address": "Tuen Mun Town Plaza, 1 Tuen Shun St, Tuen Mun, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.39302, 113.97660",
"contact": [
{
"name": "Cheng",
"phone": "98765430"
}
]
},
{
"address": "New Town Plaza Phase One, 18-19 Sha Tin Centre Street, Sha Tin, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.38177, 114.18862",
"contact": [
{
"name": "Wong",
"phone": "98765433"
}
]
}
],
"vas": [
{
"code": "HKDASH_VDELIVERY_D",
"count": "1",
"fee": ""
}
],
"items": {
"amount": "123",
"weight": "10",
"box": "S",
"types": [
"Bouquet",
"Wine"
],
"detail": "Gift set"
},
"cod": {
"service_fee": "",
"cash": ""
},
"remark": {
"partner": "remark_partner"
}
}
# 如何傳入 preferences
你需要先調用 PA-API-2.2 獲取可使用的商家工種,然後傳入獲得的值。
如果你是打算創建串點 (MPOINTS) 訂單 或你 不是月結合約商家,必須在 preferences
參數傳入一個商家工種 "business_position"。
以下是一個例子:
"preferences": [
{
"type": "business_position",
"value": "mR"
}
]
請與 Zeek 團隊查詢使用方法。
# 返回參數
名稱 | 類型 | 說明 | 備註 |
---|---|---|---|
quotations | array | 報價內容 | |
quotations[].quotation_key | int | 報價ID | |
quotations[].type | array | 類型 | |
quotations[].type.path | string | 路線類型 | exact:用戶傳入路線 smart:系統建議路線 |
quotations[].path | array | 配送路線地點 | 將按順序返回取貨點及落貨點 |
quotations[].path.coordinate | string | 座標 | 格式:緯度,經度 |
quotations[].path.contact | array | 該配送點的聯絡人信息 | |
quotations[].path.contact.name | string | 聯絡人姓名 | |
quotations[].path.contact.phone | string | 聯絡人電話 | |
quotations[].path.contact.country_code | string | 聯絡人電話區號 | |
quotations[].path.contact.company_name | string | 聯絡人公司名稱 | |
quotations[].path.description | string | 地址補充文字 | |
quotations[].path.address | string | 地址文字 | |
quotations[].name | string | 當前報價所屬的名稱 | |
quotations[].binding_parameters | array | 綁定參數 | |
quotations[].binding_parameters.position | string | 工種 | |
quotations[].binding_parameters.position_name | string | 工種名稱 | |
quotations[].binding_parameters.toll_code | string | 收費路段代號 | |
quotations[].binding_parameters.toll_name | string | 收費路段名稱 | |
quotations[].binding_parameters.product_code | string | 產品代號 | |
quotations[].fee | array | 報價 | |
quotations[].fee.amount | string | 報價金額 | |
quotations[].fee_detail | array | 報價詳情 | |
quotations[].fee_detail[].code | string | 費用CODE | |
quotations[].fee_detail[].description | string | 費用描述 | |
quotations[].fee_detail[].description_suffix | string | 費用描述拓展 | |
quotations[].fee_detail[].title | string | 費用標題 | |
quotations[].fee_detail[].fee | string | 費用金額 |
例子:
{
"error": 0,
"data": {
"quotations": [
{
"quotation_key": 11111,
"type": {
"path": "exact"
},
"path": [
{
"type": 2,
"postal": "",
"address": "Langham Place, 638 Shanghai St, Mong Kok, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.31814, 114.16866",
"contact": [
{
"name": "Lee",
"country_code": "852",
"phone": "98765431",
"company_name": ""
}
]
},
{
"type": 2,
"postal": "",
"address": "Tuen Mun Town Plaza, 1 Tuen Shun St, Tuen Mun, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.39302, 113.97660",
"contact": [
{
"name": "Cheng",
"country_code": "",
"phone": "98765430",
"company_name": ""
}
]
},
{
"postal": "",
"address": "New Town Plaza Phase One, 18-19 Sha Tin Centre Street, Sha Tin, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.38177, 114.18862",
"contact": [
{
"name": "Wong",
"country_code": "",
"phone": "98765433",
"company_name": ""
}
]
}
],
"name": "User route",
"binding_parameters": {
"position": "R",
"position_name": "電單車司機",
"business_position": "mR",
"toll_code": "城",
"toll_name": "Shing Mun Tunnels",
"product_code": "MPOINTS"
},
"fee": {
"amount": "241"
},
"fee_detail": [
{
"code": "distance_fee",
"title": "Base fee",
"description": "Base fee",
"description_suffix": "",
"fee": "236"
},
{
"code": "toll_fee",
"title": "Toll road/ area",
"description": "Toll road/ area(電單車司機:Shing Mun Tunnels)",
"description_suffix": "",
"fee": "5"
}
],
"distance": {
"total": "0",
"points_distance": []
},
"publish_until": "2022-09-20 21:09:00"
},
{
"quotation_key": 22222,
"type": {
"path": "smart"
},
"path": [
{
"postal": "",
"address": "Langham Place, 638 Shanghai St, Mong Kok, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.31814, 114.16866",
"contact": [
{
"name": "Lee",
"country_code": "852",
"phone": "98765431",
"company_name": ""
}
]
},
{
"postal": "",
"address": "New Town Plaza Phase One, 18-19 Sha Tin Centre Street, Sha Tin, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.38177, 114.18862",
"contact": [
{
"name": "Wong",
"country_code": "",
"phone": "98765433",
"company_name": ""
}
]
},
{
"postal": "",
"address": "Tuen Mun Town Plaza, 1 Tuen Shun St, Tuen Mun, Hong Kong",
"description": "Shop 999, 999/F",
"coordinate": "22.39302, 113.97660",
"contact": [
{
"name": "Cheng",
"country_code": "",
"phone": "98765430",
"company_name": ""
}
]
}
],
"name": "Suggested route",
"binding_parameters": {
"position": "R",
"position_name": "電單車司機",
"business_position": "mR",
"toll_code": "獅,城",
"toll_name": "Lion Rock Tunnel, Shing Mun Tunnels",
"product_code": "MPOINTS"
},
"fee": {
"amount": "223"
},
"fee_detail": [
{
"code": "distance_fee",
"title": "Base fee",
"description": "Base fee",
"description_suffix": "",
"fee": "210"
},
{
"code": "toll_fee",
"title": "Toll road/ area",
"description": "Toll road/ area(電單車司機:Lion Rock Tunnel, Shing Mun Tunnels)",
"description_suffix": "",
"fee": "13"
}
],
"distance": {
"total": "0",
"points_distance": []
},
"publish_until": "2022-09-20 21:09:00"
}
]
}
}