接口描述:

  • 添加一个配送区域。

请求 URL:

  • http|https://host/api/v1/delivery_area/method/add.delivery.area.item/

请求方式:

  • GET
  • POST

是否授权:

  • 需要授权

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
delivery_id integer gt:0 9 配送方式编号
name string max:50 江浙沪 配送区域名称
region integer gt[]:0 [10,11,12] 所辖区域(region_id 区域编号)
first_weight_price number egt:0 8.00 首重运费
second_weight_price number egt:0 4.50 续重运费
first_item_price number egt:0 0 首件运费
second_item_price number egt:0 0 续件运费
first_volume_price number egt:0 0 首体积运费
second_volume_price number egt:0 0 续体积运费

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
name string 江浙沪 配送区域名称
region array [] 所辖区域数组
first_weight_price number 8 首重运费
second_weight_price number 4.5 续重运费
first_item_price number 0 首件运费
second_item_price number 0 续件运费
first_volume_price number 0 首体积运费
second_volume_price number 0 续体积运费
delivery_area_id integer 16 配送区域编号
region 类型 是否返回 示例值 描述
name string 上海 区域名称
region_id integer 10 区域编号

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "name": "江浙沪",
  6. "region": [
  7. {
  8. "name": "上海",
  9. "region_id": 10
  10. },
  11. {
  12. "name": "江苏省",
  13. "region_id": 11
  14. },
  15. {
  16. "name": "浙江省",
  17. "region_id": 12
  18. }
  19. ],
  20. "first_weight_price": 8,
  21. "second_weight_price": 4.5,
  22. "first_item_price": 0,
  23. "second_item_price": 0,
  24. "first_volume_price": 0,
  25. "second_volume_price": 0,
  26. "delivery_area_id": 16
  27. }
  28. }

备注:

  1. region参数某个键值如果带有下辖区域,那么该区域的下辖区将继承其所有配置,如果某个下辖区需要单独区分费用可单独添加一个配送区域

  2. 在查询运费时,如果查询的区域不在配送区域中,那么该区域将使用配送方式的配置来计算运费。

文档更新时间: 2018-05-21 21:00