1. Đầu tiên ngài yêu cầu có được tài khoản
2. Tiến vào người dùng trung tâm bắt đầu dùng API phục vụ, thu hoạch bí chìa khóa
3.API phục vụ thỉnh cầu địa chỉ:"http://{ địa chỉ web }/webservice/APIWebService.asmx"
1. Sử dụng API yêu cầu đến người dùng trung tâm xin, hệ thống sinh thành bí chìa khóa, bí chìa khóa nhưng đình dùng hoặc đổi mới
2.API chỉ có thể thuyên chuyển chính mình tài khoản tin tức
Tuần tra duy trì phục vụ
- Ứng dụng cảnh tượng: Thu hoạch hữu hiệu vận chuyển phương thức danh sách ( tiếng Trung danh, tiếng Anh danh, số hiệu, có tác dụng trong thời gian hạn định, icon )
- Hàm số tên: getChannel ( secretkey )
- Đệ trình tham số: secretkey(API chìa khóa bí mật )
- Trao quyền: Yêu cầu
- Phản hồi: JSON
Đưa vào tham số
Tự đoạn |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
Secretkey |
String |
Cần thiết |
|
Chìa khóa bí mật |
d0fc2606-611f-443a-aea2-aa209673a32c80000 |
Phản hồi kết quả
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
Base_ChannelInfoID |
String |
Cần thiết |
|
Con đường số hiệu |
46 |
ChannelCode |
String |
Cần thiết |
|
Vận chuyển mã hóa |
CNDHL |
CnName |
String |
Cần thiết |
|
Vận chuyển tiếng Trung tên |
Đại lục DHL phổ hóa giới |
EnName |
String |
Cần thiết |
|
Vận chuyển tiếng Anh tên |
CNDHL |
RefTime |
String |
Cần thiết |
|
Có tác dụng trong thời gian hạn định |
2 - 4 |
ShortenImage |
String |
Nhưng tuyển |
|
Vận chuyển icon |
635195880046832907_dhl.gif |
Sai lầm mã
Tên |
Loại hình |
Hay không cần thiết |
Thí dụ mẫu giá trị |
Miêu tả |
complete |
Boolean |
Không |
true |
Tỏ vẻ đệ trình hay không thành công |
Kết quả ví dụ thực tế
Biểu hiện
Con đường ID |
Con đường mã hóa |
Con đường tiếng Trung tên |
Con đường tiếng Anh tên |
API thí dụ mẫu công cụ
Thí dụ mẫu
.NET thí dụ mẫu
-
Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào cung cấp API phục vụ địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
-
Bước thứ hai: Khởi động lại, lại thuyên chuyển phương pháp, có thể thu hoạch đến số liệu
.webservice p=new.webservice();
string result = p.getChannel (secretkey);
Phản hồi thí dụ mẫu
[{ "base_Channelinfoid": "46", "ChannelCode": "CNDHL", "CnName": "\u5927\u9646DHL\u666E\u8D27\u4EF7", "enname": "CNDHL", "reftime": "2 - 4", "shortenimage": "635195880046832907_dhl.gif" }
Phí chuyên chở tuần tra
- Ứng dụng cảnh tượng: Thông qua quốc gia cùng trọng lượng cập thể tích thu hoạch các vận chuyển phương thức giá cả ( vận chuyển phương thức tiếng Trung danh CHCnName, tiếng Anh danh CHEnName, phục vụ số hiệu ChannelCode, có tác dụng trong thời gian hạn định RefTime, icon, tổng phí dụng MinSaleAmountTotal)
- Hàm số tên: getFeeByCWV ( string country,stringweight,stringvolume,stringcustomerid, string secretkey )
- Nếu có thể phân biệt tài khoản đến chính là chiết khấu sau tổng phí dụng
- Đệ trình tham số: country ( quốc gia mã hóa ), weight ( trọng lượng ), volume ( thể tích ), customerid ( khách hàng ID ),scretkey( chìa khóa bí mật )
- Trao quyền: Yêu cầu
- Phản hồi: JSON
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
country |
String |
Cần thiết |
|
Quốc gia mã hóa |
Austria- Australia |
Weight |
String |
Cần thiết |
|
Trọng lượng |
0.25 ( kg ) |
Volume |
String |
Cần thiết |
|
Thể tích |
0.25 lập phương centimet |
Customer ID |
String |
Cần thiết |
|
Khách hàng ID |
80000 |
Identifier |
String |
Cần thiết |
|
Chìa khóa bí mật |
d0fc2606-611f-443a-aea2-aa209673a32c80000 |
Phản hồi kết quả
Tên |
Loại hình |
Phản hồi giá trị |
Miêu tả |
CHCnName |
string |
Hong Kong bưu chính hàng không đại bao |
Phục vụ tiếng Trung danh |
CHEnName |
string |
HKBPOST |
Phục vụ tiếng Anh danh |
ChannelCode |
string |
HKBPOST |
Con đường số hiệu |
RefTime |
string |
7 - 14 |
Tham khảo có tác dụng trong thời gian hạn định |
MinSaleAmountTotal |
string |
109.740 |
Tổng kim ngạch ( RMB ) |
Sai lầm mã
API thí dụ mẫu công cụ
Thí dụ mẫu
.NET thí dụ mẫu
-
Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào cung cấp API phục vụ địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
-
Bước thứ hai: Khởi động lại, lại thuyên chuyển phương pháp, có thể thu hoạch đến số liệu
.webservice p=new.webservice();
string result = p.getFeeByCWV(country,weight, volume,stringcustomerid, secretkey);
Phản hồi thí dụ mẫu
[{ "CHCnName": "\u9999\u6E2F\u90AE\u653F\u822A\u7A7A\u5927\u5305", "CHEnName": "HKBPOST", "ChannelCode": "HKBPOST", "RefTime": "7 - 14", "MinSaleAmountTotal": "200.620" }
Phí chuyên chở tuần tra (v2)
- Ứng dụng cảnh tượng: Thông qua quốc gia cùng trọng lượng cập thể tích thu hoạch các vận chuyển phương thức giá cả ( vận chuyển phương thức tiếng Trung danh CHCnName, tiếng Anh danh CHEnName, phục vụ số hiệu ChannelCode, có tác dụng trong thời gian hạn định RefTime, icon, tổng phí dụng MinSaleAmountTotal)
- Thỉnh cầu địa chỉ: http://m.pfcexpress:84/api/PriceQuery/Get/US/1/1000
- Trao quyền: Yêu cầu
- Đưa vào tham số: Như sau
Tham số thuyết minh
Tên |
Loại hình |
Hay không cần thiết |
Thuyết minh |
Thí dụ mẫu |
ISO Code |
String |
Cần thiết |
Quốc gia hai chữ mã |
US |
Weight |
decimal |
Cần thiết |
Trọng lượng đơn vị Kg |
0.5 |
Volume |
decimal |
Cần thiết |
Thể tích |
1000 |
.NET đệ trình ví dụ thực tế
string serverurl = "http://m.pfcexpress:84/";
string acition = "api/PriceQuery/Get/US/0.5/1000";
string apikey = "75273d06-3371-4cfb-9fa3-4621644d53b180000";
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(serverurl + acition);
request.ContentType = "application/json";
request.Accept = "application/json";
request.Headers.Add( "Authorization", "Bearer" + apikey);
request.Method = "Get";
try
{
using (WebResponse response = request.GetResponse())
{
using (StreamReader reader = new StreamReader(response.GetResponseStream()))
{
string text = reader.ReadToEnd();
}
}
}
catch (WebException ex)
{
throw ex;
}
JAVA đệ trình ví dụ thực tế
try {
String serverurl= "http://m.pfcexpress:84/";
String action= "api/PriceQuery/Get/US/0.5/1000";
String apikey= "75273d06-3371-4cfb-9fa3-4621644d53b180000";
URL url = new URL(serverurl+action);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setUseCaches(false);
conn.setRequestMethod( "Get" );
conn.setRequestProperty( "Connection", "Keep-Alive" );
conn.setRequestProperty( "Charset", "UTF-8" );
conn.setRequestProperty( "Content-Type", "application/json" );
conn.setRequestProperty( "Authorization", "Bearer" + apikey);
conn.connect();
OutputStream out = conn.getOutputStream();
out.write((shipment.toString()).getBytes());
out.flush();
out.close();
System.out.println(conn.getResponseCode());
if (conn.getResponseCode() == 200) {
System.out.println( "ok" );
InputStream in = conn.getInputStream();
String result = null;
try {
byte[] rsdata = new byte[in.available()];
in.read(rsdata);
result = new String(rsdata);
System.out.println(result);
} catch (Exception e1) {
e1.printStackTrace();
}
} else {
System.out.println( "no++" );
}
} catch (Exception e) {
}
PHP đệ trình ví dụ thực tế
php </br
$serverurl = "http://m.pfcexpress:84/";
$acition = "api/PriceQuery/Get/US/0.5/1000";
$apikey = "75273d06-3371-4cfb-9fa3-4621644d53b180000";
$headers=array('Authorization: '.'Bearer '.$apikey,'Content-type: application/json');
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $serverurl.$acition);
curl_setopt($ch, CURLOPT_HEADER, 1);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$json = curl_exec($ch);
curl_close($ch);
$result=json_decode($json, true);
print_r($result);
Phản hồi kết quả
Tự hào |
Tham số danh |
Tham số loại hình |
Miêu tả |
1 |
status |
Int |
200 đại biểu thành công
500 đại biểu không biết sai lầm
501 đại biểu bí chìa khóa sai lầm
|
2 |
msg |
string |
Tin tức nhắc nhở |
3 |
data |
string |
Phản hồi số liệu |
Phản hồi thí dụ mẫu
Thành công
Thành công:
{
"status": 200,
"msg": "",
"data": [
{
"CHCnName": "Bỉ toàn cầu bọc nhỏ",
"CHEnName": "Bpost Global Mail",
"ChannelCode": "GBPOST",
"RefTime": "7 - 15",
"MinSaleAmountTotal": "105.000",
"CalWeight": "1.000",
"BaseFee": "91.600",
"FuelFee": "0.000",
"TrackFlag": "1",
"VolWeightFlag": "0",
"ImageUrl": "http://oms.pfcexpress /Manage/UpFile/ChannelLabelPicture/635774794688066451_QQ hình ảnh 20140628093941.jpg",
"Remark": "",
"StyleName": "Quốc tế bọc nhỏ"
}
]
}
Thất bại
Thất bại:
{
"status": 501,
"msg": "API key is not correct",
"data": null
}
Đơn đặt hàng tin tức tuần tra
- Ứng dụng cảnh tượng: Thông qua đơn đặt hàng hào hoặc theo dõi hào thu hoạch ( đơn đặt hàng trạng thái, tổng phí dụng, đơn đặt hàng hào, theo dõi hào, chuyển đơn hào )
- Hàm số tên: getPackage ( string orderNo,stringcustomerid, string secretkey )
- Đệ trình tham số: strwhere ( đơn đặt hàng hào hoặc theo dõi hào ), customerid ( khách hàng ID ),scretkey( chìa khóa bí mật )
- Trao quyền: Yêu cầu
- Phản hồi: JSON
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
OrderNo |
String |
Cần thiết |
|
Đơn đặt hàng hào |
R800001407290002
|
CustomerId |
String |
Cần thiết |
|
Khách hàng đánh số |
80000 |
SecretKey |
String |
Cần thiết |
|
Chìa khóa bí mật |
d0fc2606-611f-443a-aea2-aa209673a32c80000 |
Remark |
String |
Nhưng tuyển
|
|
Ghi chú |
Null |
Phản hồi kết quả
Tên |
Loại hình |
Phản hồi giá trị |
Miêu tả |
OrderNo |
String |
R800001407290002 |
Đơn đặt hàng hào |
TrackingNo |
String |
|
Theo dõi hào |
field1 |
String |
234234 |
Chuyển đơn hào |
OrderStatus |
String |
6 |
Đơn đặt hàng trạng thái 1 |
OrderStatus2 |
String |
Đã giao hàng |
Đơn đặt hàng trạng thái 2 |
TotalAmount |
String |
6027.250 |
Tổng phí dụng |
EnName |
String |
Albania |
Thu kiện người quốc gia tiếng Anh danh |
ChannelCode |
String |
GBPOST |
Con đường số hiệu |
Sai lầm mã
API thí dụ mẫu công cụ
Thí dụ mẫu
.NET thí dụ mẫu
-
Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào cung cấp API phục vụ địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
-
Bước thứ hai: Khởi động lại, lại thuyên chuyển phương pháp, có thể thu hoạch đến số liệu
.webservice p=new.webservice();
string result = p.getPackage(orderNO, string customerid, secretkey);
Phản hồi thí dụ mẫu
[{ "OrderNo": "R800001411160002", "TrackingNo": "DDU1371690781102767", "field1": "", "OrderStatus2": "\u5DF2\u53D1\u8D27", "TotalAmount": "26.500", "ChannelCode": "GBPOST", "EnName": "Argentina", "OrderStatus": "6" }]
Sáng tạo đơn đặt hàng (v1)
- Ứng dụng cảnh tượng: Người dùng có thể thông qua API thành lập đơn đặt hàng tin tức đến hệ thống trung
- Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
- Trao quyền: Yêu cầu
- Đưa vào tham số: Như sau
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
Strorderinfo |
String |
Cần thiết |
|
Chủ tin tức |
|
Style |
String |
Cần thiết |
|
Đơn đặt hàng loại hình ( cất vào kho đơn đặt hàng hoặc bình thường đặt hàng đơn ) cất vào kho đơn đặt hàng vì 1, bình thường đơn đặt hàng vì 2 |
2 |
GFF_CustomerID |
String |
Cần thiết |
|
Khách hàng ID |
80000 |
GFF_ReceiveSendAddressID |
String |
Tuyển điền |
|
Phát kiện người ID |
189 |
ConsigneeName |
String |
Cần thiết |
|
Thu kiện người |
Tiểu minh |
Country |
String |
Cần thiết |
|
Quốc gia |
US; nước Mỹ;223 ( lần thứ hai số hiệu; tiếng Trung tên; quốc gia ID đều duy trì điền một có thể ) |
Base_ChannelInfoID |
String |
Cần thiết |
|
Con đường |
EUB;89( con đường số hiệu; con đường ID điền một có thể ) |
State |
String |
Cần thiết |
|
Châu |
San Fernando |
City |
String |
Cần thiết |
|
Thành thị |
Bernardo Ohiggins |
OrderStatus |
String |
Cần thiết |
|
Đơn đặt hàng trạng thái --( bản nháp =1),( xác nhận =3) |
1 |
Address1 |
String |
Cần thiết |
|
Thu kiện người địa chỉ hành 1 |
United States,,,MN.USA |
Address2 |
String |
Nhưng tuyển |
|
Thu kiện người địa chỉ hành 2 |
United States,,,MN.USA |
CsRefNo |
String |
Nhưng tuyển |
|
Khách hàng tham khảo hào |
1122 |
Zipcode |
String |
Nhưng tuyển |
|
Mã hoá bưu chính |
2134342 |
Contact |
String |
Nhưng tuyển |
|
Liên hệ phương thức |
180344345665 |
CusRemark |
String |
Nhưng tuyển |
|
Khách hàng đơn đặt hàng ghi chú ( thuế hào loại hình; IOSS: Điền nhập import; No-IOSS: Điền nhập non-union; Other: Không điền nội dung ) |
Null |
TrackingNo |
String |
Nhưng tuyển |
|
Theo dõi hào |
RT209114500HK |
CODFee |
String |
Nhưng tuyển |
|
Đại thu tiền hàng kim ngạch |
500 |
Duty |
String |
Nhưng tuyển (1,2) |
|
Thuế phí phí dụng gánh vác phương thức ---(1=DDP là từ gửi kiện người chi trả thuế quan ),(2=DDU là từ thu kiện người chi trả thuế quan ) |
2 |
VatNo |
String |
Nhưng tuyển |
|
VAT thuế hào |
|
EORI |
String |
Nhưng tuyển |
|
EORI hào |
|
IOSS |
String |
Nhưng tuyển |
|
IOSS hào |
|
HSCode |
String |
Nhưng tuyển |
|
Hải quan mã hóa |
|
Strorderproduct |
String |
Cần thiết |
|
Minh đếm kỹ theo |
|
MaterialRefNo |
String |
Cần thiết |
|
Vật phẩm 1 sản phẩm đánh số |
SKU1 |
MaterialQuantity |
String |
Cần thiết |
|
Vật phẩm 1 số lượng |
10 |
Price |
String |
Cần thiết |
|
Vật phẩm 1 đơn vị giá trị ( đôla ) |
10.2 |
Weight |
String |
Cần thiết |
|
Vật phẩm 1 trọng lượng ( KG ) |
10 |
EnName |
String |
Cần thiết |
|
Vật phẩm 1 sản phẩm tiếng Anh danh |
MP31232 |
Warehouse ID |
String |
Cần thiết |
|
Vật phẩm 1 cất vào kho ID |
302, có thể sử dụng cất vào kho tin tức tuần tra api thu hoạch |
ProducingArea |
String |
Nhưng tuyển |
|
Vật phẩm 1 nguyên nơi sản sinh |
|
CnName |
String |
Cần thiết |
|
Vật phẩm 1 sản phẩm tiếng Trung danh |
Tiếng Trung danh |
BatteryFlag |
String |
Nhưng tuyển |
|
Hay không mang điện |
0 đại biểu không mang theo điện 1 đại biểu mang điện cam chịu vì 0 |
...... |
...... |
...... |
...... |
...... |
...... |
Đệ trình ví dụ thực tế
Chủ tin tức: string strorderinfo = "Style:2;GFF_CustomerID:80000;GFF_ReceiveSendAddressID:;ConsigneeName:Ameerahmed;Country:84;Base_ChannelInfoID:CNGZGH;State:Paris-;City:Paris;OrderStatus:1;Address1:144 rue de rennes, 5eme etage – CODE 6335A – NOM –COTTIN AMEER;Address2:;CsRefNo:D4N3YZMJ69LI;Zipcode:75006;Contact:+33643052323;CusRemark:;TrackingNo:;VatNo:;"; |
Minh tế tin tức: string strorderproduct = "MaterialRefNo:VB40021,MaterialQuantity:1,Price:27.5,Weight:0.2,EnName:Handheld Massager,WarehouseID:302,ProducingArea:112,CnName:,;MaterialRefNo:VB40021,MaterialQuantity:1,Price:27.5,Weight:0.2,EnName:Handheld Massager,WarehouseID:302,ProducingArea:112,CnName:,;";
|
string stradd = "";( không cần truyền NULL truyền không )
|
Chìa khóa bí mật: string key = "ca0c0b19-4d8c-46b2-b91b-10fb3b44da9f80000"; |
.NET đệ trình ví dụ thực tế
Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào hoàng gia hậu cần cung cấp API phục vụ địa chỉ. Vì:
http://oms.pfcexpress /we bservice/APIWebService.asmx
pfc.pfcwebservice p = newpfc.pfcwebservice();
stringresult = p. InsertUpdateOrder(strorderinfo, strorderproduct, stradd, secretkey);
JAVA đệ trình ví dụ thực tế
String endpoint= "http://pfcexpress /webservice/APIWebService.asmx";
try{
// sáng tạo một cái phục vụ (service) thuyên chuyển (call)
Service service=new Service();
Call call= (Call) service.createCall();// thông qua service sáng tạo call đối tượng
// thiết trí service nơi URL
call.setTargetEndpointAddress(new java.net.URL(endpoint)); // cái này chính là truyền tham số lượng biến đổi, cũng chính là NET phương diện tham số, nhất định không cần mang sai rồi
call.addParameter(new QName( "http://tempuri.org/", "strorderinfo" ), org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);
call.addParameter(new QName( "http://tempuri.org/", "strorderproduct" ),org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);
call.addParameter(new QName( "http://tempuri.org/", "stradd" ),
org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);
call.addParameter(new QName( "http://tempuri.org/", "secretkey" ),
org.apache.axis.encoding.XMLType.XSD_STRING, javax.xml.rpc.ParameterMode.IN);
call.setOperationName(new QName( "http://tempuri.org/", "InsertUpdateOrder" ));// phương pháp danh
call.setReturnType(org.apache.axis.encoding.XMLType.XSD_STRING);
call.setUseSOAPAction(true);
call.setSOAPActionURI( "http://tempuri.org/InsertUpdateOrder" );
String strorderinfo= "Style:1;GFF_CustomerID:80000;GFF_ReceiveSendAddressID:;ConsigneeName:Ameerahmed;Country:84;Base_ChannelInfoID:46;State:Paris-;City:Paris;OrderStatus:1;Address1:144 rue de rennes, 5eme etage – CODE 6335A – NOM –COTTIN AMEER;Address2:;CsRefNo:D4N3YZMJ69LI;Zipcode:75006;Contact:+33643052323;CusRemark:;TrackingNo:;";
String strorderproduct= "MaterialRefNo:VB40021,MaterialQuantity:1,Price:27.5,Weight:0.2,EnName:Handheld Massager,WarehouseID:302,ProducingArea:112,CnName:,;";
String a = (String) call.invoke(new Object[] {
strorderinfo,strorderproduct, "", "d0fc2606-611f-443a-aea2-aa209673a32c80000" });
System.out.println( "--------" +a);
} catch (ServiceException e) {
e.printStackTrace();
} catch (MalformedURLException e) {
e.printStackTrace();
}
Phản hồi kết quả
Tên |
Loại hình |
Hay không cần thiết |
Thí dụ mẫu giá trị |
Miêu tả |
complete |
Boolean |
Không |
True |
Tỏ vẻ đệ trình hay không thành công Phát ra tham số đệ trình sau phản hồi hệ thống sinh thành đơn đặt hàng hào thêm phản hồi nhắc nhở tin tức, đơn đặt hàng hào cùng nhắc nhở tin tức dùng '-' ngăn cách, nếu sai lầm phản hồi sai lầm mã hóa tin tức
Phản hồi thành công kỳ liệt trực tiếp phản hồi tự phù xuyến: Đơn đặt hàng bảo tồn cũng đệ trình thành công!-DL140887( truy tung hào );R800001409100028 ( đơn đặt hàng hào ) chú: Có truy tung hào phản hồi truy tung hào, không có truy tung hào không quay lại hồi, đơn đặt hàng hào tất phản hồi
Phản hồi sai lầm tin tức ví dụ thực tế: Bảo tồn thất bại, thỉnh kiểm tra số liệu ghi vào hạng hay không có lầm! Thu kiện người quốc gia sai lầm! Hệ thống xứng đôi không đến tương ứng thu kiện người quốc gia
Đơn đặt hàng tân kiến thành công, dự báo thành công kết quả ví dụ thực tế: Đơn đặt hàng bảo tồn cũng đệ trình thành công!-DL140887( truy tung hào );R800001409100028 ( đơn đặt hàng hào ) dự báo kết quả: Dự báo: 1 điều ký lục!, thành công dự báo 1 điều ký lục
Đơn đặt hàng tân kiến thành công, dự báo thất bại kết quả ví dụ thực tế: Đơn đặt hàng bảo tồn cũng đệ trình thành công!-DL140887( truy tung hào );R800001409100028 ( đơn đặt hàng hào ) dự báo kết quả: Dự báo thất bại đơn đặt hàng hào: R800001409090003 sai lầm tin tức: Đơn đặt hàng nghiệm chứng sai lầm, sai lầm tin tức vì 【 thương phẩm trọng lượng không thể vì 0】
|
Phản hồi thí dụ mẫu
Miêu tả |
Thí dụ mẫu |
Đơn đặt hàng bảo tồn cũng đệ trình thành công |
DL140887;R800001411160002 |
Sai lầm mã
Sai lầm mã |
Sai lầm miêu tả |
Giải quyết phương án |
|
Bảo tồn thất bại, thỉnh kiểm tra số liệu ghi vào hạng hay không có lầm!! |
Căn cứ nhắc nhở thỉnh đưa vào chính xác số liệu |
API thí dụ mẫu công cụ
Thí dụ mẫu
.NET thí dụ mẫu
-
Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào cung cấp API phục vụ địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
-
Bước thứ hai: Khởi động lại, lại thuyên chuyển phương pháp, có thể thu hoạch đến số liệu
.webservice p = new.webservice();
string result = p. InsertUpdateOrder(strorderinfo, strorderproduct, stradd, secretkey);
Phản hồi thí dụ mẫu
Đơn đặt hàng bảo tồn cũng đệ trình thành công!-R800001501190004
Sáng tạo đơn đặt hàng (v2)
- Ứng dụng cảnh tượng: Người dùng có thể thông qua API thành lập đơn đặt hàng tin tức đến hệ thống trung
- Thỉnh cầu địa chỉ:
"http://oms.pfcexpress /webservice/v2/CreateShipment.aspx"
- Trao quyền: Yêu cầu
- Đưa vào tham số: Như sau
Tham số thuyết minh
Tên |
Loại hình |
Hay không cần thiết |
Thuyết minh |
Thí dụ mẫu |
Type |
Int |
Cần thiết |
1 vì cất vào kho đơn đặt hàng 2 vì bình thường đơn đặt hàng |
2 |
INorOut |
Int |
Cần thiết |
0 xuất khẩu 1 nhập khẩu |
0 |
WarehouseId |
String |
Tuyển điền |
Cất vào kho đơn đặt hàng vì tất điền |
302 |
CsRefNo |
String |
Tuyển điền |
Khách hàng tham khảo hào ( nhưng điền ngôi cao đơn đặt hàng hào / đơn hào ) |
201710100001 |
CustomerId |
String |
Tất điền |
Khách hàng ID |
80000 |
ChannelId |
String |
Cần thiết |
Con đường ID |
91 |
Sender |
String |
Tuyển điền |
Phát kiện người |
PFCexpress |
SendAddress |
String |
Tuyển điền |
Phát kiện người địa chỉ |
San Fernando |
SendPhone |
String |
Tuyển điền |
Phát kiện người điện thoại |
400-66566-88888 |
SendEmail |
String |
Tuyển điền |
Phát kiện người hộp thư |
sales@pfcexpress |
SendCompany |
String |
Tuyển điền |
Phát kiện người công ty |
pfc.inc |
ShipToName |
String |
Tất điền |
Thu kiện người |
zhangshan |
ShipToCountry |
String |
Tất điền |
Thu kiện người quốc gia hai chữ mã |
US |
ShipToState |
String |
Tất điền |
Thu kiện người châu |
UT |
ShipToCity |
String |
Tất điền |
Thu kiện người thành thị |
Cedar City |
ShipToAdress1 |
String |
Tất điền |
Thu kiện người địa chỉ 1 |
1225 W Harding Ave Apt 32 |
ShipToAdress2 |
String |
Tuyển điền |
Thu kiện người địa chỉ 2 |
|
ShipToZipCode |
String |
Cần thiết |
Thu kiện người mã hoá bưu chính |
84720 |
ShipToCompanyName |
String |
Tuyển điền |
Thu kiện người công ty |
Company.inc |
ShipToEmail |
String |
Tuyển điền |
Thu kiện người mã hoá bưu chính |
Email@me |
OrderStatus |
Int |
Cần thiết |
Đơn đặt hàng trạng thái 1 bản nháp 3 xác nhận |
1 |
TrackingNo |
String |
Tuyển điền |
Truy tung hào |
|
BatteryFlag |
String |
Tuyển điền |
Hay không mang pin 0 không mang theo 1 mang điểm cam chịu 0 |
0 |
CODFee |
decimal |
Tuyển điền |
Đại thu tiền hàng kim ngạch |
500.00 |
IDCardNo |
String |
Tuyển điền |
Số thẻ căn cước nhập khẩu đơn đặt hàng tất điền |
|
VatNo |
String |
Tuyển điền |
Thuế hào |
|
EORI |
String |
Tuyển điền |
EORI |
|
HSCode |
String |
Tuyển điền |
Hải quan mã hóa |
|
Products |
Array |
Cần thiết |
Đơn đặt hàng minh tế |
|
SKU |
String |
Tất điền |
SKU |
SKU0001 |
EnName |
String |
Tất điền |
Tiếng Anh tên vật phẩm |
Reflective clothes |
CnName |
String |
Tuyển điền |
Tiếng Trung tên vật phẩm |
Phản quang y |
MaterialQuantity |
Int |
Tất điền |
Số lượng (/ cái ) |
1 |
Price |
decimal |
Tất điền |
Trình báo giá trị (USD/ cái ) |
10.00 |
Weight |
decimal |
Tất điền |
Trọng lượng (KG/ cái ) |
0.5 |
Length |
decimal |
Tuyển điền |
Trường (/CM) |
0.5 |
Width |
decimal |
Tuyển điền |
Khoan (/CM) |
0.5 |
High |
decimal |
Tuyển điền |
Cao (/CM) |
0.5 |
ProducingArea |
String |
Tuyển điền |
Nơi sản sinh |
CN |
HSCode |
String |
Tuyển điền |
Hải quan mã hóa |
HS8888888 |
Đệ trình ví dụ thực tế
.NET đệ trình ví dụ thực tế
string serverurl = "http://oms.pfcexpress /";
string acition = "webservice/v2/CreateShipment.aspx";
string apikey = "75273d06-3371-4cfb-9fa3-4621644d53b180000";
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(serverurl + acition);
request.ContentType = "application/json";
request.Accept = "application/json";
request.Headers.Add( "Authorization", "Bearer" + apikey);
request.Method = "Post";
byte[] data = Encoding.UTF8.GetBytes(Body);
request.ContentLength = data.Length;
using (Stream requestStream = request.GetRequestStream())
{
requestStream.Write(data, 0, data.Length);
}
try
{
using (WebResponse response = request.GetResponse())
{
using (StreamReader reader = new StreamReader(response.GetResponseStream()))
{
string text = reader.ReadToEnd();
}
}
}
catch (WebException ex)
{
throw ex;
}
JAVA đệ trình ví dụ thực tế
try {
String serverurl= "http://oms.pfcexpress /";
String action= "webservice/v2/CreateShipment.aspx";
String apikey= "75273d06-3371-4cfb-9fa3-4621644d53b180000";
URL url = new URL(serverurl+action);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
conn.setUseCaches(false);
conn.setRequestMethod( "POST" );
conn.setRequestProperty( "Connection", "Keep-Alive" );
conn.setRequestProperty( "Charset", "UTF-8" );
byte[] data = Body.getBytes();
conn.setRequestProperty( "Content-Length", String.valueOf(data.length));
conn.setRequestProperty( "Content-Type", "application/json" );
conn.setRequestProperty( "Authorization", "Bearer" + apikey);
conn.connect();
OutputStream out = conn.getOutputStream();
out.write((shipment.toString()).getBytes());
out.flush();
out.close();
System.out.println(conn.getResponseCode());
if (conn.getResponseCode() == 200) {
System.out.println( "ok" );
InputStream in = conn.getInputStream();
String result = null;
try {
byte[] rsdata = new byte[in.available()];
in.read(rsdata);
result = new String(rsdata);
System.out.println(result);
} catch (Exception e1) {
e1.printStackTrace();
}
} else {
System.out.println( "no++" );
}
} catch (Exception e) {
}
PHP đệ trình ví dụ thực tế
php </br
$serverurl = "http://oms.pfcexpress /";
$acition = "webservice/v2/CreateShipment.aspx";
$apikey = "75273d06-3371-4cfb-9fa3-4621644d53b180000";
$params=array(
'Type'=>2,
'CustomerId'=>'80000',
'ChannelId'=>'DPD',
'Sender'=>'Ken',
'SendPhone'=>'73948563',
'SendAddress'=>'20 Orley Ave',
'SendCompany'=>'CS',
'SendEmail'=>'fjyer@huangjia ',
'ShipToName'=>'Eric',
'ShipToPhoneNumber'=>'2025551212',
'ShipToCountry'=>'US',
'ShipToState'=>'DC',
'ShipToCity'=>'Washington',
'ShipToAdress1'=>'475 L Enfant Plaza SW',
'ShipToAdress2'=>'',
'ShipToZipCode'=>'20260',
'ShipToCompanyName'=>'Express',
'OrderStatus'=>1,
'TrackingNo'=>'',
'Remark'=>'',
'BatteryFlag'=>0,
'INorOut'=>0,
'CODFee'=>0,
'IDCardNo'=>'',
'VatNo'=>'',
'EORI'=>'',
'HSCode'=>'',
'CsRefNo'=>'JH008',
'WarehouseId'=>'',
'Products'=>array(
array(
'CnName'=>' di động ',
'EnName'=>'Mobile',
'Weight'=>0.1,
'Price'=>5800,
'ProducingArea'=>'America',
'HSCode'=>'65421',
'SKU'=>'SK001',
'Length'=>0.1,
'Width'=>0.2,
'High'=>0.3,
'MaterialQuantity'=>1
),
array(
'CnName'=>' giày ',
'EnName'=>'shoes',
'Weight'=>0.2,
'Price'=>120,
'ProducingArea'=>'France',
'HSCode'=>'65421',
'SKU'=>'SK002',
'Length'=>0.1,
'Width'=>0.2,
'High'=>0.3,
'MaterialQuantity'=>1
)
)
);
$jsonparams=json_encode($params);
$headers=array('Authorization: '.'Bearer '.$apikey,'Content-type: application/json');
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $serverurl.$acition);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonparams);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, 60);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
$json = curl_exec($ch);
curl_close($ch);
$result=json_decode($json, true);
print_r($result);
Phản hồi kết quả
Tự hào |
Tham số danh |
Tham số loại hình |
Miêu tả |
1 |
status |
Int |
200 đại biểu thành công
500 đại biểu không biết sai lầm
501 đại biểu bí chìa khóa sai lầm
502 đại biểu tham số sai lầm
503 đại biểu không tìm được quốc gia số hiệu
504 đại biểu không tìm được con đường số hiệu
505 đại biểu không tìm được phát kiện người
506 đại biểu tham khảo hào đã tồn tại
507 đại biểu theo dõi hào đã tồn tại
508 đại biểu dự báo thất bại
509 đại biểu tồn kho không đủ
510 đại biểu không tìm được cất vào kho
511 đại biểu sản phẩm không tồn tại
512 đơn đặt hàng trạng thái không chính xác
513 đại biểu đơn đặt hàng loại hình không chính xác
|
2 |
msg |
string |
Tin tức nhắc nhở |
3 |
data |
string |
Phản hồi số liệu |
Phản hồi thí dụ mẫu
Thành công
Thành công:
{
"status": 200,
"msg": "Success",
"data": {
"TrackingNo": null,
"OrderNo": "R800001709270001",
"CsRefNo": "JH0010",
"LablesUrl": null
}
}
/div>
Thất bại
Thất bại:
{
"status": 506,
"msg": "CsRefNo repeat",
"data": null
}
Tuần tra sản phẩm tồn kho
-
Ứng dụng cảnh tượng: Người dùng có thể thông qua API tuần tra SKU/ mã vạch tồn trữ tin tức.
- Yêu cầu trao quyền, thỉnh đến người dùng trung tâm xin key.
-
Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx/getStock"
- Đưa vào tham số: Như sau
- Trao quyền: Yêu cầu
- Phản hồi: Json
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
skuorcode |
String |
Cần thiết |
|
SKU/ mã vạch |
A00001 |
customerid |
String |
Cần thiết |
|
Người dùng id |
80000 |
Secretkey |
String |
Cần thiết |
|
Chìa khóa bí mật --identifier |
d0fc2606-611f-443a-aea2-aa209673a32c80000 |
WarehouseName |
String |
Cần thiết |
|
Cất vào kho ( SZWH- Thâm Quyến tây lệ thương (302),GZWH Quảng Châu cất vào kho (381)HKWH- Hong Kong cất vào kho (382) ) |
302 |
Phản hồi kết quả
Tên |
Phản hồi giá trị |
Miêu tả |
OutinQuantity |
8662 |
Tồn kho số lượng |
Stock |
6 |
Chiếm dụng số lượng |
CnName |
MP31243 112\uFF0C |
Sản phẩm tiếng Trung danh |
EnName |
MP31 |
Sản phẩm tiếng Anh danh |
OutinQuantity |
1 |
Tồn kho số lượng |
Stock |
1 |
Chiếm dụng số lượng |
CnName |
MP31243 112\uFF0C |
Sản phẩm tiếng Trung danh |
EnName |
MP31 |
Sản phẩm tiếng Anh danh |
Sai lầm mã
Sai lầm mã |
Sai lầm miêu tả |
Giải quyết phương án |
|
|
|
API thí dụ mẫu công cụ
Thí dụ mẫu
.NET thí dụ mẫu
-
Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào cung cấp API phục vụ địa chỉ
:"http://{ địa chỉ web }/webservice/APIWebService.asmx"
-
Bước thứ hai: Khởi động lại, lại thuyên chuyển phương pháp, có thể thu hoạch đến số liệu
string result = p. getStock (skuorcode, customerid, secretkey, WarehouseName);
Tỷ như:p.getStock(S4-ACHEB, 80003,2acd2496-78f8-4eac-ba9c-fd152c2fb41e80003,302)
Phản hồi thí dụ mẫu
[{ "OutinQuantity": "8662", "Stock": "6", "CnName": "MP31243 112\uFF0C", "EnName": "MP31" },{ "OutinQuantity": "1", "Stock": "1", "CnName": "MP31243 112\uFF0C", "EnName": "MP31" }]
Bao vây truy tung tin tức
-
Ứng dụng cảnh tượng: Người dùng có thể thông qua API tuần tra đơn đặt hàng truy tung tin tức.
-
Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx/getOrder_Track"
- Đưa vào tham số: OrderNo( đơn đặt hàng hào, truy tung hào )
- Phát ra tham số: Phản hồi json tự phù xuyến
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
Order number/Tracking number |
String |
Cần thiết |
|
Đơn đặt hàng hào / chuyển phát nhanh đơn hào |
R800001411160002 |
Phản hồi kết quả
Tên |
Phản hồi giá trị |
Phái đưa nội dung |
SHENZHEN - CHINA: Gặp may phát hướng mục đích địa (Departed Facility in ) |
Thời gian |
2014-11-16 16:19:55 |
Sai lầm mã
Sai lầm mã |
Sai lầm miêu tả |
Giải quyết phương án |
|
|
|
API thí dụ mẫu công cụ
Thí dụ mẫu
.NET thí dụ mẫu
- Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào cung cấp API phục vụ địa chỉ. Giả thiết vì:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
-
Bước thứ hai: Khởi động lại, lại thuyên chuyển phương pháp, có thể thu hoạch đến số liệu.
.webservice p = new.webservice();
string result = p. getOrder_Track( "R807521408070065" )
Phản hồi thí dụ mẫu
Miêu tả ( Describe) cuối cùng đưa thời gian (the last delivery time)
SHENZHEN - CHINA: Gặp may phát hướng mục đích địa (Departed Facility in ) 2014-11-16 16:32:09
SHENZHEN - CHINA: Thu bao vây (Shipment picked up) 2014-11-16 16:19:55
Đóng dấu nhãn
- Ứng dụng cảnh tượng: Người dùng có thể trực tiếp phỏng vấn địa chỉ điền tương ứng tin tức nhưng đóng dấu nhãn
-
Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/Manage/PrintPage/Print_PDF.aspx?OrderNo=RP05851311190001,&type=A4" (A4 nhãn )
"http://{ địa chỉ web }/Manage/PrintPage/Print_PDF.aspx?OrderNo=RP05851311190001,&type= ( nhiệt mẫn nhãn )"
- Tham số giới thiệu:OrderNo có thể điền đơn hào, truy tung hào. RP05851311190001,RP05851311190001 dấu phẩy ngăn cách type: Đóng dấu cách thức =A4 liền đóng dấu A4
- Type trống không lời nói, chính là đóng dấu nhiệt mẫn.
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
type |
|
|
|
Đóng dấu trang giấy cách thức: A4 đóng dấu A4 kích cỡ;
Lưu không đóng dấu nhiệt mẫn cách thức.
|
A4 |
Order number |
|
Cần thiết |
|
Đơn đặt hàng hào / chuyển phát nhanh đơn hào |
R800001411160002 |
Thí nghiệm công cụ
Đóng dấu nhãn
- Ứng dụng cảnh tượng: Người dùng có thể trực tiếp phỏng vấn địa chỉ điền tương ứng tin tức nhưng đóng dấu nhãn
-
Thỉnh cầu địa chỉ:
http://{ địa chỉ web }/webservice/APIWebService.asmx
- Thỉnh cầu phương pháp GetLablesUrl
- Phản hồi JSON
Thỉnh cầu tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
OrderNo |
|
Cần thiết |
|
Đơn đặt hàng hào / theo dõi hào |
9400110200882632305530 |
Phản hồi kết quả
Tham số |
Phản hồi giá trị |
success |
Hay không thành công true/false |
error |
Sai lầm tin tức success vì false sườn có giá trị |
LablesUrl |
Nhãn URL |
Sáng tạo ASN đơn
- Ứng dụng cảnh tượng: Người dùng có thể thông qua API thành lập nhập kho danh sách đến hệ thống trung
- Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
- Thỉnh cầu phương pháp: CreateAsn
- Trao quyền: Yêu cầu
- Đưa vào tham số: Như sau
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
Storage |
String |
Cần thiết |
|
Kho hàng Id thông qua cất vào kho tiếp lời thu hoạch |
302 |
DeliveryStyle |
String |
Cần thiết |
|
Vận chuyển phương thức [Delievery Paid,Express delivery,Their delivery] |
Delievery Paid |
EnchaseType |
String |
Cần thiết |
|
Trang rương loại hình [Original,Mixed] |
Original |
RefNo |
String |
Cần thiết |
|
Tham khảo hào |
|
WaybillNumber |
String |
Tuyển điền |
|
Vận đơn hào |
|
ReachStartTime |
String |
Cần thiết |
|
Dự tính sớm nhất đến thương thời gian |
2022-04-08 |
ReachEndTime |
String |
Cần thiết |
|
Dự tính nhất tới trễ thương thời gian |
2022-04-08 |
GFF_CustomerID |
String |
Cần thiết |
|
Khách hàng ID |
80000 |
CusRemark |
String |
Tuyển điền |
|
Ghi chú |
|
SKU |
String |
Cần thiết |
|
SKU |
|
Quantity |
String |
Cần thiết |
|
Số lượng |
100 |
CartonNumber |
String |
Cần thiết |
|
Rương hào |
1001 |
...... |
...... |
...... |
...... |
...... |
...... |
Đệ trình ví dụ thực tế
asninfo: { "storage": "302", "enchaseType": "Original", "enchaseNum": "1", "deliveryStyle": "Delievery Paid", "RefNo": "cs1001", "waybillNumber": "123", "reachStartTime": "2022-04-07", "reachEndTime": "2022-04-07", "gfF_CustomerID": "80000", "CusRemark": "", "products":[{ "sku": "DM-0812-13", "quantity": "1", "cartonNumber": "123" }]} |
Chìa khóa bí mật: string secretkey = "ca0c0b19-4d8c-46b2-b91b-10fb3b44da9f80000"; |
Phản hồi thí dụ mẫu
Miêu tả |
Thí dụ mẫu |
|
{ "status":200, "msg":null, "data":{ "Address": "Thâm Quyến thị long cương khu bản điền trên đường phố tuyết vườn công nghệ một đường số 2 C đống 4 lâu hoàng gia hậu cần", "Consignee": "Hoàng gia hậu cần cất vào kho trung tâm - đường dụ huy", "Phone": "13530213478", "ZipCode": "518000", "ASNNo": "A800002204080003", "Label": "https://oms.pfcexpress /Manage/PrintPage/PrintPackage.aspx?oid=181434338" }} |
Sai lầm mã
Sai lầm mã |
Sai lầm miêu tả |
Giải quyết phương án |
502 |
{ "status":502, "msg": "Wrong Storage", "data":null} |
Căn cứ nhắc nhở thỉnh đưa vào chính xác số liệu |
Tuần tra ASN đơn tin tức
- Ứng dụng cảnh tượng: Người dùng có thể thông qua API tuần tra nhập kho danh sách tin tức
- Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
- Thỉnh cầu phương pháp: GetAsnInfo
- Trao quyền: Yêu cầu
- Đưa vào tham số: Như sau
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
asnno |
String |
Cần thiết |
|
ASN đơn hào |
|
gff_customerid |
String |
Cần thiết |
|
Khách hàng ID |
|
secretkey |
String |
Cần thiết |
|
Chìa khóa bí mật |
|
Phản hồi thí dụ mẫu
Miêu tả |
Thí dụ mẫu |
|
{ "status":200, "msg":null, "data":[{ "SKU": "DM-0812-13", "TakedQuantity": "1" }]} |
Sai lầm mã
Sai lầm mã |
Sai lầm miêu tả |
Giải quyết phương án |
502 |
{ "status":502, "msg": "Can't find ASNNo or Quality checking in progress", "data":null} |
Căn cứ nhắc nhở thỉnh đưa vào chính xác số liệu |
Chặn lại đơn đặt hàng
- Ứng dụng cảnh tượng: Người dùng có thể thông qua API chặn lại đã trả tiền chờ phân phó hóa, chưa trả tiền chờ phân phó hóa, xử lý trung đơn đặt hàng
- Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
- Thỉnh cầu phương pháp: AddPromble
- Trao quyền: Yêu cầu
- Đưa vào tham số: Như sau
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
No |
String |
Cần thiết |
|
Đơn đặt hàng hào hoặc là truy tung đơn hào |
|
Remark |
String |
Cần thiết |
|
Tiệt đơn nguyên nhân cùng với xử lý phương thức |
|
CustomerId |
String |
Cần thiết |
|
Khách hàng ID |
Original |
Đệ trình ví dụ thực tế
{ "order": "{\" no\ ":\" R800002209210002\ ",\" remark\ ":\" hủy bỏ đơn đặt hàng \ ",\" customerId\ ":\" 80000\ "}", "secretkey": "39129c2c-30fc-4a5c-3dc82-da5732a8352d80000" } |
Phản hồi thí dụ mẫu
Miêu tả |
Thí dụ mẫu |
|
{ "status":200, "msg": "Tiệt đơn thành công!" }} |
Sai lầm mã
Sai lầm mã |
Sai lầm miêu tả |
Giải quyết phương án |
502 |
{ "status":502, "msg": Tiệt đơn thành công: R800002207300327 đã đã làm tiệt đơn! "} |
Căn cứ nhắc nhở thỉnh đưa vào chính xác số liệu |
Thu hoạch cất vào kho tin tức
- Ứng dụng cảnh tượng: Người dùng có thể thông qua API thu hoạch cất vào kho tin tức
- Thỉnh cầu địa chỉ:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
Đưa vào tham số
Tên |
Loại hình |
Hay không cần thiết |
Cam chịu giá trị |
Thuyết minh |
Thí dụ mẫu |
Secretkey |
String |
Cần thiết |
|
Chìa khóa bí mật |
d0fc2606-611f-443a-aea2-aa209673a32c80000 |
Phản hồi kết quả
Tên |
Phản hồi giá trị |
SZWH- Thâm Quyến tây lệ thương |
Cất vào kho tên |
302 |
Cất vào kho ID |
Kết quả ví dụ thực tế
Biểu hiện
Cất vào kho ID |
Cất vào kho tên |
Thí nghiệm công cụThí dụ mẫu
.NET thí dụ mẫu
- Bước đầu tiên: Ở ngươi kiến tốt asp.net hạng mục trung, tăng thêm web trích dẫn, đưa vào cung cấp API phục vụ địa chỉ. Giả thiết vì:
"http://{ địa chỉ web }/webservice/APIWebService.asmx"
-
Bước thứ hai: Khởi động lại, lại thuyên chuyển phương pháp, có thể thu hoạch đến số liệu.
.webservice p = new.webservice();
string result = p. GetWarehouse();// phản hồi tự phù xuyến
Phản hồi thí dụ mẫu
302:SZWH- Thâm Quyến tây lệ thương;381:GZWH Quảng Châu cất vào kho;382:HKWH- Hong Kong cất vào kho;457: Thâm Quyến VIP cất vào kho
Sáng tạo đơn đặt hàng sai lầm phản hồi
Phản hồi giá trị |
Thuyết minh |
Giải quyết phương án |
"" |
Không có quyền hạn cắm vào nhật ký |
Liên hệ quản lý viên |
Ngươi chìa khóa bí mật không chính xác |
Hệ thống xứng đôi không đến chính xác chìa khóa bí mật |
Thỉnh kiểm tra chìa khóa bí mật cùng người dùng ID hay không chính xác, thuyên chuyển tiếp lời địa chỉ hay không xứng đôi |
Strorderinfo( đơn đặt hàng chủ số liệu ) hoặc Strorderproduct( đơn đặt hàng minh tế ) vì không! |
Đơn đặt hàng số liệu không chính xác |
Thỉnh xem xét “Sáng tạo đơn đặt hàng” trung đệ trình ví dụ thực tế |
Phát kiện người vô hiệu, thỉnh kiểm tra hay không ở hệ thống tân kiến phát kiện người? |
Người dùng không có phát kiện người |
Mời tiến vào người dùng bản cài đặt tân kiến một cái phát kiện người |
Thu kiện người quốc gia sai lầm! Hệ thống xứng đôi không đến tương ứng thu kiện người quốc gia! |
Hệ thống xứng đôi không đến phát kiện người quốc gia |
Thỉnh xem xét “Sáng tạo đơn đặt hàng” trung đưa vào tham số |
Vận chuyển phương thức ( con đường ) số liệu sai lầm! Hệ thống xứng đôi không đến tương ứng vận chuyển phương thức ( con đường )! |
Hệ thống xứng đôi không đến vận chuyển phương thức ( con đường ) |
Thỉnh xem xét “Sáng tạo đơn đặt hàng” trung đưa vào tham số |
Đơn đặt hàng bảo tồn cũng đệ trình thành công!-DL140887( theo dõi hào, vận đơn hào );R800001409100028 ( đơn đặt hàng hào ) |
Đơn đặt hàng đệ trình thành công ( không có bất luận cái gì sai lầm ) |
Đệ trình đến xác nhận đơn đặt hàng mới có thể phản hồi theo dõi hào |
Đơn đặt hàng bảo tồn cũng đệ trình thành công!-R800001409100028 ( đơn đặt hàng hào ) |
Đơn đặt hàng đệ trình thành công ( không có bất luận cái gì sai lầm ) |
Đơn đặt hàng không có phản hồi theo dõi hào, bản thân con đường bộ phản hồi theo dõi hào, cũng không dự báo |
Đơn đặt hàng bảo tồn cũng đệ trình thành công!-R800001409100028 ( đơn đặt hàng hào ) - dự báo thất bại: Đơn đặt hàng hào R800001409100028 mã hoá bưu chính không chính xác |
Đơn đặt hàng đệ trình thành công ( không có bất luận cái gì sai lầm ) |
Đơn đặt hàng không có phản hồi theo dõi hào, con đường có dự báo, nhưng là dự báo thất bại, sẽ phản hồi dự báo sau sai lầm tin tức |
Đơn đặt hàng bảo tồn thành công, nhưng đệ trình đến xác nhận trạng thái thất bại!- minh tế cắm vào thất bại |
Đơn đặt hàng chủ số liệu đệ trình thành công ( minh tế cắm vào thất bại ) |
Thỉnh kiểm tra truyền vào minh đếm kỹ theo |
Đơn đặt hàng bảo tồn thành công, nhưng đệ trình đến xác nhận trạng thái thất bại! Sai lầm tin tức |
Đệ trình đến xác nhận thất bại |
Thỉnh kiểm tra truyền vào “Đơn đặt hàng loại hình” Style:1 cất vào kho đơn đặt hàng ( nếu truyền vào minh tế sản phẩm không tồn tại tắc đệ trình đến xác nhận thất bại ) |
Đơn đặt hàng bảo tồn thành công, nhưng bởi vì không thỏa mãn theo dõi hào cần thiết duy nhất hoặc là thu kiện người tên, thu kiện người quốc gia, vận chuyển phương thức, địa chỉ hành 1 đều không thể vì không, đệ trình đến xác nhận trạng thái thất bại!- "Sai lầm tin tức |
Đơn đặt hàng bảo tồn thành công |
Thỉnh kiểm tra truyền vào số liệu hay không có lầm! |
Đơn đặt hàng làm lỗi |
Truyền vào số liệu cách thức không chính xác |
Thỉnh tham khảo “Sáng tạo đơn đặt hàng” trung đệ trình ví dụ thực tế |
Kỹ thuật duy trì
API vấn đề thỉnh phát bưu kiện đến sales@pfcexpress