超商 / 列印託運單 / B2C(含測標)、宅配

應用場景

B2C訂單(含測試標籤)、宅配訂單可使用此API列印,或是從廠商管理後台列印。

❗ 注意事項:

  1. 使用列印托運單功能時,請勿使用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
檢查碼 必填

請參考附錄檢查碼機制

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

綠界官方網站