全局接⼜说明状态码statusCode
全局接⼜code说明
Content-Type ： application/json
2** :success 3**：warn 4** :error
1.登录接口
接口调用请求说明
请求⽅式: POST
正式环境地址：http://{admin}.itdida.com/itdida-api/login?username=8888&password=888888
测试账号：8888. 密码：888888
测试渠道：HKDHL测试
参数说明
返回说明
{"data":{"token":"TOKEN"},"statusCode":200}
{data: "用户名或密码错误！",statusCode: 400}
返回参数说明
状态码statusCode说明
2.运单批量导入预报接口 top
接口调用请求说明
请求方式: POST
正式环境地址：http://{admin}.itdida.com/itdida-api/yundans?access_token={TOKEN}
* 该接接口一次最多只允许导入100票运单
参数示例
[
{
"keHuDanHao": "test8888101",
"qitaDanHao1": "ABCD123",
"maiJiaId": "maijia1234",
“shouHuoQuDao": HKDHL测试",
"guoJia": "us",
"zhouMing": "BZ",
"eori": "eori0",
"jianShu": 1,
"shouHuoShiZhong": 1.2,
"shouHuoCaiJi": 1.2,
"baoGuanFangShi": 0,
"fuShuiJin": 0,
"wuLiuFangShi": 0,
"baoGuoLeiXing": 1,
"zhongWenPingMing": "中⽂品名",
"shouJianRenGongSi": "KylaEvans",
"shouJianRenXingMing": "KylaEvans",
"shouJianRenDianHua": "6048085188",
"shouJianRenDiZhi1": "5720172 Stret",
"shouJianRenDiZhi2": "shoujian2",
"shouJianRenDiZhi3": "shoujian3",
"shouJianRenYouBian": "33186-4212",
"shouJianRenChengShi": "MIAMI",
"daiShouHuoKuan": "30",
"daiShouHuoKuanBiZhong": "RMB",
"huoWuTeXing":"",
"requiredZhuanDanHao":true,
"requiredZhuanDanLabel":true,
“requiredZhuanDanFaPiao”:true,
“shenBaoXinList”[
{
"shenBaoXiZhong":"USD"，
“shenBaoJia”：13.5，
"shenBaoHaiGuanBianMa":"123456789",
“shenBaoJinE“：105，
"shenBaoPinMing":"shenBaoPinMing",
"shenBaoShuLing":10
},
{
"shenBaoZhong“："USD”,
“shenBaoJia”：13.5，
"shenBaoHaiGuanBianMa":"123456789",
“shenBaoJinE“：105，
"shenBaoPinMing":"shPinMing",
"shenBaoShuLing":10
},
{
"shenBaoZhong“："USD”,
“shenBaoJia”：15.5，
"shenBaoHaiGuanBianMa":"123456789",
“shenBaoJinE“：105，
"shenBaoPinMing":"shPinMing",
"shenBaoShuLing":10
},
{
"shenBaoZhong“："USD”,
“shenBaoJia”：12.1，
"shenBaoHaiGuanBianMa":"23456789",
“shenBaoJinE“：101，
"shenBaoPinMing":"shenBaoPinMing2",
"shenBaoShuLing":10
},
]，
"danJianList":[
{“chang”：19，
"kuan”：12，
"gao":8,
“shiZhong”：1.2
}
]
}
]
参数说明
返回说明
正常情况下，会返回下述JSON数据包
{"data":[
{"keHuDanHao":"98634567811",
"xiTongDanHao":"098700266979",
"zhuanDanHao":"98634567811"}
],"statusCode":200}
返回code说明
2.1转单号回调通知数据示例参数说明
参数说明
收到回调通知请返回⼀个"SUCCESS",表示已收到请求，将不会重新发送
3.下载系统标签 top
接⼝调⽤请求说明
请求⽅式:POST
正式环境地址：http://{admin}.itdida.com/itdida-api/files?
keHuDanHaoList=30020171131044&wenJianLeiXingList=1,2,3&access_token={TOKEN}
返回说明
正常情况下，会返回下述JSON数据包
{"data”:
[
{"code":200,"fileList":[{"code":200,"data”:”xxxxx (⽂件BASE64编码)","message":"成功","type":"1”},
{"code":200,"fileList":[{"code":200,"data”:”xxxxx (⽂件BASE64编码)","message":"成功","type":"2”},
{"code":304,"format":"","message":"⽂件不存在","type":"3”}
],
"keHuDanHao":"30020171131044","message":"成功"}],
"statusCode”:200
}
返回code说明
4.获取轨迹信息 top
接⼝调⽤请求说明
请求⽅式:POST正式环境地址：http://{admin}.itdida.com/itdida-api/track?
keHuDanHaoList=1100306616,10020184101308,1101215343&access_token={TOKEN}
返回说明
正常情况下，会返回下述数据
{
"data": [
{
"code": 200,
"keHuDanHao": "1100306616",
"message": "成功",
"trackList": [
{
"date": "2017-09-26 15:41:46",
"miaoShu": "操作状态: 草稿-->已预报",
"weiZhi": "客户"
}
]
},
{
"code": 200,
"keHuDanHao": "10020184101308",
"message": "成功",
"trackList": [
{
"date": "2018-04-27 16:25:30",
"miaoShu": "已预报",
"weiZhi": "客户"
},
{
"date": "2018-04-12 11:04:08",
"miaoShu": "已预报",
"weiZhi": "客户"
}
]
},
{
"code": 200,
"keHuDanHao": "1101215343",
"message": "成功",
"trackList": [
{
"date": "2017-09-19 01:55:00",
"miaoShu": "快件信息已收到",
"weiZhi": "SHENZHEN - CHINA, PEOPLES REPUBLIC"
},
{
"date": "2017-09-19 01:55:00",
"miaoShu": "快件制单信息已收到",
"weiZhi": "SHENZHEN - CHINA, PEOPLES REPUBLIC"
},
{
"date": "2017-09-11 17:16:04",
"miaoShu": "操作状态: 待发货-->待上网",
"weiZhi": "广州站点"
},
{
"date": "2017-09-08 11:34:13",
"miaoShu": "操作状态: 已预报-->待发货",
"weiZhi": "广州站点"
},
{
"date": "2017-09-08 11:34:11",
"miaoShu": "到达[广州站点]",
"weiZhi": "广州站点"
},
{
"date": "2017-09-08 11:23:40",
"miaoShu": "操作状态: 草稿-->已预报",
"weiZhi": "客户"
},
{
"date": "2017-09-08 10:44:29",
"miaoShu": "操作状态: 已预报-->草稿",
"weiZhi": "客户"
},
{
"date": "2017-09-08 10:40:20",
"miaoShu": "操作状态: 草稿-->已预报",
"weiZhi": "客户"
}
]
}
],
"statusCode": 200
}
5.删除运单接口 top
接⼝调⽤请求说明
请求方式:POST
正式环境地址：http://{admin}.itdida.com/itdida-api/deleteYundans?keHuDanHao={客户单号}&access_token={TOKEN}
返回说明
{“data":"操作成功！","statusCode":200}
6.各国邮编规则 top
7.渠道名称查询 top
接口调用请求说明
请求方式:GET
正式环境地址：http://{DOMAIN}.itdida.com/itdida-api/getReceivingChannels
返回说明
{
“statusCode”: 200,
“data”: [
{
“channelName”:”11-小包”,
“logisticsModeCode”:”1”,
“logisticsModeName”:”小包”
}
....
]
}
版本更新记录
