淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_place_order_request4_open_api_d_t_o	PlaceOrderRequest4OpenApiDto	必须			下单具体参数
logistics_address MaillingAddressRequestDto 必须物流地址信息 └ address String 必须 sh Kashirskoe dom 142 (QIWI) 地址信息 └ address2 String 可选 sh Kashirskoe dom 142 (QIWI) 地址扩展信息 └ city String 可选 Mosco 城市 └ contact_person String 可选 RU TEST TEST 联系人 └ country String 可选 RU 国家 └ cpf String 可选 111 cpf税号 └ full_name String 可选 RU TEST TEST 收货人全称 └ locale String 可选 en_US 国际化locale └ mobile_no String 可选 12334445 电话号码 └ passport_no String 可选 12345 护照号 └ passport_no_date String 可选 02-23-2018 护照日期 └ passport_organization String 可选 xxxx 护照签发机构 └ phone_country String 可选 +7 电话所在国家区号 └ province String 可选 Mosco 省份 └ tax_number String 可选 xxx 税号 └ zip String 可选 12222 邮政编码 └ rut_no String 可选 123-K 智利税号 └ foreigner_passport_no String 可选 123456789 外籍税号(韩国外籍须填登陆证号或者护照号) └ is_foreigner String 可选 true 是否是外籍 └ vat_no String 可选 123456778 vat税号 └ tax_company String 可选 Soceite General 公司名称 └ location_tree_address_id String 可选 903200190000000000-903200190137000000 地址树ID product_items ProductBaseItem [] 必须商品属性 └ product_count Number 必须 2 商品数量 └ product_id Number 必须 1223211 商品id └ sku_attr String 可选 14:70221 商品sku └ logistics_service_name String 可选 EPAM 物流服务名称 └ order_memo String 可选 Please put it in a gift box. 用户留言

名称	类型	示例值	描述
result	PlaceOrderRes4OpenApiDto	{}	result
└ error_code String PARM_ILLEGL errorCode └ error_msg String param_illegl errorMsg └ order_list Number [] 1000000000 orderList └ is_success Boolean true success

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AliexpressTradeBuyPlaceorderRequest req = new AliexpressTradeBuyPlaceorderRequest();
AliexpressTradeBuyPlaceorderRequest.PlaceOrderRequest4OpenApiDto obj1 = new AliexpressTradeBuyPlaceorderRequest.PlaceOrderRequest4OpenApiDto();
AliexpressTradeBuyPlaceorderRequest.MaillingAddressRequestDto obj2 = new AliexpressTradeBuyPlaceorderRequest.MaillingAddressRequestDto();
obj2.setAddress("sh Kashirskoe dom 142 (QIWI)");
obj2.setAddress2("sh Kashirskoe dom 142 (QIWI)");
obj2.setCity("Mosco");
obj2.setContactPerson("RU  TEST TEST");
obj2.setCountry("RU");
obj2.setCpf("111");
obj2.setFullName("RU  TEST TEST");
obj2.setLocale("en_US");
obj2.setMobileNo("12334445");
obj2.setPassportNo("12345");
obj2.setPassportNoDate("02-23-2018");
obj2.setPassportOrganization("xxxx");
obj2.setPhoneCountry("+7");
obj2.setProvince("Mosco");
obj2.setTaxNumber("xxx");
obj2.setZip("12222");
obj2.setRutNo("123-K");
obj2.setForeignerPassportNo("123456789");
obj2.setIsForeigner("true");
obj2.setVatNo("123456778");
obj2.setTaxCompany("Soceite General");
obj2.setLocationTreeAddressId("903200190000000000-903200190137000000");
obj1.setLogisticsAddress(obj2);
List<AliexpressTradeBuyPlaceorderRequest.ProductBaseItem> list4 = new ArrayList<AliexpressTradeBuyPlaceorderRequest.ProductBaseItem>();
AliexpressTradeBuyPlaceorderRequest.ProductBaseItem obj5 = new AliexpressTradeBuyPlaceorderRequest.ProductBaseItem();
list4.add(obj5);
obj5.setProductCount(2L);
obj5.setProductId(1223211L);
obj5.setSkuAttr("14:70221");
obj5.setLogisticsServiceName("EPAM");
obj5.setOrderMemo("Please put it in a gift box.");
obj1.setProductItems(list4);
req.setParamPlaceOrderRequest4OpenApiDTO(obj1);
AliexpressTradeBuyPlaceorderResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AliexpressTradeBuyPlaceorderRequest req = new AliexpressTradeBuyPlaceorderRequest();
AliexpressTradeBuyPlaceorderRequest.PlaceOrderRequest4OpenApiDtoDomain obj1 = new AliexpressTradeBuyPlaceorderRequest.PlaceOrderRequest4OpenApiDtoDomain();
AliexpressTradeBuyPlaceorderRequest.MaillingAddressRequestDtoDomain obj2 = new AliexpressTradeBuyPlaceorderRequest.MaillingAddressRequestDtoDomain();
obj2.Address = "sh Kashirskoe dom 142 (QIWI)";
obj2.Address2 = "sh Kashirskoe dom 142 (QIWI)";
obj2.City = "Mosco";
obj2.ContactPerson = "RU  TEST TEST";
obj2.Country = "RU";
obj2.Cpf = "111";
obj2.FullName = "RU  TEST TEST";
obj2.Locale = "en_US";
obj2.MobileNo = "12334445";
obj2.PassportNo = "12345";
obj2.PassportNoDate = "02-23-2018";
obj2.PassportOrganization = "xxxx";
obj2.PhoneCountry = "+7";
obj2.Province = "Mosco";
obj2.TaxNumber = "xxx";
obj2.Zip = "12222";
obj2.RutNo = "123-K";
obj2.ForeignerPassportNo = "123456789";
obj2.IsForeigner = "true";
obj2.VatNo = "123456778";
obj2.TaxCompany = "Soceite General";
obj2.LocationTreeAddressId = "903200190000000000-903200190137000000";
obj1.LogisticsAddress= obj2;
List<AliexpressTradeBuyPlaceorderRequest.ProductBaseItemDomain> list4 = new List<AliexpressTradeBuyPlaceorderRequest.ProductBaseItemDomain>();
AliexpressTradeBuyPlaceorderRequest.ProductBaseItemDomain obj5 = new AliexpressTradeBuyPlaceorderRequest.ProductBaseItemDomain();
list4.Add(obj5);
obj5.ProductCount = 2L;
obj5.ProductId = 1223211L;
obj5.SkuAttr = "14:70221";
obj5.LogisticsServiceName = "EPAM";
obj5.OrderMemo = "Please put it in a gift box.";
obj1.ProductItems= list4;
req.ParamPlaceOrderRequest4OpenApiDTO_ = obj1;
AliexpressTradeBuyPlaceorderResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AliexpressTradeBuyPlaceorderRequest;
$param_place_order_request4_open_api_d_t_o = new PlaceOrderRequest4OpenApiDto;
$logistics_address = new MaillingAddressRequestDto;
$logistics_address->address="sh Kashirskoe dom 142 (QIWI)";
$logistics_address->address2="sh Kashirskoe dom 142 (QIWI)";
$logistics_address->city="Mosco";
$logistics_address->contact_person="RU  TEST TEST";
$logistics_address->country="RU";
$logistics_address->cpf="111";
$logistics_address->full_name="RU  TEST TEST";
$logistics_address->locale="en_US";
$logistics_address->mobile_no="12334445";
$logistics_address->passport_no="12345";
$logistics_address->passport_no_date="02-23-2018";
$logistics_address->passport_organization="xxxx";
$logistics_address->phone_country="+7";
$logistics_address->province="Mosco";
$logistics_address->tax_number="xxx";
$logistics_address->zip="12222";
$logistics_address->rut_no="123-K";
$logistics_address->foreigner_passport_no="123456789";
$logistics_address->is_foreigner="true";
$logistics_address->vat_no="123456778";
$logistics_address->tax_company="Soceite General";
$logistics_address->location_tree_address_id="903200190000000000-903200190137000000";
$param_place_order_request4_open_api_d_t_o->logistics_address = $logistics_address;
$product_items = new ProductBaseItem;
$product_items->product_count="2";
$product_items->product_id="1223211";
$product_items->sku_attr="14:70221";
$product_items->logistics_service_name="EPAM";
$product_items->order_memo="Please put it in a gift box.";
$param_place_order_request4_open_api_d_t_o->product_items = $product_items;
$req->setParamPlaceOrderRequest4OpenApiDTO(json_encode($param_place_order_request4_open_api_d_t_o));
$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=aliexpress.trade.buy.placeorder' \
-d 'partner_id=apidoc' \
-d 'session=284da66d-87dc-49bd-97a9-7f7802e84f7d' \
-d 'sign=53B515F16DE6CC4FE3E6257FA129D02E' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-03-10+04%3A01%3A14' \
-d 'v=2.0' \
-d 'param_place_order_request4_open_api_d_t_o=null'

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

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

req.param_place_order_request4_open_api_d_t_o=""
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,"aliexpress.trade.buy.placeorder");
add_param(pRequest,"param_place_order_request4_open_api_d_t_o","数据结构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('aliexpress.trade.buy.placeorder', {
	'param_place_order_request4_open_api_d_t_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<aliexpress_trade_buy_placeorder_response>
    <result>
        <error_code>PARM_ILLEGL</error_code>
        <error_msg>param_illegl</error_msg>
        <order_list>
            <number>1000000000</number>
        </order_list>
        <is_success>true</is_success>
    </result>
</aliexpress_trade_buy_placeorder_response>

{
    "aliexpress_trade_buy_placeorder_response":{
        "result":{
            "error_code":"PARM_ILLEGL",
            "error_msg":"param_illegl",
            "order_list":{
                "number":[
                    1000000000
                ]
            },
            "is_success":true
        }
    }
}

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"
	}
}

错误码	错误描述	解决方案
B_DROPSHIPPER_DELIVERY_ADDRESS_VALIDATE_FAIL	地址不符合规则	修改下单用户地址
BLACKLIST_BUYER_IN_LIST	黑名单买家	此用户暂时无法下单
USER_ACCOUNT_DISABLED	buyer account has been disabled	contact customer service for further information
PRICE_PAY_CURRENCY_ERROR	products in the place order request should not be declared in different currencies	products should declare as same currency
DELIVERY_METHOD_NOT_EXIST	delivery method is not exist	please fill valid delivery method
INVENTORY_HOLD_ERROR	hold inventory error	maybe inventory is insufficient or system error occured
REPEATED_ORDER_ERROR	repeated placed order	please check buyer order list, request already been handled successfully.
ERROR_WHEN_BUILD_FOR_PLACE_ORDER	system error.	please try again later.
A001_ORDER_CANNOT_BE_PLACED	A001_ORDER_CANNOT_BE_PLACED	A001_ORDER_CANNOT_BE_PLACED
A002_INVALID_ZONE	A002_INVALID_ZONE	A002_INVALID_ZONE
A003_SUSPICIOUS_BUYER	A003_SUSPICIOUS_BUYER	A003_SUSPICIOUS_BUYER
A004_CANNOT_USER_COUPON	A004_CANNOT_USER_COUPON	A004_CANNOT_USER_COUPON
A005_INVALID_COUNTRIES	A005_INVALID_COUNTRIES	A005_INVALID_COUNTRIES
A006_INVALID_ACCOUNT_INFO	A006_INVALID_ACCOUNT_INFO	A006_INVALID_ACCOUNT_INFO

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

开放平台

Dropshipping（已废弃）

aliexpress.trade.buy.placeorder (AE下单API)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ