注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > 天猫精灵供应链数字工厂

alibaba.ailab.mall.order.create (线下门店订单创建)

线下门店订单创建

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
create_order_request CreateOrderRequest 可选 下单参数
  • └ store_en_code
  • String
  • 可选
  • ABCD
  • 店铺编码
  • receiver
  • BaseReceiverDTO
  • 可选
  • 收件人信息
  • └ province
  • String
  • 可选
  • 浙江省
  • └ city
  • String
  • 可选
  • 杭州市
  • 城市
  • └ contact_name
  • String
  • 可选
  • 张三
  • 收件人
  • └ country_code
  • String
  • 可选
  • CN
  • 国家代码
  • └ street
  • String
  • 可选
  • 五常街道
  • 街道
  • └ district
  • String
  • 可选
  • 余杭区
  • 区县
  • └ postcode
  • String
  • 可选
  • 000000
  • 邮政编码
  • └ detail_address
  • String
  • 可选
  • 五常街道阿里科技创新园区
  • 详细地址
  • └ contact_phone
  • String
  • 可选
  • 13012345678
  • 收件人联系方式
  • └ out_biz_no
  • String
  • 可选
  • 123
  • 外部交易单号,根据此字段幂等
  • └ remark
  • String
  • 可选
  • 备注
  • 备注信息
  • └ place_order_time
  • String
  • 可选
  • 2025-11-11 13:14:00
  • 下单时间
  • └ extensions
  • String
  • 可选
  • {"key": "value"}
  • 拓展信息
  • └ place_order_user
  • String
  • 可选
  • 张三
  • 下单人
  • items
  • SyncOrderItem []
  • 可选
  • []
  • 下单商品
  • └ out_line_no
  • String
  • 可选
  • 订单行号
  • 一个订单内部需要唯一
  • └ unit_price
  • String
  • 可选
  • 30.20
  • 单价
  • └ extensions
  • String
  • 可选
  • {"key": "value"}
  • 订单行拓展信息
  • └ quantity
  • Number
  • 可选
  • 3
  • 下单数量
  • └ sp_code
  • String
  • 可选
  • SP12345
  • 下单商品SP码

响应参数

名称 类型 示例值 描述
message String 外部订单单号不可以为空 请求信息
trace_id String aaaaa trace_id
response_code String success 响应编码
data String 123123 生成的订单号
request_id String abce TOP请求id

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAilabMallOrderCreateRequest req = new AlibabaAilabMallOrderCreateRequest();
AlibabaAilabMallOrderCreateRequest.CreateOrderRequest obj1 = new AlibabaAilabMallOrderCreateRequest.CreateOrderRequest();
obj1.setStoreEnCode("ABCD");
AlibabaAilabMallOrderCreateRequest.BaseReceiverDTO obj2 = new AlibabaAilabMallOrderCreateRequest.BaseReceiverDTO();
obj2.setProvince("浙江省");
obj2.setCity("杭州市");
obj2.setContactName("张三");
obj2.setCountryCode("CN");
obj2.setStreet("五常街道");
obj2.setDistrict("余杭区");
obj2.setPostcode("000000");
obj2.setDetailAddress("五常街道阿里科技创新园区");
obj2.setContactPhone("13012345678");
obj1.setReceiver(obj2);
obj1.setOutBizNo("123");
obj1.setRemark("备注");
obj1.setPlaceOrderTime("2025-11-11 13:14:00");
obj1.setExtensions("{\"key\": \"value\"}");
obj1.setPlaceOrderUser("张三");
List<AlibabaAilabMallOrderCreateRequest.SyncOrderItem> list4 = new ArrayList<AlibabaAilabMallOrderCreateRequest.SyncOrderItem>();
AlibabaAilabMallOrderCreateRequest.SyncOrderItem obj5 = new AlibabaAilabMallOrderCreateRequest.SyncOrderItem();
list4.add(obj5);
obj5.setOutLineNo("订单行号");
obj5.setUnitPrice("30.20");
obj5.setExtensions("{\"key\": \"value\"}");
obj5.setQuantity(3L);
obj5.setSpCode("SP12345");
obj1.setItems(list4);
req.setCreateOrderRequest(obj1);
AlibabaAilabMallOrderCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ailab_mall_order_create_response>
    <message>外部订单单号不可以为空</message>
    <trace_id>aaaaa</trace_id>
    <response_code>success</response_code>
    <data>123123</data>
    <request_id>abce</request_id>
</alibaba_ailab_mall_order_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工具

如何获得此API

FAQ

返回
顶部