按id获取商品运费模版接口

根据id获取拼多多商家的物流运费模板信息

1.请求参数:

请求URL:

POST https://kf.fw199.com/gateway/pdd/one/express/cost/template

1.1 基础参数
参数名 类型 必须 说明
appid String 必填 合作伙伴AppId
timestamp String 必填 当前时间戳
seller_nick String 必填 拼多多账号, 非店铺名称
sign String 必填 如何计算生成见示例代码
1.2 业务参数
参数接口 参数类型 是否必填 说明
cost_template_id LONG 必填 运费模板id

2. 请求示例代码(Java)

  @Test
    public void PddOneExpressCostTemplatet() throws Exception {

        String seller_nick = Config.PddSellerNick;
        //业务参数
        Map<String, String> data = new HashMap<String, String>();
        data.put("appid", Config.AppId);
        data.put("seller_nick", seller_nick);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("cost_template_id", "571070406990848");
        // 参数签名
        data.put("sign", Utils.Sign(data, Config.AppSecret));
        doHttpRequest(Config.PddOneExpressCostTemplatetUrl, data);

    }

3. 返回结果

返回结果如下 。

{
  "code": 0,
  "data": {
    "additional_service_type": null,
    "city_id": null,
    "cost_template_list": [
      {
        "add_cost": 2500,
        "add_standard": 1,
        "cost_province_list": [
          {
            "province": "甘肃省",
            "province_id": 5
          }
        ],
        "first_cost": 2800,
        "first_standard": 1,
        "have_free_min_amount": null,
        "have_free_min_count": null,
        "is_have_free_min_amount": false,
        "is_have_free_min_count": false
      },
      {
        "add_cost": 2500,
        "add_standard": 1,
        "cost_province_list": [
          {
            "province": "内蒙古自治区",
            "province_id": 19
          }
        ],
        "first_cost": 2800,
        "first_standard": 1,
        "have_free_min_amount": null,
        "have_free_min_count": null,
        "is_have_free_min_amount": false,
        "is_have_free_min_count": false
      },
      {
        "add_cost": 2500,
        "add_standard": 1,
        "cost_province_list": [
          {
            "province": "宁夏回族自治区",
            "province_id": 20
          }
        ],
        "first_cost": 2800,
        "first_standard": 1,
        "have_free_min_amount": null,
        "have_free_min_count": null,
        "is_have_free_min_amount": false,
        "is_have_free_min_count": false
      },
      {
        "add_cost": 2500,
        "add_standard": 1,
        "cost_province_list": [
          {
            "province": "青海省",
            "province_id": 21
          }
        ],
        "first_cost": 2800,
        "first_standard": 1,
        "have_free_min_amount": null,
        "have_free_min_count": null,
        "is_have_free_min_amount": false,
        "is_have_free_min_count": false
      },
      {
        "add_cost": 2500,
        "add_standard": 1,
        "cost_province_list": [
          {
            "province": "西藏自治区",
            "province_id": 28
          }
        ],
        "first_cost": 2800,
        "first_standard": 1,
        "have_free_min_amount": null,
        "have_free_min_count": null,
        "is_have_free_min_amount": false,
        "is_have_free_min_count": false
      },
      {
        "add_cost": 2500,
        "add_standard": 1,
        "cost_province_list": [
          {
            "province": "新疆维吾尔自治区",
            "province_id": 29
          }
        ],
        "first_cost": 2800,
        "first_standard": 1,
        "have_free_min_amount": null,
        "have_free_min_count": null,
        "is_have_free_min_amount": false,
        "is_have_free_min_count": false
      }
    ],
    "cost_type": 0,
    "district_id": null,
    "free_deliver_house": false,
    "free_deliver_house_area_list": [],
    "free_province_list": [
      {
        "province": "北京市",
        "province_id": 2
      },
      {
        "province": "安徽省",
        "province_id": 3
      },
      {
        "province": "福建省",
        "province_id": 4
      },
      {
        "province": "广东省",
        "province_id": 6
      },
      {
        "province": "广西壮族自治区",
        "province_id": 7
      },
      {
        "province": "贵州省",
        "province_id": 8
      },
      {
        "province": "海南省",
        "province_id": 9
      },
      {
        "province": "河北省",
        "province_id": 10
      },
      {
        "province": "河南省",
        "province_id": 11
      },
      {
        "province": "黑龙江省",
        "province_id": 12
      },
      {
        "province": "湖北省",
        "province_id": 13
      },
      {
        "province": "湖南省",
        "province_id": 14
      },
      {
        "province": "吉林省",
        "province_id": 15
      },
      {
        "province": "江苏省",
        "province_id": 16
      },
      {
        "province": "江西省",
        "province_id": 17
      },
      {
        "province": "辽宁省",
        "province_id": 18
      },
      {
        "province": "山东省",
        "province_id": 22
      },
      {
        "province": "山西省",
        "province_id": 23
      },
      {
        "province": "陕西省",
        "province_id": 24
      },
      {
        "province": "上海市",
        "province_id": 25
      },
      {
        "province": "四川省",
        "province_id": 26
      },
      {
        "province": "天津市",
        "province_id": 27
      },
      {
        "province": "云南省",
        "province_id": 30
      },
      {
        "province": "浙江省",
        "province_id": 31
      },
      {
        "province": "重庆市",
        "province_id": 32
      }
    ],
    "province_id": null,
    "request_id": "17481028036853970",
    "sf_free_type": 0,
    "template_id": 571070406990848,
    "template_name": "偏远按件收费默认模板"
  },
  "message": "ok"
}

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

参数接口 参数类型 例子 说明
one_express_cost_template_response OBJECT response
province_id INTEGER 发货地省份ID
city_id INTEGER 发货地城市ID
district_id INTEGER 发货地区ID
additional_service_type INTEGER 送货入户并安装服务,0-不支持、1-支持送货入户、2-支持送货入户并安装
sf_free_type INTEGER 是否顺丰包邮
cost_template_list OBJECT[] 不包邮区域/需要买家付邮费区域
cost_province_list OBJECT[] 不包邮的区域
province STRING 省份
province_id INTEGER 不包邮区域的ID
first_standard LONG 首件
first_cost LONG 首件或首重价格,单位为分
add_standard LONG 续重或续件
add_cost LONG 续件或续重价格,单位为分
is_have_free_min_count BOOLEAN 对不包邮地区,true-若要包邮须满足件数包邮,false-不开启满足件数包邮
have_free_min_count LONG 对不包邮地区,满足指定件数包邮,该值为商家设置的指定件数,若为-1则商家没有开启满足件数包邮
is_have_free_min_amount BOOLEAN 对不包邮地区,true-若要包邮须满足指定价格则可以包邮,false-不开启满足指定价格包邮
have_free_min_amount LONG 对不包邮地区,满足指定价格包邮,该值为商家设置的指定订单金额,若为-1则商家没有开启满足指定价格包邮,注意,单位为分
template_id LONG 运费模板id
template_name STRING 运费模板名称
cost_type INTEGER 计费方式,0-按件计费,1-按重量计费
free_deliver_house BOOLEAN 是否送货上门,对于包邮地区:true-商品包邮且送货上门,false-商品包邮但不送货上门
free_deliver_house_area_list OBJECT[] 送货上门地区列表
town_id INTEGER 包邮送货上门的城区ID
city_id INTEGER 包邮送货上门的城市ID
province_id INTEGER 包邮送货上门的省份ID
province STRING 包邮送货上门的省份
city STRING 包邮送货上门的城市
town STRING 包邮送货上门的城区
free_province_list OBJECT[] 包邮省份对象
province_id LONG 省份ID
province STRING 省份
文档更新时间: 2025-05-25 00:09   作者:admin