查询电子面单(获取面单信息)

用于商家向字节系统,获取电子面单打印加密数据。使用本接口的前置条件是通过接口:获取电子面单单号和打印信息 已经获取了快递单号等信息。

另外:
为方便大家的使用,本接口已经将上面2个步骤合二为一,传入参数,直接返回快递单号和对应的电子面单信息。
合二为一的取号接口:获取电子面单(合二为一)

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/dd/logistics/getwaybill

公共参数

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

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
request_data json 见下面的示例json 请求结构体,最多100个对象

request_data为取号的示例业务报文,json格式如下:

 [
    {
        "logistics_code":"zhongtong", //物流公司编码
        "track_no":"75531717195834" //运单号
    },
    {
        "logistics_code":"zhongtong",
        "track_no":"75531717195835"
    }
]

2. 请求示例代码(Java)

     @Test
    public void  DDLogisticsGetWayBill() throws Exception { 

        String   reqDataMW ="[{\"logistics_code\":\"zhongtong\" , \"track_no\": \"75531717195834\" }, \n" +
                "     {\"logistics_code\":\"zhongtong\" , \"track_no\": \"75531717195835\" }\n" +
                "    ]";  
        Map<String, Object> data = new HashMap<String, Object>();
        data.put("appid", Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("seller_nick", Config.DDSellerNick);
        data.put("request_data", reqDataMW);
        data.put("sign", Sign(data, Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDLogisticsGetWayBillUrl, data);
        System.out.println(resp);  
    }

3. 返回结果如下:

{
    "code":0,
    "message":"ok",
    "data":{
        "waybill_infos":[
            {
                "order_id":"4948795729456854758",
                "track_no":"75531717195834",
                "print_params":"access_token=39558966-785f-4589-a7c9-c51a801e387c\u0026app_key=7112649030697485854\u0026method=logistics.getShopKey\u0026param_json={}\u0026timestamp=1659702342\u0026v=2\u0026sign=e245fb6bc0ab8e6a5ffc194c957f02d835092611ee84d5271955a524d0f21c19\u0026sign_method=hmac-sha256", 
                "print_data":"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",
                "sign":"gjgttFB2YwI/wD0iLRsXLi1oRcquOhnY99glwj2mK3dcjRnBi6LVIOZkAfnL3SOBRWc0c81nIKJgiXggcVv8LJDcPCnQQZzERsSH6LRknMPzQNHEHHA5gXGsrZciCt0KaeVAo4H5PEbelev5gsm1h0JlRG4inb3DSDbO1jx6kouVUdHEx/UfeqKmDMe8cnTdQKRtToY6+ukq0OIHF++8kUA62JYE9ueWIm0KgHsMswS/btdjdFApNcU3OGwb4LIOobGJCKcZVFkubBOXeS2xut4yi7vPshDQxChDBry4a0DK3x6MOmAWZhgnqEPEHqBDHHOMcdLxT4b3GOdm2P1Blw==",
                "err_code":0,
                "err_msg":"",
                "sort_code":"",
                "package_center_code":"",
                "package_center_name":"",
                "short_address_code":"",
                "short_address_name":"",
                "extra_resp":"",
                "sub_waybill_codes":"",
                "order_channel":"",
                "shipping_code":"",
                "pack_id":""
            }
        ],
        "err_infos":[
            {
                "track_no":"75531717195835",
                "order_id":"",
                "err_code":100108,
                "err_msg":"不存在该运单信息"
            }
        ]
    }
}

返回参数说明

说明: code为0表示成功,非0为失败,message会包含失败原因。

获取面单信息后,可以对接抖音的面单打印组件, 更多信息:https://op.jinritemai.com/docs/guide-docs/120/596

文档更新时间: 2023-03-14 16:53   作者:admin