建立物流訂單 / 物流狀態(貨態)通知

應用場景：

每當物流狀態有變更時，綠界科技會主動傳送物流狀態至合作特店。

Step1. 綠界科技：以 ServerPost 方式傳送物流狀態至合作特店設定的(ServerReplyURL) 網址
Step2. 合作特店：收到綠界科技的物流狀態，RtnCode請回應1

注意事項：

若未正確回應(RtnCode=1)，系統會隔60分鐘後重發訊息給特店，當天重複發送三次。
若特店持續收到綠界回傳的物流狀態(貨態)通知，此時請檢查是否未正確回應(RtnCode=1)給綠界。
測試環境尚無提供模擬物流狀態通知功能，若需得知實際物流狀態，請於正式環境建立訂單並出貨。
物流狀態是由物流中心發送給綠界，收到後會依當下排程回傳至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

HTTPS 傳輸協定

Content Type ：application/json
HTTP Method ：POST

綠界Request參數說明(Json格式)

PlatformID String(10)
特約合作平台商代號

PlatformID為與綠界有合作專案的特約平台商身分使用。一般特店或賣家身分(Merchant)，或平台商本身，此參數請帶放空值。
若隸屬於特約平台商的一般特店，此參數請帶放平台商的MerchantID。

MerchantID String(10)
特店編號

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
加密資料

回傳相關資料，此為加密過JSON格式的資料。加密方法說明

綠界Request參數範例

				
					{
"MerchantID": "2000132",
    "RqHeader": {
        "Timestamp": "1525169058"
    },
    "TransCode": 1,
    "TransMsg": "",
    "Data": "加密資料"
}

Data參數說明(Json格式)

RtnCode Int
回應代碼

1 代表 API 執行成功，其餘代碼均為失敗，失敗代碼請參考交易訊息代碼表。

RtnMsg String(200)
回應訊息

MerchantID String(10)
廠商編號

LogisticsType String(20)
物流類型

HOME：宅配
CVS：店到店

LogisticsSubType String(20)
物流子類型

請參考物流方式一覽表

MerchantTradeNo String(20)
廠商交易編號

LogisticsID String(20)
綠界訂單編號

LogisticsStatus String(8)
物流狀態

回傳代碼請參考物流狀態代碼一覽表

LogisticsStatusName String(100)
貨態代碼訊息

回傳代碼請參考物流狀態代碼一覽表

GoodsAmount Int
商品金額

商品金額範圍為1~20000元
訂單的商品金額如果超出範圍，會更新訂單失敗

UpdateStatusDate String(20)
物流狀態更新時間

格式為: yyyy/MM/dd HH:mm:ss

ReceiverName String(10)
收件人姓名

ReceiverPhone String(20)
收件人電話

ReceiverCellPhone String(20)
收件人手機

ReceiverEmail String(50)
收件人Email

ReceiverAddress String(60)
收件人地址

CVSPaymentNo String(15)
寄貨編號

CVSValidationNo String(10)
驗證碼

(C2C) 7-ELEVEN 才會回傳

BookingNote String(50)
托運單號

物流類型為 HOME 才會回傳

回傳Data參數範例

				
					{
    "RtnCode": 1,
    "RtnMsg": "成功", 
    "LogisticsType": "CVS",
    "LogisticsSubType": "FAMI",
    "MerchantID": "2000132",
    "MerchantTradeNo": "1234567890",
    "LogisticsID": "1234567890",
    "LogisticsStatus": "300",
    "LogisticsStatusName": "訂單處理中(已收到訂單資料)",
    "GoodsAmount": 1,
    "UpdateStatusDate": "2020/05/09 10:36:04",
    "ReceiverName": "Test receiver",
    "ReceiverCellPhone": "85212345678",
    "ReceiverEmail": "xxx@xxx.com.tw",
    "ReceiverAddress": "xxxx",
    "CVSPaymentNo": "xxxx",
    "CVSValidationNo": "xxxx",
    "BookingNote": "xxxx"
}

特店Response參數說明(Json格式)

PlatformID String(10)
特約合作平台商代號

PlatformID為與綠界有合作專案的特約平台商身分使用。一般特店或賣家身分(Merchant)，或平台商本身，此參數請帶放空值。
若隸屬於特約平台商的一般特店，此參數請帶放平台商的MerchantID。

MerchantID String(10)
特店編號

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
加密資料

回傳相關資料，此為加密過JSON格式的資料。加密方法說明

特店Response參數範例

				
					{
"MerchantID": "2000132",
    "RpHeader": {
        "Timestamp": "1525169058"
    },
    "TransCode": 1,
    "TransMsg": "",
    "Data": "加密資料"
}

Data參數說明(Json格式)

RtnCode Int
回應代碼

1 代表 API 執行成功，其餘代碼均為失敗，失敗代碼請參考交易訊息代碼表。

RtnMsg String(200)
回應訊息

Data參數範例

				
					{
    "RtnCode": 1,
    "RtnMsg": "成功"
}

綠界官方網站