增加运费模板的外部接口
名称 | 类型 | 是否必须 | 示例值 | 更多限制 | 描述 |
---|---|---|---|---|---|
name | String | 必须 | 按件运费模板 |
|
运费模板的名称,长度不能超过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 | 模板对象 | |
|
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());
<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>
<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中设置了增费大于首费! |