711FreezingC2C V2.0

7-11交貨便(冷凍)C2C物流流程說明

取得店鋪資料並成立訂單取號

導向到選擇物流服務，取得店鋪相關資訊

(會將店號、店名、店址、物流服務、訂單編號回傳至回傳店號網址)

完善訂單資料後組成JSON字串Post到建立物流單

建立訂單成功後帶入指定資料打向獲取出貨單取得配送編號

取得配送編號後至列印7-11大宗(冷凍)物流網址獲取物流單標籤

請於列印標籤後隔日進行出貨，進店日期由物流商分配

7-11 交貨便冷凍C2C流程圖

711FreezingBulkC2Clogisticflow

7-11FreezingC2C API

網址連結

正式: https://logistic.paynow.com.tw
測試: https://testlogistic.paynow.com.tw

1. 選擇物流服務

說明

使用者在此頁面選擇取貨門市，選擇完畢後回傳門市資訊至帶入的回傳網址

傳遞方式：Http POST method

API URL：/Member/Order/Choselogistics

Request

參數	名稱	型態	長度	必須	備註
user_account	商家主帳號	string	10	Y
orderno	訂單編號	string	27	N
apicode	商家api密碼	string	30	Y	請以TripleDESEncoding加密後傳送附錄
Logistic_serviceID	物流服務ID	string	2	Y	22:7-11大宗物流(冷凍)
returnUrl	回傳網址	string	200	Y	回傳店號網址

Response

參數	名稱	型態	長度	必須	備註
orderno	商家訂單編號	string	20	Y	如有帶入訂單編號則回傳訂單編號
service	物流服務	string	2	Y	21:7-11交貨便(冷凍)
storeaddress	店址	string	150	Y
storename	店名	string	30	Y
storeid	店ID	string	10	Y

2. 建立物流訂單

說明

建立物流訂單

傳遞方式：Http POST method application/x-www-form-urlencoded

API URL：/api/Orderapi/Add_Order

Request

參數	名稱	型態	長度	必須	備註
JsonOrder	物流單資料	string		Y	資料組成JSON字串以TripleDESEncoding加密後UrlEncode傳送附錄

JsonOrder Content

參數	名稱	型態	長度	必須	備註
user_account	商家主帳號	string	10	Y
apicode	商家api密碼	string	30	Y
Logistic_service	使用的物流服務	string	2	Y	固定為21代表7-11交貨便(冷凍)
OrderNo	商家訂單編號	string	27	Y	限英文與數字
DeliverMode	取貨是否付款	string	2	Y	01:取貨付款 02:取貨不付款
TotalAmount	總金額	string	5	Y	正整數且金額不可大於20000
Remark	備註	string	200	Y	若不填入值請填空字串
Description	單號描述	string	50	Y	若不填入值請填空字串
EC	EC平台	string	50	N
receiver_storeid	取件店號	string	30	Y
receiver_storename	取件店名	string	100	Y
return_storeid	退件店號	string	6	Y	若不填入值請填空字串
Receiver_Name	收件人姓名	string	10	Y	長度限制須至少包含兩個中文字或4個英文字，最多五個中文字或10個英文字不得包含 , 號
Receiver_Phone	收件人手機	string	10	Y
Receiver_Email	收件人EMAIL	string	100	Y
Receiver_address	收件人地址	string	150	Y	請輸入店址
Sender_Name	寄件人姓名	string	10	Y	長度限制須至少包含兩個中文字或4個英文字，最多五個中文字或10個英文字不得包含 , 號
Sender_Phone	寄件人手機	string	10	Y
Sender_Email	寄件人EMAIL	string	100	Y	如不填入請填空字串
Sender_address	寄件人地址	string	150	Y	如不填入請填空字串
PassCode	傳遞碼	string		Y	以下參數值依序組合起來成一段字串(不包含+號) : user_account + OrderNo + TotalAmount + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄

如為7-11訂單欄位內各屬性都不可帶入Ibon 禁用字元。

Ibon禁用字元 (資料內容請勿使用以下特殊符號):

’單引號 " 雙引號 % 百分比 | pipe符號 & AND符號 ` 重音 ^ caret符號 @ at符號 ! 驚嘆號

. 點 # 井字號 ( 左括號 ) 右括號 * 米字號 _下底線 + 加號 -連接號 ;分號 :冒號 ,逗號

Response

參數	名稱	型態	長度	必須	備註
Status	狀態	string	1	Y	S:成功 F:失敗
LogisticNumber	PayNow物流單號	string	20	Y
LogisticService	物流服務名稱	string		Y	7-11交貨便冷凍
LogisticServiceID	物流服務代碼	string	2	Y	21:7-11交貨便(冷凍)
ErrorMsg	錯誤訊息	string		Y	成功則為null
ReturnMsg	回傳訊息	string		Y
orderno	商家訂單編號	string	27	Y
validationno	物流商驗證碼	string		Y	物流商驗證碼(7-11店到店回傳) 如需使用Ibon列印請搭paymentno 使用

Objec Example

Request Object

{
  "user_account":"28229955",
  "apicode":"12345678",
  "Logistic_service":"22",
  "OrderNo":"211214141817",
  "DeliverMode":"02",
  "TotalAmount":"200",
  "Remark":"",
  "Description":"test",
  "receiver_storeid":"183413",
  "receiver_storename":"八仙門市",
  "return_storeid":"",
  "Receiver_Name":"收件測",
  "Receiver_Phone":"0912345678",
  "Receiver_Email":"123@paynow.com.tw",
  "Receiver_address":"新北市八里區中華路二段290號292號296號",
  "Sender_Name":"寄件測",
  "Sender_Phone":"0900000000",
  "Sender_Email":"test@paynow.com.tw",
  "Sender_address":"",
  "PassCode":"08D6038DFDA1AF0412CBA925135DC33F31C928A1"
}

Response Object

{
  "Status":"S",
  "LogisticNumber":"MIJA0027R22203232824",
  "LogisticService":"7-11交貨便冷凍",
  "LogisticServiceID":"21",
  "paymentno":" D8273267",
  "validationno ":" 9066",
  "ReturnMsg":"",
  "orderno":"220323105411",
  "ErrorMsg":null
}

3. 查詢物流單(PayNow物流單號)

說明

根據PayNow物流單號查詢物流單資訊

傳遞方式：Http GET method

API URL：/api/Orderapi/Get_Order_Info

Request

參數	名稱	型態	長度	必須	備註
LogisticNumber	PayNow物流單號	string	20	Y
sno	物流單序號	int		Y	固定為1

Response

參數	名稱	型態	長度	必須	備註
LogisticNumber	PayNow物流單號	string	20	Y
sno	物流單序號	string		Y
orderno	商家訂單編號	string	30	Y
Logistic_Serviece	物流服務	string	2	Y	21:7-11交貨便(冷凍)
Status	狀態	string	1	Y	0：成立中訂單 1：無效訂單
Delivery_Status	物流狀態	string	2	Y	流程狀態描述
PayNowLogisticCode	物流代碼	string	4	Y	PayNow物流代碼
Detail_Status_Description	物流代碼描述	string		Y	PayNow物流代碼詳細資訊
paymentno	物流商託運單號	string		Y
ErrorMsg	錯誤訊息	string		Y	Null則為查詢成功
validationno	驗證碼	string		Y	物流商驗證碼 (7-11店到店回傳)如需使用Ibon列印請搭paymentno 使用

Objec Example

Request Object

{
  "LogisticNumber":"MIJA0027B22112100002",
  "sno":"1",
}

Response Object

{
  "LogisticNumber":"MIJA0027R22203232824",
  "orderno":"220323105411",
  "Logistic_Serviece":"21",
  "Status":"0",
  "Delivery_Status":"等待寄件",
  "PayNowLogisticCode":"0000",
  "Detail_Status_Description":"訂單已成立 等待出貨",
  "sno":"1",
  "ErrorMsg":null,
  "paymentno":"D8273267",
  "validationno":"9066"
}

4. 查詢物流單(商家訂單編號)

說明

查詢物流單(商家訂單編號)

傳遞方式：Http GET method

API URL：/api/Orderapi/Get_Order_Info_orderno

Request

參數	名稱	型態	長度	必須	備註
orderno	商家訂單編號	string	30	Y
user_account	商家主帳號	string	10	Y
sno	物流單序號	int		Y	固定為1

Response

參數	名稱	型態	長度	必須	備註
LogisticNumber	PayNow物流單號	string	20	Y
sno	物流單序號	string		Y
orderno	商家訂單編號	string	30	Y
Logistic_Serviece	物流服務	string	2	Y	21:7-11交貨便(冷凍)
Status	狀態	string	1	Y	0:成立中訂單 1:無效訂單
Delivery_Status	物流狀態	string	2	Y	流程狀態描述
PayNowLogisticCode	物流代碼	string	4	Y	PayNow物流代碼
Detail_Status_Description	物流代碼描述	string		Y	PayNow物流代碼詳細資訊
paymentno	物流商託運單號	string		Y
ErrorMsg	錯誤訊息	string		Y	Null則為查詢成功
validationno	驗證碼	string		Y	物流商驗證碼 (7-11店到店回傳) 如需使用Ibon列印請搭paymentno 使用

Objec Example

Request Object

{
  "orderno":"1630206584255",
  "user_account":"28229955",
  "sno":"1",
}

Response Object

{
  "LogisticNumber":"MIJA0027R22203232824",
  "orderno":"220323105411",
  "Logistic_Serviece":"21",
  "Status":"0",
  "Delivery_Status":"等待寄件",
  "PayNowLogisticCode":"0000",
  "Detail_Status_Description":"訂單已成立 等待出貨",
  "sno":"1",
  "ErrorMsg":null,
  "paymentno":"D8273267",
  "validationno":"9066"
}

5. 取消物流單

說明

將該張物流單更改為無效訂單，若為出貨中大宗訂單無法使用功

傳遞方式：Http DELETE method application/x-www-form-urlencoded

API URL：/api/Orderapi/CancelOrder

Request

參數	名稱	型態	長度	必須	備註
LogisticNumber	Paynow物流單號	string	20	Y
sno	物流單序號	int		Y	請帶1
PassCode	傳遞碼	string		Y	以下參數值依序組合成一段字串(不包含+號)user_account + OrderNo + TotalAmount + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄

Response

參數	名稱	型態	長度	必須	備註
		string		Y	純字串 S成功回傳: S,訂單已取消失敗回傳:F,訂單取消失敗失敗原因: 失敗原因

6. 門市更新(關轉)

說明

接收到門市關轉需求的訂單由此API指定新門市進行配送
請於收到貨態代碼7101、7104、7201、7204日期D+7前關轉，逾期則無法關轉，例如:2020/10/07收到7101的貨態代碼，請於10/14前打此API進行更換門市
關轉發生原因：進行出貨後因各種狀況無法將包裹配達指定門市，需請商家/消費者更換取件門市

傳遞方式： Http Put method application/x-www-form-urlencoded

API URL： /api/Orderapi/Put

Request

參數	名稱	型態	長度	必須	備註
UpdateOrder	物流單資料	string		Y
LogisticNumber	PAYNOW物流單號	string	20	Y
sno	物流單序號	int		Y	請帶1
ChangeType	改變方式	string	2	Y	01:取件門市更新 02:退件門市更新
NewStoreId	新門市店號	string		Y
NewStoreName	新門市名稱	string		Y
PassCode	傳遞碼	string		Y	以下參數值依序組合起來成一段字串(不包含+號) : user_account + Orderno + TotalAmount + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄

Response

參數	名稱	型態	長度	必須	備註
		string		Y	純字串成功回傳: S 失敗回傳: F,失敗原因: 失敗原因

Objec Example

Request Object

{
 "LogisticNumber":"MIJA0027B22112100002",
 "sno":"1",
 "ChangeType":"01",
 "NewStoreId":"863698",
 "NewStoreName":"豫銘門市",
 "PassCode":"4CF47FD844DF64C5D0FBF8DD134708B55ABE208B"
}

7. 列印超商物流單(物流標籤)

說明

列印7-11交貨便物流單

傳遞方式：Http Post method

API URL：

/Member/Order/Print711FreezingC2CLabel

Request

參數	名稱	型態	長度	必須	備註
orderNumberStr	訂單編號	string		Y	Paynow物流單號多筆之間用,相隔 Ex:ABCD0017B21903001221,ABCD0017B21903001270
user_account	商家主帳號	string	10	Y

Response

參數	名稱	型態	長度	必須	備註
純字串		string			成功回傳: S,網址失敗回傳: F,錯誤訊息

參數

名稱

型態

長度

必須

備註

純字串

string

成功回傳: S,網址

失敗回傳: F,錯誤訊息

8. 物流貨態回傳

說明

商家接收物流貨態，更新貨態時由PayNow傳送訂單貨態資料給商家

傳遞方式：Http Post method

Response

參數	名稱	型態	長度	必須	備註
orderno	商家自訂編號	string	30	Y
OriginOrderno	商家原始自訂單號	string	27	Y
PayNowLogisticCode	物流代碼	string	4	Y
Detail_Status_Description	物流狀態描述	string	2	Y
paymentno	物流商託運單號	string		Y
StoreDate	到店日期	string		N	若代碼為5000/5001 商品實際到店日期
StoreTime	到店時間	string		N	若代碼為5000/5001 商品實際到店時間

9. 重新取號

說明

依商家原有訂單資料進行重新取號(PayNow物流單號、配送編號)
重新取號過的訂單若需在重取請帶入新的LogisticNumber

傳遞方式：Http POST method application/x-www-form-urlencoded

API：/api/Orderapi/ReNewOrder

Request

參數	名稱	型態	長度	必須	備註
JsonOrder	物流單資料	string		Y	以下資料組成Object後轉換JsonString以TripleDESEncoding加密後urlencode傳送附錄

Json Content

參數	名稱	型態	長度	必須	備註
user_account	商家主帳號	string	10	Y
LogisticNumber	Paynow物流單號	string	20	Y
sno	物流單序號	int		Y
OrderNo	商家訂單編號	string	27	Y	商家原始訂單編號
TotalAmount	訂單總金額	string	5	Y
apicode	商家api密碼	string	30	Y
PassCode	傳遞碼	string		Y	以下參數值依序組合成一段字串(不包含+號)user_account + OrderNo + TotalAmount + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄

Response

參數	名稱	型態	長度	必須	備註
Status	狀態	string	1	Y	S:成功 F:失敗
LogisticNumber	PayNow物流單號	string	20	Y
OrderNo	商家原始訂單編號	string	27	Y
sno	物流單序號	int		Y
paynoworderno	新訂單編號	string	30	Y	重新取號後新的商家訂單編號若於成立訂單日7天後重取會取得新訂單編號，請以此訂單編號作為批次列印與查詢的訂單編號
paymentno	物流商貨運編號	string		Y	重新取號後新的物流商貨運編號
validationno	物流商驗證碼	string		Y	物流商驗證碼如需使用Ibon列印請搭paymentno使用
ErrorMsg	錯誤訊息	string		Y	成功則為null

Objec Example

Request Object

{
  "LogisticNumber":"MIJA0027B22112100002",
  "OrderNo":"211210165125",
  "apicode":"12345678",
  "TotalAmount":"200",
  "user_account":"28229955",
  "PassCode":"4CF47FD844DF64C5D0FBF8DD134708B55ABE208B",
  "sno":"1"
}

Response Object

{
  "LogisticNumber":"MIJA0027B22112100002",
  "OrderNo":"211210165125",
  "paynoworderno":"211210165125",
  "sno":"1",
  "paymentno":"M0045670",
  "validationno":"1600",
  "Status":"S",
  "ErrorMsg":null
}

7-11冷凍C2C物流貨態代碼

貨態代碼

貨態代碼	貨態描述
0	訂單已成立等待寄件中
101	商品已到寄件門市
102	門市已更新寄件中
103	門市已更新退件中
4000	進驗成功
4034	同一個訂單兩包商品資料重複
4060	物流中心理貨中
4063	包裹異常不配送
4064	取消寄件再次寄送(直接轉 C 店)
4065	提早轉 C 店-廠商因素(直接轉 C 店)
4066	提早轉 C 店-超商因素(直接轉 C 店)
4075	包裹異常進入判賠程序
4076	包裹已送達物流中心，即將配送至指定門市
4077	無退件門市資料
4078	包裹等待配送中
4079	包裹進行配送中
5000	取件門市配達
5001	退件門市配達
5011	作業錯誤
5012	車輛故障
5013	天候不佳
5014	道路中斷
5015	門市停業
5017	門市報缺
5018	寄件貨態異常協尋中
5019	取件包裹異常協尋中
5021	物流中心暫報缺
5022	驗收前包裹異常
5201	EC收退
5202	交貨便收件
5204	異常收退
5301	取消寄件
5302	寄件遺失進行賠償程序
5303	取件遺失進行賠償作業
6002	待退貨請盡速取件
7001	正常一退
7012	門市關店
7013	門市轉店
7014	廠商要求
7015	商品為違禁品，將進行退貨處理與罰款
7021	刷 A 給 B
7022	消費者要求
7101	取件門市關轉店
7102	取件門市舊店號更新
7104	取件門市臨時關轉店
7201	退件門市關轉店
7202	退件門市舊店號更新
7203	退件門市無取件門市資料
7204	退件門市臨時關轉店
8000	買家已取件
8077	退至7總倉
8100	賣家已取件
8305	已送宅配
8306	放7天後拋棄
9411	貨態停滯

貨態代碼流變動程
一般出貨流程(成功取件)
0101->5202->4060->4000->5000->8000
一般出貨流程(退貨成功)
0101->5202->4060->4000->5000->6002->7001->4000->5001->8100
門市關轉(更新門市後取件成功)
0101->7101 or 7104->0102->4000->5000->8000
門市關轉(更新退件門市後成功)
0101->5202->4000->5000->7201 or 7203 or 7204->0103->4000->5001->8100

711FreezingC2C V2.0

7-11交貨便(冷凍)C2C物流流程說明​

取得店鋪資料並成立訂單取號​

7-11FreezingC2C API​

網址連結​

1. 選擇物流服務​

2. 建立物流訂單​

3. 查詢物流單(PayNow物流單號)​

4. 查詢物流單(商家訂單編號)​

5. 取消物流單​

6. 門市更新(關轉)​

7. 列印超商物流單(物流標籤)​

8. 物流貨態回傳​

9. 重新取號​

7-11冷凍C2C物流貨態代碼​

7-11交貨便(冷凍)C2C物流流程說明

取得店鋪資料並成立訂單取號

7-11FreezingC2C API

網址連結

1. 選擇物流服務

2. 建立物流訂單

3. 查詢物流單(PayNow物流單號)

4. 查詢物流單(商家訂單編號)

5. 取消物流單

6. 門市更新(關轉)

7. 列印超商物流單(物流標籤)

8. 物流貨態回傳

9. 重新取號

7-11冷凍C2C物流貨態代碼