應用場景
使用者在特店(賣家會員)消費後，特店(賣家會員)將結帳完成的出貨資訊(訂購資訊包含選擇的門市電子地圖資料等)POST至綠界科技建立門市訂單。
注意事項：
- 全家及7-ELEVEN 超商B2C大宗寄件，皆需先完成「測標」作業，若測標未通過而進行寄件將會被物流中心退回，運費須由特店(賣家會員)負擔。
- 測標作業流程，請參考廠商管理後台→物流管理→對帳查詢→一段標查詢。
- 選擇地圖與門市建立訂單間隔時間太長，需留意門市關轉導致無法建立訂單。
- 測試環境請使用以下門市進行測試：
- 7-ELEVEN 超商：131386
- 7-ELEVEN 超商冷凍店取：896539
- 全家：006598
- OK：1328
- 訂單產生成功後，請確認ServerReplyURL是否收到成功的物流狀態，確保後續能持續收到物流狀態通知。
- (B2C)訂單寄貨編號請使用物流訂單查詢API取得ShipmentNo
- 建立訂單時，依其物流子類型有商品金額限制，如自行使用金流信用卡付款超過此金額上限，風險須自行承擔。
- 如帳戶餘額過低，將無法建立物流單，建議留存一定金額於綠界帳戶或至廠商後台預存綠界帳戶餘額供物流費扣款使用。
- 其餘出貨相關請參考附錄：出貨注意事項
API介接網址
- 測試環境：https://logistics-stage.ecpay.com.tw/Express/Create
- 正式環境：https://logistics.ecpay.com.tw/Express/Create
HTTPS傳輸協定
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
特店Request參數說明
MerchantID String(10)
廠商編號 必填
由綠界科技提供
MerchantTradeNo String(20)
廠商交易編號
- 支援中文、數字、英文大小寫
- 廠商交易編號均為唯一值，不可重複使用
- 廠商交易編號可為空，系統會自動產生一組廠商訂單編號。
MerchantTradeDate String(20)
廠商交易時間 必填
請依消費者交易的當下時間設定
(此時間不會等於綠界建立物流訂單完成的時間)
格式為：yyyy/MM/dd HH:mm:ss
LogisticsType String(20)
物流類型 必填
CVS：超商取貨
LogisticsSubType String(20)
物流子類型 必填
當物流類型為CVS時，子物流類型選擇以下類型：
- B2C
FAMI：全家
UNIMART：7-ELEVEN超商
UNIMARTFREEZE：7-ELEVEN冷凍店取
HILIFE：萊爾富 - C2C
FAMIC2C：全家店到店
UNIMARTC2C：7-ELEVEN超商交貨便
HILIFEC2C：萊爾富店到店
OKMARTC2C：OK店到店
注意事項：
- 若申請類型為B2C，只能串參數為FAMI、UNIMART、HILIFE、UNIMARTFREEZE
- 若申請類型為C2C，只能串參數為FAMIC2C、UNIMARTC2C、HILIFEC2C、OKMARTC2C
GoodsAmount Int
商品金額 必填
- 商品金額範圍為1~20000元。
- 訂單的商品金額如果超出範圍，會訂單失敗且回傳錯誤代碼10500040商品金額錯誤
CollectionAmount Int
代收金額
物流子類型為UNIMARTC2C (7-ELEVEN超商交貨便) 時，代收金額需要與商品金額一致。
IsCollection String(1)
是否代收貨款
- N：不代收貨款，為預設值。
- Y：代收貨款，則代收貨款金額為商品金額。
GoodsName String(50)
商品名稱
若物流子類型(LogisticsSubType)為以下類型時，此欄位不可為空：
- UNIMARTC2C(7-ELEVEN超商交貨便)
- HILIFEC2C(萊爾富店到店)
- OKMARTC2C(OK超商店到店)
注意事項：不得輸入^ ‘ ` ! @ # % & * + \ ” < >| _ [ ]等特殊符號。
SenderName String(10)
寄件人姓名 必填
注意事項：
- 字元限制為4~10個字元(例：半形英文可支援4~10個字，中文可支援2~5個字)
- 不可帶入數字和特殊符號(禁用特殊符號如下所示)
- 不可帶入不符合姓名規則的文字如表情圖示(emoji符號)
- C2C店到店未取退回原寄件門市，須出示身分證件領取，請勿填寫公司名稱，避免無法領取退件。
SenderPhone String(20)
寄件人電話
SenderCellPhone String(10)
寄件人手機
若物流子類型(LogisticsSubType)為以下類型時，此欄位不可為空：
- UNIMARTC2C(7-ELEVEN超商交貨便)
- HILIFEC2C(萊爾富店到店)
- OKMARTC2C(OK超商店到店)
注意事項：
- 只允許數字、長度限制10碼、必須以09開頭
- 物流子類型為FAMIC2C(全家店到店)時，若欄位為空值，為避免無法發送退貨通知簡訊，系統將預設帶入廠商後台>廠商專區>廠商基本資料>寄件人資訊欄位中所填寫的手機號碼。
ReceiverName String(10)
收件人姓名 必填
注意事項：
- 字元限制為4~10個字元(例：半形英文可支援4~10個字，中文可支援2~5個字)
- 不可帶入數字和特殊符號(禁用特殊符號如下所示)
- 不可帶入不符合姓名規則的文字如表情圖示(emoji符號)
ReceiverPhone String(20)
收件人電話
注意事項：允許數字+特殊符號；特殊符號僅限()-#
ReceiverCellPhone String(10)
收件人手機 必填
注意事項：只允許數字、長度限制10碼、必須以09開頭
ReceiverEmail String(50)
收件人email
TradeDesc String(200)
交易描述
ServerReplyURL String(200)
Server端回覆網址 必填
物流狀態都會透過此URL通知
ClientReplyURL String(200)
Client端回覆網址
訂單建立成功後，才會將頁面導轉至此URL，反之則無作用
注意事項：若要使用幕後建立訂單，此欄位請勿填寫
Remark String(200)
備註
PlatformID String(10)
特約合作平台商代號
- 由綠界科技提供，此參數為專案合作的平台商使用，一般廠商介接請放空值。
- 若為專案合作的平台商使用時，請帶賣家所綁定的MerchantID。
CheckMacValue String
檢查碼 必填
請參考附錄檢查碼機制
ReceiverStoreID String(6)
收件人門市代號 必填
ReturnStoreID String(6)
退貨門市代號
若沒有設定ReturnStoreID，當貨品退貨時，會返回原寄件門市，若有設定則會送至指定的退貨門市
注意事項：僅7-ELEVEN C2C適用，其他超商C2C帶此參數仍會退回原寄件門市。
綠界Response參數說明
MerchantID String(10)
廠商編號
MerchantTradeNo String(20)
廠商交易編號
訂單產生時傳送給綠界科技的廠商交易編號
RtnCode Int
目前物流狀態
請參考物流狀態代碼一覽表
RtnMsg String(200)
物流狀態說明
AllPayLogisticsID String(20)
綠界科技的物流交易編號
請保存綠界科技的交易編號與 AllPayLogisticsID的關連。
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)
收件人地址
CVSPaymentNo String(15)
寄貨編號
CVSValidationNo String(10)
驗證碼
(C2C) 7-ELEVEN才會回傳
注意事項：7-ELEVEN C2C 交貨便代碼即為CVSPaymentNo與CVSValidationNo的組合。
BookingNote String(50)
托運單號
物流類型為HOME才會回傳
CheckMacValue String
檢查碼
合作特店必須檢查CheckMacValue來驗證，請參考附錄檢查碼機制
幕後產生物流訂單回應訊息範例：
- 正確
1|MerchantID=XXX&MerchantTradeNo=XXX&RtnCode=XXX&BookingNote=&RtnMsg=XXX&AllPayLogisticsID=XXX&LogisticsType=XXX&LogisticsSubType=XXX&GoodsAmount=XXX&UpdateStatusDate=XXX&ReceiverName=XXX&ReceiverPhone=XXX&ReceiverCellPhone=XXX&ReceiverEmail=XXX&ReceiverAddress=XXX&CVSPaymentNo=XXX &CVSValidationNo=XXX &CheckMacValue=XXX
- 錯誤
0| ErrorMessage