物流发货接口
sop出库发货接口
1.请求参数:
请求URL:
公共参数
参数名称 | 参数类型 | 是否必须 | 示例值 | 参数描述 |
---|---|---|---|---|
appid | String | 是 | 合作伙伴AppId | |
timestamp | String | 是 | 1657525936 | 当前Unix时间戳,秒 |
seller_nick | String | 是 | 38173182 | 京东的账号,对应蜂巢授权返回jdseller字段 |
sign | String | 是 |
业务参数
名称 | 类型 | 必须 | 示例值 | 描述 |
---|---|---|---|---|
- orderId | Number | 是 | 1 | 订单号 |
- logiCoprId | String | 是 | 2100|4700 | 物流公司ID(只可通过获取商家物流公司接口获得),多个物流公司以|分隔。如:2100|4700。请注意:如果填写厂家自送(1274),则不会保存物流单号,也不会有具体的跟踪信息。 |
- logiNo | String | 否 | 1200458628372,111232|468778814888,323232323 | 运单号(当厂家自送时运单号可为空,不同物流公司的运单号用|分隔,如果同一物流公司有多个运单号,则用英文逗号分隔) 。如:1200458628372,111232|468778814888,323232323 |
- installId | Number | 否 | 1 | 安装公司(非必填,大件物流订单可填) |
2. 请求示例代码(Java)
请求示例代码
@Test
public void shipment() throws Exception {
String tb_seller_nick = Config.JDSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
data.put("seller_nick", tb_seller_nick);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
//订单号
data.put("orderId","252770493591" );
data.put("logiCoprId","467" );// 467为顺丰
data.put("logiNo","SF1655275297820" );
//安装公司(非必填,大件物流订单可填)
// data.put("installId","1" );
// 参数签名
data.put("sign", Utils.Sign(data, Config.AppSecret));
doHttpRequest(Config.JDshipment, data);
}
3. 返回结果如下:
返回结果
{
"code": 0,
"message": "ok",
"data": {
"chineseErrCode": "SOP订单 订单出库成功",
"englishErrCode": "Order out of library success",
"errorCode": "0",
"success": true
}
}
失败的情况1:
{"code":1,"message":"299011912672x不符合转化整型条件(解决方案参考: https://jos.jd.com/commondoc?listId=171)"}
失败的情况2:
{
"code": 0,
"message": "ok",
"data": {
"englishErrCode": "order does not exist or does not belong to business",
"success": false,
"errorCode": "10100041",
"chineseErrCode": "订单不存在或不属于当前商家"
}
}
说明: code为0表示成功,非0为失败,message会包含失败原因。业务成功与否见success的值,true为成功.
文档更新时间: 2024-08-01 00:50 作者:admin