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

taobao.delivery.template.add (新增运费模板)

增加运费模板的外部接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
name String 必须 按件运费模板
  • 最大长度:50
  • 运费模板的名称,长度不能超过50个字节
    assumer Number 必须 1 可选值:0、1 ,说明如下
    0:表示买家承担服务费;
    1:表示卖家承担服务费
    valuation Number 必须 0 可选值:0、1、3,说明如下。
    0:表示按宝贝件数计算运费
    1:表示按宝贝重量计算运费
    3:表示按宝贝体积计算运费
    consign_area_id Number 可选 11245 卖家发货地址区域ID

    可以不填,如果没有填写取卖家默认发货地址的区域ID,如果需要输入必须用taobao.areas.get接口获取.或者参考:http://www.stats.gov.cn/tjbz/xzqhdm/t20080215_402462675.htm

    注意:填入该值时必须取您的发货地址最小区域级别ID,比如您的发货地址是:某省XX市xx区(县)时需要填入区(县)的ID,当然有些地方没有区或县可以直接填市级别的ID
    template_types String 必须 express;post;ems;cod 运费方式:平邮 (post),快递公司(express),EMS (ems),货到付款(cod),物流宝保障速递(wlb),家装物流(furniture)结构:value1;value2;value3;value4 如: post;express;ems;cod
    注意:在添加多个运费方式时,字符串中使用 ";" 分号区分 。template_dests(指定地区) template_start_standards(首费标准)、template_start_fees(首费)、template_add_standards(增费标准)、template_add_fees(增费)必须与template_types的分号数量相同.
    注意:
    1、post,ems,express三种运费方式必须填写一个
    2、只有订购了货到付款用户可以填cod;只有家装物流用户可以填写furniture 只有订购了保障速递的用户可以填写bzsd,只有物流宝用户可以填写wlb
    3、如果是货到付款用户当没有填写cod运送方式时,运费模板会默认继承express的费用为cod的费用
    4、如果是保障速递户当没有填写bzsd运送方式时,运费模板会默认继承express的费用为bzsd的费用
    5、由于3和4的原因所以当是货到付款用户或保障速递用户时如果没填写对应的运送方式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范围内的整数
    当valuation(记价方式)为1时输入0.1-9999.9范围内的小数只能包含以为小数(单位为千克)
    当valuation(记价方式)为3时输入0.1-999.9范围内的数值,数值只能包含一位小数(单位为 立方米)
    输入的格式分号个数和template_types数量一致,逗号个数必须与template_dests以分号隔开之后一一对应的数量一致
    template_start_fees String 必须 10.10,10.10;10,11;8,9;12,15 首费:输入0.00-999.99(最多包含两位小数)
    输入的格式分号个数和template_types数量一致,逗号个数必须与template_dests以分号隔开之后一一对应的数量一致
    template_add_standards String 必须 3,3;1,3;1,1;3,2 增费标准:当valuation(记价方式)为0时输入1-9999范围内的整数
    当valuation(记价方式)为1时输入0.1-9999.9范围内的小数只能包含以为小数(单位为千克)
    当valuation(记价方式)为3时输入0.1-999.9范围内的数值,数值只能包含一位小数(单位为 立方米)

    输入的格式分号个数和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以分号隔开之后一一对应的数量一致

    响应参数

    名称 类型 示例值 描述
    delivery_template DeliveryTemplate 模板对象
    • └ template_id
    • Number
    • 100203
    • 模块ID
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 模板创建时间

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    DeliveryTemplateAddRequest req = new DeliveryTemplateAddRequest();
    req.setName("按件运费模板");
    req.setAssumer(1L);
    req.setValuation(0L);
    req.setConsignAreaId(11245L);
    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");
    DeliveryTemplateAddResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <delivery_template_add_response>
        <delivery_template>
            <template_id>100203</template_id>
            <created>2000-01-01 00:00:00</created>
        </delivery_template>
    </delivery_template_add_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-permission:template-name-repeat 该错误提示,当前使用运费模板名称已经存在!请使用其它名称。 换一个运费模版名称添加
    61 出现该错误,代表同一区域,同一服务类型,设置了多个运费。 请检查传入的数据,(例如:全国 存在多个快递的数据)
    isv.invalid-parameter:query-seller-area-id-error 运费模板发货地id错误 请检查设置模板的发货地的区域id,需要是正确的行政区域id
    isv.invalid-permission:no-template-name-too-large 运费模板名称太长,超过25 请合理的设置运费模板的名称,长度做好控制
    isv.mismatch-parameters:templatetype-feeparam-size-not-mismatch 设置费用项个数和服务类型个数不匹配 请检查费用项和服务类型,补齐缺失项
    isv.invalid-parameter:templateModule-type-error 模板服务类型非法 请检查服务类型template_types入参
    isv.invalid-parameter:get_default_area_id_error 没有设置默认的发货地址 设置默认的发货地址
    isv.invalid-parameter:express-start-feed-error 快递首费有误 请检查费用的范围
    isv.invalid-parameter:ems-start-feed-error ems的首费错误 检查ems费用的范围
    67 卖家强制包邮费用不为0 设置的模板是卖家包邮,但是费用项不为0
    isv.invalid-parameter:expressnot-contain-def-fee-error 没有设置express默认运费 没有设置express默认运费
    isv.invalid-parameter:express-add-fee-greater-than-start-fee-error express中设置了增费大于首费! express中设置了增费大于首费!

    API工具

    如何获得此API

    FAQ

    返回
    顶部