获取电子面单打印数据

获取京配打印数据

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/jd/printing/pulldata

公共参数

参数名称	参数类型	是否必须	示例值	参数描述
appid	String	是		合作伙伴AppId
timestamp	String	是	1657525936	当前Unix时间戳，秒
seller_nick	String	是	38173182	京东的账号，对应蜂巢授权返回jdseller字段
sign	String	是
sysid	可选	应用标识，不清楚请咨询客服

业务参数

名称	类型	必须	示例值	描述
- objectId	String	是	1606370979791	每次请求唯一，本次获取打印数据请求ID，长度不超过20位
parameters	java.util.Map	是		参数,key有文档规范。电子面单商家编码:ewCustomerCode(String)（青龙业主号），商城商家编码:eCustomerCode(String)
- key1	String	是	ewCustomerCode	map的key
- value1	String	是	1111111	map的value
wayBillInfos	java.util.List	是		运单信息列表 最多支持100条
—	com.jd.jcloud.wms.printing.dto.WayBillInfo	是
- orderNo	String	否	00000	商城订单号
- popFlag	Number	是	1	是否pop订单，1：pop订单；不填或者0：非pop订单
- wayBillCode	String	否	0000000	运单号
- jdWayBillCode	String	是	0000000	京东运单号
- cpCode	String	是	JD	物流公司编码。京东快递：JD

请求业务报文

{
    "objectId": "314321414",
    "parameters": {
        "eCustomerCode": "12412981"
    },
    "wayBillInfos": [
        {
            "orderNo": "252154489446",
            "popFlag": 1,
            "wayBillCode": "SF1655275297820"

        },
        {
            "orderNo": "255919279479",
            "popFlag": 1,
            "wayBillCode": "SF1637407679724"

        }
    ],
    "cpCode": "SF"
}

二、请求示例代码

Java

请求示例代码

// 获取面单打印信息
    @Test
    public void     wayBillPulldata() throws Exception {

        String sellerNick = Config.JDSellerNick ;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        data.put("seller_nick", sellerNick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());

         // 获取单个订单获取面单信息
//        String param1 ="{\n" +
//                "    \"objectId\": \"314321414\",\n" +
//                "    \"parameters\": {\n" +
//                "        \"eCustomerCode\": \"12412981\" \n" +
//                "    },\n" +
//                "    \"wayBillInfos\": [\n" +
//                "        {\n" +
//                "            \"orderNo\": \"252154489446\",\n" +
//                "            \"popFlag\": 1,\n" +
//                "            \"wayBillCode\": \"SF1655275297820\" \n" +
//                "       \n" +
//                "        }\n" +
//                "    ],\n" +
//                "    \"cpCode\": \"SF\"\n" +
//                "}";

        // 多个订单的情况
        String param1 = "{\n" +
                "    \"objectId\": \"314321414\",\n" +
                "    \"parameters\": {\n" +
                "        \"eCustomerCode\": \"12412981\"  \n" +
                "    },\n" +
                "    \"wayBillInfos\": [\n" +
                "        {\n" +
                "            \"orderNo\": \"252154489446\",\n" +
                "            \"popFlag\": 1,\n" +
                "            \"wayBillCode\": \"SF1655275297820\" \n" +
                "       \n" +
                "        },\n" +
                "        {\n" +
                "            \"orderNo\": \"255919279479\",\n" +
                "            \"popFlag\": 1,\n" +
                "            \"wayBillCode\": \"SF1637407679724\" \n" +
                "       \n" +
                "        }\n" +
                "    ],\n" +
                "    \"cpCode\": \"SF\"\n" +
                "}";

         data.put("request_data",param1);
         data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.JDwayBillPulldata, data);
    }

三、返回结果

{
    "code": 0,
    "message": "ok",
    "data": {
        "objectId": "65432168764",
        "result": [
            {
                "code": 0,
                "msg": "success",
                "packageCode": "",
                "perPrintData": "QMNwNAcT/A5KUESRgH4ETWWNmPq1RKNyoOo2cy8c6oU6R8hUR1BLdE/n8ZtRhRXlSyenVXann/7nZ9M8dFWBzR63Q3gXInNWvBd4QKcaR25OyYNnFKUCkzZxU1uZJ3GhFOpPFRuqdYL2rplqnzOy7zxLIEUcZuhZEuTr2X2Tsr6cPZ0gZztrOpN+qo95qXWClKqEbupVbPYdlSa+cn1Rb3zZD0Ctw8TD9eVbG9P4aKvQeean/q73h5E33pJ4b92m2FFGVynMkaTQPTIyA4VqZ+B8KFsS4bXKQ7jWU6plBmFXUB7IGPsP8oyvJ8hxE3EzZ/t39XXypTuVt01AJ32Z7ZtB7RfgrcNCsQxnF6TzcMPZeRh3BlFQ==",
                "wayBillNo": "428076724748633"
            },
            {
                "code": 2,
                "msg": "无界返回数据不能为空！",
                "packageCode": "",
                "perPrintData": "",
                "wayBillNo": "4280767247486339"
            }
        ]
    }
}

业务成功与否参见内层code,0为成功, 失败的话msg包括失败的消息. 关键业务字段说明如下:

名称	类型	示例值	描述
wayBillNo	String	0000000	运单号
code	int	0	单个运单查询结果
msg	String	操作成功	单个运单查询响应信息
perPrintData	String	9XR7FEUvv/J9BWi	加密的运单数据
packageCode	String	str	包裹号

四、京东快递问题

京东快递和第三方快递（如圆通快递等）在本接口入参时会有不同，商家签约京东快递时需要绑定商家，并获得青龙业主号。

{
  "objectId" : "05557tizHLd2swUckDxlX23",
  "parameters" : {
    "ewCustomerCode" : "010K222222xxxxxxx" //青龙业主号
  },
  "wayBillInfos" : [ {
    "orderNo" : "298038012689",
    "popFlag" : 1,
    "jdWayBillCode" : "JDVA29xxxxxxx"  // 京东快递单号
  } ],
  "cpCode" : "JD"
}