按id获取商品运费模版接口
根据id获取拼多多商家的物流运费模板信息
支持应用:OMS
一、请求参数
请求URL:
POST https://kf.fw199.com/gateway/pdd/one/express/cost/template
一(一)、基础参数
| 参数名 | 类型 | 必须 | 说明 |
|---|---|---|---|
| appid | String | 必填 | 合作伙伴AppId |
| timestamp | String | 必填 | 当前时间戳 |
| seller_nick | String | 必填 | 拼多多账号, 非店铺名称 |
| sign | String | 必填 | 如何计算生成见示例代码 |
一(二)、业务参数
| 参数接口 | 参数类型 | 是否必填 | 说明 |
|---|---|---|---|
| cost_template_id | LONG | 必填 | 运费模板id |
二、请求示例代码
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);
}三、返回结果
返回结果如下 。
{ "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 | 省份 |