国际物流系统（T7）API提交订单接口说明文档
编 写 人：吴海龙
审核部门：技术研发部
审 核 人：杨全
完成时间：2018年11月29日
审核时间：2018年11月30日
更新时间：2019年04月02日
深圳市全景世纪科技有限公司
目录
调用说明
返回结果
返回错误信息
返回JSON格式案例
提交JSON格式案例
测试账号信息
一．调用说明
1. 请求参数说明：
订单请求接口地址：
http://api.56sys.com/Helper/WayDate.ashx（注：正式地址）
渠道请求地址：
http://api.56sys.com/Helper/Apiinformation.ashx
验证调用参数：
|
参数 |
类型 |
是否必填 |
说明 |
|
wd_SecretKey |
String |
是 |
Json数组对象自面量 |
|
PartnerID |
String |
是 |
合作者身份ID |
|
PartnerKey |
String |
是 |
合作者秘钥 |
|
IdUser |
String |
是 |
账号 |
2. 包裹信息调用参数：
调用参数：
|
参数 |
类型 |
是否必填 |
说明 |
|
PackageItemDetail |
String |
是 |
Json数组对象自面量 |
|
EnglishName |
String |
是 |
英文品名 |
|
ChineseName |
String |
是 |
中文品名 |
|
Number |
int |
是 |
数量 |
|
Price |
Deciamal |
是 |
单价 |
|
ItemNumber |
String |
是 |
海关编码 |
|
Remark |
String |
是 |
产地 |
3. 运单信息添加接口请求：
请求接口地址：http://api.56sys.com/Helper/WayDate.ashx（注：正式地址）
调用参数：
|
参数 |
类型 |
是否必填 |
说明 |
|
waybill |
String |
是 |
Json数组对象自面量 |
|
IdUser |
String |
是 |
会员账号 |
|
Columns |
int |
是 |
包裹件数 |
|
Weight |
Deciamal |
是 |
包裹重量 |
|
Proxy |
String |
是 |
原始单号 |
|
Bagnumber |
String |
是 |
产品种类P(包裹)D(文件) |
|
Deliveryid |
int |
是 |
渠道ID |
|
ChannelsTxt |
String |
是 |
发货渠道中文 |
|
Product |
String |
是 |
产品(默认Express Worldwide) |
|
PackageType |
int |
是 |
包装类型(1.花袋/信封2.DHL箱子3.你自己的包装) |
|
PaymentMethod |
int |
是 |
重量单位(默认4002) |
|
Remark |
String |
是 |
字符串长度限制（255） |
|
SenderVAT |
String |
否 |
发件人税号 |
|
RecipientsVAT |
String |
否 |
收件人税号 |
|
CustomsDeclared |
Deciamal |
是 |
通关申报价值 |
|
DeclaredValue |
Deciamal |
否 |
申报价值 |
|
DeclaredType |
String |
否 |
价值币种 |
|
Long |
Deciamal |
否 |
长 |
|
Width |
Deciamal |
否 |
宽 |
|
Height |
Deciamal |
否 |
高 |
4.收件人请求参数(注意:地址只填收件人即可):
|
AddressReceived |
String |
是 |
收件人Json数组对象自面量 |
|
Companyname |
String |
否 |
所在公司 |
|
Name |
String |
是 |
名称 |
|
Country |
String |
是 |
国家 |
|
Countryid |
int |
否 |
国家ID |
|
Province |
String |
否 |
州 |
|
City |
String |
是 |
城市 |
|
Provinceid |
int |
否 |
州ID |
|
Zipcode |
String |
是 |
邮编 |
|
Phone |
String |
否 |
电话 |
|
Adress |
String |
是 |
详细地址 |
|
AdressTwo |
String |
否 |
详细地址2 |
|
AdressThree |
String |
否 |
详细地址3 |
|
|
String |
否 |
邮箱 |
|
Code |
String |
是 |
国家代码 |
二．返回结果
1. 提交订单返回结果参数：
|
字段名称 |
字段含义 |
|
Status |
True（成功）false失败 |
|
Code |
错误编号 |
|
Description |
错误描述 |
|
WaybillnumberS |
快递单号 |
|
|
面单 |
2. 获取渠道返回结果参数：
|
字段名称 |
字段含义 |
|
Title |
渠道名称 |
|
ID |
渠道ID |
三．返回错误信息
|
Code |
说明 |
|
1 |
json格式不对 |
|
2 |
秘钥,合作者身份id,账号不能为空 |
|
3 |
秘钥,合作者身份id,账号信息不对 |
|
4 |
运单账号不能为空 |
|
5 |
货物名称不能为空 |
|
6 |
备注不能为空 |
|
7 |
通关申报价值不能为空 |
|
8 |
通关申报价值币种不能为空 |
|
9 |
发货渠道不能为空 |
|
10 |
产品代码不能为空 |
|
11 |
发货渠道不存在 |
|
12 |
重量单位不存在 |
|
13 |
收件人不能为空 |
|
13 |
国家代码不能为空 |
|
13 |
收件邮编不能为空 |
|
13 |
收件城市不能为空 |
|
13 |
收件人不能为空 |
|
14 |
收件人信息不存在 |
|
15 |
原始单号已存在 |
|
16 |
该运单不在该渠道重量范围内,请选择其他渠道 |
|
17 |
该渠道接口信息有误 |
|
18 |
该渠道当日订单量已超出 |
|
19 |
包裹信息填写不完整 |
|
20 |
接口请求失败 |
四．返回json格式案例
1. 返回订单json：
错误json：
{"Status":false,"ResponseStatusList":[{"Code":17,"Description":"发件邮编不能为空","WaybillnumberS":""}]}
正确json：
、{"Status":true,"ResponseStatusList":[{"Code":0,"Description":"成功","WaybillnumberS":"8900101176"}]}
2. 返回渠道json：
[{
"TableName": "Channel",
"PrimaryKey": "ID",
"ID": 2018,
"FID": 0,
"Title": "DHL-D",
"TitleEn": null,
"Code": "",
"IDNumberTrue": false,
"IsTrue": true,
"AddTime": "\/Date(1532070681000)\/",
"OrderID": 1,
"IsDelete": null,
"WarehouseID": null,
"Warehouse": null,
"Compulsory": 0,
"APIName": "dhl-D",
"ApiID": 11,
"Percentage": 0,
"Volume": 5000,
"BillingType": 1,
"BillingTypeTxt": "国家"
}, {
"TableName": "Channel",
"PrimaryKey": "ID",
"ID": 2007,
"FID": 0,
"Title": "DHLA",
"TitleEn": null,
"Code": "ups002",
"IDNumberTrue": false,
"IsTrue": true,
"AddTime": "\/Date(1522377483000)\/",
"OrderID": 1,
"IsDelete": null,
"WarehouseID": null,
"Warehouse": null,
"Compulsory": 5000,
"APIName": "ATC",
"ApiID": 2,
"Percentage": 3,
"Volume": 5000,
"BillingType": 1,
"BillingTypeTxt": "国家"
}, {
"TableName": "Channel",
"PrimaryKey": "ID",
"ID": 2011,
"FID": 0,
"Title": "DHLB",
"TitleEn": null,
"Code": "",
"IDNumberTrue": false,
"IsTrue": true,
"AddTime": "\/Date(1522377461000)\/",
"OrderID": 1,
"IsDelete": null,
"WarehouseID": null,
"Warehouse": null,
"Compulsory": 0,
"APIName": "XJ",
"ApiID": 4,
"Percentage": 0,
"Volume": 5000,
"BillingType": 1,
"BillingTypeTxt": "国家"
}]
五．提交订单json格式Demo
dataArray={
"waybill": {
"PackageItemDetail": [{
"EnglishName": "ladys Woven dresses",
"ChineseName": "连衣裙",
"Number": 1,
"Price": 6.45,
"ItemNumber": "6204440090",
"Remark": "中国(China)"
}, {
"EnglishName": "ladys Woven dresses",
"ChineseName": "T 恤衫",
"Number": 1,
"Price": 2.70,
"ItemNumber": "6109100010",
"Remark": "中国(China)"
}],
"AddressReceived": {
"Country": "United States Of America(美国)",
"Countryid": 14,
"Province": "NEW YORK",
"Provinceid": "49",
"Name": "LEAH VAN SON",
"City": "ADDISON",
"Email": " 2597618808@qq.com",
"Phone": "5857941335",
"Companyname": "LEAH VAN SON",
"Adress": "211 LAWRENCE STREET",
"AdressTwo": null,
"Remark": null,
"Zipcode": "14801",
"Code": "US"
},
"IdUser": "2597618808@qq.com",
"Columns": 1,
"Weight": 2.0,
"Proxy": "ceshi201902205988",
"Bagnumber": "P",
"Deliveryid": 2007,
"ChannelsTxt": "DHLA",
"Product": "Express Worldwide",
"PackageType": 1,
"PaymentMethod": 4002,
"Remark": "ladys Woven dresses",
"SenderVAT": " ",
"RecipientsVAT": "dddddd",
"CustomsDeclared": 2.0,
"DeclaredValue": 2.0,
"DeclaredType": "USD",
"Long": 1,
"Width": 1,
"Height": 1
},
"wd_SecretKey": {
"PartnerID": "52192730152",
"PartnerKey": "D49CDED23518224F659F12B779A342E6",
"IdUser": "2597618808@qq.com"
}
}
获取渠道json Demo
dataArray1={"wd_SecretKey": {
"PartnerID": "52192730152",
"PartnerKey": "D49CDED23518224F659F12B779A342E6",
"IdUser": "2597618808@qq.com"
}
}
六．测试账号信息
账号：2597618808@qq.com
合作者身份ID：52192730152
KEY值：D49CDED23518224F659F12B779A342E6
