关于顺丰接入说明

针对顺丰接入菜鸟的说明

本次顺丰旗下有3个产品接入菜鸟。 分别是：

1. 顺丰速运，SF

2. 顺丰快运, FOP

3. 丰⽹速运, FW

一、取号接口变更

原菜鸟电子面单云打印接口（取号接口）增加相关的入参。 以丰网为例，最最基本的取号参数在原来的取号接口上增加以下2个字段即可。

增加参数	类型	是否必须	描述
brand_code	String	顺丰取号，必须	品牌编码，比如FW代表丰网速运。 注意如果是顺丰取号，原来的取号参数公司编码cp_code传为SF
package_info.goods_description	String	顺丰取号，必须	包裹说明，比如文件。

product_code

最基本的丰网取号示例报文

{
    "cp_code": "SF",
    "brand_code": "FW",
    "customer_code":"月结卡号",
    "dms_sorting": false,
    "three_pl_timing ": false,
    "need_encrypt": true,
    "resource_code ": "",
    "sender": {
        "mobile": "13907896832",
        "name": "王去龙",
        "phone": "",
        "address": {
            "city": "泉州市",
              "detail": "世茂摩天城1期",
              "district": "石狮市",
              "province": "福建省"
        }
    },
    "store_code ": "",
    "trade_order_info_dtos": [{
        "object_id": "500000033",
        "order_info": {
            "order_channels_type": "TB",
            "trade_order_list": ["2203578759552580083"]
        },
        "package_info": {
            "id": "10",
            "items": [{
                "count": 1,
                "name": "A4\打\印\纸"
            }],
            "goods_description": "文件",
            "volume": 1,
            "weight": 1
        },
        "recipient": {
            "address": {
                "city": "武汉市",
                "detail": "杨*街*道余**路怡**小区",
                "district": "武昌区",
                "province": "湖北省",
                "town": ""
            },
            "mobile": "55555559993",
            "name": "@**",
            "phone": "",
            "oaid": "1GzEV8mUSicnbibo1i4bbqk4gg7tngN2HGyED9JibmAvc3tV6q6PDMrhMQOWnfYX1Ibix1c3xZA",
            "tid": "2203578759552580082"
        },
        "template_url": "http://cloudprint.cainiao.com/template/standard/490404/8",
        "user_id": 0
    }]
}

取号的返回结果增加字段extra_info。 ⽬前⽀持透出顺丰取号接⼝ 返回值的remark字段。示例： {“remark”: “xxxx”}

二、 相关资料

更多的信息接入，请查看此文档：接菜鸟电子面单SF取号指南

二（一）、顺丰无月结账号取号

增加extra_info扩展字段，同时加入payMethod字段，请求参数:

{
  "cp_code": "SF",
  "brand_code": "SF",
  "extra_info": "{\"payMethod\": 1}",
  "dms_sorting": false,
  "three_pl_timing ": false,
  "need_encrypt": false,
  "resource_code": "",
  "sender": {
    "address": {
      "province": "浙江省",
      "city": "温州市",
      "district": "瑞安市",
      "detail": "东阳路28号"
    },
    "name": "1318681xxx",
    "mobile": "1318681xxx",
    "phone": ""
  },
  "store_code": "",
  "trade_order_info_dtos": [
    {
      "object_id": "1231170722364558617",
      "order_info": {
        "order_channels_type": "TB",
        "trade_order_list": ["ceshi"]
      },
      "package_info": {
        "id": "PI20240206204725858322",
        "items": [{ "count": 1, "name": "KA542-51B0S" }],
        "goods_description": "物品",
        "length": 1,
        "width": 1,
        "height": 1
      },
      "recipient": {
        "address": {
          "province": "海南省",
          "city": "三亚市",
          "district": "吉阳区",
          "town": "",
          "detail": "测试地址"
        },
        "name": "测试",
        "mobile": "18813265322",
        "phone": ""
      },
      "template_url": "https://cloudprint.cainiao.com/template/standard/474750/19",
      "user_id": 0
    }
  ]
}

其中payMethod说明 现结： payMethod = 1,无需传入月结卡号 到付：payMethod = 2，无需传入月结卡号 第三方付：payMethod = 3， 需月结卡号

三、常见问题

1. 如何进行顺丰电商标快的取号 在取号参数cp_code同级增加product_code字段，如下 "product_code":"247" 顺丰各时效性产品见：sf-product-type

附件

• 0927_ISV对接菜鸟电子面单，SF取号指南v1.7.pdf