淘宝开放平台

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
intention_order	IntentionOrderSaveRequest	可选			意向单结构
└ buyer_fax String 可选 001-123456789 买家传真号码 └ buyer_telephone String 可选 001-123456789 买家电话号码 └ buyer_email String 可选 xxx@alibaba.com 买家电邮地址 └ remark String 可选 xxx,xxx,xxx 订单备注 └ trade_term String 可选 FOB 贸易条款 └ buyer_zip_code String 可选 201101 买家邮编 └ order_amount String 可选 1000 订单总价 └ buyer_city String 可选 NewYork 买家城市 intention_order_logistics IntentionOrderLogistics 可选意向单物流结构 └ shipment_fee String 可选 100 物流费 └ country String 可选 The United States 收货国家 └ city String 可选 NewYork 收货城市 └ city_code String 可选 NY 收货城市代码 └ contact_person String 可选 Jack Wu 收货人 └ departure_port String 可选 ShangHai 发货港 └ delivery_date_type String 可选 relative * 发货日期类型：绝对时间/预付款收齐/尾款收齐 * 枚举值：absolute/relative/relative_balance; └ address_id String 可选 12345678 物流地址ID（根据国际站的物流地址ID保持一致） └ delivery_date_relative_duration Number 可选 33 * 发货时间，适用于预付款收齐后多少天发货、尾款收齐后多少天发货两种发货类型 * 单位：天 └ shipment_method String 可选 express/air/sea/land:快递/空运/海运/陆运/ 运输方式 └ province String 可选 California 收货省/州 └ departure_city_code String 可选 SH 发货城市代码 └ country_code String 可选 US 收货国家代码 └ delivery_date_absolute_time String 可选 2019-10-10 10:00:00 绝对发货时间，格式传 "yyyy-MM-dd HH:mm:ss" fax Phone 可选收货人传真结构 └ area String 可选 8 收货人传真区域号码 └ country String 可选 001 收货人传真国家号码 └ number String 可选 123456789 收货人传真号码 └ departure_port_code String 可选 SH 发货港口代码 └ zip String 可选 201101 收货人邮编 └ address String 可选 #20A, 2345 Belmont Avenue, Durham, NC，America 收货详细地址 └ departure_city String 可选 Shanghai 发货城市 └ province_code String 可选 CA 收货人省/州代码 mobile Phone 可选收货人移动电话结构 └ area String 可选 8 收货人移动电话区域号码 └ country String 可选 001 收货人移动电话国家号码 └ number String 可选 123456789 收货人移动电话号码 telephone Phone 可选收货人电话结构 └ area String 可选 8 收货人电话区域号码 └ country String 可选 001 收货人电话国家号码 └ number String 可选 123456789 收货人电话号码 └ port_code String 可选 NY 收货人港口代码 └ carrier String 可选 United Parcel Service of America 承运商 └ port String 可选 NewYork 收货人港口名称 └ carrier_code String 可选 UPS 承运商代码 └ alternate_address String 可选 #20A, 2345 Belmont Avenue, Durham, NC，America 收货人备份详细地址 └ properties String 可选 JSON字符串格式物流扩展属性 └ currency String 可选 USD 交易货币类型 └ source_channel_refer_id String 可选 12345678 渠道订单ID └ buyer_province String 可选 California 买家省/州 └ buyer_contact_address String 可选 #20A, 2345 Belmont Avenue, Durham, NC，America 买家联系地址 └ buyer_country_port String 可选 NewYork 买家收货港口名称 intention_order_products IntentionOrderProduct [] 可选意向单商品结构 └ product_desc String 可选 xxx,xxx 商品描述 └ product_spec String 可选 xxx,xxx 商品规格描述 └ sku_id String 可选 1234 SKU ID,跟国际站SKU ID保持一致 └ quantity String 可选 100 商品数量 └ original_unit_price String 可选 12 商品原始单价 └ unit_price String 可选 10 商品单价 └ unit String 可选 Pieces 商品单位 └ image_url String 可选 http://cdn.xxx.com/xxx/xxx 商品图片地址URL，先调用API（alibaba.order.picture.upload）上传图片 └ type String 可选 Sample/ Customized/Standard 商品类型 └ name String 可选 mp3 player with bluetooth 商品名称 └ product_id Number 可选 12345678 商品ID，跟国际站商品ID保持一致 └ properties String 可选 JSON结构字符串商品扩展属性 └ buyer_country_port_code String 可选 NY 买家收货港口代码 └ intention_order_id String 可选 12345678 意向单ID，如果是创建意向单不需要填写 └ buyer_name String 可选 Jack Wu 买家名称 └ buyer_company_name String 可选 Alibaba 买家公司名称 └ buyer_country_code String 可选 US 买家国家代码 └ buyer_country String 可选 The United States 买家国家 └ advanced_amount String 可选 300 预付款金额 └ buyer_province_code String 可选 CA 买家省/州代码 └ buyer_city_code String 可选 NY 买家城市代码 └ buyer_mobile String 可选 001-123456789 买家移动电话 └ properties String 可选 JSON结构字符串订单扩展属性 └ status String 可选 DRAFT 订单状态 DRAFT/APPROACHED/BUYER_CONFIRMED/CONFIRMED/CANCELLED：起草意向单/已和买家联系/买家已确认/双方确定/已取消

名称	类型	示例值	描述
value	IntentionOrderResponse	{}	返回值接口
└ intention_id String 1234567890 意向单ID

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIntentionOrderSaveRequest req = new AlibabaIntentionOrderSaveRequest();
AlibabaIntentionOrderSaveRequest.IntentionOrderSaveRequest obj1 = new AlibabaIntentionOrderSaveRequest.IntentionOrderSaveRequest();
obj1.setBuyerFax("001-123456789");
obj1.setBuyerTelephone("001-123456789");
obj1.setBuyerEmail("xxx@alibaba.com");
obj1.setRemark("xxx,xxx,xxx");
obj1.setTradeTerm("FOB");
obj1.setBuyerZipCode("201101");
obj1.setOrderAmount("1000");
obj1.setBuyerCity("NewYork");
AlibabaIntentionOrderSaveRequest.IntentionOrderLogistics obj2 = new AlibabaIntentionOrderSaveRequest.IntentionOrderLogistics();
obj2.setShipmentFee("100");
obj2.setCountry("The United States");
obj2.setCity("NewYork");
obj2.setCityCode("NY");
obj2.setContactPerson("Jack Wu");
obj2.setDeparturePort("ShangHai");
obj2.setDeliveryDateType("relative");
obj2.setAddressId("12345678");
obj2.setDeliveryDateRelativeDuration(33L);
obj2.setShipmentMethod("express/air/sea/land:快递/空运/海运/陆运/");
obj2.setProvince("California");
obj2.setDepartureCityCode("SH");
obj2.setCountryCode("US");
obj2.setDeliveryDateAbsoluteTime("2019-10-10 10:00:00");
AlibabaIntentionOrderSaveRequest.Phone obj3 = new AlibabaIntentionOrderSaveRequest.Phone();
obj3.setArea("8");
obj3.setCountry("001");
obj3.setNumber("123456789");
obj2.setFax(obj3);
obj2.setDeparturePortCode("SH");
obj2.setZip("201101");
obj2.setAddress("#20A, 2345 Belmont Avenue, Durham, NC，America");
obj2.setDepartureCity("Shanghai");
obj2.setProvinceCode("CA");
AlibabaIntentionOrderSaveRequest.Phone obj4 = new AlibabaIntentionOrderSaveRequest.Phone();
obj4.setArea("8");
obj4.setCountry("001");
obj4.setNumber("123456789");
obj2.setMobile(obj4);
AlibabaIntentionOrderSaveRequest.Phone obj5 = new AlibabaIntentionOrderSaveRequest.Phone();
obj5.setArea("8");
obj5.setCountry("001");
obj5.setNumber("123456789");
obj2.setTelephone(obj5);
obj2.setPortCode("NY");
obj2.setCarrier("United Parcel Service of America");
obj2.setPort("NewYork");
obj2.setCarrierCode("UPS");
obj2.setAlternateAddress("#20A, 2345 Belmont Avenue, Durham, NC，America");
obj2.setProperties("JSON字符串格式");
obj1.setIntentionOrderLogistics(obj2);
obj1.setCurrency("USD");
obj1.setSourceChannelReferId("12345678");
obj1.setBuyerProvince("California");
obj1.setBuyerContactAddress("#20A, 2345 Belmont Avenue, Durham, NC，America");
obj1.setBuyerCountryPort("NewYork");
List<AlibabaIntentionOrderSaveRequest.IntentionOrderProduct> list7 = new ArrayList<AlibabaIntentionOrderSaveRequest.IntentionOrderProduct>();
AlibabaIntentionOrderSaveRequest.IntentionOrderProduct obj8 = new AlibabaIntentionOrderSaveRequest.IntentionOrderProduct();
list7.add(obj8);
obj8.setProductDesc("xxx,xxx");
obj8.setProductSpec("xxx,xxx");
obj8.setSkuId("1234");
obj8.setQuantity("100");
obj8.setOriginalUnitPrice("12");
obj8.setUnitPrice("10");
obj8.setUnit("Pieces");
obj8.setImageUrl("http://cdn.xxx.com/xxx/xxx");
obj8.setType("Sample/ Customized/Standard");
obj8.setName("mp3 player with bluetooth");
obj8.setProductId(12345678L);
obj8.setProperties("JSON结构字符串");
obj1.setIntentionOrderProducts(list7);
obj1.setBuyerCountryPortCode("NY");
obj1.setIntentionOrderId("12345678");
obj1.setBuyerName("Jack Wu");
obj1.setBuyerCompanyName("Alibaba");
obj1.setBuyerCountryCode("US");
obj1.setBuyerCountry("The United States");
obj1.setAdvancedAmount("300");
obj1.setBuyerProvinceCode("CA");
obj1.setBuyerCityCode("NY");
obj1.setBuyerMobile("001-123456789");
obj1.setProperties("JSON结构字符串");
obj1.setStatus("DRAFT");
req.setIntentionOrder(obj1);
AlibabaIntentionOrderSaveResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIntentionOrderSaveRequest req = new AlibabaIntentionOrderSaveRequest();
AlibabaIntentionOrderSaveRequest.IntentionOrderSaveRequestDomain obj1 = new AlibabaIntentionOrderSaveRequest.IntentionOrderSaveRequestDomain();
obj1.BuyerFax = "001-123456789";
obj1.BuyerTelephone = "001-123456789";
obj1.BuyerEmail = "xxx@alibaba.com";
obj1.Remark = "xxx,xxx,xxx";
obj1.TradeTerm = "FOB";
obj1.BuyerZipCode = "201101";
obj1.OrderAmount = "1000";
obj1.BuyerCity = "NewYork";
AlibabaIntentionOrderSaveRequest.IntentionOrderLogisticsDomain obj2 = new AlibabaIntentionOrderSaveRequest.IntentionOrderLogisticsDomain();
obj2.ShipmentFee = "100";
obj2.Country = "The United States";
obj2.City = "NewYork";
obj2.CityCode = "NY";
obj2.ContactPerson = "Jack Wu";
obj2.DeparturePort = "ShangHai";
obj2.DeliveryDateType = "relative";
obj2.AddressId = "12345678";
obj2.DeliveryDateRelativeDuration = 33L;
obj2.ShipmentMethod = "express/air/sea/land:快递/空运/海运/陆运/";
obj2.Province = "California";
obj2.DepartureCityCode = "SH";
obj2.CountryCode = "US";
obj2.DeliveryDateAbsoluteTime = "2019-10-10 10:00:00";
AlibabaIntentionOrderSaveRequest.PhoneDomain obj3 = new AlibabaIntentionOrderSaveRequest.PhoneDomain();
obj3.Area = "8";
obj3.Country = "001";
obj3.Number = "123456789";
obj2.Fax= obj3;
obj2.DeparturePortCode = "SH";
obj2.Zip = "201101";
obj2.Address = "#20A, 2345 Belmont Avenue, Durham, NC，America";
obj2.DepartureCity = "Shanghai";
obj2.ProvinceCode = "CA";
AlibabaIntentionOrderSaveRequest.PhoneDomain obj4 = new AlibabaIntentionOrderSaveRequest.PhoneDomain();
obj4.Area = "8";
obj4.Country = "001";
obj4.Number = "123456789";
obj2.Mobile= obj4;
AlibabaIntentionOrderSaveRequest.PhoneDomain obj5 = new AlibabaIntentionOrderSaveRequest.PhoneDomain();
obj5.Area = "8";
obj5.Country = "001";
obj5.Number = "123456789";
obj2.Telephone= obj5;
obj2.PortCode = "NY";
obj2.Carrier = "United Parcel Service of America";
obj2.Port = "NewYork";
obj2.CarrierCode = "UPS";
obj2.AlternateAddress = "#20A, 2345 Belmont Avenue, Durham, NC，America";
obj2.Properties = "JSON字符串格式";
obj1.IntentionOrderLogistics= obj2;
obj1.Currency = "USD";
obj1.SourceChannelReferId = "12345678";
obj1.BuyerProvince = "California";
obj1.BuyerContactAddress = "#20A, 2345 Belmont Avenue, Durham, NC，America";
obj1.BuyerCountryPort = "NewYork";
List<AlibabaIntentionOrderSaveRequest.IntentionOrderProductDomain> list7 = new List<AlibabaIntentionOrderSaveRequest.IntentionOrderProductDomain>();
AlibabaIntentionOrderSaveRequest.IntentionOrderProductDomain obj8 = new AlibabaIntentionOrderSaveRequest.IntentionOrderProductDomain();
list7.Add(obj8);
obj8.ProductDesc = "xxx,xxx";
obj8.ProductSpec = "xxx,xxx";
obj8.SkuId = "1234";
obj8.Quantity = "100";
obj8.OriginalUnitPrice = "12";
obj8.UnitPrice = "10";
obj8.Unit = "Pieces";
obj8.ImageUrl = "http://cdn.xxx.com/xxx/xxx";
obj8.Type = "Sample/ Customized/Standard";
obj8.Name = "mp3 player with bluetooth";
obj8.ProductId = 12345678L;
obj8.Properties = "JSON结构字符串";
obj1.IntentionOrderProducts= list7;
obj1.BuyerCountryPortCode = "NY";
obj1.IntentionOrderId = "12345678";
obj1.BuyerName = "Jack Wu";
obj1.BuyerCompanyName = "Alibaba";
obj1.BuyerCountryCode = "US";
obj1.BuyerCountry = "The United States";
obj1.AdvancedAmount = "300";
obj1.BuyerProvinceCode = "CA";
obj1.BuyerCityCode = "NY";
obj1.BuyerMobile = "001-123456789";
obj1.Properties = "JSON结构字符串";
obj1.Status = "DRAFT";
req.IntentionOrder_ = obj1;
AlibabaIntentionOrderSaveResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIntentionOrderSaveRequest;
$intention_order = new IntentionOrderSaveRequest;
$intention_order->buyer_fax="001-123456789";
$intention_order->buyer_telephone="001-123456789";
$intention_order->buyer_email="xxx@alibaba.com";
$intention_order->remark="xxx,xxx,xxx";
$intention_order->trade_term="FOB";
$intention_order->buyer_zip_code="201101";
$intention_order->order_amount="1000";
$intention_order->buyer_city="NewYork";
$intention_order_logistics = new IntentionOrderLogistics;
$intention_order_logistics->shipment_fee="100";
$intention_order_logistics->country="The United States";
$intention_order_logistics->city="NewYork";
$intention_order_logistics->city_code="NY";
$intention_order_logistics->contact_person="Jack Wu";
$intention_order_logistics->departure_port="ShangHai";
$intention_order_logistics->delivery_date_type="relative";
$intention_order_logistics->address_id="12345678";
$intention_order_logistics->delivery_date_relative_duration="33";
$intention_order_logistics->shipment_method="express/air/sea/land:快递/空运/海运/陆运/";
$intention_order_logistics->province="California";
$intention_order_logistics->departure_city_code="SH";
$intention_order_logistics->country_code="US";
$intention_order_logistics->delivery_date_absolute_time="2019-10-10 10:00:00";
$fax = new Phone;
$fax->area="8";
$fax->country="001";
$fax->number="123456789";
$intention_order_logistics->fax = $fax;
$intention_order_logistics->departure_port_code="SH";
$intention_order_logistics->zip="201101";
$intention_order_logistics->address="#20A, 2345 Belmont Avenue, Durham, NC，America";
$intention_order_logistics->departure_city="Shanghai";
$intention_order_logistics->province_code="CA";
$mobile = new Phone;
$mobile->area="8";
$mobile->country="001";
$mobile->number="123456789";
$intention_order_logistics->mobile = $mobile;
$telephone = new Phone;
$telephone->area="8";
$telephone->country="001";
$telephone->number="123456789";
$intention_order_logistics->telephone = $telephone;
$intention_order_logistics->port_code="NY";
$intention_order_logistics->carrier="United Parcel Service of America";
$intention_order_logistics->port="NewYork";
$intention_order_logistics->carrier_code="UPS";
$intention_order_logistics->alternate_address="#20A, 2345 Belmont Avenue, Durham, NC，America";
$intention_order_logistics->properties="JSON字符串格式";
$intention_order->intention_order_logistics = $intention_order_logistics;
$intention_order->currency="USD";
$intention_order->source_channel_refer_id="12345678";
$intention_order->buyer_province="California";
$intention_order->buyer_contact_address="#20A, 2345 Belmont Avenue, Durham, NC，America";
$intention_order->buyer_country_port="NewYork";
$intention_order_products = new IntentionOrderProduct;
$intention_order_products->product_desc="xxx,xxx";
$intention_order_products->product_spec="xxx,xxx";
$intention_order_products->sku_id="1234";
$intention_order_products->quantity="100";
$intention_order_products->original_unit_price="12";
$intention_order_products->unit_price="10";
$intention_order_products->unit="Pieces";
$intention_order_products->image_url="http://cdn.xxx.com/xxx/xxx";
$intention_order_products->type="Sample/ Customized/Standard";
$intention_order_products->name="mp3 player with bluetooth";
$intention_order_products->product_id="12345678";
$intention_order_products->properties="JSON结构字符串";
$intention_order->intention_order_products = $intention_order_products;
$intention_order->buyer_country_port_code="NY";
$intention_order->intention_order_id="12345678";
$intention_order->buyer_name="Jack Wu";
$intention_order->buyer_company_name="Alibaba";
$intention_order->buyer_country_code="US";
$intention_order->buyer_country="The United States";
$intention_order->advanced_amount="300";
$intention_order->buyer_province_code="CA";
$intention_order->buyer_city_code="NY";
$intention_order->buyer_mobile="001-123456789";
$intention_order->properties="JSON结构字符串";
$intention_order->status="DRAFT";
$req->setIntentionOrder(json_encode($intention_order));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.intention.order.save' \
-d 'partner_id=apidoc' \
-d 'session=bc91e809-5400-4f91-bfd7-a9c7fd1e5397' \
-d 'sign=B203FB1B231CA01BE744755BBEF734F0' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-11-22+04%3A31%3A31' \
-d 'v=2.0' \
-d 'intention_order=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaIntentionOrderSaveRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.intention_order=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.intention.order.save");
add_param(pRequest,"intention_order","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.intention.order.save', {
	'intention_order':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_intention_order_save_response>
    <value>
        <intention_id>1234567890</intention_id>
    </value>
</alibaba_intention_order_save_response>

{
    "alibaba_intention_order_save_response":{
        "value":{
            "intention_id":"1234567890"
        }
    }
}

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>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

ICBU－交易

alibaba.intention.order.save (意向单创建接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ