获取电子面单打印数据

获取京配打印数据

1.请求参数:

请求URL:

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

公共参数

参数名称 参数类型 是否必须 示例值 参数描述
appid String 合作伙伴AppId
timestamp String 1657525936 当前Unix时间戳,秒
seller_nick String 38173182 京东的账号,对应蜂巢授权返回jdseller字段
sign String

业务参数

名称 类型 必须 示例值 描述
- 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"
}

2. 请求示例代码(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);
    }

3. 返回结果如下:

{
    "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 包裹号
文档更新时间: 2023-04-13 23:05   作者:admin