應用場景：
每當物流狀態有變更時，綠界科技會主動傳送物流狀態至合作特店。
Step1. 綠界科技：以 ServerPost 方式傳送物流狀態至合作特店設定的(ServerReplyURL) 網址
Step2. 合作特店：收到綠界科技的物流狀態，RtnCode請回應1
注意事項：
- 若未正確回應(RtnCode=1)，系統會隔60分鐘後重發訊息給特店，當天重複發送三次。
- 若特店持續收到綠界回傳的物流狀態(貨態)通知，此時請檢查是否未正確回應(RtnCode=1)給綠界。
HTTPS 傳輸協定
- Content Type ：application/json
- HTTP Method ：POST
綠界Request參數說明(Json格式)
PlatformID String(10)
特約合作平台商代號
- PlatformID為與綠界有合作專案的特約平台商身分使用。一般特店或賣家身分(Merchant)，或平台商本身，此參數請帶放空值。
- 若隸屬於特約平台商的一般特店，此參數請帶放平台商的MerchantID。
RpHeader Object
回傳資料
Timestamp String(10)
回傳時間
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
注意事項：
- 驗證時間區間為 5 分鐘內有效，若超過此驗證時間則此次訂單將無法建立，產生時間戳請參考相關資料。
- 合作特店須進行主機「時間校正」，避免主機產生時差，延伸API無法正常運作。
TransCode Int
回傳代碼
1 代表 API 傳輸資料(MerchantID, RqHeader, Data)接收成功，實際的 API 執行結果狀態請參考 RtnCode。
TransMsg String(200)
回傳訊息
Data String
加密資料
綠界Request參數範例
{
"MerchantID": "2000132",
"RqHeader": {
"Timestamp": "1525169058"
},
"TransCode": 1,
"TransMsg": "",
"Data": "加密資料"
}
Data參數說明(Json格式)
RtnCode Int
回應代碼
1 代表 API 執行成功，其餘代碼均為失敗，失敗代碼請參考交易訊息代碼表。
RtnMsg String(200)
回應訊息
MerchantID String(10)
廠商編號
RtnMerchantTradeNo String(20)
廠商交易編號
LogisticsID String(20)
綠界訂單編號
LogisticsStatus String(8)
物流狀態
LogisticsStatusName String(100)
貨態代碼訊息
GoodsAmount Int
商品金額
UpdateStatusDate String(20)
物流狀態更新時間
BookingNote String(50)
托運單號
回傳Data參數範例
{
"RtnCode": 1,
"RtnMsg": "成功",
"LogisticsStatus": "300",
"LogisticsStatusName": "訂單處理中(已收到訂單資料)",
"MerchantID": "2000132",
"RtnMerchantTradeNo": "1234567890",
"LogisticsID": "1234567890",
"GoodsAmount": 1,
"UpdateStatusDate": "2020/05/09 10:36:04",
"BookingNote": "xxxx"
}
特店Response參數說明(Json格式)
PlatformID String(10)
特約合作平台商代號
- PlatformID為與綠界有合作專案的特約平台商身分使用。一般特店或賣家身分(Merchant)，或平台商本身，此參數請帶放空值。
- 若隸屬於特約平台商的一般特店，此參數請帶放平台商的MerchantID。
RpHeader Object
回傳資料
Timestamp String(10)
回傳時間
請將傳輸時間轉換為時間戳(GMT+8)，綠界會利用此參數將當下的時間轉為Unix TimeStamp來驗證此次介接的時間區間。
注意事項：
- 驗證時間區間為 5 分鐘內有效，若超過此驗證時間則此次訂單將無法建立，產生時間戳請參考相關資料。
- 合作特店須進行主機「時間校正」，避免主機產生時差，延伸API無法正常運作。
TransCode Int
回傳代碼
1 代表 API 傳輸資料(MerchantID, RqHeader, Data)接收成功，實際的 API 執行結果狀態請參考 RtnCode。
TransMsg String(200)
回傳訊息
Data String
加密資料
特店Response參數範例
{
"MerchantID": "2000132",
"RpHeader": {
"Timestamp": "1525169058"
},
"TransCode": 1,
"TransMsg": "",
"Data": "加密資料"
}
Data參數範例
{
"RtnCode": 1,
"RtnMsg": "成功"
}