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

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

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

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

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

  1. 获取电子面单单号和打印信息 ： http://doc.fw199.com/docs/h7b/dd-logistics-newCreateOrder
  2. 查询电子面单（获取面单信息）: http://doc.fw199.com/docs/h7b/logistics-waybillApply

1.请求参数:

请求URL:

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

公共参数

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

业务参数

参数名称 参数类型 是否必须 示例值 参数描述
request_data json 是 见下面的示例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": "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"
}

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

2. 请求示例代码(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传入明文即可。

3. 返回结果如下：

 {
    "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_id String 202011809 订单号
pack_id String 1 包裹id
track_no String 202011809 运单号
print_data String 加密的面单数据
err_code int 错误码,0表示成功，非0失败
err_msg String 取号失败时，返回的信息
sort_code String 400-W00 000 分拣码（三段码）
package_center_code String 1 集包地代码
package_center_name String 1 集包名称
short_address_code String 1 大头笔编码
short_address_name String 1 大头笔名称
extra_resp String 1 额外打印信息（众邮、京东、丰网使用），具体请参考抖音电商电子面单对接文档附录4
sub_waybill_codes String 13,434,556 子母件列表英文逗号分隔
order_channel String c 2；详情请看文档映射表
shipping_code String 34343 快递商侧系统生成的寄件码

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

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

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

4.1 主店铺A帮其他副店铺B（抖音平台的店铺）取号时，即A出号给B使用。

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

4.2 主店铺A帮其他副店铺B（非抖音平台的店铺）取号时，即A出号给B使用。

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

渠道名称 渠道编码（接口交互使用） order_channel
抖音 1
快手 2
淘宝 3
天猫 4
京东 5
拍拍 6
易讯 7
当当 8
EBAY 9
亚马逊 10
QQ 11
苏宁 12
国美 13
唯品会 14
聚美 15
乐蜂 16
蘑菇街 17
聚尚 18
拍鞋 19
银泰 20
1号店 21
凡客 22
邮乐 23
优购 24
1688 25
有赞 26
拼多多 27
折800 28
楚楚街 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
4.3 顺丰电商标快如何取号

在取号参数在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

4.4 如何传入月结账号？

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

文档更新时间: 2024-10-21 23:43   作者：admin