taobao.open.trades.sold.get (查询卖家已卖出的交易数据(商家应用使用))

搜索当前会话用户作为卖家已卖出的交易数据(只能获取到三个月以内的交易信息)
1. 返回的数据结果是以订单的创建时间倒序排列的。
注意:type字段的说明,如果该字段不传,接口默认只查4种类型订单,非默认查询的订单是不返回。遇到订单查不到的情况的,通常都是这个原因造成。解决办法就是type加上订单类型就可正常返回了。
2.入参fields中传入buyer_nick ,才能返回buyer_open_id

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 tid,type,status,payment,orders,rx_audit_status,buyer_nick 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。rx_audit_status=0,处方药未审核
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 可选 ALL_WAIT_PAY 交易状态(查看可选值),默认查询所有交易状态的数据,除了默认值外每次只能查询一种状态。
type String 可选 game_equipment 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade,auto_delivery,ec,cod,step 这5 种的交易类型的数据;查询所有交易类型的数据,需要设置下面全部可选值。可选值:fixed(一口价)auction(拍卖)guarantee_trade(一口价、拍卖)step(分阶段付款,万人团,阶梯团订单)independent_simple_trade(旺店入门版交易)independent_shop_trade(旺店标准版交易)auto_delivery(自动发货)ec(直冲)cod(货到付款)game_equipment(游戏装备)shopex_trade(ShopEX交易)netcn_trade(万网交易)external_trade(统一外部交易)instant_trade (即时到账)b2c_cod(大商家货到付款)hotel_trade(酒店类型交易)super_market_trade(商超交易)super_market_cod_trade(商超货到付款交易)taohua(淘花网交易类型)waimai(外卖交易类型)o2o_offlinetrade(O2O交易)nopaid(即时到帐/趣味猜交易类型)step (万人团) eticket(电子凭证) tmall_i18n(天猫国际);nopaid (无付款交易)insurance_plus(保险)finance(基金)注:guarantee_trade是一个组合查询条件,并不是一种交易类型,获取批量或单个订单中不会返回此种类型的订单。pre_auth_type(预授权0元购) lazada(获取lazada订单类型)
page_no Number 可选 1
  • 默认值:1
  • 页码。取值范围:大于零的整数; 默认值:1
    page_size Number 可选 40
  • 默认值:40
  • 每页条数。取值范围:大于零的整数; 默认值:40;最大值:100
    use_has_next Boolean 可选 true
  • 默认值:false
  • 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,接口调用成功率在原有的基础上有所提升。
    buyer_open_id String 可选 AAHm5d-EAAeGwJedwSHpg8bT 买家的openId

    响应参数

    名称 类型 示例值 描述
    total_results Number 100 搜索到的交易信息总数
    has_next Boolean true 是否存在下一页
    trades Trade [] 搜索到的交易信息列表,返回的Trade和Order中包含的具体信息为入参fields请求的字段信息
    • └ tid
    • String
    • 2231958349
    • 交易编号 (父订单的交易编号)
    • └ num
    • Number
    • 1
    • 商品购买数量。取值范围:大于零的整数,对于一个trade对应多个order的时候(一笔主订单,对应多笔子订单),num=0,num是一个跟商品关联的属性,一笔订单对应多比子订单的时候,主订单上的num无意义。
    • └ num_iid
    • Number
    • 3424234
    • 商品数字编号
    • └ status
    • String
    • TRADE_NO_CREATE_PAY
    • 交易状态。可选值: * TRADE_NO_CREATE_PAY(没有创建支付宝交易) * WAIT_BUYER_PAY(等待买家付款) * SELLER_CONSIGNED_PART(卖家部分发货) * WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) * WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) * TRADE_BUYER_SIGNED(买家已签收,货到付款专用) * TRADE_FINISHED(交易成功) * TRADE_CLOSED(付款以后用户退款成功,交易自动关闭) * TRADE_CLOSED_BY_TAOBAO(付款以前,卖家或买家主动关闭交易) * PAY_PENDING(国际信用卡支付付款确认中) * WAIT_PRE_AUTH_CONFIRM(0元购合约中) * PAID_FORBID_CONSIGN(拼团中订单或者发货强管控的订单,已付款但禁止发货)
    • └ type
    • String
    • fixed(一口价)
    • 交易类型列表,同时查询多种交易类型可用逗号分隔。默认同时查询guarantee_trade, auto_delivery, ec, cod的4种交易类型的数据 可选值 fixed(一口价) auction(拍卖) guarantee_trade(一口价、拍卖) auto_delivery(自动发货) independent_simple_trade(旺店入门版交易) independent_shop_trade(旺店标准版交易) ec(直冲) cod(货到付款) fenxiao(分销) game_equipment(游戏装备) shopex_trade(ShopEX交易) netcn_trade(万网交易) external_trade(统一外部交易)o2o_offlinetrade(O2O交易)step (万人团)nopaid(无付款订单)pre_auth_type(预授权0元购机交易)
    • └ price
    • String
    • 200.07
    • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ total_fee
    • String
    • 200.07
    • 商品金额(商品价格乘以数量的总金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ created
    • String
    • 2000-01-01 00:00:00
    • 交易创建时间。格式:yyyy-MM-dd HH:mm:ss
    • orders
    • Order []
    • 订单列表
    • └ outer_iid
    • String
    • 152e442aefe88dd41cb0879232c0dcb0
    • 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id,可以通过taobao.items.custom.get获取商品的Item的信息
    • └ oid
    • String
    • 2231958349
    • 子订单编号
    • └ status
    • String
    • TRADE_NO_CREATE_PAY
    • 订单状态
    • └ price
    • String
    • 200.07
    • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ num_iid
    • Number
    • 2342344
    • 商品数字ID
    • └ sku_id
    • String
    • 5937146
    • 商品的最小库存单位Sku的id.可以通过taobao.item.sku.get获取详细的Sku信息
    • └ num
    • Number
    • 1
    • 购买数量。取值范围:大于零的整数
    • └ outer_sku_id
    • String
    • 81893848
    • 外部网店自己定义的Sku编号
    • └ total_fee
    • String
    • 200.07
    • 应付金额(商品价格 * 商品数量 + 手工调整金额 - 子订单级订单优惠金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ pic_path
    • String
    • http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
    • 商品图片的绝对路径
    • └ title
    • String
    • 测试机器
    • 商品标题
    • └ refund_id
    • Number
    • 2231958349
    • 最近退款的id
    • └ refund_status
    • String
    • SUCCESS(退款成功)
    • 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
    • └ payment
    • String
    • 25
    • 实付金额
    • └ buyer_open_uid
    • String
    • AAER5d-EAAeGwJedwSHvQhrl
    • 买家的openuid。入参fields中传入buyer_nick获取
    • └ step_trade_status
    • String
    • FRONT_NOPAID_FINAL_NOPAID
    • 分阶段付款的订单状态(例如万人团订单等),目前有三返回状态FRONT_NOPAID_FINAL_NOPAID(定金未付尾款未付),FRONT_PAID_FINAL_NOPAID(定金已付尾款未付),FRONT_PAID_FINAL_PAID(定金和尾款都付)
    • └ step_paid_fee
    • String
    • 525.70
    • 分阶段付款的已付金额(万人团订单已付金额)
    • └ pay_time
    • String
    • 2000-01-01 00:00:00
    • 付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。
    • └ payment
    • String
    • 25
    • 实付金额

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    OpenTradesSoldGetRequest req = new OpenTradesSoldGetRequest();
    req.setFields("tid,type,status,payment,orders,rx_audit_status,buyer_nick");
    req.setStartCreated(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndCreated(StringUtils.parseDateTime("2000-01-01 23:59:59"));
    req.setStatus("ALL_WAIT_PAY");
    req.setType("game_equipment");
    req.setPageNo(1L);
    req.setPageSize(40L);
    req.setUseHasNext(true);
    req.setBuyerOpenId("AAHm5d-EAAeGwJedwSHpg8bT");
    req.setBuyerNick("zhangsan");
    OpenTradesSoldGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <open_trades_sold_get_response>
        <total_results>100</total_results>
        <has_next>true</has_next>
        <trades>
            <trade>
                <tid>2231958349</tid>
                <num>1</num>
                <num_iid>3424234</num_iid>
                <status>TRADE_NO_CREATE_PAY</status>
                <type>fixed(一口价)</type>
                <price>200.07</price>
                <total_fee>200.07</total_fee>
                <created>2000-01-01 00:00:00</created>
                <orders>
                    <order>
                        <outer_iid>152e442aefe88dd41cb0879232c0dcb0</outer_iid>
                        <oid>2231958349</oid>
                        <status>TRADE_NO_CREATE_PAY</status>
                        <price>200.07</price>
                        <num_iid>2342344</num_iid>
                        <sku_id>5937146</sku_id>
                        <num>1</num>
                        <outer_sku_id>81893848</outer_sku_id>
                        <total_fee>200.07</total_fee>
                        <pic_path>http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg</pic_path>
                        <title>测试机器</title>
                        <refund_id>2231958349</refund_id>
                        <refund_status>SUCCESS(退款成功)</refund_status>
                        <payment>25</payment>
                    </order>
                </orders>
                <buyer_open_uid>AAER5d-EAAeGwJedwSHvQhrl</buyer_open_uid>
                <step_trade_status>FRONT_NOPAID_FINAL_NOPAID</step_trade_status>
                <step_paid_fee>525.70</step_paid_fee>
                <pay_time>2000-01-01 00:00:00</pay_time>
                <payment>25</payment>
            </trade>
        </trades>
    </open_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.invalid-parameter:buyer_nick 用户不存在【***】 通过简单的判断可以减少此类错误:排除特殊字符的昵称,如包含空格,冒号之类的昵称或排除字符长度小于5个,大于20个的
    isv.invalid-parameter:seller_nick 参数:seller_nick无效,格式不对、非法值、越界等 请填写正确的nick
    isp.remote-service-timeout API调用远程服务超时 1. 每次返回50条以下,时间跨度小于半个小时 2. 避开交易高峰期上午9:30-11:00,下午14:00-17:00,晚上20:00-22:30 3.使用增量API(taobao.increment.trades.get)可以减少甚至避免超时问题
    isv.trade-service-rejection 请求被拒绝。 可能原因为限流,请不要频繁调用,尽量避开高峰期。
    isp.trade-service-readdb-overflow 数据库限流。 请求量较大,请避开高峰期。
    isv.trade-service-access-frequency 服务访问频繁 请稍后重试
    isv.invalid-parameter:start_created-or-end_created 不合法的参数 创建时间和结束时间不能为空
    isv.invalid-parameter:seller-id 非法的参数 卖家ID非法
    isp.call-limited 限流 避开限流

    API工具

    如何获得此API

    FAQ

    返回
    顶部