超商 / 測試標籤資料產生

應用場景

申請全家及7-ELEVEN超商B2C物流的廠商,需要測標通過後才可建立B2C物流訂單,此API可以產生測標所需要的測試訂單資訊。可於廠商管理後台列印,或透過列印託運單

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
檢查碼 

請參考附錄檢查碼機制

❗ 注意事項:

  1. 請務必使用雷射印表機列印標籤,並用”信封袋”寄送至各物流中心進行標籤刷讀,如不符合標準,日後出貨商品不予驗收,以退貨處理。以下地址僅供測標寄送
    • 全家標籤寄送地址:335 桃園市大溪區新光東路76巷22-2號。日翊文化電子商務部- EC測標收。
    • 7-ELEVEN標籤寄送地址:238新北市樹林區佳園路二段70-1號。大智通文化行銷-EC驗收組收。
    • 7-ELEVEN B2C冷凍店取標籤寄送地址:744 台南市新市區大營里7號。統昶物流中心–EC冷凍店取測標收。
  2. 7-ELEVEN 訂單測標資料後,請於D+5日 14:00 前列印,超過便無法列印
  3. 全家訂單建立後,請於6日內列印,超過便無法列印
  4. 測標結果查詢:
    • 全家:測標結果請務必點擊「廠商管理後台」> 物流管理 > 對帳查詢 >【一段標查詢】,查詢按鈕後,若測標成功,方可正常建立訂單。
    • 7-ELEVEN:測標結果由綠界科技客服通知,可在廠商管理後台 >廠商專區 >廠商基本資料 >物流資訊 >測標結果查詢,若測標成功,方可正常建立訂單 。

幕後產生物流訂單回應訊息範例:

  • 正確:
				
					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
				
			

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.

綠界官方網站