文档中心 > API类目 > 全渠道API

alibaba.retail.commission.order.query (分销订单查询)

查询商家的分销订单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_no Number 可选 1
  • 默认值:1
  • 页码,默认第一页
    page_size Number 可选 10
  • 默认值:10
  • 页大小,默认每页十条
    end_pay_time String 必须 2000-01-01 00:00:00 查询三个月内交易创建时间开始。格式:yyyy-MM-dd HH:mm:ss
    start_pay_time String 必须 2000-01-01 23:59:59 查询交易创建时间结束。格式:yyyy-MM-dd HH:mm:ss

    响应参数

    名称 类型 示例值 描述
    result PageResult 分页结果
    • └ total
    • Number
    • 100
    • 总条数
    • └ message
    • String
    • 1
    • 页码,请求的值
    • └ page_no
    • Number
    • 10
    • 页大小,请求的值
    • order_list
    • OrderDto []
    • 返回数据
    • └ biz_order_id
    • Number
    • 10000000
    • 订单id
    • └ main
    • Number
    • 1
    • 1-父订单,0-子订单
    • └ seller_id
    • Number
    • 12345
    • 旗舰店id
    • └ pay_order_id
    • Number
    • 12345
    • 支付订单id
    • └ buyer_nick
    • String
    • 张三
    • 消费者nick
    • └ pay_status
    • Number
    • 7
    • 支付状态:1 - 未冻结/未付款 ->等待买家付款 2 - 已冻结/已付款 ->等待卖家发货 4 - 已退款 ->交易关闭 6 - 已转交易 -> 交易成功 7 - 没有创建外部交易(支付宝交易) 8 - 交易被淘宝关闭 9 - 不可付款
    • └ logistics_status
    • Number
    • 6
    • 物流状态:1 - 未发货 -> 等待卖家发货, 2 - 已发货 -> 等待买家确认收货, 3 - 已收货 -> 交易成功, 4 - 已经退货 -> 交易失败, 5 - 部分收货 -> 交易成功, 6 - 部分发货中, 8 - 还未创建物流订单, 9 - 配货中,目前周期购已经使用到
    • └ pay_time
    • String
    • 2019-03-23 19:34:10
    • 支付时间
    • └ end_time
    • String
    • 2019-03-23 19:34:10
    • 结束时间
    • └ seller_nick
    • String
    • 阿里掌柜测试帐号
    • 旗舰店名称
    • └ auction_id
    • Number
    • 11111
    • 商品id
    • └ auction_price
    • Number
    • 1000
    • 单件商品价格,单位分
    • └ buy_amount
    • Number
    • 2
    • 购买数量
    • └ adjust_fee
    • Number
    • 0
    • 商品的卖出金额调整,金额增加时为正数,金额减少时为负数,单位是分,不带小数。 如果是对整个订单的金额调整,会保存在主订单上,否则保存在子订单里
    • └ discount_fee
    • Number
    • 0
    • 系统对商品作的减价,始终为正数,单位是分
    • └ refund_status
    • Number
    • 9
    • 退款状态:1 买家已经申请退款,等待卖家同意 2 卖家已经同意退款,等待买家退货 3 买家已经退货,等待卖家确认收货 4 退款关闭 5 退款成功 6 卖家拒绝退款 9 没有申请退款,对主定单和子订单都有效 10 有活动退款,申请退款后,只对主定单有效 只有一笔订单的情况,主定单的退款状态可能为1,2,3,6,10 11退款结束,只对父订单有效
    • └ refund_fee
    • Number
    • 0
    • 到目前为止生效的退款,单位是分,父订单的退款等于各个子订单退款的和
    • └ actual_pay_fee
    • Number
    • 1200
    • 实付金额,单位是分
    • └ detail_order_list
    • String []
    • 子订单,属性与主订单相同
    • └ page_size
    • Number
    • 10
    • 每页多少条记录
    • └ code
    • String
    • 200
    • 状态码,200-成功
    • └ success
    • Boolean
    • true
    • 成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    AlibabaRetailCommissionOrderQueryRequest req = new AlibabaRetailCommissionOrderQueryRequest();
    req.setPageNo(1L);
    req.setPageSize(10L);
    req.setEndPayTime("2000-01-01 00:00:00");
    req.setStartPayTime("2000-01-01 23:59:59");
    AlibabaRetailCommissionOrderQueryResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <alibaba_retail_commission_order_query_response>
        <result>
            <total>100</total>
            <message>1</message>
            <page_no>10</page_no>
            <order_list>
                <order_dto>
                    <biz_order_id>10000000</biz_order_id>
                    <main>1</main>
                    <seller_id>12345</seller_id>
                    <pay_order_id>12345</pay_order_id>
                    <buyer_nick>张三</buyer_nick>
                    <pay_status>7</pay_status>
                    <logistics_status>6</logistics_status>
                    <pay_time>2019-03-23 19:34:10</pay_time>
                    <end_time>2019-03-23 19:34:10</end_time>
                    <seller_nick>阿里掌柜测试帐号</seller_nick>
                    <auction_id>11111</auction_id>
                    <auction_price>1000</auction_price>
                    <buy_amount>2</buy_amount>
                    <adjust_fee>0</adjust_fee>
                    <discount_fee>0</discount_fee>
                    <refund_status>9</refund_status>
                    <refund_fee>0</refund_fee>
                    <actual_pay_fee>1200</actual_pay_fee>
                    <detail_order_list>
                        <string></string>
                    </detail_order_list>
                </order_dto>
            </order_list>
            <page_size>10</page_size>
            <code>200</code>
            <success>true</success>
        </result>
    </alibaba_retail_commission_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

    返回
    顶部