淘宝开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
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());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaXsdStoreDeliveryPurchaseRequest req = new AlibabaXsdStoreDeliveryPurchaseRequest();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryPurchaseRequestDomain obj1 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryPurchaseRequestDomain();
obj1.DeliveryType = 1L;
obj1.ShopId = "30114109";
AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryConfigDomain obj2 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdStoreDeliveryConfigDomain();
obj2.MerchantSupportDisplayDay = 7L;
obj2.DailyPackCostTime = 15L;
obj2.MaxWeight = 10L;
AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightConfigDomain obj3 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightConfigDomain();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightDistanceHitRuleDomain obj4 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightDistanceHitRuleDomain();
obj4.Effective = true;
List<AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfigDomain> list6 = new List<AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfigDomain>();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfigDomain obj7 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdFreightRangeConfigDomain();
list6.Add(obj7);
obj7.StartRange = "5.0";
obj7.EndRange = "6.0";
obj7.ConfigValue = "1.5";
obj4.RangeList= list6;
obj4.BaseDistance = "5.0";
obj3.FreightDistanceHitRule= obj4;
AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodFreightHitRuleDomain obj8 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodFreightHitRuleDomain();
obj8.Effective = true;
List<AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfigDomain> list10 = new List<AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfigDomain>();
AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfigDomain obj11 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdSpecialPeriodConfigDomain();
list10.Add(obj11);
obj11.StartTime = "09:00";
obj11.EndTime = "10:00";
obj11.ConfigValue = "1.5";
obj8.RangeList= list10;
obj3.SpecialPeriodFreightHitRule= obj8;
obj3.DeliveryFreight = "4.5";
AlibabaXsdStoreDeliveryPurchaseRequest.XsdOverweightFreightRuleDomain obj12 = new AlibabaXsdStoreDeliveryPurchaseRequest.XsdOverweightFreightRuleDomain();
obj12.Effective = true;
obj12.OverweightFreight = "1.5";
obj12.BaseWeight = "5.0";
obj3.OverweightFreightRule= obj12;
obj2.XsdFreightConfig= obj3;
List<AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTimeDomain> list14 = new List<AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTimeDomain>();
AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTimeDomain obj15 = new AlibabaXsdStoreDeliveryPurchaseRequest.DistinctRangeCostTimeDomain();
list14.Add(obj15);
obj15.CostTimePer1K = 2L;
obj15.EndDistanceRange = 3L;
obj15.StartDistanceRange = 4L;
obj2.DistinctRangeCostTimes= list14;
obj1.Config= obj2;
obj1.DeliveryRadius = 5L;
req.XsdStoreDeliveryPurchaseRequest_ = obj1;
AlibabaXsdStoreDeliveryPurchaseResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaXsdStoreDeliveryPurchaseRequest;
$xsd_store_delivery_purchase_request = new XsdStoreDeliveryPurchaseRequest;
$xsd_store_delivery_purchase_request->delivery_type="1";
$xsd_store_delivery_purchase_request->shop_id="30114109";
$config = new XsdStoreDeliveryConfig;
$config->merchant_support_display_day="7";
$config->daily_pack_cost_time="15";
$config->max_weight="10";
$xsd_freight_config = new XsdFreightConfig;
$freight_distance_hit_rule = new XsdFreightDistanceHitRule;
$freight_distance_hit_rule->effective="true";
$range_list = new XsdFreightRangeConfig;
$range_list->start_range="5.0";
$range_list->end_range="6.0";
$range_list->config_value="1.5";
$freight_distance_hit_rule->range_list = $range_list;
$freight_distance_hit_rule->base_distance="5.0";
$xsd_freight_config->freight_distance_hit_rule = $freight_distance_hit_rule;
$special_period_freight_hit_rule = new XsdSpecialPeriodFreightHitRule;
$special_period_freight_hit_rule->effective="true";
$range_list = new XsdSpecialPeriodConfig;
$range_list->start_time="09:00";
$range_list->end_time="10:00";
$range_list->config_value="1.5";
$special_period_freight_hit_rule->range_list = $range_list;
$xsd_freight_config->special_period_freight_hit_rule = $special_period_freight_hit_rule;
$xsd_freight_config->delivery_freight="4.5";
$overweight_freight_rule = new XsdOverweightFreightRule;
$overweight_freight_rule->effective="true";
$overweight_freight_rule->overweight_freight="1.5";
$overweight_freight_rule->base_weight="5.0";
$xsd_freight_config->overweight_freight_rule = $overweight_freight_rule;
$config->xsd_freight_config = $xsd_freight_config;
$distinct_range_cost_times = new DistinctRangeCostTime;
$distinct_range_cost_times->cost_time_per1_k="2";
$distinct_range_cost_times->end_distance_range="3";
$distinct_range_cost_times->start_distance_range="4";
$config->distinct_range_cost_times = $distinct_range_cost_times;
$xsd_store_delivery_purchase_request->config = $config;
$xsd_store_delivery_purchase_request->delivery_radius="5";
$req->setXsdStoreDeliveryPurchaseRequest(json_encode($xsd_store_delivery_purchase_request));
$resp = $c->execute($req, $sessionKey);

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测试工具错误码查询工具 SDK下载

淘宝小时达履约

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

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ