跳转到内容
Cheeli 文档
返回官网

获取电子面单（合二为一）

主要用于商家ERP/ISV 向字节电子面单系统获取单号和打印信息。 （重要）若取号后再来取号，需传相同订单号及不同的包裹id再次来取号，否则返回老号 支持批量取号，一次最多50条。

说明： 抖店获取打印电子面单分为2个步骤（2个接口）：

  1. 获取快递单号

  2. 再根据已获取的快递单号，再次调用接口获取电子面单信息。

为方便大家的使用，本接口已经将上面2个步骤合二为一，传入参数，直接返回快递单号和对应的电子面单信息。 如果您的业务场景需要分开调用的话，也可以分开单独调用下面2个接口（注意调用顺序）。

  1. 获取电子面单单号和打印信息 ： dd-logistics-newCreateOrder

  2. 查询电子面单（获取面单信息）: logistics-waybillApply

一、请求参数

请求URL:

POST https://kf.fw199.com/gateway/dd/logistics/waybill/get

公共参数

参数名称参数类型是否必须示例值参数描述
appidString是合作伙伴AppId
timestampString是1657525936当前Unix时间戳，秒
seller_nickString是oms38173182抖店的账号，对应蜂巢授权返回doudianseller字段
signString是
sysidint是应用ID业务参数

业务参数

参数名称参数类型是否必须示例值参数描述
request_datajson是见下面的示例json获取单号和面单打印数据 ,如果同时对多个订单进行取号，将多个订单信息放到集合order_infos中。

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

{
    "sender_info":{
        "address":{
            "country_code":"CHN",
            "province_name":"上海市",
            "city_name":"上海市",
            "district_name":"青浦区",
            "detail_address":"测试"
        },
        "contact":{
            "name":"hanson",
            "mobile":"18817834074"
        }
    },
    "logistics_code":"zhongtong",
    "order_infos":[
        {
            "order_id":"49488636457864312061",//密文取号时，传从千里马获取的订单号，明文取号时，传自定义订单号。
            "pack_id":"pkg_01",
            "receiver_info":{
                "address":{
                    "country_code":"CHN",
                    "province_name":"浙江省",
                    "city_name":"杭州市",
                    "district_name":"西湖区",
                    "detail_address":""  //密文取号时，传空字符串; 明文取号时，传收件人真实详细地址。
                },
                "contact":{
                    "name":"",//密文取号时，传空字符串;  明文取号时，传收件人真实姓名
                    "mobile":""//密文取号时，传空字符串; 明文取号时，传收件人真实手机。
                }
            },
            "items":[
                {
                    "item_name":"【测试商品勿拍】白色水墨印花衬衣",
                    "item_specs":"颜色:默认 尺码:120cm",
                    "item_count":1
                }
            ]
        },
        {
            "order_id":"4948795729456854758",//密文取号时，传从千里马获取的订单号，明文取号时，传自定义订单号。
            "receiver_info":{
                "address":{
                    "country_code":"CHN",
                    "province_name":"浙江省",
                    "city_name":"杭州市",
                    "district_name":"西湖区",
                    "detail_address":"" //密文取号时，传空字符串; 明文取号时，传收件人真实详细地址。
                },
                "contact":{
                    "name":"",//密文取号时，传空字符串;  明文取号时，传收件人真实姓名
                    "mobile":""//密文取号时，传空字符串; 明文取号时，传收件人真实手机。
                }
            },
            "items":[
                {
                    "item_name":"【【测试商品勿拍】dy测试上衣-各种编码3",
                    "item_count":1
                }
            ]
        }
    ],
    "user_id":-1,
    "order_channel":"1"
}

上述请求参数字段的以及更多字段的业务含义说明见文档

二、请求示例代码

Java

@Test
    public void  DDLogisticsWaybillGet() throws Exception {


         String reqData = "{\"sender_info\": {" +
            "        \"address\": {" +
            "            \"country_code\": \"CHN\"," +
            "            \"province_name\": \"上海市\"," +
            "            \"city_name\": \"上海市\"," +
            "            \"district_name\": \"青浦区\"," +
            "            \"detail_address\": \"测试\"" +
            "        }," +
            "        \"contact\": {" +
            "            \"name\": \"hanson\"," +
            "            \"mobile\": \"18817834074\"" +
            "        }" +
            "    }," +
            "    \"logistics_code\": \"zhongtong\"," +
            "    \"order_infos\": [" +
            "        {" +
            "            \"order_id\": \"4948863645786431206\"," +
            "            \"pack_id\": \"pkg_01\"," +
            "            \"receiver_info\": {" +
            "                \"address\": {" +
            "                    \"country_code\": \"CHN\"," +
            "                    \"province_name\": \"浙江省\"," +
            "                    \"city_name\": \"杭州市\"," +
            "                    \"district_name\": \"西湖区\"," +
            "                    \"detail_address\": \"#ZbZE6fdvKu0n/gB488d4Uxj7bzQi#n3zBNQgaGXiMjQb7CIwUDrQ/oEQGP43PmvV9Oi4lTooQagOruEjHzoy8JiUfZ/+3kOQABhWWXbhtTCKXDaE5GrNfbVhmef3N2d1u4eIDRZ6cT4fAsxUY4eCRTD+3pg==*CgwIARCtHBiYJSABKAESPgo8azkO9VDljulg7gl8Z8ykmOOfh93YeeMY+p+VbuytBkgfmS61mTnWtH4omldn44DJ4b7CZPzdDybE/QFBGgA=#1##\"" +
            "                }," +
            "                \"contact\": {" +
            "                    \"name\": \"#JsKP#mjMUmDSsFnoIZQyxnI8dKvJm7af8F+6YU+ZQRYZRGpukzSczT5arppGdExz9pleid3zCHGr8FvBmFsMmU5mmZ03F8k/dCNEy*CgwIARCtHBiYJSABKAESPgo8EGql2MQlYZNFj1iHVlSK41VeEYk0sH3UrzR5/8nYgPlbhkrbI2fbWQmlYrkuSJig7K3SHQi1jI6oXkp5GgA=#1##\"," +
            "                    \"mobile\": \"$dzFmfVaRHLlEEdPMqNWcR5WZ01oatEm4hTtC3iO9+sM=$0uwlr1TmDiJNYFPgdS1vCTOdq2ZxXk1ed8aSS8AZLpa8itQk/L9noLXPPnyWt6VOF3ZyyC+N00OGk09TzF+4/Mtn4VeJ0OGAPqZtGTlJGJxx*CgwIARCtHBiYJSABKAESPgo88ghgupGfSv8mUFdaXWzO3J54gbTj1192xyPJJUHcxjR0SqFUEdfoeUVsLKK6EaekOkvU5OTFCWgREZehGgA=$1$$\"" +
            "                }" +
            "            }," +
            "            \"items\": [" +
            "                {" +
            "                    \"item_name\": \"【测试商品勿拍】白色水墨印花衬衣\"," +
            "                    \"item_specs\": \"颜色:默认 尺码:120cm\"," +
            "                    \"item_count\": 1" +
            "                } " +
            "            ]" +
            "        }" +
            "    ]," +
            "    \"user_id\": -1," +
            "    \"order_channel\": \"1\"" +
            "}";


        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", reqData);
        data.put("sign", Sign(data, Config.AppSecret));
        // 调用服务API
        String resp = doHttpRequest(Config.DDLogisticsWaybillGetUrl, data);
        System.out.println(resp);


    }

说明：取号也支持明文取号，将收件人详细地址detail_address、收件人姓名name、收件人手机mobile传入明文即可。

三、返回结果

{
    "code":0,
    "message":"ok",
    "data":[
        {
            "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":"jZYBkt/kbP0YxFMFK2gD8iWlM3egfXldgwItw0eGu5SvwI8eQnaFGTURUQVs6uQOpI/d0K8OUOg26/+VqSzNaCOSGNvCA/QZm+iMKXJT1VXO/sG1913ylSs74YKESYlfiJ6THueDbeDs1ZjdohyX4Bxu3v49givPQ5Xcl2g049xVW/WOUMmOJJZdKqgXCohOVoC9prYZGBmgVzqU/ymWw2DP91WDQFpJ/j8TZjY7ohncepc5mfYQtBTy7ydvGW8bCjaWdvvNqELeu97oBL3Mff/NcnU1SUXoXvajBN6gpegnn9UETtilJA1w219hvW1ifHoPqYBS9so0aN1/6HmSvA==",
            "err_code":0,
            "err_msg":"",
            "sort_code":"320- 13 128",
            "package_center_code":"",
            "package_center_name":"杭州",
            "short_address_code":"",
            "short_address_name":"",
            "extra_resp":"",
            "sub_waybill_codes":"",
            "order_channel":"1",
            "shipping_code":"",
            "pack_id":""
        }
    ],
    "trace_id":""
}

返回参数说明

参数名称参数类型是否必须示例值参数描述
order_idString202011809订单号
pack_idString1包裹id
track_noString202011809运单号
print_dataString加密的面单数据
err_codeint错误码,0表示成功，非0失败
err_msgString取号失败时，返回的信息
sort_codeString400-W00 000分拣码（三段码）
package_center_codeString1集包地代码
package_center_nameString1集包名称
short_address_codeString1大头笔编码
short_address_nameString1大头笔名称
extra_respString1额外打印信息（众邮、京东、丰网使用），具体请参考抖音电商电子面单对接文档附录4
sub_waybill_codesString13,434,556子母件列表英文逗号分隔
order_channelStringc2；详情请看文档映射表
shipping_codeString34343快递商侧系统生成的寄件码

说明： code为0表示成功，非0为失败，message会包含失败原因。此接口为批量取号接口，多个订单同时取号时，取号失败的订单也会返回，是否成功以err_code为准，err_msg会包含失败的原因。

四、多店铺共享面单库存&非抖店面单取号方案

当取号接口返回提示“查询订单失败”时，一般是渠道和订单号与店铺不一致造成的，一般有如下2种情况：

四（一）、主店铺A帮其他副店铺B取号时，即A出号给B使用。

抖音平台的店铺

这种情况，取号参数中的user_id传B店铺的店铺ID。若无法获取到B店铺的店铺ID，传值 -1 可绕过order_id与user_id的一致性校验。

四（二）、主店铺A帮其他副店铺B取号时，即A出号给B使用。

非抖音平台的店铺

这情况下，因为传入的订单号order_id是其他平台渠道的订单号，所以还要传入order_channel渠道代码（不传或传1是代表抖音）， 所以order_channel要传其他平台的代码。 其他平台的代码表如下：

渠道名称渠道编码（接口交互使用） order_channel
抖音1
快手2
淘宝3
天猫4
京东5
拍拍6
易讯7
当当8
EBAY9
亚马逊10
QQ11
苏宁12
国美13
唯品会14
聚美15
乐蜂16
蘑菇街17
聚尚18
拍鞋19
银泰20
1号店21
凡客22
邮乐23
优购24
168825
有赞26
拼多多27
折80028
楚楚街29
卷皮30
贝贝31
微店32
千米33
美丽说34
返利35
萌店36
网易严选37
微盟38
微商39
小米40
考拉41
蜜芽42
云集43
贝店44
闲鱼45
玩物得志46
小红书47
华为48
洋码头49
我买50
酒仙网51
本来生活52
得物53
小荷健康商城55
微信视频号56
字节供应链101
字节抖音超市102

四（三）、顺丰电商标快如何取号

在取号参数在order_infos的节点下增加product_type产品类型，取值是247。

// ...省略
      "items": [
          {
            "item_name": "大抽纸70克-北京顺丰",
            "item_specs": "",
            "item_count": 1
          }
        ],
        "product_type":"247"
    //   ...省略

顺丰的产品类型说明请：https://open.sf-express.com/developSupport/734349?activeIndex=324604

四（四）、如何传入月结账号？

取号接口根据寄件人地址匹配月结卡号的，抖店商家后台开通网点的时候填入月结卡号，接口传对应的寄件人地址就会自动匹配，不同的月结卡号需要开通不同的寄件人地址，如果相同，则会匹配到后台先开通的那个网点和月结卡号。