物流发货接口

sop出库发货接口

一、请求参数

请求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	安装公司（非必填，大件物流订单可填）
sysid	Number	是		应用ID

二、请求示例代码

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","xxxxxx" );
         data.put("logiCoprId","467" );// 467为顺丰
         data.put("logiNo","SFxxxxxx" );
        //安装公司（非必填，大件物流订单可填）
//        data.put("installId","1" );
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDshipment, data);
    }

三、返回结果

返回结果

{
    "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为成功.