taiwan-logistics-skill 1.2.2 → 1.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,27 +1,23 @@
1
- field_name,field_zh,ecpay_name,newebpay_name,payuni_name,type,required,max_length,format,notes
2
- merchant_id,商店代號,MerchantID,uid,MerID,string,true,10,,
3
- order_id,訂單編號,MerchantTradeNo,merchant_order_no,MerTradeNo,string,true,20,英數字,需唯一
4
- order_date,訂單日期,MerchantTradeDate,create_time,TradeTime,string,true,20,yyyy/MM/dd HH:mm:ss,
5
- logistics_type,物流類型,LogisticsType,lgs_type,LogisticsType,string,true,20,CVS/Home,
6
- logistics_sub_type,物流子類型,LogisticsSubType,lgs_sub_type,LogisticsSubType,string,true,20,,見代碼表
7
- ecpay_logistics_id,物流編號,AllPayLogisticsID,logistics_id,PayUniLogisticsID,string,false,20,,廠商回傳
8
- goods_amount,商品金額,GoodsAmount,goods_amount,GoodsAmount,integer,true,,,
9
- goods_name,商品名稱,GoodsName,goods_name,GoodsName,string,true,50,,
10
- sender_name,寄件人姓名,SenderName,sender_name,SenderName,string,true,10,,
11
- sender_phone,寄件人電話,SenderPhone,sender_tel,SenderPhone,string,true,20,,
12
- sender_cell_phone,寄件人手機,SenderCellPhone,sender_cell_phone,SenderCellPhone,string,false,20,,
13
- sender_zipcode,寄件人郵遞區號,SenderZipCode,sender_zipcode,SenderZipCode,string,false,6,,宅配必填
14
- sender_address,寄件人地址,SenderAddress,sender_address,SenderAddress,string,false,200,,宅配必填
15
- receiver_name,收件人姓名,ReceiverName,receiver_name,ReceiverName,string,true,10,,
16
- receiver_phone,收件人電話,ReceiverPhone,receiver_tel,ReceiverPhone,string,true,20,,
17
- receiver_cell_phone,收件人手機,ReceiverCellPhone,receiver_cell_phone,ReceiverCellPhone,string,false,20,,
18
- receiver_zipcode,收件人郵遞區號,ReceiverZipCode,receiver_zipcode,ReceiverZipCode,string,false,6,,宅配必填
19
- receiver_address,收件人地址,ReceiverAddress,receiver_address,ReceiverAddress,string,false,200,,宅配必填
20
- receiver_store_id,收件門市代號,ReceiverStoreID,receiver_store_code,ReceiverStoreID,string,false,6,,超商必填
21
- return_store_id,退貨門市代號,ReturnStoreID,return_store_code,ReturnStoreID,string,false,6,,
22
- is_collection,是否代收,IsCollection,is_collection,N/A,string,false,1,Y/N,超商適用
23
- collection_amount,代收金額,CollectionAmount,collection_amount,N/A,integer,false,,,
24
- temperature,溫層,Temperature,temperature,Temperature,string,false,4,0001/0002/0003,宅配適用
25
- distance,距離,Distance,distance,N/A,string,false,2,00/01,00同縣市 01外縣市
26
- specification,規格,Specification,specification,Specification,string,false,4,,包裹尺寸
27
- server_reply_url,通知網址,ServerReplyURL,notify_url,NotifyURL,string,true,200,URL,
1
+ field_name,field_zh,ecpay_name,newebpay_name,payuni_name,smilepay_name,pchomepay_name,paynow_name,hct_name,type,required,notes
2
+ merchant_id,商店代號,MerchantID,uid,MerID,Dcvc,APP_ID (Basic Auth),merID,CustomerNo,string,true,HCT 直連用 CustomerNo;PChomePay 用 Basic Auth → token
3
+ order_id,訂單編號,MerchantTradeNo,merchant_order_no,MerTradeNo,Data_id,order_id,(自選),epino,string,true,HCT 必須 esdate+epino 唯一組合
4
+ order_date,訂單日期,MerchantTradeDate,create_time,TradeTime,(系統決定),(系統決定),(系統決定),esdate (YYYY/MM/DD),string,true,HCT esdate 是「出貨日期」格式為 yyyy/MM/dd
5
+ logistics_type,物流類型,LogisticsType,lgs_type,LogisticsType,Pay_zg,pay_type,LogisticServiceID,(N/A — HCT 直連碳貓),string,true,SmilePay 用 Pay_zg 編碼;PayNow 用 ServiceID 區分 11 條產品線
6
+ logistics_sub_type,物流子類型,LogisticsSubType,lgs_sub_type,LogisticsSubType,Pay_subzg,logistic_type,(內含於 ServiceID),(N/A),string,true,SmilePay Pay_subzg=7NET/FAMI;PChomePay logistic_type=PL711/PLFMI/PLHIL/PLOK
7
+ logistics_id,物流編號,AllPayLogisticsID,logistics_id,PayUniLogisticsID,Smseid,(returned in data),LogisticTradeNo,edelno,string,false,廠商回傳;HCT 在 100 天內唯一
8
+ goods_amount,代收金額,GoodsAmount,goods_amount,GoodsAmount,Amount,(via金流),Amount,eamtcod,integer,true,COD 才填;HCT 用 eamtcod (epaytype=2)
9
+ goods_name,商品名稱,GoodsName,goods_name,GoodsName,od_sob,(無),GoodsName,eprdcl1,string,true,SmilePay 用 od_sob
10
+ sender_name,寄件人姓名,SenderName,sender_name,SenderName,(無 — 商家固定),(後台設定),SenderName,epname,string,true,
11
+ sender_phone,寄件人電話,SenderPhone,sender_tel,SenderPhone,(無),(後台設定),SenderPhone,eptel,string,true,
12
+ sender_address,寄件人地址,SenderAddress,sender_address,SenderAddress,(無),(後台設定),SenderAddress,eaddr2,string,false,宅配必填
13
+ receiver_name,收件人姓名,ReceiverName,receiver_name,ReceiverName,Pur_name,name,ReceiverName,epdcl1,string,true,
14
+ receiver_phone,收件人電話,ReceiverPhone,receiver_tel,ReceiverPhone,Pur_telno,phone,ReceiverPhone,epdcl2,string,true,
15
+ receiver_address,收件人地址,ReceiverAddress,receiver_address,ReceiverAddress,Address,address,ReceiverAddress,eaddr1,string,false,宅配必填
16
+ receiver_store_id,收件門市代號,ReceiverStoreID,receiver_store_code,ReceiverStoreID,(透過 Emap 選店回傳),store_id,ReceiverStoreID,(N/A),string,false,超商必填;SmilePay/PayNow/PChomePay 透過電子地圖選店 callback 回傳
17
+ return_store_id,退貨門市代號,ReturnStoreID,return_store_code,ReturnStoreID,(無),return_store_id,(無),(N/A),string,false,
18
+ is_collection,是否代收,IsCollection,is_collection,N/A,(由 Pay_zg 決定),(由 pay_type 決定),(由 IsCOD/Y/N 決定),epaytype=2,string,false,SmilePay 從 Pay_zg 51/55/81 (COD) vs 52/56/82 (PICKUP) 判斷
19
+ collection_amount,代收金額,CollectionAmount,collection_amount,N/A,Amount,(via 金流),Amount,eamtcod,integer,false,
20
+ temperature,溫層,Temperature,temperature,Temperature,Temperature (1/2/3),(透過 logistic_type),(內含於 ServiceID),eshipment,string,false,1常溫 2冷藏 3冷凍;PayNow 透過產品線細分
21
+ weight,重量,(N/A),(N/A),(N/A),(N/A),(N/A),(N/A),eweight,integer,false,HCT 直連必填;其他 aggregator 通常自動分箱
22
+ package_count,件數,(N/A),(N/A),(N/A),(N/A),(N/A),(N/A),eqmny,integer,false,HCT 必填
23
+ server_reply_url,通知網址,ServerReplyURL,notify_url,NotifyURL,Roturl,(後台設定),ReturnURL,(N/A — 用 webhook),string,true,HCT 直連靠主動查詢,無 push notify
@@ -33,3 +33,57 @@ payuni,206,退貨中,Return in Progress,returning,退貨流程進行中,
33
33
  payuni,207,退貨完成,Return Completed,returned,退貨已完成,
34
34
  payuni,400,訂單錯誤,Order Error,error,訂單資料錯誤,檢查訂單參數
35
35
  payuni,500,系統錯誤,System Error,error,系統發生錯誤,聯繫客服
36
+ smilepay,1,Status 1,Success,success,SmilePay 取號或操作成功,
37
+ smilepay,21,待出貨,Awaiting Shipment,pending,商家尚未交件給物流商,商家備貨後交件
38
+ smilepay,22,物流驗收中,Logistics Inspection,in_transit,物流中心收件並驗收,自動轉入配送
39
+ smilepay,31,配送中,In Transit,in_transit,商品配送中(C2C 可能於此階段門市關轉),
40
+ smilepay,32,待取貨,At Store,at_store,包裹已配達門市,等待消費者取貨,通知消費者
41
+ smilepay,33,異常訂單,Anomaly,error,配送過程發生異常,聯繫物流商
42
+ smilepay,11,已取貨,Picked Up,completed,消費者已至超商取貨,
43
+ smilepay,41,已取消,Cancelled,cancelled,訂單已被商家取消,
44
+ smilepay,43,賠償訂單,Compensation,error,物流中心 / 黑貓宅配確認賠償訂單產生,跟進賠償流程
45
+ smilepay,44,包裹遺失,Lost,error,包裹經 18 天協尋後無法找到,走遺失賠償流程
46
+ smilepay,51,一般退貨,Standard Return,returning,退貨便 / 黑貓退貨,
47
+ smilepay,52,買家未取,Customer Not Picked,returning,買家超過取貨期限未取件,通知商家
48
+ smilepay,53,廠退,Vendor Return,returning,包裹退回物流中心 / 黑貓集貨所,
49
+ smilepay,55,賣家未取,Vendor Not Picked,returning,商店未於期限內至退貨門市領取,
50
+ smilepay,81,門市關轉,Store Closed,error,門市暫歇,需重選其他可配達門市,通知消費者重選
51
+ pchomepay,SSND,出貨成功,Sender Shipped,in_transit,商家已交件並出貨,
52
+ pchomepay,SATB,送達門市,Arrived,at_store,包裹已配達取貨門市,通知取貨
53
+ pchomepay,RATC,已取貨,Received,completed,消費者已取貨完成,
54
+ pchomepay,LINT,配送中,In Transit,in_transit,物流配送中,
55
+ pchomepay,LGNO,出貨單未產生,No Shipment,pending,尚未取得出貨單編號,呼叫 /v1/logistic/batch
56
+ pchomepay,WD,退倉,Returned to Warehouse,returning,包裹未取貨已退倉,
57
+ pchomepay,90001,取號失敗,Get Shipment Failed,error,呼叫 /v1/logistic/batch 失敗,檢查 store_id 與必填欄位
58
+ pchomepay,90002,門市不存在,Store Not Found,error,提供的 store_id 在系統中不存在,使用 PChomePay 提供之門市清單
59
+ pchomepay,90004,訂單尚無物流,No Logistic,error,該訂單尚未呼叫過取號 API,呼叫 /v1/logistic/batch 取號
60
+ paynow,1,Success,Success,success,PayNow 物流操作成功,
61
+ paynow,M01,商家代號錯誤,Invalid merID,error,merID 在系統中不存在,確認商家代號
62
+ paynow,A01,加密驗證失敗,Auth Failed,error,3DES 加密或 PassCode 驗證失敗,檢查 24-byte Key + 8-byte IV
63
+ paynow,B01,訂單金額錯誤,Invalid Amount,error,Amount 超出範圍或格式錯誤,確認金額為正整數
64
+ paynow,C01,訂單編號重複,Duplicate Order,error,paymentNo 已存在,使用唯一訂單編號
65
+ paynow,LS01,7-11 大宗已出貨,7-11 Shipped,in_transit,7-11 大宗 B2C 已出貨,
66
+ paynow,LS02,7-11 已配達門市,7-11 At Store,at_store,7-11 包裹已配達取貨門市,
67
+ paynow,LS03,7-11 已取貨,7-11 Picked,completed,7-11 消費者取貨完成,
68
+ paynow,LS11,全家已出貨,FAMI Shipped,in_transit,全家大宗 B2C 已出貨,
69
+ paynow,LS12,全家已配達門市,FAMI At Store,at_store,
70
+ paynow,LS13,全家已取貨,FAMI Picked,completed,
71
+ paynow,LS21,黑貓已出貨,TCAT Shipped,in_transit,黑貓宅配已出貨,
72
+ paynow,LS22,黑貓配達中,TCAT In Transit,in_transit,
73
+ paynow,LS23,黑貓配達完成,TCAT Delivered,delivered,
74
+ paynow,LE01,異常訂單,Anomaly,error,配送異常,聯繫客服
75
+ paynow,LR01,退貨完成,Return Done,returned,
76
+ hct,集貨,Picked Up,Picked Up,picked_up,HCT 已收件,
77
+ hct,卸集貨,Unloaded,Unloaded,in_transit,包裹進入轉運站,
78
+ hct,發送,Dispatched,Dispatched,in_transit,包裹從站所發送,
79
+ hct,到著,Arrived,Arrived,in_transit,包裹到達目的地站所,
80
+ hct,配達,Delivered,Delivered,delivered,司機已送達收件人,
81
+ hct,持回,Hold,On Hold,error,司機持回(收件人不在或拒收),聯繫收件人
82
+ hct,派遣,Dispatching,Dispatching,in_transit,司機派遣中,
83
+ hct,客戶不在,Customer Absent,Customer Absent,error,司機到達但客戶不在,
84
+ hct,已取,Picked,Picked,completed,自取站所已取件,
85
+ hct,誤派,Misdelivered,Misrouted,error,派送至錯誤站所,系統重新分配
86
+ hct,址誤,Address Error,Address Error,error,地址錯誤無法配送,聯繫商家更正地址
87
+ hct,拒收退回,Refused,Refused Return,returned,收件人拒收,包裹退回,
88
+ hct,商品保留不退,Hold No Return,Held No Return,on_hold,商品保留不退回,聯繫商家
89
+ hct,公司行號休息,Office Closed,Office Closed,error,公司行號休息日無法配送,延後重新配送