文档中心 > API类目 > 阿里通信API

taobao.epp.trade.query (采购单查询)

采购单查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
query_order_req QueryOrderReq 必须 查询参数
  • └ out_order_id
  • String
  • 必须
  • EPP20231213104
  • 采购单外部ID
  • └ ex_param
  • String
  • 可选
  • {"xxx":123}
  • 扩展字段可为空

响应参数

名称 类型 示例值 描述
result Result result
  • └ code
  • String
  • 200
  • code
  • data
  • BaseOrderRes
  • 成功的数据
  • └ out_order_id
  • String
  • EPP20231213104
  • 采购单外部ID
  • tb_order_list
  • TbOrderList []
  • 采购单订单列表
  • tb_sub_order_list
  • TbSubOrderList []
  • 子订单集合
  • └ sku_title
  • String
  • 容量:1L
  • sku名称
  • └ item_title
  • String
  • 仕仁测试,请不要拍
  • 商品名称
  • └ tb_sub_order_logistics_status
  • String
  • 1
  • 物流状态 1=未发货 -> 等待卖家发货 2=已发货 -> 等待买家确认收货 3=已收货 -> 交易成功 4=已经退货 -> 交易失败 5=部分收货 -> 交易成功 6=部分发货中 8=还未创建物流订单
  • └ tb_sub_order_id
  • String
  • 3667030632380297000
  • tb子订单id
  • └ mail_number
  • String
  • 3667030632380297404
  • 物流单号
  • └ pic_url
  • String
  • img.alicdn.com/imgextra/i4/263168616/O1CN01inLPEY2DWBOcplKM9_!!0-item_pic.jpg
  • 商品图片
  • └ epp_item_id
  • String
  • EA086199749310
  • 商品Id
  • └ tb_sub_order_price
  • Number
  • 0
  • 子订单应付单价
  • └ buy_amount
  • Number
  • 1
  • 数量
  • └ sku_id
  • String
  • 123123
  • skuId
  • └ tb_order_id
  • String
  • 3667030632380297000
  • tb主订单id
  • └ tb_order_status
  • Number
  • 2
  • 订单状态 1=待支付,2=已支付,4=已退款关闭,6=交易成功,8=已关闭
  • └ tb_order_price
  • Number
  • 0
  • 订单总金额(分)
  • └ tb_order_create_time
  • String
  • 2023-12-08 11:01:57
  • 创建时间
  • └ tb_logistics_status
  • Number
  • 1
  • 物流状态 1=未发货 -> 等待卖家发货 2=已发货 -> 等待买家确认收货 3=已收货 -> 交易成功 4=已经退货 -> 交易失败 5=部分收货 -> 交易成功 6=部分发货中 8=还未创建物流订单
  • └ success
  • Boolean
  • true
  • 调用是否成功
  • └ message
  • String
  • 成功
  • 消息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
EppTradeQueryRequest req = new EppTradeQueryRequest();
EppTradeQueryRequest.QueryOrderReq obj1 = new EppTradeQueryRequest.QueryOrderReq();
obj1.setOutOrderId("EPP20231213104");
obj1.setExParam("{\"xxx\":123}");
req.setQueryOrderReq(obj1);
EppTradeQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<epp_trade_query_response>
    <result>
        <code>200</code>
        <data>
            <out_order_id>EPP20231213104</out_order_id>
            <tb_order_list>
                <tb_order_list>
                    <tb_sub_order_list>
                        <tb_sub_order_list>
                            <sku_title>容量:1L</sku_title>
                            <item_title>仕仁测试,请不要拍</item_title>
                            <tb_sub_order_logistics_status>1</tb_sub_order_logistics_status>
                            <tb_sub_order_id>3667030632380297000</tb_sub_order_id>
                            <mail_number>3667030632380297404</mail_number>
                            <pic_url>img.alicdn.com/imgextra/i4/263168616/O1CN01inLPEY2DWBOcplKM9_!!0-item_pic.jpg</pic_url>
                            <epp_item_id>EA086199749310</epp_item_id>
                            <tb_sub_order_price>0</tb_sub_order_price>
                            <buy_amount>1</buy_amount>
                            <sku_id>123123</sku_id>
                        </tb_sub_order_list>
                    </tb_sub_order_list>
                    <tb_order_id>3667030632380297000</tb_order_id>
                    <tb_order_status>2</tb_order_status>
                    <tb_order_price>0</tb_order_price>
                    <tb_order_create_time>2023-12-08 11:01:57</tb_order_create_time>
                    <tb_logistics_status>1</tb_logistics_status>
                </tb_order_list>
            </tb_order_list>
        </data>
        <success>true</success>
        <message>成功</message>
    </result>
</epp_trade_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

返回
顶部