taobao.shangou.trades.sold.get (查询卖家已卖出的闪购交易数据(根据创建时间))

查询卖家已卖出的闪购交易数据(根据创建时间)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
page_no Number 必须 1
  • 默认值:1
  • 页码。默认值:1
    page_size Number 必须 20
  • 默认值:20
  • 每页条数。 默认值:20;最大值:50
    start_created Date 必须 2000-01-01 00:00:00 查询三个月内交易创建时间开始。格式:yyyy-MM-dd HH:mm:ss
    end_created Date 必须 2000-01-01 23:59:59 查询交易创建时间结束。格式:yyyy-MM-dd HH:mm:ss
    status String 可选 WAIT_SELLER_SEND_GOODS 交易状态。可选值 等待卖家发货:WAIT_SELLER_SEND_GOODS, 等待买家确认收货:WAIT_BUYER_CONFIRM_GOODS, 交易成功:TRADE_FINISHED, 交易关闭:TRADE_CLOSED
    buyer_nick String 可选 zhangsan 买家昵称
    buyer_open_id String 可选 AAHm5d-EAAeGwJedwSHpg8bT 买家的openId

    响应参数

    名称 类型 示例值 描述
    total_results Number 100 搜索到的交易信息总数
    trades OrderDetailDTO [] 100 搜索到的交易信息列表
    • └ seller_nick
    • String
    • 我在测试
    • 卖家昵称
    • └ buyer_open_uid
    • String
    • AAHk5d-EAAeGwJedwSFu0XXX
    • 买家OpenUid
    • └ created
    • String
    • 2000-01-01 00:00:00
    • 交易创建时间。格式:yyyy-MM-dd HH:mm:ss
    • └ tid
    • String
    • 2231958349
    • 交易编号 (父订单的交易编号)
    • └ buyer_nick
    • String
    • 我**
    • 买家昵称
    • └ status
    • String
    • WAIT_SELLER_SEND_GOODS
    • 交易状态。可选值 等待卖家发货:WAIT_SELLER_SEND_GOODS, 等待买家确认收货:WAIT_BUYER_CONFIRM_GOODS, 交易成功:TRADE_FINISHED, 交易关闭:TRADE_CLOSED
    • └ payment
    • String
    • 200.07
    • 实付金额。精确到2位小数,单位:元。
    • └ total_fee
    • String
    • 200.07
    • 应付金额。精确到2位小数;单位:元。
    • └ post_fee
    • String
    • 200.07
    • 邮费。精确到2位小数;单位:元。
    • └ receiver_state
    • String
    • 浙江省
    • 收货人的所在省份
    • └ receiver_city
    • String
    • 杭州市
    • 收货人的所在城市
    • └ receiver_district
    • String
    • 西湖区
    • 收货人的所在地区
    • └ receiver_town
    • String
    • 三墎镇
    • 收货人街道地址
    • orders
    • OrderDetailDTO []
    • 订单列表
    • └ oid
    • String
    • 2231958349
    • 子订单编号
    • └ num_iid
    • Number
    • 3424234
    • 商品数字编号
    • └ title
    • String
    • 山寨版测试机器
    • 商品标题
    • └ sku_properties_name
    • String
    • 颜色:桔色;尺码:M
    • SKU的值
    • └ price
    • String
    • 200.07
    • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ num
    • Number
    • 1
    • 购买数量。取值范围:大于零的整数
    • └ pic_path
    • String
    • http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
    • 商品图片绝对途径
    • └ refund_id
    • String
    • 2231958349
    • 退款单ID
    • └ refund_status
    • String
    • SUCCESS(退款成功)
    • 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
    • └ store_code
    • String
    • TB_XSD_11426202
    • 门店code
    • └ store_name
    • String
    • 测试门店
    • 门店名称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    ShangouTradesSoldGetRequest req = new ShangouTradesSoldGetRequest();
    req.setPageNo(1L);
    req.setPageSize(20L);
    req.setStartCreated(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndCreated(StringUtils.parseDateTime("2000-01-01 23:59:59"));
    req.setStatus("WAIT_SELLER_SEND_GOODS");
    req.setBuyerNick("zhangsan");
    req.setBuyerOpenId("AAHm5d-EAAeGwJedwSHpg8bT");
    ShangouTradesSoldGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <shangou_trades_sold_get_response>
        <total_results>100</total_results>
        <trades>
            <order_detail_d_t_o>
                <seller_nick>我在测试</seller_nick>
                <buyer_open_uid>AAHk5d-EAAeGwJedwSFu0XXX</buyer_open_uid>
                <created>2000-01-01 00:00:00</created>
                <tid>2231958349</tid>
                <buyer_nick>我**</buyer_nick>
                <status>WAIT_SELLER_SEND_GOODS</status>
                <payment>200.07</payment>
                <total_fee>200.07</total_fee>
                <post_fee>200.07</post_fee>
                <receiver_state>浙江省</receiver_state>
                <receiver_city>杭州市</receiver_city>
                <receiver_district>西湖区</receiver_district>
                <receiver_town>三墎镇</receiver_town>
                <orders>
                    <order_detail_d_t_o>
                        <oid>2231958349</oid>
                        <num_iid>3424234</num_iid>
                        <title>山寨版测试机器</title>
                        <sku_properties_name>颜色:桔色;尺码:M</sku_properties_name>
                        <price>200.07</price>
                        <num>1</num>
                        <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
                        <refund_id>2231958349</refund_id>
                        <refund_status>SUCCESS(退款成功)</refund_status>
                    </order_detail_d_t_o>
                </orders>
                <store_code>TB_XSD_11426202</store_code>
                <store_name>测试门店</store_name>
            </order_detail_d_t_o>
        </trades>
    </shangou_trades_sold_get_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

    返回
    顶部