获取用户下所有模板
根据用户ID获取用户下所有模板
1.请求参数:
请求URL:
POST https://kf.fw199.com/gateway/taobao/logistices/delivery/template/get
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
appid | String | true | uwkahf@jfs92 | 合作伙伴AppId |
timestamp | String | true | 1633618722 | 当前时间戳 |
tb_seller_nick | String | true | kingdo | 淘宝卖家店铺登录账号,非店铺名称 |
sys_id | String | false | 100 | 支持100:订单应用, 102:商品应用 |
sign | String | true | 999de41d862efaa6f1084ead3b3ba480 | 如何计算生成见示例代码 |
fields | String | true | template_id,template_name,created | 需返回的字段列表 可选值:示例中的值;各字段之间用”,”隔开 |
返回字段fields说明
template_id:查询模板ID
template_name:查询模板名称
assumer:查询服务承担放
valuation:查询计价规则
supports:查询增值服务列表
created:查询模板创建时间
modified:查询修改时间
consign_area_id:运费模板上设置的卖家发货地址最小级别ID
address:卖家地址信息
query_cod:查询货到付款运费信息
query_post:查询平邮运费信息
query_express:查询快递公司运费信息
query_ems:查询EMS运费信息
query_bzsd:查询普通保障速递运费信息
query_wlb:查询物流宝保障速递运费信息
query_furniture:查询家装物流运费信息
不能有空格
2. 请求示例代码(Java)
@Test
public void TaoBaoLogisticesDeliveryTplList() throws Exception {
String tb_seller_nick = Config.TBSellerNick ;
//业务参数
Map<String, String> data = new HashMap<String, String>();
data.put("appid", Config.AppId);
Long timestamp = System.currentTimeMillis() / 1000;
data.put("timestamp", timestamp.toString());
data.put("tb_seller_nick", tb_seller_nick);
data.put("fields", "template_id,template_name,created,modified,supports,assumer,valuation,query_express,query_ems,query_cod,query_post");
data.put("sign", Utils.Sign(data,Config.AppSecret));
// 调用服务API
doHttpRequest(Config.TaoBaoLogisticesDeliveryTplListUrl ,data);
}
3. 返回结果
返回结果如下
{
"code":0,
"message":"ok",
"data":{
"delivery_templates":{
"delivery_template":[
{
"assumer":0,
"created":"2021-10-07 21:26:50",
"fee_list":{
"top_fee":[
{
"add_fee":"5.00",
"add_standard":"1",
"destination":"1",
"service_type":"ems",
"start_fee":"5.00",
"start_standard":"1"
}
]
},
"modified":"2021-10-07 21:26:50",
"name":"softest",
"template_id":52897133690,
"valuation":0
}, {
"assumer":2,
"created":"2014-04-25 10:42:19",
"fee_list":{
"top_fee":[
{
"add_fee":"0.00",
"add_standard":"1",
"destination":"1",
"service_type":"express",
"start_fee":"0.00",
"start_standard":"1"
}
]
},
"modified":"2014-04-25 10:42:19",
"name":"免邮",
"template_id":1190535780,
"valuation":0
}
]
},
"request_id":"8cxfpnj0nsa1",
"total_results":2
},
"trace_id":""
}
说明: code为0表示成功,非0为失败,message会包含失败原因。
4. 返回参数说明
参数名 | 类型 | 必须 | 示例值 | 说明 |
---|---|---|---|---|
delivery_templates | DeliveryTemplate [] | 运费模板列表 | ||
template_id | Number | 100203 | 模块ID | |
name | String | 邮费测试模板 | 模板名称,长度不能超过25个字节 | |
assumer | Number | 1 | 可选值:0,1,2,3 ,说明如下 1)买家承担运费的模版 0:买家承担服务费 1: 卖家承担服务费 2)卖家承担运费的模版 2:卖家承担运费的模版(集市),卖家承担服务费 3:卖家承担运费的模版(天猫),卖家承担服务费 | |
valuation | Number | 0 | 可选值:0 说明: 0:表示按宝贝件数计算运费 1:表示按宝贝重量计算运费 3:表示按宝贝体积计算运费 | |
fee_list | TopFee[] | 运费模板中运费详细信息对象,包含默认运费和指定地区运费 | ||
service_type | String | post | 可选值:post:平邮; cod:货到付款; ems:EMS; express:快递公司 | |
destination | String | 1,3100000 | 邮费子项涉及的地区,多个地区用逗号连接数量串;可以用taobao.areas.get接口获取.或者参考:http://www.stats.gov.cn/tjbz/xzqhdm/t20080215_402462675.htm 例 (110000,310000,320000,330000).就代表邮费子项涉 及(北京,上海,江苏,浙江)四个地区.填写时要注意对照地区代码值,如果填入错误地区代码,将会出现错误信息. | |
start_standard | String | 1 | 首费标准:当valuation(记价方式)为0时输入1-9999范围内的整数 | |
start_fee | String | 10.22 | 首费:输入0.01-999.99(最多包含两位小数) 不能为空也不能为0 | |
add_standard | String | 2 | 增费标准:当valuation(记价方式)为0时输入1-9999范围内的整数 | |
add_fee | String | 2.3 | 增费:输入0.00-999.99(最多包含两位小数) 不能为空不输入运费时必须输入0 | |
supports | String | cod,mpos | 物流服务模板支持增值服务列表,多个用分号隔开。cod:货到付款 mops:刷卡付款 | |
created | Date | 2000-01-01 00:00:00 | 模板创建时间 | |
modified | Date | 2000-01-01 00:00:00 | 模板修改时间 | |
address | String | 浙江省杭州市西湖去文三路XX号 | 运费模板上设置的发货地址 | |
consign_area_id | Number | 1112 | 该模板上设置的卖家发货地址区域ID,如:address为浙江省杭州市西湖去文三路XX号那么这个consign_area_id的值就是西湖区的ID | |
total_results | Number | 10 | 获得到符合条件的结果总数 |
文档更新时间: 2023-05-25 17:27 作者:admin