711OverSea V2.7
7-11 海外配送(店配/宅配)相關規定
運費
- 依配送國家、材積、重量有所不同,可使用查詢物流重量費用預估運費。
- 寄件前請先預估包裹重量與材積,包裹到倉後倉庫會進行測量,以倉庫測量為主。
- 重量與材積兩者取較高值計價,材積算法請參考 材積算法表。
- 實際收取運費由會計帳務為主,可使用查詢寄送包裹費用明細取得運費相關資訊。
禁運物品
香港
活生動物(蜜蜂、水蛭及蠶除外);各類動物之骨骼、無煙菸草製品、攝氏 60 度以下會產生引火點之油漆、洋漆、亮 漆及其類似物質;炸藥、煙火、火柴及各類易燃、易爆物質、仿製郵政出版之信封、明信片及郵政用品;具煽動性之物 品;彩券及與彩券有關之文件;涉及非法業務之賭博性廣告;相命廣告及任意散發之地下非法借貨廣告;猥褻或有傷風 化之物品;載有仿製郵政機關使用之字語、信函或標記之物品;侵害商標或著作權之物品;印有模仿郵票之物品含有猥 亵或下流之繪畫或文字:偽造郵票或具有模仿郵票之物品:香水產品;鋰電池…
新加坡
電子香菸、電子菸斗、電子雪茄菸
馬來西亞
活生動物及動物製品:肉類及動物內臟、海鮮類、奶製品、燕窩、蛋類;植物(包括任何種類之植物及其部分:例如根、 莖、葉、花果、種子等)及其製品、菲律寶或印尼生產之可可、紅毛丹、山荔枝、龍眼等水果;動物性肥料、易燃燒、 易爆炸之化學混合物及任何會釋放瓦斯及發熱的物質、煙火、爆竹:用來錄音或錄影的磁帶;未加工的木頭;廢棄紙類、 硬紙板及用以造紙之紙材:猥褻,淫穢之書報、圖畫、照片;未使用之郵資、銀行支票、錢幣、印染沙龍(裙)之布料、印 有可蘭經經文之紡織品:軍用衣物及装備;繩索、防水卡其外套及長襪、紡織設備、安全帽(除了腳踏車、機車騎士使 用者);未製成形之玻璃、鑽石、珠寶;刀劍及魚叉、魚槍;碾米機及其零件;電力設備及其零件、電訊設備及廣播器材:單色影印機器、武器、彈藥;遊戲機的代幣或磁片、通訊產品(如手機等)須提出 SIRIM 許可證,在海關規定之時間內無法 提供認證者,郵件將扣押不予退回
以上資訊僅供參考,實際規範以各國海關公布內容為主
注意事項
- 香港 進口免稅額:無須繳付關稅。除:1.酒類、菸草、碳氫油類、甲醇 2.任何貿易、商業用途均無免稅優惠
- 馬來西亞 偏遠地區需加收費用(東馬地區/郵遞區號為:87xxx 以上)
- 澳門 店配為智能櫃取件,店配取貨為 3 天內,因疫情關係目前為 24 小時內取件
- 中國: 運費有兩種報價上海、江蘇、浙江、廣東、深圳、福建、廈門 FeeMode=0,其他省分 FeeMode=1。 目前中國無法進行配送
進口免稅額請參考下表,實際收取費用還是以各國海關收取的費用為準
材積算法表
國家 | 國家代碼 | 到店取貨天數 | 重量(kg)/材積(cm)限制 | 進口免稅額參考 | 當地物流宅配費用 | 材積計算方式 |
---|---|---|---|---|---|---|
香港 | HK | 3 天 | 店配:30*50*30cm 5kg 宅配:85*85*85cm 20kg | 無須繳付 關稅 | 第1公斤 27HKD 第2-5公斤 37HKD | 長*寬*高/6000 |
新加坡 | SG | 2 天 | 店配:長+寬+高80cm 5kg 宅配:85*85*85cm 20kg | SGD400 | 首重 7SGD/kg 續重 3SGD/Kg。 | 長*寬*高/6000 |
馬來西亞 | MY | 4 天 | 店配:40*40*40cm 4kg 宅配:85*85*85cm 20kg 液體可送 | MYR500 | 西馬: 首重 9MYR/kg 續重 3MYR/Kg 東馬: 首重 23MYR/Kg 續重 16MYRkg | 長*寬*高/6000 |
澳門 | MO | 24小時內 | 店配:45*31*35cm 20kg 宅配:120*80*70cm 20kg | 同區一件為 10 元澳門幣 跨區 2KG 以內 22 元澳門幣 | 長*寬*高/6000 | |
泰國 | TH | 3 天 | 店配:60*60*60cm 5kg 宅配:85*85*85cm 20kg | 價格已含稅 | 首重 60NTD/Kg 續重 15NTD/kg | 長*寬*高/6000 |
越南 | VN | 宅配:3kg | 價格已含稅 | 長*寬*高/6000 | ||
美國 | US | 宅配:100*80*70cm 20kg (建議 5kg 以下,超過容易 被查驗而產生關稅) | USD800 | 長*寬*高/5000 |
其他國家
- 宅配: 100*80*70cm 20kg
- 材積計算方式: 長*寬*高/5000
國家 | 進口免稅額 |
---|---|
菲律賓 | PHP 10000 |
印尼 | USD 3 |
柬埔寨 | USD 50 |
日本 | JPY 10000 |
韓國 | KRW 16000 |
中國 | RMB 50 |
澳洲 | AUD1000 |
紐西蘭 | NZD 60 |
加拿大 | CAD 60 |
法國 | EUR 22 |
德國 | EUR 22 |
義大利 | EUR 22 |
英國 | EUR 15 |
墨西哥 | USD 50 |
7-11 海外配送(店配)流程說明
取得店鋪資料並成立訂單取號
導向到選擇物流服務,取得店鋪相關資訊。
(會將店號、店名、店址、物流服務、訂單編號回傳至回傳店號網址)。
完善訂單資料後組成JSON字串Post到建立物流單。
建立訂單成功後至列印7-11海外配送(店配/宅配)網址獲取列印物流單網址。
訂單成立後需於5日內進行完成寄件(含成立當日),開始物流流程。
未取貨包裹後續流程
包裹將轉為海外宅配,店配費用由商家支付,
宅配費用由消費者現場支付給當地物流業者,若消費者轉宅配後拒收,宅配費用改由商家支付(店配未取轉宅配,請參考表1當地物流宅配費用)
若最終消費者未取件,包裹回至當地倉庫(保留七天),商家於七天內選擇銷毀或寄回台灣(需再支付物 流費)
7-11 海外配送(店配)流程圖
7-11 海外配送(宅配)流程說明
取得店鋪資料並成立訂單取號
完善訂單資料後組成JSON字串Post到建立物流單
建立訂單成功後至列印7-11海外配送(店配/宅配)網址獲取列印物流單網址
訂單成立後需於5日內進行完成寄件(含成立當日),開始物流流程
未取貨包裹後續流程
包裹回至當地倉庫(保留七天),商家於七天內選擇銷毀或寄回台灣(需再支付物流費)
7-11 海外配送(宅配)流程圖
7-11OverSea API
網址連結
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 | 07:7-11海外配送(店配) |
returnUrl | 回傳網址 | string | 200 | Y | 回傳店號網址 |
Country | 國家代碼 | string | 3 | Y | SG:新加坡/MY:馬來西亞/HK:香港/ MO:澳門/TH 泰國顯示全部國家請輸入 ALL |
Response
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
orderno | 商家訂單編號 | string | 20 | Y | 如有帶入訂單編號則回傳訂單編號 |
service | 物流服務 | string | 2 | Y | 07: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 | 07:7-11海外配送(店配) 08:7-11海外配送(宅配) |
OrderNo | 商家訂單編號 | string | 27 | Y | 限英文與數字 |
DeliverMode | 取貨是否付款 | string | 2 | Y | 02:取貨不付款 |
TotalAmount | 總金額 | string | 5 | Y | 包裹金額,正整數,請帶入台幣金額 |
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 | 非新馬/中港澳外國家 必填英文姓名 |
Receiver_Phone | 收件人手機 | string | 10 | Y | 請填手機號碼不含符號、空格,全數字含國碼 香港請填入 852 後接手機號碼(純數字) 澳門請填入 853 後接手機號碼(純數字) 泰國且為店取者請填入手機號碼,不含國碼且為0開頭,共 10 碼 |
Receiver_Email | 收件人EMAIL | string | 100 | Y | |
Receiver_address | 收件人地址 | string | 150 | Y | 除新馬/港澳以外,其他國家之收件人 地址長度不可大於135byte 除新馬/中港澳以外,其他國家之收件人地址需填英文 |
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雜湊函數取得組合字串的雜湊值附錄 | |
ReceiverCountry | 收件人國家 | string | 2 | Y | 必填英文,請參考材積算法表 填入查詢國家代碼 API 的 CountryId |
ReceiverCode | 收件人宅配郵編 | string | 10 | Y | 配送國家為香港請帶入: 00000 配送國家為澳門請帶入: 999078 請勿包含特殊符號 |
Weight | 包裹重量(KG) | string | 5 | Y | 請參考材積算法表,可帶小數點 |
Length | 外箱長(cm) | string | 5 | Y | 請參考材積算法表,可帶小數點 |
Width | 外箱寬(cm) | string | 5 | Y | 請參考材積算法表,可帶小數點 |
Height | 外箱高(cm) | string | 5 | Y | 請參考材積算法表,可帶小數點 |
如為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海外配送 7-11海外配送宅配 | |
LogisticServiceID | 物流服務代碼 | string | 2 | Y | 07:7-11海外配送(店配) 08:7-11海外配送(宅配) |
ErrorMsg | 錯誤訊息 | string | Y | 成功則為null | |
ReturnMsg | 回傳訊息 | string | Y | ||
orderno | 商家訂單編號 | string | 27 | Y | |
paymentno | 物流商貨運編號 | string | Y | 超商物流配送編號 |
Objec Example
Request Object
{
"user_account":"28229955",
"apicode":"12345678",
"Logistic_service":"07",
"OrderNo":"211224100919",
"DeliverMode":"02",
"TotalAmount":"200",
"Remark":"",
"Description":"test",
"receiver_storeid":"853A2012",
"receiver_storename":"OK",
"return_storeid":"",
"Receiver_Name":"收件測",
"Receiver_Phone":"85312312385312312385",
"Receiver_Email":"123@paynow.com.tw",
"Receiver_address":"新北市三重區力行路二段158號160號",
"Sender_Name":"寄件測",
"Sender_Phone":"0900000000",
"Sender_Email":"test@paynow.com.tw",
"Sender_address":"",
"PassCode":"79DB118BBDF1969DC6070BAB6BFEC9BC3B2F8C10",
"ReceiverCountry":"MO",
"ReceiverCode":"0000",
"Weight":"5",
"Length":"30",
"Width":"30",
"Height":"20"
}
Response Object
{
"Status":"S",
"LogisticNumber":"MIJA0027O22112241104",
"LogisticService":"7-11海外配送",
"LogisticServiceID":"07",
"ReturnMsg":"",
"orderno":"211224100919",
"paymentno":"PRE21120000301180",
"ErrorMsg":null,
}
3. 列印 7-11 海外配送(店配/宅配)(物流標籤)
說明
- 列印 7-11 海外配送(店配/宅配)物流單,店配/宅配可一起進行列印
- 超過成立訂單後 5 日(包含成立訂單當日),將無法列印標籤,請重新取號
- 單筆列印導向列印畫面,多筆列印將下載 Excel,發生錯誤的訂單會放入 NoShipNo 工作表,寫入錯誤原因+訂單編號,Excel 請放入導向畫面內批次查詢進行標籤列印
傳遞方式:Http GET method
API URL:/api/OverSeas711Order
Request
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
orderNumberStr | Orderno組成的字串 | string | Y | 由商家訂單編號組成的字串每筆orderno之間以逗號(,)分隔一次最多可列印 100 筆訂單 |
Response
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
string | 成功回傳: S,網址 失敗回傳: F,錯誤訊息 |
4. 物流貨態回傳
說明
- 商家接收物流貨態,更新貨態時由PayNow傳送訂單貨態資料給商家
傳遞方式:Http Post method
Request
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
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 商品實際到店時間 |
5. 查詢物流單
說明
- 根據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 | 07:7-11海外配送(店配) 08: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則為查詢成功 |
Objec Example
Request Object
{
"LogisticNumber":"MIJA0027B22112100002",
"sno":"1",
}
Response Object
{
"LogisticNumber":"MIJA0027H22112242931",
"orderno":"20211224102345",
"Logistic_Serviece":"08",
"Status":"0",
"Delivery_Status":"等待寄件",
"PayNowLogisticCode":"0000",
"Detail_Status_Description":"物流訂單等待出貨",
"sno":"1",
"ErrorMsg":null,
"paymentno":"PRE21120000303581"
}
6. 查詢物流單
說明
- 查詢物流單(商家訂單編號)
傳遞方式: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 | 07:7-11海外配送(店配) 08: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則為查詢成功 |
7. 重新取號
說明
- 依商家原有訂單資料進行重新取號(PayNow 物流單號、配送編號)
- 重新取號規則
1. 已獲取出貨單號且訂單狀態為成立中,且買家尚未取貨
傳遞方式:Http POST method application/x-www-form-urlencoded
API:URL/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 | 請以此訂單編號作為批次列印查詢的訂單編號 |
paymentno | 物流商貨運編號 | string | Y | 重新取號後新的物流商貨運編號 | |
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":"82900502031",
"Status":"S",
"ErrorMsg":null
}
8. 查詢國家代碼
說明
- 查詢海外配送國家的國家代碼
傳遞方式:Http POST method application/x-www-form-urlencoded
API:/api/OverSeas711Order/SelCountryID
Request
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
JsonOrder | 物流單資料 | string | Y | 以下資料組成Object後轉換JsonString以TripleDESEncoding加密後urlencode傳送附錄 |
Json Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
user_account | 商家主帳號 | string | 10 | Y | |
apicode | 商家api密碼 | string | 30 | Y |
Response
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Status | 狀態 | string | 1 | Y | S:成功 F:失敗 |
ErrorMsg | 錯誤訊息 | string | Y | Status="S" 回傳空白字串 Status="F" 回傳錯誤訊息 | |
Detail | 明細 | Array | Y |
Detail Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
CountryId | 國家代碼 | string | 2 | Y | 查詢物流費用 API CountryId 帶入值 |
ChineseName | 國家中文名稱 | string | 20 | Y | |
EnglishName | 國家英文名稱 | string | 100 | Y |
Objec Example
Response Object
{
"Status":"S",
"ErrorMsg":"",
"Detail":
[
{"CountryId":"AD","ChineseName":"安道爾","EnglishName":"Andorra"},
{"CountryId":"AF","ChineseName":"阿富汗","EnglishName":"Afghanistan"},
{"CountryId":"AI","ChineseName":"安圭拉","EnglishName":"Anguilla"},
]
}
9. 查詢物流重量費用
說明
- 獲取物流重量費用,此費用不包含營業稅5%
傳遞方式:Http POST method application/x-www-form-urlencoded
API:/api/Orderapi/SelWeightChart
Request
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
JsonOrder | 物流單資料 | string | Y | 以下資料組成Object後轉換JsonString以TripleDESEncoding加密後urlencode傳送附錄 |
Json Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
user_account | 商家主帳號 | string | 10 | Y | |
apicode | 商家api密碼 | string | 30 | Y | |
LogisticServiceID | 物流服務 | string | 2 | Y | 07:7-11海外配送(店配) 08:7-11海外配送(宅配) |
LogisticServiceID2 | 物流服務 | string | 2 | N | 07:7-11海外配送(店配) 08:7-11海外配送(宅配) |
CountryID | 國家代碼 | string | Y | 請帶入查詢國家代碼API CountryId欄位 |
Response
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Status | 狀態 | string | 1 | Y | S:成功 F:失敗 |
ErrorMsg | 錯誤訊息 | string | Y | Status="S" 回傳空白字串 Status="F" 回傳錯誤訊息 | |
Detail | 明細 | Array | Y |
Detail Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Country | 國家 | string | 50 | Y | 查詢物流費用 API CountryId 帶入值 |
Weight | 包裹重量(KG) | string | 10 | Y | |
Cost | 費用 | decimal | (8,2) | Y | |
FeeMode | 運費計算模式 | string | 5 | 0:正常 1:偏遠地區 | |
Pay | 收費方案 | string | 5 | 0:一般 1:經濟 2:空運 3:運費到付 4:其他 | |
DeliveryMethod | 配送方式 | string | 5 | 0:店配 1:宅配 |
Objec Example
Request Object
{
{
"user_account":"28229955",
"apicode":"12345678",
"LogisticServiceID":"08",
"LogisticServiceID2":"",
"CountryID":"US"
}
}
Response Object
{
"Status":"S",
"ErrorMsg":"",
"Detail":
[
{
"Country":"US",
"Weight":"0.5KG",
"Cost":733.00,
"FeeMode":"0",
"Pay":"0",
"DeliveryMethod":"1"
},
{
"Country":"US",
"Weight":"1KG",
"Cost":842.00,
"FeeMode":"0",
"Pay":"0",
"DeliveryMethod":"1"
}
]
}
10. 查詢寄送包裹費用明細(依訂單編號)
說明
- 獲取 7-11 海外配送(店配/宅配)寄送包裹費用明細,店配/宅配可一起查詢
- 店配未取轉宅配後宅配未取,僅顯示店配費用
- 發生錯誤/例外狀況的訂單將跳過此單號繼續執行,錯誤訂單紀錄於OrderError,發生未預期狀況中斷查詢
傳遞方式:Http POST method application/x-www-form-urlencoded
API:/api/OverSeas711Order/SelBillDetail
Request
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
JsonOrder | 物流單資料 | string | Y | 以下資料組成Object後轉換JsonString以TripleDESEncoding加密後urlencode傳送附錄 |
Json Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
user_account | 商家主帳號 | string | 10 | Y | |
apicode | 商家api密碼 | string | 30 | Y | |
Orderno | 物流服務 | string | 2 | Y | 多筆訂單之間以逗號 ( , )分隔 |
Response
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Status | 狀態 | string | 1 | Y | S:成功 F:失敗 |
ErrorMsg | 錯誤訊息 | string | Y | Status="S" 回傳空白字串 Status="F" 回傳錯誤訊息 | |
OrderError | 錯誤訂單明細 | Array | Y | Status="S" 回傳空白字串 Status="F" 回傳錯誤訊息 | |
Detail | 明細 | Array | Y |
OrderError Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Orderno | 訂單編號 | string | 50 | Y | |
Msg | 錯誤訊息 | string | 10 | Y |
Detail Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Orderno | 國家 | string | 50 | Y | |
CountryChineseName | 國家 | string | 20 | Y | |
ShipNo | 配送編號 | string | 17 | Y | |
Date | 貨品入倉刷單日 | string | 10 | 日期格式("yyyy-MM-dd") | |
Weight | 總重量 | decimal | (8,2) | ||
Total | 總金額 | decimal | (8,2) |
Objec Example
Request Object
{
{
"user_account":"28229955",
"apicode":"12345678",
"Orderno":"82900502031"
}
}
Response Object
成功
{
"Status":"S",
"ErrorMsg":"",
"OrderError":
[
{
"Orderno":"1438205834844",
"CountryChineseName":"馬來西亞",
"ShipNo":"GMJI7110000349001",
"Date":"2020-01-20",
"Weight":1.00,
"Total":272.00
}
]
}
(含有查詢錯誤的訂單)
{
"Status":"F",
"ErrorMsg":"訂單查詢錯誤",
"OrderError":
[
{
"Orderno":"1124204550182",
"Msg":"無相關訂單資料"
}
],
"Detail":
[
{
"Orderno":"1438205834844",
"CountryChineseName":"馬來西亞",
"ShipNo":"GMJI7110000349001",
"Date":"2020-01-20",
"Weight":1.00,
"Total":272.00
}
]
}
11. 查詢寄送包裹費用明細(依日期)
說明
- 獲取 7-11 海外配送(店配/宅配)寄送包裹費用明細,店配/宅配可一起查詢
- 店配未取轉宅配後宅配未取,僅顯示店配費用
- 每週四更新帳務,可查詢至上一周整周帳務(查詢結果包含結束日期當日)
傳遞方式:Http POST method application/x-www-form-urlencoded
API:/api/OverSeas711Order/SelBillDetailDate
Request
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
JsonOrder | 物流單資料 | string | Y | 以下資料組成Object後轉換JsonString以TripleDESEncoding加密後urlencode傳送附錄 |
Json Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
user_account | 商家主帳號 | string | 10 | Y | |
apicode | 商家api密碼 | string | 30 | Y | |
StartDate | 開始日期 | string | 10 | Y | 日期格式("yyyy-MM-dd") |
EndDate | 結束日期 | string | 10 | Y | 日期格式("yyyy-MM-dd") |
Response
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Status | 狀態 | string | 1 | Y | S:成功 F:失敗 |
ErrorMsg | 錯誤訊息 | string | Y | Status="S" 回傳空白字串 Status="F" 回傳錯誤訊息 | |
OrderError | 錯誤訂單明細 | Array | Y | Status="S" 回傳空白字串 Status="F" 回傳錯誤訊息 | |
Detail | 明細 | Array | Y |
OrderError Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Orderno | 訂單編號 | string | 50 | Y | |
Msg | 錯誤訊息 | string | 10 | Y |
Detail Content
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
Orderno | 國家 | string | 50 | Y | |
CountryChineseName | 國家 | string | 20 | Y | |
ShipNo | 配送編號 | string | 17 | Y | |
Date | 貨品入倉刷單日 | string | 10 | 日期格式("yyyy-MM-dd") | |
Weight | 總重量 | decimal | (8,2) | ||
Total | 總金額 | decimal | (8,2) |
Objec Example
Request Object
{
{
"user_account":"28229955",
"apicode":"12345678",
"StartDate":"2024-11-01",
"EndDate":"2024-11-30"
}
}
Response Object
成功
{
"Status":"S",
"ErrorMsg":"",
"OrderError":
[
{
"Orderno":"1438205834844",
"CountryChineseName":"馬來西亞",
"ShipNo":"GMJI7110000349001",
"Date":"2020-01-20",
"Weight":1.00,
"Total":272.00
}
]
}
(含有查詢錯誤的訂單)
{
"Status":"F",
"ErrorMsg":"訂單查詢錯誤",
"OrderError":
[
{
"Orderno":"1124204550182",
"Msg":"無相關訂單資料"
}
],
"Detail":
[
{
"Orderno":"1438205834844",
"CountryChineseName":"馬來西亞",
"ShipNo":"GMJI7110000349001",
"Date":"2020-01-20",
"Weight":1.00,
"Total":272.00
}
]
}
7-11大宗物流貨態代碼
貨態代碼 | 貨態描述 |
---|---|
0000 | 訂單已成立 等待出貨 |
5000 | 門市配達 |
5401 | 提單成立 |
5402 | 已入倉 |
5403 | 出口作業中 |
5404 | 已出倉 |
5405 | 清關中 |
5406 | 派送中 |
5407 | 取消 |
5408 | 問題單 |
5409 | 退件包裹 |
5410 | 店取未取轉宅配失敗 |
5411 | 宅配失敗 |
5412 | 台灣海關檢查不通過 |
5413 | 標籤異常/包裝異常/訂單異常取消 |
5414 | 貨件遺失 |
5415 | 包裹異常(件數不對/超材) |
8000 | 買家已取件 |
9411 | 貨態停滯 |
貨態代碼流變動程 |
---|
07:7-11 海外配送(店配) |
一般出貨流程(成功取件) |
5401->5402->5405->5406->5000->8000 |
一般出貨流程(退貨成功) |
5401->5402->5405->5406->5000->5409 |
07:7-11 海外配送(宅配) |
一般出貨流程(成功取件) |
5401->5402->5405->5406->8000 |
一般出貨流程(退貨成功) |
5401->5402->5405->5406->5409 |