文档中心 > API类目 > 淘宝小时达履约

alibaba.xsd.store.delivery.purchase (运力采购)

运力采购

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
xsd_store_delivery_purchase_request XsdStoreDeliveryPurchaseRequest 必须 入参
  • └ delivery_type
  • Number
  • 必须
  • 1
  • 配送方式 0:平台配送 1:商家自配送
  • └ shop_id
  • String
  • 必须
  • 30114109
  • 渠道店ID
  • config
  • XsdStoreDeliveryConfig
  • 可选
  • 运力配置
  • └ merchant_support_display_day
  • Number
  • 可选
  • 7
  • 支持预约天数
  • └ daily_pack_cost_time
  • Number
  • 可选
  • 15
  • 备货时长,单位:分钟
  • └ max_weight
  • Number
  • 可选
  • 10
  • 最大配送重量,单位:kg
  • xsd_freight_config
  • XsdFreightConfig
  • 可选
  • 运费配置
  • freight_distance_hit_rule
  • XsdFreightDistanceHitRule
  • 可选
  • 距离加价规则
  • └ effective
  • Boolean
  • 可选
  • true
  • 是否启用
  • range_list
  • XsdFreightRangeConfig []
  • 可选
  • []
  • 阶梯配置,左开右闭
  • └ start_range
  • String
  • 可选
  • 5.0
  • 开始范围,单位km
  • └ end_range
  • String
  • 可选
  • 6.0
  • 结束范围,单位km
  • └ config_value
  • String
  • 可选
  • 1.5
  • 配置值, 单位元, 一位小数
  • └ base_distance
  • String
  • 可选
  • 5.0
  • 基础距离, 单位km
  • special_period_freight_hit_rule
  • XsdSpecialPeriodFreightHitRule
  • 可选
  • 时段加价规则
  • └ effective
  • Boolean
  • 可选
  • true
  • 是否启用
  • range_list
  • XsdSpecialPeriodConfig []
  • 可选
  • []
  • 加价时段规则,左开右闭
  • └ start_time
  • String
  • 可选
  • 09:00
  • 开始时间, 格式: HH:mm
  • └ end_time
  • String
  • 可选
  • 10:00
  • 结束时间, 格式: HH:mm
  • └ config_value
  • String
  • 可选
  • 1.5
  • 配置值, 单位元, 一位小数
  • └ delivery_freight
  • String
  • 可选
  • 4.5
  • 基础运费,单位:元
  • overweight_freight_rule
  • XsdOverweightFreightRule
  • 可选
  • 重量加价规则
  • └ effective
  • Boolean
  • 可选
  • true
  • 是否启用
  • └ overweight_freight
  • String
  • 可选
  • 1.5
  • 超重运费 单位元
  • └ base_weight
  • String
  • 可选
  • 5.0
  • 基础重量 单位kg
  • distinct_range_cost_times
  • DistinctRangeCostTime []
  • 可选
  • []
  • 配送时长配置,左开右闭
  • └ cost_time_per1_k
  • Number
  • 可选
  • 2
  • 区间内每公里耗时,单位分钟
  • └ end_distance_range
  • Number
  • 可选
  • 3
  • 配送区间结束距离,闭区间,单位km
  • └ start_distance_range
  • Number
  • 可选
  • 4
  • 配送区间开始距离,开区间,单位km
  • └ delivery_radius
  • Number
  • 可选
  • 5
  • 配送范围半径 单位:千米

响应参数

名称 类型 示例值 描述
result ResultDTO 返回对象
  • └ code
  • String
  • A0001
  • 错误码
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ message
  • String
  • 系统异常
  • 错误说明

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaXsdStoreDeliveryPurchaseRequest req = new AlibabaXsdStoreDeliveryPurchaseRequest();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryPurchaseRequest obj1 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryPurchaseRequest();
obj1.setDeliveryType(1L);
obj1.setShopId("30114109");
AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryConfig obj2 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryConfig();
obj2.setMerchantSupportDisplayDay(7L);
obj2.setDailyPackCostTime(15L);
obj2.setMaxWeight(10L);
AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightConfig obj3 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightConfig();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightDistanceHitRule obj4 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightDistanceHitRule();
obj4.setEffective(true);
List<AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfig> list6 = new ArrayList<AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfig>();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfig obj7 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfig();
list6.add(obj7);
obj7.setStartRange("5.0");
obj7.setEndRange("6.0");
obj7.setConfigValue("1.5");
obj4.setRangeList(list6);
obj4.setBaseDistance("5.0");
obj3.setFreightDistanceHitRule(obj4);
AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodFreightHitRule obj8 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodFreightHitRule();
obj8.setEffective(true);
List<AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfig> list10 = new ArrayList<AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfig>();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfig obj11 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfig();
list10.add(obj11);
obj11.setStartTime("09:00");
obj11.setEndTime("10:00");
obj11.setConfigValue("1.5");
obj8.setRangeList(list10);
obj3.setSpecialPeriodFreightHitRule(obj8);
obj3.setDeliveryFreight("4.5");
AlibabaXsdStoreDeliveryPurchaseRequest.XsdOverweightFreightRule obj12 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdOverweightFreightRule();
obj12.setEffective(true);
obj12.setOverweightFreight("1.5");
obj12.setBaseWeight("5.0");
obj3.setOverweightFreightRule(obj12);
obj2.setXsdFreightConfig(obj3);
List<AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTime> list14 = new ArrayList<AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTime>();
AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTime obj15 = new AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTime();
list14.add(obj15);
obj15.setCostTimePer1K(2L);
obj15.setEndDistanceRange(3L);
obj15.setStartDistanceRange(4L);
obj2.setDistinctRangeCostTimes(list14);
obj1.setConfig(obj2);
obj1.setDeliveryRadius(5L);
req.setXsdStoreDeliveryPurchaseRequest(obj1);
AlibabaXsdStoreDeliveryPurchaseResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_xsd_store_delivery_purchase_response>
    <result>
        <code>A0001</code>
        <success>true</success>
        <message>系统异常</message>
    </result>
</alibaba_xsd_store_delivery_purchase_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

返回
顶部