文档中心 > API类目 > 银泰开放平台

alibaba.mos.tm.open.order.query (订单查询接口)

订单查询接口。订单状态变更可订阅以下消息:销售单发货消息alibaba_mos_SaleOrderDeliver、销售单状态变更alibaba_mos_SaleOrder、销售单退款消息alibaba_mos_SaleOrderRefund。消息服务可参考文档https://open.taobao.com/docV3.htm?docId=101663&docType=1

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query OpenOrderQuery 必须 查询入参
  • └ create_time_start
  • Date
  • 必须
  • 2021-06-01 00:00:00
  • 订单创建开始时间
  • └ create_time_end
  • Date
  • 必须
  • 2021-06-02 00:00:00
  • 订单创建结束时间
  • └ page_no
  • Number
  • 必须
  • 1
  • 分页号,从1开始
  • └ page_size
  • Number
  • 必须
  • 10
  • 分页大小,不能大于10
  • └ out_trade_nos
  • String []
  • 可选
  • 20210716000841049675
  • 渠道订单号(平台原始订单号)
  • └ out_counter_nos
  • String []
  • 可选
  • HZ01-00092
  • 门店专柜号,必传字段
  • └ trade_statuses
  • String []
  • 可选
  • [3,8]
  • 交易状态, 3:已支付 8:已完成 9:已退款(线下订单的完结状态是已付款,线上订单的完结状态是已完成)
  • └ sale_channels
  • String []
  • 可选
  • [1,2]
  • 销售渠道编码:1(线下),2(喵街),3(天猫),6(支付宝小程序),7(淘宝),8(微信小程序),10(抖音),11(其他),99(手工收单)
  • └ modified_time_start
  • Date
  • 可选
  • 2021-06-01 00:00:00
  • 订单更新开始时间
  • └ modified_time_end
  • Date
  • 可选
  • 2021-06-02 00:00:00
  • 订单更新结束时间
  • └ deliver_time_start
  • Date
  • 可选
  • 2021-06-01 00:00:00
  • 发货开始时间
  • └ deliver_time_end
  • Date
  • 可选
  • 2021-06-02 00:00:00
  • 发货结束时间
  • └ master_order_no
  • String
  • 可选
  • 20221206000000000012039486070
  • 销售单主单号(按专柜拆分的单号)
  • └ out_channel_trade_nos
  • String []
  • 可选
  • ["20240729203335-33517"]
  • 外部渠道订单号

响应参数

名称 类型 示例值 描述
result MultiResult 接口返回model
  • datas
  • Data []
  • 返回数据列表
  • order_items
  • OrderItems []
  • 订单商品
  • └ logistics_way_name
  • String
  • 普通快递
  • 履约方式
  • └ quantity
  • Number
  • 1
  • 数量
  • └ sale_price
  • Number
  • 0
  • 销售价(单位:分)
  • └ item_title
  • String
  • 倩碧匀净淡斑多效精华露30ml套装赠礼
  • 商品名称
  • payments
  • Payments []
  • 支付分摊
  • └ out_payment_name
  • String
  • 支付宝
  • 支付名称
  • └ split_amount
  • Number
  • 1000
  • 分摊金额(单位:分)
  • └ out_payment_code
  • String
  • D146
  • 支付方式
  • └ pay_line_no
  • Number
  • 1
  • 支付行号
  • └ art_no
  • String
  • QB20200410
  • 货号
  • └ tag_price
  • Number
  • 0
  • 吊牌价(单位:分)
  • └ third_disc_amount
  • String
  • demo
  • 外部折扣金额
  • └ bar_code
  • String
  • QB20200410
  • 商品条码
  • └ line_no
  • Number
  • 3
  • 行号
  • └ logistics_way
  • Number
  • 2
  • 履约方式,0:无配送 ,1:到店自提 ,2:普通快递,3:物流到店 4:定时达,5:到店服务 6:次日达,7:无需配送
  • └ logistics_status_text
  • String
  • 已收货
  • 履约状态
  • └ out_sku_id
  • String
  • demo
  • 商家outid(供应链对接专用)
  • └ third_disc_code
  • String
  • demo
  • 外部折扣码
  • └ logistics_status
  • Number
  • 5
  • 履约状态,0:未知状态 , 1:未发货 , 2:已部分发货 , 3:已发货 4:已拒收 5:已收货 7:已关闭
  • └ share_promotion_e2_amount
  • Number
  • 0
  • 银泰满减促销分摊金额(单位:分)
  • └ mp_sku_id
  • String
  • 10000943000084
  • 银泰内部skuid,一般用不到
  • counter
  • CounterView
  • 专柜信息
  • └ counter_name
  • String
  • 倩碧
  • 专柜名称
  • └ counter_id
  • Number
  • 123456
  • 专柜id
  • └ counter_no
  • String
  • 606060
  • 专柜号
  • └ store_counter_no
  • String
  • HZ01-606060
  • 门店专柜号
  • └ brand_id
  • String
  • 100010
  • 主品牌id
  • warehouse
  • WarehouseView
  • 仓库信息
  • └ warehouse_name
  • String
  • 杭州一仓
  • 仓库名
  • └ warehouse_type
  • String
  • SUPPLIER
  • 仓库类型,warehouseType STORE:门店仓,CENTER:中心仓,SUPPLIER:供应商仓,FRONT:前置仓,SUPPLIER_VIRTUAL:商家虚仓
  • └ warehouse_number
  • String
  • 123456
  • 仓库号
  • └ sub_line_no
  • Number
  • 1
  • 组合商品子品行号
  • └ pay_amount
  • Number
  • 0
  • 商品行实付金额(单位:分)
  • └ master_order_no
  • String
  • 20220116000000000960088002000
  • 销售单主单号(按专柜拆分的单号)
  • └ deliver_time
  • Date
  • 1624175784000
  • 发货时间
  • └ guider_id
  • String
  • 0694
  • 开票导购id
  • └ brand_set_code
  • String
  • code1
  • 品牌组套编码
  • └ give_away_value
  • Number
  • 1
  • 赠品价值(单位:分)
  • └ brand_set_code_qty
  • Number
  • 2
  • 品牌组套编码套内数量
  • └ brand_new_enjoy_activity_id
  • String
  • 12345
  • 品牌新享(加赠)活动Id
  • └ brand_new_gift_member_tag
  • String
  • BRAND_NEWCOMER
  • 活动人群:BRAND_NEWCOMER ->品牌新享;BRAND_EXCLUSIVE ->品牌专项;BRAND_MEETING ->入会礼遇
  • order
  • OpenOrderView
  • 订单
  • └ gmt_modified
  • Date
  • 1624175784000
  • 修改时间
  • └ pay_time
  • Date
  • 1624175783000
  • 支付时间
  • └ post_fee
  • Number
  • 0
  • 运费(单位:分)
  • store
  • StoreView
  • 门店
  • └ store_no
  • String
  • HZ01
  • 门店号
  • └ store_name
  • String
  • 银泰百货武林总店
  • 门店名称
  • └ store_id
  • Number
  • 66177122
  • 门店Id
  • └ buyer_open_id
  • String
  • 918505435
  • 买家openId(会员对接专用)
  • └ gmt_create
  • Date
  • 1624175769000
  • 创建时间
  • └ trade_status_text
  • String
  • 已付款
  • 订单状态
  • └ buy_note
  • String
  • demo
  • 买家留言
  • └ sale_channel_name
  • String
  • 喵街
  • 销售渠道名称
  • └ sale_channel
  • Number
  • 2
  • 销售渠道编码:1(线下),2(喵街),3(天猫),6(支付宝小程序),7(淘宝),8(微信小程序),10(抖音),11(其他),99(手工收单)
  • └ total_fee
  • Number
  • 49500
  • 订单金额(商品行实付金额,不含运费)
  • └ out_trade_no
  • String
  • 20210620000830019813
  • 渠道订单号(平台原始订单号)
  • └ trade_status
  • Number
  • 3
  • 订单状态,tradeStatus 0:未知,2:未付款,3:已付款 , 8:交易成功 , 9:交易关闭
  • └ ticket_no
  • String
  • HZ0178416005959
  • 小票号
  • └ guider_id
  • String
  • 0000
  • 导购员id
  • └ success_time
  • Date
  • 1624175769000
  • 交易完成时间
  • └ guider_name
  • String
  • 导购
  • 导购员姓名
  • └ order_types
  • String []
  • 订单类型
  • └ pre_buy_status_text
  • String
  • 待结算
  • 预购状态描述: 0 待结算 ,1 待结算, 2 已结算待返款, 3 返款处理中, 4 返款成功
  • └ pre_buy_status
  • Number
  • 0
  • 预购状态: 0 待结算 ,1 待结算, 2 已结算待返款, 3 返款处理中, 4 返款成功
  • └ pre_buy_settle_time
  • Date
  • 1662508860000
  • 预购结算时间
  • └ master_order_no
  • String
  • 20220116000000000960088002000
  • 销售单主单号(按专柜拆分的单号)
  • └ delivery_status
  • String
  • 3
  • 交易发货状态: 0:未知状态 , 1:未发货 , 2:已部分发货 , 3:已发货 4:已拒收 5:已收货 7:已关闭
  • └ delivery_status_text
  • String
  • 已发货
  • 交易发货状态名称
  • └ out_channel_trade_no
  • String
  • 20240729203335
  • 外部渠道订单号
  • └ success
  • Boolean
  • true
  • 接口调用是否成功
  • └ err_code
  • String
  • demo
  • 错误码
  • └ err_message
  • String
  • demo
  • 错误信息
  • └ total
  • Number
  • 1
  • 总条数

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosTmOpenOrderQueryRequest req = new AlibabaMosTmOpenOrderQueryRequest();
AlibabaMosTmOpenOrderQueryRequest.OpenOrderQuery obj1 = new AlibabaMosTmOpenOrderQueryRequest.OpenOrderQuery();
obj1.setCreateTimeStart(StringUtils.parseDateTime("2021-06-01 00:00:00"));
obj1.setCreateTimeEnd(StringUtils.parseDateTime("2021-06-02 00:00:00"));
obj1.setPageNo(1L);
obj1.setPageSize(10L);
obj1.setOutTradeNos("20210716000841049675");
obj1.setOutCounterNos("HZ01-00092");
obj1.setTradeStatuses("3,8");
obj1.setSaleChannels("1,2");
obj1.setModifiedTimeStart(StringUtils.parseDateTime("2021-06-01 00:00:00"));
obj1.setModifiedTimeEnd(StringUtils.parseDateTime("2021-06-02 00:00:00"));
obj1.setDeliverTimeStart(StringUtils.parseDateTime("2021-06-01 00:00:00"));
obj1.setDeliverTimeEnd(StringUtils.parseDateTime("2021-06-02 00:00:00"));
obj1.setMasterOrderNo("20221206000000000012039486070");
obj1.setOutChannelTradeNos(""20240729203335-33517"");
req.setQuery(obj1);
AlibabaMosTmOpenOrderQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_mos_tm_open_order_query_response>
    <result>
        <datas>
            <data>
                <order_items>
                    <order_items>
                        <logistics_way_name>普通快递</logistics_way_name>
                        <quantity>1</quantity>
                        <sale_price>0</sale_price>
                        <item_title>倩碧匀净淡斑多效精华露30ml套装赠礼</item_title>
                        <payments>
                            <payments>
                                <out_payment_name>支付宝</out_payment_name>
                                <split_amount>1000</split_amount>
                                <out_payment_code>D146</out_payment_code>
                                <pay_line_no>1</pay_line_no>
                            </payments>
                        </payments>
                        <art_no>QB20200410</art_no>
                        <tag_price>0</tag_price>
                        <bar_code>QB20200410</bar_code>
                        <line_no>3</line_no>
                        <logistics_way>2</logistics_way>
                        <logistics_status_text>已收货</logistics_status_text>
                        <out_sku_id>demo</out_sku_id>
                        <logistics_status>5</logistics_status>
                        <counter>
                            <counter_name>倩碧</counter_name>
                            <store_counter_no>HZ01-606060</store_counter_no>
                            <brand_id>100010</brand_id>
                        </counter>
                        <warehouse>
                            <warehouse_name>杭州一仓</warehouse_name>
                            <warehouse_type>SUPPLIER</warehouse_type>
                            <warehouse_number>123456</warehouse_number>
                        </warehouse>
                        <sub_line_no>1</sub_line_no>
                        <pay_amount>0</pay_amount>
                        <master_order_no>20220116000000000960088002000</master_order_no>
                        <deliver_time>1624175784000</deliver_time>
                        <guider_id>0694</guider_id>
                        <brand_set_code>code1</brand_set_code>
                        <give_away_value>1</give_away_value>
                        <brand_set_code_qty>2</brand_set_code_qty>
                        <brand_new_enjoy_activity_id>12345</brand_new_enjoy_activity_id>
                        <brand_new_gift_member_tag>BRAND_NEWCOMER</brand_new_gift_member_tag>
                    </order_items>
                </order_items>
                <order>
                    <gmt_modified>1624175784000</gmt_modified>
                    <pay_time>1624175783000</pay_time>
                    <post_fee>0</post_fee>
                    <store>
                        <store_no>HZ01</store_no>
                        <store_name>银泰百货武林总店</store_name>
                    </store>
                    <buyer_open_id>918505435</buyer_open_id>
                    <gmt_create>1624175769000</gmt_create>
                    <trade_status_text>已付款</trade_status_text>
                    <buy_note>demo</buy_note>
                    <sale_channel_name>喵街</sale_channel_name>
                    <sale_channel>2</sale_channel>
                    <total_fee>49500</total_fee>
                    <out_trade_no>20210620000830019813</out_trade_no>
                    <trade_status>3</trade_status>
                    <ticket_no>HZ0178416005959</ticket_no>
                    <guider_id>0000</guider_id>
                    <success_time>1624175769000</success_time>
                    <guider_name>导购</guider_name>
                    <pre_buy_status_text>待结算</pre_buy_status_text>
                    <pre_buy_status>0</pre_buy_status>
                    <pre_buy_settle_time>1662508860000</pre_buy_settle_time>
                    <master_order_no>20220116000000000960088002000</master_order_no>
                    <delivery_status>3</delivery_status>
                    <delivery_status_text>已发货</delivery_status_text>
                    <out_channel_trade_no>20240729203335</out_channel_trade_no>
                </order>
            </data>
        </datas>
        <success>true</success>
        <err_code>demo</err_code>
        <err_message>demo</err_message>
        <total>1</total>
    </result>
</alibaba_mos_tm_open_order_query_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

返回
顶部