物流发货接口

sop出库发货接口

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/jd/order/shipment

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
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