商家寄件订单详情查询接口
POST
https://order.kuaidi100.com/order/borderapi.do查询通过商家寄件下单接口下单的订单详情信息
param数据结构:
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
taskId | 是 | string | 下单时返回的任务ID |
说明:
信息代码 | 信息内容描述 | 原因及建议处理方式 |
---|---|---|
200 | 提交成功 | 提交成功 |
400 | 参数错误等 | 请根据技术文档请求,注意参数类型及是否必填 |
500 | 服务器错误 | 快递100的服务器出理间隙或临时性异常,有时如果因为不按规范提交请求,比如快递公司参数写错等,也会报此错误 |
503 | 验证签名失败 | 请检查加密方式,param + t + key + secret 的顺序进行MD5加密,加密后字符串转大写,不用加上“+”号 |
600 | 您不是合法的用户(即授权Key出错) | 账号无可用余额,需要充值 |
601 | KEY已过期 | 账号无可用余额,需要充值 |
请求参数
Body 参数application/x-www-form-urlencoded
method
string
必需
业务类型(默认:detail)
key
string
必需
授权码,请到快递100页面申请企业版接口获取
sign
string
必需
32位大写签名,用于验证身份,按MD5 (param +t+key+ secret)的顺序进行MD5加密,不需要加上“+”号secret在授权邮件里面有
t
string
必需
时间戳如:1576123932000
param
string
由其他字段拼接
示例代码
返回响应
成功(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
object
必需
cargo
string
物品名称
comment
null
备注内容
courierMobile
null
快递员联系方式
courierName
null
快递员姓名
createTime
string
下单时间
sendName
string
寄件人姓名
dayType
null
预约日期
freight
null
折后运费,单位:元
feeDetails
array [object {4}]
必需
kuaidiCom
string
快递公司
kuaidiNum
string
快递单号
lastWeight
null
快递公司返回最终重量 ,单位:kg
orderId
string
订单ID
payStatus
integer
支付状态,0:预扣款,1:已支付,3:退款中,4:已退款
payment
string
支付方式,SHIPPER: 寄付,CONSIGNEE: 到付, MONTHLY:月结
pickupEndTime
null
预约截止时间
pickupStartTime
null
预约时间
preWeight
string
用户端输入重量,单位:kg
defPrice
null
标准运费,单位:元
recAddr
string
收件人详细地址
recCity
string
收件人城市
recDistrict
string
收件人区
recMobile
string
收件人联系方式
recName
string
必需
recProvince
string
收件人省份
sendAddr
string
寄件人详细地址
sendCity
string
寄件人城市
sendDistrict
string
寄件人区
sendMobile
string
寄件人联系方式
sendName
string
收件人姓名
sendProvince
string
寄件人省份
serviceType
string
业务类型
status
integer
订单状态: 0:'下单成功'; 1:'已接单'; 2:'收件中'; 9:'用户主动取消'; 10;'已取件'; 11;'揽货失败'; 12;'已退回'; 13;'已签收'; 14;'异常签收';15;'已结算' 99;'订单已取消'101;'运输中';200:'已出单'201:'出单失败'
taskId
string
任务ID
valins
null
保价费用
message
string
返回报文描述
result
boolean
提交结果
true提交成功,false失败
returnCode
string
返回编码
示例
{
"data": {
"cargo": "普货",
"comment": null,
"courierMobile": null,
"courierName": null,
"createTime": "2022-04-22 01:23:40",
"dayType": null,
"freight": null,
"feeDetails": [
{
"feeType": "",
"feeDesc": "",
"amount": "",
"payStatus": ""
}
],
"kuaidiCom": "jd",
"kuaidiNum": "JDVC13641480904",
"lastWeight": null,
"orderId": "20274573",
"payStatus": 4,
"payment": "SHIPPER",
"pickupEndTime": null,
"pickupStartTime": null,
"preWeight": "1",
"defPrice": null,
"recAddr": "长安塘村长兴工业区12号3楼",
"recCity": "东莞市",
"recDistrict": "东坑镇",
"recMobile": "13800138000",
"recName": "李谬朵",
"recProvince": "广东",
"sendAddr": "蔡子池街道新大陆国际监控室",
"sendCity": "衡阳市",
"sendDistrict": "耒阳市",
"sendMobile": "13800138000",
"sendName": "李新红",
"sendProvince": "湖南",
"serviceType": "特惠送",
"status": 9,
"taskId": "44B0108CF44728E6F8A121177E3212B2",
"valins": null
},
"message": "成功",
"result": true,
"returnCode": "200"
}
修改于 2 年前