API介接網址
- 測試環境:https://logistics-stage.ecpay.com.tw/Express/CreateTestData
- 正式環境:https://logistics.ecpay.com.tw/Express/CreateTestData
HTTPS傳輸協定
- HTTP Method:POST
- Accept:text/html
- Content Type:application/x-www-form-urlencoded
特店Request參數說明
MerchantID String(10)
廠商編號 必填
由綠界科技提供
ClientReplyURL String(200)
Client端回覆網址
訂單建立成功後,才會將頁面導轉至此URL,反之則無作用。
PlatformID String(10)
特約合作平台商代號
- 由綠界科技提供,此參數為專案合作的平台商使用,一般廠商介接請放空值。
- 若為專案合作的平台商使用時,請帶賣家所綁定的MerchantID。
LogisticsSubType String(20)
物流子類型 必填
- FAMI:全家
- UNIMART:7-ELEVEN超商
- UNIMARTFREEZE:7-ELEVEN冷凍店取
注意事項:各物流子類型都需要分別測標,通過後才可建單
CheckMacValue String
檢查碼 必填
請參考附錄檢查碼機制
綠界Response參數說明
MerchantID String(9)
廠商編號
MerchantTradeNo String(20)
廠商交易編號
RtnCode String
目前物流狀態
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)
收件人地址
BookingNote String(50)
托運單號
空白
CVSPaymentNo String(15)
寄貨編號
空白
CVSValidationNo String(10)
驗證碼
空白
CheckMacValue String
檢查碼
請參考附錄檢查碼機制
注意事項:
- 請務必使用雷射印表機列印標籤,並用”信封袋”寄送至各物流中心進行標籤刷讀,如不符合標準,日後出貨商品不予驗收,以退貨處理。以下地址僅供測標寄送
- 全家標籤寄送地址:335 桃園市大溪區新光東路76巷22-2號。日翊文化電子商務部- EC測標收。
- 7-ELEVEN標籤寄送地址:238新北市樹林區佳園路二段70-1號。大智通文化行銷-EC驗收組收。
- 7-ELEVEN B2C冷凍店取標籤寄送地址:744 台南市新市區大營里7號。統昶物流中心–EC冷凍店取測標收。
- 7-ELEVEN 訂單測標資料後,請於D+5日 14:00 前列印,超過便無法列印
- 全家訂單建立後,請於6日內列印,超過便無法列印
- 測標結果查詢:
幕後產生物流訂單回應訊息範例:
- 正確:
1|MerchantID=XXX&MerchantTradeNo=XXX&RtnCode=XXX&RtnMsg=XXX&AllPayLogisticsID=XXX&LogisticsType=XXX&LogisticsSubType=XXX&GoodsAmount=XXX&UpdateStatusDate=XXX&ReceiverName=XXX&ReceiverPhone=XXX&ReceiverCellPhone=XXX&ReceiverEmail=XXX&ReceiverAddress=XXX&BookingNote=&CVSPaymentNo=XXX&CVSValidationNo=XXX &CheckMacValue=XXX
- 錯誤:
0| ErrorMessage