應用場景
每當物流狀態有變更時，綠界科技皆會傳送物流狀態至合作特店。
- Step1 綠界科技：以 ServerPOST 方式傳送物流狀態至合作特店設定的(ServerReplyURL) 網址
- Step2 合作特店：收到綠界科技的物流狀態，並判斷檢查碼是否相符
- Step3 合作特店：檢查碼相符後，在網頁端回應 1|OK
HTTPS傳輸協定
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
綠界Request參數說明
MerchantID String(10)
廠商編號
由綠界科技提供
MerchantTradeNo String(20)
廠商交易編號
訂單產生時傳送給綠界科技的廠商交易編號
RtnCode Int
目前物流狀態
請參考物流狀態代碼一覽表
RtnMsg String(200)
物流狀態說明
AllPayLogisticsID String(20)
綠界科技的物流交易編號
請保存綠界科技的物流交易編號與廠商交易編號的關連。
LogisticsType String(20)
物流類型
請參考物流方式一覽表
LogisticsSubType String(20)
物流子類型
請參考物流方式一覽表
GoodsAmount Int
商品金額
商品遺失賠償依據
UpdateStatusDate String(20)
物流狀態更新時間
格式為:
yyyy/MM/dd HH:mm:ss
ReceiverName String(60)
收件人姓名
ReceiverPhone String(20)
收件人電話
ReceiverCellPhone String(20)
收件人手機
ReceiverEmail String(50)
收件人email
ReceiverAddress String(200)
收件人地址
CVSPaymentNo String(15)
寄貨編號
CVSValidationNo String(10)
驗證碼
(C2C) 7-ELEVEN才會回傳
BookingNote String(50)
托運單號
物流類型為HOME才會回傳。
CheckMacValue String
檢查碼
合作特店必須檢查CheckMacValue來驗證，請參考附錄檢查碼機制
特店Response參數說明
回傳值為純字串並無參數名稱。
- 若回傳值為1|OK時為成功
- 未回傳或回傳為非1|OK時為失敗
1|OK
注意事項：
- 請賣家會員必須判斷CheckMacValue是否正確，以及是否已經對該筆訂單的付款通知，做過相對應的處理，若不判斷，請賣家會員自行承擔損失。
- 若未正確回應1|OK，系統會進入排程重發訊息給特店，三次後則會延至隔天再發訊息，從貨態更新日起維持三天發送。回應訊息請勿有任何HTML標籤、空格等其他符號。
- 測試環境尚無提供模擬物流狀態通知功能，若需得知實際物流狀態，請於正式環境建立訂單並出貨。
- 物流狀態是由物流中心發送給綠界，收到後會依當下排程回傳至ServerReplyURL，因此狀態通知不是即時傳送。
- ServerReplyURL若未持續收到更新狀態，亦可使用「查詢物流訂單API」進行反查。此外，狀態也會因物流配送過程異常而導致狀態未更新。
- 常用物流狀態RtnCode說明：
 物流狀態\物流方式 |
7-ELEVEN B2C |
7-ELEVEN C2C |
全家 B2C |
全家 C2C |
萊爾富B2C |
萊爾富C2C |
OK C2C |
|---|---|---|---|---|---|---|---|
|
商品已送至物流中心 |
2030 |
2030 |
3024 |
3024 |
3024
|
3024
|
2030
|
|
商品已送達門市 |
2063 |
2073 |
3018 |
3018 |
3018
|
3018
|
2073
|
|
消費者成功取件 |
2067 |
2067 |
3022 |
3022 |
3022
|
3022
|
3022
|
|
消費者七天未取件 |
2074 |
2074 |
3020 |
3020 |
3020
|
3020
|
2074
|