[{"base_Channelinfoid":"46","ChannelCode":"CNDHL","CnName":"\u5927\u9646DHL\u666E\u8D27\u4EF7","enname":"CNDHL","reftime":"2 - 4","shortenimage":"635195880046832907_dhl.gif"}
                              

    [{"CHCnName":"\u9999\u6E2F\u90AE\u653F\u822A\u7A7A\u5927\u5305","CHEnName":"HKBPOST","ChannelCode":"HKBPOST","RefTime":"7 - 14","MinSaleAmountTotal":"200.620"}

string serverurl = "http://m.pfcexpress.com: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;
}

try {
String serverurl="http://m.pfcexpress.com: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) {
}

$serverurl = "http://m.pfcexpress.com: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);

成功： { "status": 200, "msg": "", "data": [ { "CHCnName": "比利時全球小包", "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.com/Manage/UpFile/ChannelLabelPicture/635774794688066451_QQ圖片20140628093941.jpg", "Remark": "", "StyleName": "國際小包" } ] }

失敗： { "status": 501, "msg": "API key is not correct", "data": null }

    [{"OrderNo":"R800001411160002","TrackingNo":"DDU1371690781102767","field1":"","OrderStatus2":"\u5DF2\u53D1\u8D27","TotalAmount":"26.500","ChannelCode":"GBPOST","EnName":"Argentina","OrderStatus":"6"}]

第一步：在你建好的 asp.net 項目中，添加 web 引用,輸入皇家物流提供的 API 服務(wù)地址。為: http://oms.pfcexpress.com/we bservice/APIWebService.asmx
pfc.pfcwebservice p = newpfc.pfcwebservice();
stringresult = p. InsertUpdateOrder(strorderinfo, strorderproduct, stradd, secretkey);

String endpoint=" http://pfcexpress.com/webservice/APIWebService.asmx";
try{ //創(chuàng)建一個服務(wù)(service)調(diào)用(call)
Service service=new Service();
Call call= (Call) service.createCall();//通過service創(chuàng)建call對象
//設(shè)置service所在URL
call.setTargetEndpointAddress(new java.net.URL(endpoint)); //這個就是傳參數(shù)的變量,也就是NET方面的參數(shù),一定不要帶錯了
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"));//方法名

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(); }

訂單保存并提交成功!-R800001501190004 

string serverurl = "http://oms.pfcexpress.com/";
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;
}

try {
String serverurl="http://oms.pfcexpress.com/";
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) {
}

$serverurl = "http://oms.pfcexpress.com/";
$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.com',
'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'=>'手機(jī)',
'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'=>'鞋子',
'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);

成功： { "status": 200, "msg": "Success", "data": { "TrackingNo": null, "OrderNo": "R800001709270001", "CsRefNo": "JH0010", "LablesUrl": null } }

失敗

查詢產(chǎn)品庫存

輸入?yún)?shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
skuorcode	String	必須		SKU/條形碼	A00001
customerid	String	必須		用戶 id	80000
Secretkey	String	必須		密鑰 --identifier	d0fc2606-611f-443a-aea2-aa209673a32c80000
WarehouseName	String	必須		倉儲（SZWH-深圳西麗倉(302),GZWH廣州倉儲(381)HKWH-香港倉儲(382)）	302

返回結(jié)果

名稱	返回值	描述
OutinQuantity	8662	庫存數(shù)量
Stock	6	占用數(shù)量
CnName	MP31243 112\uFF0C	產(chǎn)品中文名
EnName	MP31	產(chǎn)品英文名
OutinQuantity	1	庫存數(shù)量
Stock	1	占用數(shù)量
CnName	MP31243 112\uFF0C	產(chǎn)品中文名
EnName	MP31	產(chǎn)品英文名

錯誤碼

錯誤碼	錯誤描述	解決方案

API示例工具

示例

.NET 示例

返回示例

    [{"OutinQuantity":"8662","Stock":"6","CnName":"MP31243 112\uFF0C","EnName":"MP31"},{"OutinQuantity":"1","Stock":"1","CnName":"MP31243 112\uFF0C","EnName":"MP31"}]

包裹追蹤信息

輸入?yún)?shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
Order number/Tracking number	String	必須		訂單號/快遞單號	R800001411160002

返回結(jié)果

名稱	返回值
派送內(nèi)容	SHENZHEN - CHINA:交運發(fā)往目的地(Departed Facility in ）
時間	2014-11-16 16:19:55

錯誤碼

錯誤碼	錯誤描述	解決方案

API示例工具

示例

.NET 示例

返回示例

描述( Describe)	                                                 最后投遞時間(the last delivery time)
SHENZHEN - CHINA:交運發(fā)往目的地(Departed Facility in )       2014-11-16 16:32:09
SHENZHEN - CHINA:收取包裹(Shipment picked up) 	                 2014-11-16 16:19:55

打印標(biāo)簽

輸入?yún)?shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
type				打印紙張格式：A4打印A4尺寸； 留空打印熱敏的格式。	A4
Order number		必須		訂單號/快遞單號	R800001411160002

測試工具

打印標(biāo)簽

請求參數(shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
OrderNo		必須		訂單號/跟蹤號	9400110200882632305530

返回結(jié)果

參數(shù)	返回值
success	是否成功 true/false
error	錯誤信息 success為false 側(cè)有值
LablesUrl	標(biāo)簽URL

創(chuàng)建ASN單

輸入?yún)?shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
Storage	String	必須		倉庫Id通過倉儲接口獲取	302
DeliveryStyle	String	必須		運輸方式[Delievery Paid,Express delivery,Their delivery]	Delievery Paid
EnchaseType	String	必須		裝箱類型[Original,Mixed]	Original
RefNo	String	必須		參考號
WaybillNumber	String	選填		運單號
ReachStartTime	String	必須		預(yù)計最早到倉時間	2022-04-08
ReachEndTime	String	必須		預(yù)計最晚到倉時間	2022-04-08
GFF_CustomerID	String	必須		客戶ID	80000
CusRemark	String	選填		備注
SKU	String	必須		SKU
Quantity	String	必須		數(shù)量	100
CartonNumber	String	必須		箱號	1001
......	......	......	......	......	......

提交實例

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"}]}

密鑰：string secretkey = "ca0c0b19-4d8c-46b2-b91b-10fb3b44da9f80000";

返回示例

描述	示例
	{"status":200,"msg":null,"data":{"Address":"深圳市龍崗區(qū)坂田街道上雪科技園一路二號C棟4樓皇家物流","Consignee":"皇家物流倉儲中心-唐裕輝","Phone":"13530213478","ZipCode":"518000","ASNNo":"A800002204080003","Label":"https://oms.pfcexpress.com/Manage/PrintPage/PrintPackage.aspx?oid=181434338"}}

錯誤碼

錯誤碼	錯誤描述	解決方案
502	{"status":502,"msg":"Wrong Storage","data":null}	根據(jù)提示請輸入正確的數(shù)據(jù)

查詢ASN單信息

輸入?yún)?shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
asnno	String	必須		ASN單號
gff_customerid	String	必須		客戶ID
secretkey	String	必須		密鑰

返回示例

描述	示例
	{"status":200,"msg":null,"data":[{"SKU":"DM-0812-13","TakedQuantity":"1"}]}

錯誤碼

錯誤碼	錯誤描述	解決方案
502	{"status":502,"msg":"Can't find ASNNo or Quality checking in progress","data":null}	根據(jù)提示請輸入正確的數(shù)據(jù)

攔截訂單

輸入?yún)?shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
No	String	必須		訂單號或者追蹤單號
Remark	String	必須		截單原因以及處理方式
CustomerId	String	必須		客戶ID	Original

提交實例

{"order":"{\"no\":\"R800002209210002\",\"remark\":\"取消訂單\",\"customerId\":\"80000\"}","secretkey":"39129c2c-30fc-4a5c-3dc82-da5732a8352d80000"}

返回示例

描述	示例
	{"status":200,"msg":"截單成功！"}}

錯誤碼

錯誤碼	錯誤描述	解決方案
502	{"status":502,"msg":截單成功：R800002207300327已做過截單！"}	根據(jù)提示請輸入正確的數(shù)據(jù)

獲取倉儲信息

輸入?yún)?shù)

名稱	類型	是否必須	默認(rèn)值	說明	示例
Secretkey	String	必須		密鑰	d0fc2606-611f-443a-aea2-aa209673a32c80000

返回結(jié)果

名稱	返回值
SZWH-深圳西麗倉	倉儲名稱
302	倉儲ID

結(jié)果實例 顯示

倉儲ID	倉儲名稱

測試工具

示例

.NET 示例

返回示例

 302:SZWH-深圳西麗倉;381:GZWH廣州倉儲;382:HKWH-香港倉儲;457:深圳VIP倉儲
                              

創(chuàng)建訂單錯誤返回

返回值	說明	解決方案
""	沒有權(quán)限插入日志	聯(lián)系管理員
你的密鑰不正確	系統(tǒng)匹配不到正確的密鑰	請檢查密鑰和用戶ID是否正確,調(diào)用的接口地址是否匹配
Strorderinfo(訂單主數(shù)據(jù))或Strorderproduct(訂單明細(xì))為空!	訂單數(shù)據(jù)不正確	請查看“創(chuàng)建訂單”中的提交實例
發(fā)件人無效,請檢查是否在系統(tǒng)新建發(fā)件人？	用戶沒有發(fā)件人	請進(jìn)入用戶的客戶端新建一個發(fā)件人
收件人國家錯誤！系統(tǒng)匹配不到相應(yīng)的收件人國家！	系統(tǒng)匹配不到發(fā)件人國家	請查看“創(chuàng)建訂單”中的輸入?yún)?shù)
運輸方式(渠道)數(shù)據(jù)錯誤！系統(tǒng)匹配不到相應(yīng)的運輸方式(渠道)！	系統(tǒng)匹配不到運輸方式(渠道)	請查看“創(chuàng)建訂單”中的輸入?yún)?shù)
訂單保存并提交成功!-DL140887(跟蹤號，運單號);R800001409100028（訂單號）	訂單提交成功（沒有任何錯誤）	提交到確認(rèn)的訂單才會返回跟蹤號
訂單保存并提交成功!-R800001409100028（訂單號）	訂單提交成功（沒有任何錯誤）	訂單沒有返回跟蹤號，本身渠道部返回跟蹤號，也不預(yù)報
訂單保存并提交成功!-R800001409100028（訂單號）-預(yù)報失?。河唵翁朢800001409100028郵編不正確	訂單提交成功（沒有任何錯誤）	訂單沒有返回跟蹤號，渠道有預(yù)報，但是預(yù)報失敗，會返回預(yù)報后的錯誤信息
訂單保存成功，但提交到確認(rèn)狀態(tài)失敗!-明細(xì)插入失敗	訂單主數(shù)據(jù)提交成功（明細(xì)插入失?。?/td>	請檢查傳入的明細(xì)數(shù)據(jù)
訂單保存成功，但提交到確認(rèn)狀態(tài)失敗!錯誤信息	提交到確認(rèn)失敗	請檢查傳入的“訂單類型”Style:1 倉儲訂單（如果傳入的明細(xì)產(chǎn)品不存在則提交到確認(rèn)失?。?/td>
訂單保存成功,但由于不滿足跟蹤號必須唯一或者收件人名稱、收件人國家、運輸方式、地址行1都不能為空,提交到確認(rèn)狀態(tài)失敗!-" 錯誤信息	訂單保存成功	請檢查傳入數(shù)據(jù)是否有誤!
訂單出錯	傳入的數(shù)據(jù)格式不正確	請參考“創(chuàng)建訂單”中的提交實例

技術(shù)支持