應用場景
※此規格目前尚未開放
特店進行C2C逆物流訂單查詢作業
API介接網址
- 測試環境：https://logistics-stage.ecpay.com.tw/Helper/QueryLogisticsC2CRtn
- 正式環境：https://logistics.ecpay.com.tw/Helper/QueryLogisticsC2CRtn
HTTPS傳輸協定
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
特店Request參數說明
MerchantID String(10)
廠商編號 必填
由綠界科技提供
AllPayLogisticsID String(20)
綠界科技的物流交易編號
與MerchantTradeNo(廠商交易編號)需二擇一填寫
注意事項：
- 僅提供查詢近5年的物流訂單資料
MerchantTradeNo String(20)
廠商交易編號
- 廠商交易編號均為唯一值，不可重複使用。
- 英數字大小寫混合。
- 與AllPayLogisticsID(綠界科技的物流交易編號)需二擇一填寫
注意事項：
- 僅提供查詢近5年的物流訂單資料
TimeStamp Int
驗證時間 必填
- 將當下的時間轉為UnixTimeStamp，用於驗證此次介接的時間區間。
- 綠界科技驗證時間區間暫訂為 3 分鐘內有效，超過則此次介接無效。
- 參考資料：http://www.epochconverter.com/。
PlatformID String(10)
特約合作平台商代號
- 由綠界科技提供，此參數為專案合作的平台商使用，一般廠商介接請放空值。
- 若為專案合作的平台商使用時，請帶賣家所綁定的MerchantID。
CheckMacValue String
檢查碼 必填
請參考附錄檢查碼機制
綠界Response參數說明
AllPayLogisticsID String(20)
綠界科技的物流交易編號
MerchantTradeNo String(20)
廠商交易編號
CollectionAllocateDate String(10)
物流代收款項撥款日期
格式為：yyyy/MM/dd
CVSPaymentNo String(15)
寄貨編號
- 物流類型為CVS才會回傳
- 超商C2C配送編號請抓取此欄位，7-ELEVEN需再抓取CVSValidationNo進行組合
CVSValidationNo String(10)
驗證碼
(C2C) 7-ELEVEN才會回傳
注意事項：7-ELEVEN C2C 交貨便代碼為CVSPaymentNo與CVSValidationNo的組合。
GoodsAmount Int
商品金額
商品遺失賠償依據
GoodsName String(200)
商品名稱
LogisticsStatus String(8)
物流狀態
請參考物流狀態代碼一覽表
LogisticsType String(20)
會員選擇的物流方式
請參考物流方式一覽表
MerchantID String(9)
廠商編號
HandlingCharge Int
物流費用
ShipChargeDate String(10)
物流運費扣款日期
格式為：yyyy/MM/dd
ShipmentNo String(25)
配送編號
- 物流類型為CVS才會回傳
- 超商B2C配送編號請抓取此欄位
TradeDate String(20)
訂單成立時間
格式為：yyyy/MM/dd HH:mm:ss
SenderName String(10)
退貨寄件人(買家)姓名
SenderPhone String(20)
退貨寄件人(買家)電話
由於此參數在建單時為非必填，且申請物流服務時也非必填，所以可能回傳空值
SenderCellPhone String(10)
退貨寄件人(買家)手機
CheckMacValue String
檢查碼
請參考附錄檢查碼機制