阿里大于 -

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
presales_order_create_request	PresalesordercreaterequestTest	可选			预售商家仓接单对象
presales_order PresalesorderTest 可选预售单 └ presales_order_code String 必须 11111 出库单号 └ place_order_time String 必须 2016-07-06 12:00:00 前台订单(店铺订单)创建时间(下单时间) └ total_amount String 可选 22.22 订单总金额=应收金额+已收金额=商品总金额-订单折扣金额+快递费用 └ store_code String 可选 STORE111 仓库 └ remark String 可选备注信息备注 sender_info Senderinfo 可选发件人信息 └ name String 必须张三姓名 └ zip_code String 可选 111111 邮编 └ tel String 可选 0571-88888888 固定电话 └ mobile String 必须 13333333333 移动电话 └ province String 必须浙江省省份 └ city String 必须杭州市城市 └ area String 可选余杭区区域 └ town String 可选蒋村村镇 └ detail_address String 必须西湖区雷峰塔详细地址 receiver_info Receiverinfo 可选收件人信息 └ name String 必须李四姓名 └ zip_code String 可选 111111 邮编 └ tel String 可选 0571-88888888 固定电话 └ mobile String 必须 13333333333 移动电话 └ province String 必须浙江省省份 └ city String 必须杭州市城市 └ area String 可选余杭区区域 └ town String 可选蒋村村镇 └ detail_address String 必须西湖区雷峰塔详细地址 └ oaid String 可选 112233 收件人地址ID order_lines Orderlines [] 可选订单信息 └ shop_code String 可选 b商家测试帐号177 店铺编码 └ actual_price String 可选 11.11 实际成交价 └ retail_price String 可选 10.10 零售价=实际成交价+单件商品折扣金额 └ plan_qty Number 可选 1 应发商品数量 └ item_name String 可选奶茶商品名称 └ item_code String 可选 Item1234 商品编码 └ item_id String 可选 1234 商品ID,前端宝贝ID └ sub_source_order_code String 可选 1213636827396769884 交易平台子订单编码 └ source_order_code String 可选 1213636827396769884 交易平台订单 └ order_line_no String 可选 12345 单据行

名称	类型	示例值	描述
presales_order_create_response	ResultWrapper		返回值包装,result为返回具体消息内容
└ success Boolean true 返回是否成功 └ error_code String 系统自动生成 └ error_message String 系统自动生成 data Data 1111 菜鸟订单编码 logistics_accept_info_res_list Logisticsacceptinforeslist [] 物流信息 └ presales_order_id String 2222 菜鸟订单编码

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpUopTaobaoPresalesorderCreateRequest req = new AlibabaAscpUopTaobaoPresalesorderCreateRequest();
AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesordercreaterequestTest obj1 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesordercreaterequestTest();
AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesorderTest obj2 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesorderTest();
obj2.setPresalesOrderCode("11111");
obj2.setPlaceOrderTime("2016-07-06 12:00:00");
obj2.setTotalAmount("22.22");
obj2.setStoreCode("STORE111");
obj2.setRemark("备注信息");
AlibabaAscpUopTaobaoPresalesorderCreateRequest.Senderinfo obj3 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.Senderinfo();
obj3.setName("张三");
obj3.setZipCode("111111");
obj3.setTel("0571-88888888");
obj3.setMobile("13333333333");
obj3.setProvince("浙江省");
obj3.setCity("杭州市");
obj3.setArea("余杭区");
obj3.setTown("蒋村");
obj3.setDetailAddress("西湖区雷峰塔");
obj2.setSenderInfo(obj3);
AlibabaAscpUopTaobaoPresalesorderCreateRequest.Receiverinfo obj4 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.Receiverinfo();
obj4.setName("李四");
obj4.setZipCode("111111");
obj4.setTel("0571-88888888");
obj4.setMobile("13333333333");
obj4.setProvince("浙江省");
obj4.setCity("杭州市");
obj4.setArea("余杭区");
obj4.setTown("蒋村");
obj4.setDetailAddress("西湖区雷峰塔");
obj4.setOaid("112233");
obj2.setReceiverInfo(obj4);
List<AlibabaAscpUopTaobaoPresalesorderCreateRequest.Orderlines> list6 = new ArrayList<AlibabaAscpUopTaobaoPresalesorderCreateRequest.Orderlines>();
AlibabaAscpUopTaobaoPresalesorderCreateRequest.Orderlines obj7 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.Orderlines();
list6.add(obj7);
obj7.setShopCode("b商家测试帐号177");
obj7.setActualPrice("11.11");
obj7.setRetailPrice("10.10");
obj7.setPlanQty(1L);
obj7.setItemName("奶茶");
obj7.setItemCode("Item1234");
obj7.setItemId("1234");
obj7.setSubSourceOrderCode("1213636827396769884");
obj7.setSourceOrderCode("1213636827396769884");
obj7.setOrderLineNo("12345");
obj2.setOrderLines(list6);
obj1.setPresalesOrder(obj2);
req.setPresalesOrderCreateRequest(obj1);
AlibabaAscpUopTaobaoPresalesorderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaAscpUopTaobaoPresalesorderCreateRequest req = new AlibabaAscpUopTaobaoPresalesorderCreateRequest();
AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesordercreaterequestTestDomain obj1 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesordercreaterequestTestDomain();
AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesorderTestDomain obj2 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.PresalesorderTestDomain();
obj2.PresalesOrderCode = "11111";
obj2.PlaceOrderTime = "2016-07-06 12:00:00";
obj2.TotalAmount = "22.22";
obj2.StoreCode = "STORE111";
obj2.Remark = "备注信息";
AlibabaAscpUopTaobaoPresalesorderCreateRequest.SenderinfoDomain obj3 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.SenderinfoDomain();
obj3.Name = "张三";
obj3.ZipCode = "111111";
obj3.Tel = "0571-88888888";
obj3.Mobile = "13333333333";
obj3.Province = "浙江省";
obj3.City = "杭州市";
obj3.Area = "余杭区";
obj3.Town = "蒋村";
obj3.DetailAddress = "西湖区雷峰塔";
obj2.SenderInfo= obj3;
AlibabaAscpUopTaobaoPresalesorderCreateRequest.ReceiverinfoDomain obj4 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.ReceiverinfoDomain();
obj4.Name = "李四";
obj4.ZipCode = "111111";
obj4.Tel = "0571-88888888";
obj4.Mobile = "13333333333";
obj4.Province = "浙江省";
obj4.City = "杭州市";
obj4.Area = "余杭区";
obj4.Town = "蒋村";
obj4.DetailAddress = "西湖区雷峰塔";
obj4.Oaid = "112233";
obj2.ReceiverInfo= obj4;
List<AlibabaAscpUopTaobaoPresalesorderCreateRequest.OrderlinesDomain> list6 = new List<AlibabaAscpUopTaobaoPresalesorderCreateRequest.OrderlinesDomain>();
AlibabaAscpUopTaobaoPresalesorderCreateRequest.OrderlinesDomain obj7 = new AlibabaAscpUopTaobaoPresalesorderCreateRequest.OrderlinesDomain();
list6.Add(obj7);
obj7.ShopCode = "b商家测试帐号177";
obj7.ActualPrice = "11.11";
obj7.RetailPrice = "10.10";
obj7.PlanQty = 1L;
obj7.ItemName = "奶茶";
obj7.ItemCode = "Item1234";
obj7.ItemId = "1234";
obj7.SubSourceOrderCode = "1213636827396769884";
obj7.SourceOrderCode = "1213636827396769884";
obj7.OrderLineNo = "12345";
obj2.OrderLines= list6;
obj1.PresalesOrder= obj2;
req.PresalesOrderCreateRequest_ = obj1;
AlibabaAscpUopTaobaoPresalesorderCreateResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaAscpUopTaobaoPresalesorderCreateRequest;
$presales_order_create_request = new PresalesordercreaterequestTest;
$presales_order = new PresalesorderTest;
$presales_order->presales_order_code="11111";
$presales_order->place_order_time="2016-07-06 12:00:00";
$presales_order->total_amount="22.22";
$presales_order->store_code="STORE111";
$presales_order->remark="备注信息";
$sender_info = new Senderinfo;
$sender_info->name="张三";
$sender_info->zip_code="111111";
$sender_info->tel="0571-88888888";
$sender_info->mobile="13333333333";
$sender_info->province="浙江省";
$sender_info->city="杭州市";
$sender_info->area="余杭区";
$sender_info->town="蒋村";
$sender_info->detail_address="西湖区雷峰塔";
$presales_order->sender_info = $sender_info;
$receiver_info = new Receiverinfo;
$receiver_info->name="李四";
$receiver_info->zip_code="111111";
$receiver_info->tel="0571-88888888";
$receiver_info->mobile="13333333333";
$receiver_info->province="浙江省";
$receiver_info->city="杭州市";
$receiver_info->area="余杭区";
$receiver_info->town="蒋村";
$receiver_info->detail_address="西湖区雷峰塔";
$receiver_info->oaid="112233";
$presales_order->receiver_info = $receiver_info;
$order_lines = new Orderlines;
$order_lines->shop_code="b商家测试帐号177";
$order_lines->actual_price="11.11";
$order_lines->retail_price="10.10";
$order_lines->plan_qty="1";
$order_lines->item_name="奶茶";
$order_lines->item_code="Item1234";
$order_lines->item_id="1234";
$order_lines->sub_source_order_code="1213636827396769884";
$order_lines->source_order_code="1213636827396769884";
$order_lines->order_line_no="12345";
$presales_order->order_lines = $order_lines;
$presales_order_create_request->presales_order = $presales_order;
$req->setPresalesOrderCreateRequest(json_encode($presales_order_create_request));
$resp = $c->execute($req, $sessionKey);

XML示例
JSON示例

<alibaba_ascp_uop_taobao_presalesorder_create_response>
    <presales_order_create_response>
        <success>true</success>
        <error_code></error_code>
        <error_message></error_message>
        <data>
            <logistics_accept_info_res_list>
                <logisticsacceptinforeslist>
                    <presales_order_id>2222</presales_order_id>
                </logisticsacceptinforeslist>
            </logistics_accept_info_res_list>
        </data>
    </presales_order_create_response>
</alibaba_ascp_uop_taobao_presalesorder_create_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下载

新零售供应链API

alibaba.ascp.uop.taobao.presalesorder.create (预售商家仓接单)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ