SuperMarketC2C V2.5

7-11、Family、OK、萊爾富常溫C2C物流流程說明

導向到選擇物流服務，取得店鋪相關資訊 (會將店號、店名、店址、物流服務、訂單編號回傳至回傳店號網址)

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

建立訂單成功後至列印四大超商交貨便網址獲取交貨便列印網址

需於規定時間內到四大超商列印繳費寄貨，開始物流流程

7-11、Family：7天、萊爾富：5天、OK：15天

7-11、OK、萊爾富物流C2C流程圖

7-11_OK_HilieFlow

Family物流C2C流程圖

FamilyFlow

7-11、Family、OK、萊爾富C2C 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	01:7-11交貨便 03:全家店到店 05:萊爾富店到店 10:OK店到店依輸入值導向到該服務的電子地圖如為空值則導向到選擇物流服務頁面
returnUrl	回傳網址	string	200	Y	回傳店號網址

Response

參數	名稱	型態	長度	必須	備註
orderno	商家訂單編號	string	20	Y	如有帶入訂單編號則回傳訂單編號
service	物流服務	string	2	Y	01:7-11交貨便 03:全家店到店 05:萊爾富店到店 10:OK店到店
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	01:7-11交貨便 03:全家店到店 05:萊爾富店到店 10:OK店到店
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	請勿帶入標點符號 7-11交貨便 : 長度限制為10 全家店到店 : 長度限制為30 萊爾富店到店 : 長度限制為20 OK店到店 :長度限制為10
Receiver_Phone	收件人手機	string	10	Y
Receiver_Email	收件人EMAIL	string	100	Y
Receiver_address	收件人地址	string	150	Y	請輸入店址
Sender_Name	寄件人姓名	string	10	Y	請勿輸入標點符號
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	物流服務名稱Ex：7-11 交貨便
LogisticServiceID	物流服務代碼	string	2	Y	01:7-11交貨便 03:全家店到店 05:萊爾富店到店 10:OK店到店依輸入值導向到該服務的電子地圖
ErrorMsg	錯誤訊息	string		Y	成功則為null
paymentno	物流商貨運編號	string		Y	超商物流配送編號
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":"MIJA0027C22112026083",
  "LogisticService":"7-11交貨便",
  "LogisticServiceID":"01",
  "paymentno":"L9991156",
  "validationno":"0497",
  "ReturnMsg":"",
  "orderno":"211202115804",
  "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	01:7-11交貨便 03:全家店到店 05:萊爾富店到店 10:OK店到店
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":"MIJA0027B22112100002",
  "orderno":"211210165125",
  "Logistic_Serviece":"02",
  "Status":"0",
  "Delivery_Status":null,
  "PayNowLogisticCode":"",
  "Detail_Status_Description":"",
  "sno":"1",
  "ErrorMsg":null,
  "paymentno":"",
  "validationno": "0497"
} 

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	01:7-11交貨便 03:全家店到店 05:萊爾富店到店 10:OK店到店
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":"MIJA0027B22112100002",
  "orderno":"211210165125",
  "Logistic_Serviece":"02",
  "Status":"0",
  "Delivery_Status":"等待寄件",
  "PayNowLogisticCode":"",
  "Detail_Status_Description":"",
  "sno":"1",
  "ErrorMsg":null,
  "paymentno":"",
  "validationno": "0497"
} 

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,訂單已取消失敗回傳 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

UpdateOrder Content

參數	名稱	型態	長度	必須	備註
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、Family、OK、萊爾富)物流單

傳遞方式：Http Get method

API URL：

/api/Order711
/api/OrderFamiC2C
/api/OrderHiLife
/api/OKC2C

Request

參數	名稱	型態	長度	必須	備註
orderNumberStr	訂單編號	string		Y	由商家訂單編號組成的字串每筆orderno之間以逗號( , )分隔一次最多可列印100筆訂單
user_account	商家主帳號	string	10	Y

參數

名稱

型態

長度

必須

備註

orderNumberStr

訂單編號

string

由商家訂單編號組成的字串

每筆orderno之間以逗號( , )分隔

一次最多可列印100筆訂單

user_account

商家主帳號

string

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
重新取號特別規則
1. 萊爾富需在訂單成立30分鐘後才能進行重新取號

傳遞方式：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		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-11 5天 / 全家當天 / 萊爾富 5天) 請以此訂單編號作為批次列印查詢的訂單編號
paymentno	物流商貨運編號	string		Y	重新取號後新的物流商貨運編號
validationno	物流商驗證碼	string		Y	物流商驗證碼(7-11店到店回傳) 如需使用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
}

10. 全家店號轉換

說明

轉換全家現行店號/原始店號

傳遞方式：Http GET method

API：/api/OrderFamiC2C/GetFamiStoreID

Request

參數	名稱	型態	長度	必須	備註
storeId	店號	string	6	Y
IDtype	轉換類型	string	1	Y	1:轉換成現行店號 2:轉換成原始店號

Response

參數	名稱	型態	長度	備註
storeId	店號	string	6
IDtype	轉換類型	string	1
Error	錯誤訊息	string		沒有錯誤則為空值

Objec Example

Response Object

{
 "storeId": "017206",
  "IDtype": "1",
  "Error": "",
}

貨態代碼

	貨態代碼	貨態描述
C2C相同代碼	0000	訂單已成立等待出貨
	0000	訂單已成立等待出貨
	0101	商品已到寄件門市
	0102	門市已更新寄件中
	0103	門市已更新退件中
	4000	進驗成功
	4031	商品破損退貨中
	4032	商品超才退貨中
	4040	條碼資料錯誤
	5000	取件門市配達
	5001	退件門市配達
	7101	取件門市關轉店
	7201	退件門市關轉店
	8000	買家已取件
	8010	買家已取件-代收金額錯誤
	8020	買家已取件商品有誤
	8100	賣家已取件
	8110	賣家已取件-代收金額錯誤
	8120	賣家已取件商品有誤
	9411	貨態停滯
7-11代碼	4019	物流中心未收到貨
	4033	違禁品進行罰款退貨中
	4034	同一個訂單兩包商品資料重複
	4035	已過門市進貨日
	4036	門市關轉請更新門市
	4037	條碼規格錯誤
	4038	條碼無法判讀
	4060	物流中心理貨中
	4061	商品遺失
	4062	門市不配送
	4063	包裹異常不配送
	4064	取消寄件再次寄送(直接轉 C 店)
	4065	提早轉 C 店-廠商因素(直接轉 C 店)
	4066	提早轉 C 店-超商因素(直接轉 C 店)
	5011	作業錯誤
	5012	車輛故障
	5013	天候不佳
	5014	道路中斷
	5015	門市停業
	5016	缺件
	5017	門市報缺
	5018	寄件貨態異常協尋中
	5019	取件包裹異常協尋中
	5102	管制品取件門市配達
	5103	管制品退件門市配達
	5201	EC收退
	5202	交貨便收件
	5203	退貨便收件
	5204	異常收退
	5301	取消寄件
	5302	寄件遺失進行賠償程序
	5303	取件遺失進行賠償作業
	6002	待退貨請盡速取件
	6003	退至7總倉
	7001	正常一退
	7011	商品瑕疵
	7012	門市關店
	7013	門市轉店
	7014	廠商要求
	7015	商品為違禁品，將進行退貨處理與罰款
	7021	刷 A 給 B
	7022	消費者要求
	7102	取件門市舊店號更新
	7104	取件門市臨時關轉店
	7202	退件門市舊店號更新
	7203	退件門市無取件門市資料
	7204	退件門市臨時關轉店
	8077	退至7總倉
全家代碼	4019	物流中心未收到貨
	4067	小物流遺失
	4068	門市遺失
	4069	包裝廠不良包裝廠不良 (滲漏 )
	4070	門市反應商品包裝不良(滲漏)
	4071	門市關店
	4072	條碼資料重複
	4073	7日內未寄件單號失效
	4074	貨物進店後發生異常提早退貨
	5200	商品運送中
	6002	待退貨請盡速取件
	6004	商品退回物流中心
	8002	退至全家總倉
萊爾富代碼	4067	小物流遺失
	4068	門市遺失
	4069	包裝廠不良包裝廠不良 (滲漏 )
	4070	門市反應商品包裝不良(滲漏)
	4071	門市關店
	4073	7日內未寄件單號失效
	4074	貨物進店後發生異常提早退貨
	8079	退至萊爾富總倉
OK代碼	4030	無進貨資料
	4031	商品破損退貨中
	4032	商品超才退貨中
	4040	條碼資料錯誤
	4069	包裝廠不良包裝廠不良 (滲漏 )
	4070	門市反應商品包裝不良
	4074	貨物進店後發生異常提早退貨
	8076	退至OK總倉

貨態代碼流變動程
一般出貨流程(成功取件)
0101->5202->4000->5000->8000
一般出貨流程(退貨成功)
0101->5202->4000->5000->6002->5201->7001->5001->8100
二次退貨(貨到物流中心)
0101->4000->5000->6002->4000->5001->8079(萊爾富總倉) or 8077(7-11總倉) or8002(全家總倉)
門市關轉(更新門市後取件成功)
0101->7101 or 7104->0102->4000->5000->8000
門市關轉(更新退件門市後成功)
0101->5202->4000->5000->7201 or 7203 or 7204->0103->4000->5001->8100

SuperMarketC2C V2.5

7-11、Family、OK、萊爾富常溫C2C物流流程說明​

7-11、Family、OK、萊爾富C2C API​

網址連結​

1. 選擇物流服務​

2. 建立物流訂單​

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

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

5. 取消物流單​

6. 門市更新(關轉)​

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

8. 物流貨態回傳​

9. 重新取號​

1. 萊爾富需在訂單成立30分鐘後才能進行重新取號​

10. 全家店號轉換​

7-11、Family、OK、萊爾富常溫C2C物流流程說明

7-11、Family、OK、萊爾富C2C API

網址連結

1. 選擇物流服務

2. 建立物流訂單

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

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

5. 取消物流單

6. 門市更新(關轉)

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

8. 物流貨態回傳

9. 重新取號

1. 萊爾富需在訂單成立30分鐘後才能進行重新取號

10. 全家店號轉換