應用場景
B2C訂單(含測試標籤)、宅配訂單可使用此API列印,或是從廠商管理後台列印。
注意事項:
- 使用列印托運單功能時,請勿使用iframe 避免導轉到超商時被阻擋而失敗。
API介接網址
- 測試環境:https://logistics-stage.ecpay.com.tw/helper/printTradeDocument
- 正式環境:https://logistics.ecpay.com.tw/helper/printTradeDocument
HTTPS傳輸協定
- Accept:text/html
- Content Type:application/x-www-form-urlencoded
- HTTP Method:POST
特店Request參數說明
MerchantID String(10)
廠商編號 必填
由綠界科技提供
AllPayLogisticsID String(Max)
物流交易編號 必填
- 可支援單筆或批次列印
- 批次列印須以(,)半型逗號分隔。
例如:10011,10012
注意事項:7-ELEVEN、全家及萊爾富,因各家列印一段標格式不同,不可與其他超商一段標混合列印使用。
PlatformID String(10)
特約合作平台商代號
- 由綠界科技提供,此參數為專案合作的平台商使用,一般廠商介接請放空值。
- 若為專案合作的平台商使用時,請帶賣家所綁定的MerchantID。
PrintMode Int
列印模式
1: 一般模式,A4大小
2: 熱感應標籤機,A6大小
注意事項:
- 對於 POST 物流訂單:
- 如果輸入值為 1:使用一般模式(A4 大小)
- 如果輸入值為 2:使用熱感應標籤機模式(A6 大小)
- 如果輸入其他任何值或未提供此參數:將被視為 1,使用一般模式(A4 大小)
- 對於非 POST 物流訂單:
- 無論輸入任何值,此參數都將被忽略,始終使用一般模式(A4大小)
CheckMacValue String
檢查碼 必填
請參考附錄檢查碼機制