文档中心 > API类目 > 淘宝物流API

taobao.delivery.template.update (修改运费模板)

修改运费模板

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
name String 可选 修改按件运费模板 模板名称,长度不能大于50个字节
template_id Number 必须 100201 需要修改的模板对应的模板ID
assumer Number 可选 1 必填,可选值:0,1
说明
0:表示买家承担服务费;
1:表示卖家承担服务费
template_types String 必须 express;post;ems;cod 运费方式:平邮 (post),快递公司(express),EMS (ems),货到付款(cod)结构:value1;value2;value3;value4 如: post;express;ems;cod
注意:在添加多个运费方式时,字符串中使用 ";" 分号区分。template_dests(指定地区) template_start_standards(首费标准)、template_start_fees(首费)、template_add_standards(增费标准)、template_add_fees(增费)必须与template_types的分号数量相同.
普通用户:post,ems,express三种运费方式必须填写一个,不能填写cod。 货到付款用户:如果填写了cod运费方式,则post,ems,express三种运费方式也必须填写一个,如果没有填写cod则填写的运费方式中必须存在express
template_dests String 必须 1,110000;1,110000|310000;1|320000,310000;1,320000|440000 邮费子项涉及的地区.结构: value1;value2;value3,value4
如:1,110000;1,110000;1,310000;1,320000,330000。 aredId解释(1=全国,110000=北京,310000=上海,320000=江苏,330000=浙江) 如果template_types设置为post;ems;exmpress;cod则表示为平邮(post)指定默认地区(全国)和北京地区的运费;其他的类似以分号区分一一对应
可以用taobao.areas.get接口获取.或者参考:http://www.stats.gov.cn/tjbz/xzqhdm/t20080215_402462675.htm
每个运费方式设置的设涉及地区中必须包含全国地区(areaId=1)表示默认运费,可以只设置默认运费
注意:为多个地区指定指定不同(首费标准、首费、增费标准、增费一项不一样就算不同)的运费以逗号","区分, template_start_standards(首费标准)、template_start_fees(首费)、 template_add_standards(增费标准)、 template_add_fees(增费)必须与template_types分号数量相同。如果为需要为多个地区指定相同运费则地区之间用“|”隔开即可。
template_start_standards String 必须 1,1;1,1;1,2;1,2 首费标准:当valuation(记价方式)为0时输入1-9999范围内的整数
首费标准目前只能为1
输入的格式分号个数和template_types数量一致,逗号个数必须与template_dests以分号隔开之后一一对应的数量一致
template_start_fees String 必须 10.10,10.10;10,11;8,9;12,15 首费:输入0.01-999.99(最多包含两位小数)
首费不能为0
输入的格式分号个数和template_types数量一致,逗号个数必须与template_dests以分号隔开之后一一对应的数量一致
template_add_standards String 必须 3,3;1,3;1,1;3,2 增费标准:当valuation(记价方式)为0时输入1-9999范围内的整数
增费标准目前只能为1
输入的格式分号个数和template_types数量一致,逗号个数必须与template_dests以分号隔开之后一一对应的数量一致
template_add_fees String 必须 10,10;4,4;3,1;1,4 增费:输入0.00-999.99(最多包含两位小数)
增费可以为0
输入的格式分号个数和template_types数量一致,逗号个数必须与template_dests以分号隔开之后一一对应的数量一致

响应参数

名称 类型 示例值 描述
complete Boolean true 表示修改是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
DeliveryTemplateUpdateRequest req = new DeliveryTemplateUpdateRequest();
req.setName("修改按件运费模板");
req.setTemplateId(100201L);
req.setAssumer(1L);
req.setTemplateTypes("express;post;ems;cod");
req.setTemplateDests("1,110000;1,110000|310000;1|320000,310000;1,320000|440000");
req.setTemplateStartStandards("1,1;1,1;1,2;1,2");
req.setTemplateStartFees("10.10,10.10;10,11;8,9;12,15");
req.setTemplateAddStandards("3,3;1,3;1,1;3,2");
req.setTemplateAddFees("10,10;4,4;3,1;1,4");
DeliveryTemplateUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<delivery_template_update_response>
    <complete>true</complete>
</delivery_template_update_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部