taobao.trades.sold.increment.get (查询卖家已卖出的增量交易数据(根据修改时间))

搜索当前会话用户作为卖家已卖出的增量交易数据(只能获取到三个月以内的交易信息)
1. 一次请求只能查询时间跨度为一天的增量交易记录,即end_modified - start_modified <= 1天。
2. 返回的数据结果是以订单的修改时间倒序排列的,通过从后往前翻页的方式可以避免漏单问题。
3. 返回的数据结果只包含了订单的部分数据,可通过taobao.trade.fullinfo.get获取订单详情。
点击查看更多交易API说明

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fields String 必须 tid,type,status,payment,orders,rx_audit_status 需要返回的字段列表,多个字段用半角逗号分隔,可选值为返回示例中能看到的所有字段。rx_audit_status=0为处方药未审核状态
start_modified Date 必须 2000-01-01 00:00:00 查询修改开始时间(修改时间跨度不能大于一天)。格式:yyyy-MM-dd HH:mm:ss
end_modified Date 必须 2000-01-02 00:00:00 查询修改结束时间,必须大于修改开始时间(修改时间跨度不能大于一天),格式:yyyy-MM-dd HH:mm:ss。建议使用30分钟以内的时间跨度,能大大提高响应速度和成功率
status String 可选 TRADE_NO_CREATE_PAY 交易状态(查看可选值),默认查询所有交易状态的数据,除了默认值外每次只能查询一种状态。
type String 可选 fixed 交易类型列表(查看可选值),一次查询多种类型可用半角逗号分隔,默认同时查询guarantee_trade,auto_delivery,ec,cod,step这5种类型的数据。
buyer_nick String 可选 zhangsan 买家昵称
ext_type String 可选 service 可选值有ershou(二手市场的订单),service(商城服务子订单)mark(双十一大促活动异常订单)作为扩展类型筛选只能做单个ext_type查询,不能全部查询所有的ext_type类型
tag String 可选 time_card 卖家对交易的自定义分组标签,目前可选值为:time_card(点卡软件代充),fee_card(话费软件代充)
page_no Number 可选 1
  • 默认值:1
  • 页码。取值范围:大于零的整数;默认值:1。注:必须采用倒序的分页方式(从最后一页往回取)才能避免漏单问题。
    page_size Number 可选 40
  • 默认值:40
  • 每页条数。取值范围:1~100,默认值:40。建议使用40~50,可以提高成功率,减少超时数量
    use_has_next Boolean 可选 true
  • 默认值:false
  • 是否启用has_next的分页方式,如果指定true,则返回的结果中不包含总记录数,但是会新增一个是否存在下一页的的字段,通过此种方式获取增量交易,效率在原有的基础上有80%的提升
    buyer_open_uid String 可选 AAHm5d-EAAeGwJedwSHpg8bT 买家openId

    响应参数

    名称 类型 示例值 描述
    total_results Number 100 搜索到的交易信息总数
    trades Trade [] 搜索到的交易信息列表,返回的Trade和Order中包含的具体信息为入参fields请求的字段信息
    • └ seller_nick
    • String
    • 我在测试
    • 卖家昵称
    • └ pic_path
    • String
    • http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
    • 商品图片绝对途径
    • └ payment
    • String
    • 200.07
    • 实付金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ seller_rate
    • Boolean
    • true
    • 卖家是否已评价。可选值:true(已评价),false(未评价)
    • └ post_fee
    • String
    • 200.07
    • 邮费。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ receiver_name
    • String
    • 东方不败
    • 收货人的姓名
    • └ receiver_state
    • String
    • 浙江省
    • 收货人的所在省份
    • └ receiver_address
    • String
    • 淘宝城911号
    • 收货人的详细地址
    • └ receiver_zip
    • String
    • 223700
    • 收货人的邮编
    • └ receiver_mobile
    • String
    • 13512501826
    • 收货人的手机号码
    • └ receiver_phone
    • String
    • 13819175372
    • 收货人的电话号码
    • └ consign_time
    • Date
    • 2000-01-01 00:00:00
    • 卖家发货时间。格式:yyyy-MM-dd HH:mm:ss
    • └ received_payment
    • String
    • 200.07
    • 卖家实际收到的支付宝打款金额(由于子订单可以部分确认收货,这个金额会随着子订单的确认收货而不断增加,交易成功后等于买家实付款减去退款金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ receiver_country
    • String
    • 中国
    • 收货人国籍
    • └ receiver_town
    • String
    • 三墎镇
    • 收货人街道地址
    • └ order_tax_fee
    • String
    • 0
    • 天猫国际官网直供主订单关税税费
    • └ tid
    • Number
    • 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(拼团中订单或者发货强管控的订单,已付款但禁止发货)
    • └ title
    • String
    • 麦包包
    • 交易标题,以店铺名作为此标题的值。注:taobao.trades.get接口返回的Trade中的title是商品名称
    • └ 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分
    • └ discount_fee
    • String
    • 200.07
    • 可以使用trade.promotion_details查询系统优惠系统优惠金额(如打折,VIP,满就送等),精确到2位小数,单位:元。如:200.07,表示:200元7分
    • └ total_fee
    • String
    • 200.07
    • 商品金额(商品价格乘以数量的总金额)。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 交易创建时间。格式:yyyy-MM-dd HH:mm:ss
    • └ pay_time
    • Date
    • 2000-01-01 00:00:00
    • 付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss
    • └ end_time
    • Date
    • 2000-01-01 00:00:00
    • 交易结束时间。交易成功时间(更新交易状态为成功的同时更新)/确认收货时间或者交易关闭时间 。格式:yyyy-MM-dd HH:mm:ss
    • └ seller_flag
    • Number
    • 1
    • 卖家备注旗帜(与淘宝网上订单的卖家备注旗帜对应,只有卖家才能查看该字段)红、黄、绿、蓝、紫 分别对应 1、2、3、4、5
    • └ buyer_nick
    • String
    • 我在测试
    • 买家昵称
    • └ has_buyer_message
    • Boolean
    • true
    • 判断订单是否有买家留言,有买家留言返回true,否则返回false
    • └ credit_card_fee
    • String
    • 30.5
    • 使用信用卡支付金额数
    • └ 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
    • 分阶段付款的已付金额(万人团订单已付金额)
    • └ mark_desc
    • String
    • 该订单需要延长收货时间
    • 订单出现异常问题的时候,给予用户的描述,没有异常的时候,此值为空
    • └ buyer_open_uid
    • String
    • AAHk5d-EAAeGwJedwSFu0XXX
    • 买家OpenUid
    • └ shipping_type
    • String
    • free
    • 创建交易时的物流方式(交易完成前,物流方式有可能改变,但系统里的这个字段一直不变)。可选值:free(卖家包邮),post(平邮),express(快递),ems(EMS),virtual(虚拟发货),25(次日必达),26(预约配送)。
    • └ adjust_fee
    • String
    • 200.07
    • 卖家手工调整金额,精确到2位小数,单位:元。如:200.07,表示:200元7分。来源于订单价格修改,如果有多笔子订单的时候,这个为0,单笔的话则跟[order].adjust_fee一样
    • service_orders
    • ServiceOrder []
    • 服务子订单列表
    • └ oid
    • Number
    • 110770592823138
    • 虚拟服务子订单订单号
    • └ item_oid
    • Number
    • 110770592803138
    • 服务所属的交易订单号。如果服务为一年包换,则item_oid这笔订单享受改服务的保护
    • └ service_id
    • Number
    • 2342344
    • 服务数字id
    • └ service_detail_url
    • String
    • http://wt.taobao.com/plan.htm?plan_id=planId
    • 服务详情的URL地址
    • └ num
    • Number
    • 1
    • 购买数量,取值范围为大于0的整数
    • └ price
    • String
    • 39.09
    • 服务价格,精确到小数点后两位:单位:元
    • └ payment
    • String
    • 29.98
    • 子订单实付金额。精确到2位小数,单位:元。如:200.07,表示:200元7分。
    • └ title
    • String
    • 滚筒洗衣机
    • 商品名称
    • └ total_fee
    • String
    • 39.09
    • 服务子订单总费用
    • └ buyer_nick
    • String
    • 小倩2005
    • 卖家昵称
    • └ refund_id
    • String
    • 2231958349
    • 最近退款的id
    • └ seller_nick
    • String
    • 麦包包
    • 卖家昵称
    • └ pic_path
    • String
    • http://img08.taobao.com/bao/upload/i8/T1jVXXXePb_a0908.jpg
    • 服务图片地址
    • └ tmser_spu_code
    • String
    • 家装干支装服务
    • 支持家装类物流的类型
    • └ buyer_rate
    • Boolean
    • true
    • 买家是否已评价。可选值:true(已评价),false(未评价)。如买家只评价未打分,此字段仍返回false
    • └ receiver_city
    • String
    • 杭州市
    • 收货人的所在城市
      注:因为国家对于城市和地区的划分的有:省直辖市和省直辖县级行政区(区级别的)划分的,淘宝这边根据这个差异保存在不同字段里面比如:广东广州:广州属于一个直辖市是放在的receiver_city的字段里面;而河南济源:济源属于省直辖县级行政区划分,是区级别的,放在了receiver_district里面
      建议:程序依赖于城市字段做物流等判断的操作,最好加一个判断逻辑:如果返回值里面只有receiver_district参数,该参数作为城市
    • └ receiver_district
    • String
    • 西湖区
    • 收货人的所在地区
      注:因为国家对于城市和地区的划分的有:省直辖市和省直辖县级行政区(区级别的)划分的,淘宝这边根据这个差异保存在不同字段里面比如:广东广州:广州属于一个直辖市是放在的receiver_city的字段里面;而河南济源:济源属于省直辖县级行政区划分,是区级别的,放在了receiver_district里面
      建议:程序依赖于城市字段做物流等判断的操作,最好加一个判断逻辑:如果返回值里面只有receiver_district参数,该参数作为城市
    • orders
    • Order []
    • 订单列表
    • └ item_meal_name
    • String
    • M8原装电池:便携支架:M8专用座充:莫凡保护袋
    • 套餐的值。如:M8原装电池:便携支架:M8专用座充:莫凡保护袋
    • └ pic_path
    • String
    • http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg
    • 商品图片的绝对路径
    • └ refund_status
    • String
    • SUCCESS(退款成功)
    • 退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货,等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)
    • └ outer_iid
    • String
    • 152e442aefe88dd41cb0879232c0dcb0
    • 商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id,可以通过taobao.items.custom.get获取商品的Item的信息
    • └ buyer_rate
    • Boolean
    • true
    • 买家是否已评价。可选值:true(已评价),false(未评价)
    • └ seller_rate
    • Boolean
    • true
    • 卖家是否已评价。可选值:true(已评价),false(未评价)
    • └ seller_type
    • String
    • B(商城商家)
    • 卖家类型,可选值为:B(商城商家),C(普通卖家)
    • └ cid
    • Number
    • 123456
    • 交易商品对应的类目ID
    • └ sub_order_tax_fee
    • String
    • 0
    • 天猫国际官网直供子订单关税税费
    • └ sub_order_tax_rate
    • String
    • 0
    • 天猫国际官网直供子订单关税税率
    • └ oid
    • Number
    • 2231958349
    • 子订单编号
    • └ status
    • String
    • TRADE_NO_CREATE_PAY
    • 订单状态(请关注此状态,如果为TRADE_CLOSED_BY_TAOBAO状态,则不要对此订单进行发货,切记啊!)。可选值:
      • TRADE_NO_CREATE_PAY(没有创建支付宝交易)
      • WAIT_BUYER_PAY(等待买家付款)
      • WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款)
      • WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货)
      • TRADE_BUYER_SIGNED(买家已签收,货到付款专用)
      • TRADE_FINISHED(交易成功)
      • TRADE_CLOSED(付款以后用户退款成功,交易自动关闭)
      • TRADE_CLOSED_BY_TAOBAO(付款以前,卖家或买家主动关闭交易)
      • PAY_PENDING(国际信用卡支付付款确认中)
    • └ title
    • String
    • 山寨版测试机器
    • 商品标题
    • └ price
    • String
    • 200.07
    • 商品价格。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ num_iid
    • Number
    • 2342344
    • 商品数字ID
    • └ item_meal_id
    • Number
    • 2564854632
    • 套餐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分
    • └ payment
    • String
    • 200.07
    • 子订单实付金额。精确到2位小数,单位:元。如:200.07,表示:200元7分。对于多子订单的交易,计算公式如下:payment = price * num + adjust_fee - discount_fee ;单子订单交易,payment与主订单的payment一致,对于退款成功的子订单,由于主订单的优惠分摊金额,会造成该字段可能不为0.00元。建议使用退款前的实付金额减去退款单中的实际退款金额计算。
    • └ discount_fee
    • String
    • 200.07
    • 子订单级订单优惠金额。精确到2位小数;单位:元。如:200.07,表示:200元7分
    • └ adjust_fee
    • String
    • 1.01
    • 手工调整金额.格式为:1.01;单位:元;精确到小数点后两位.
    • └ sku_properties_name
    • String
    • 颜色:桔色;尺码:M
    • SKU的值。如:机身颜色:黑色;手机套餐:官方标配
    • └ refund_id
    • String
    • 2231958349
    • 最近退款ID
    • └ is_service_order
    • Boolean
    • true
    • 是否是服务订单,是返回true,否返回false。
    • └ end_time
    • Date
    • 2012-04-07 00:00:00
    • 子订单的交易结束时间说明:子订单有单独的结束时间,与主订单的结束时间可能有所不同,在有退款发起的时候或者是主订单分阶段付款的时候,子订单的结束时间会早于主订单的结束时间,所以开放这个字段便于订单结束状态的判断
    • └ consign_time
    • String
    • 2013-01-13 15:23:00
    • 子订单发货时间,当卖家对订单进行了多次发货,子订单的发货时间和主订单的发货时间可能不一样了,那么就需要以子订单的时间为准。(没有进行多次发货的订单,主订单的发货时间和子订单的发货时间都一样)
    • └ shipping_type
    • String
    • post
    • 子订单的运送方式(卖家对订单进行多次发货之后,一个主订单下的子订单的运送方式可能不同,用order.shipping_type来区分子订单的运送方式)
    • └ bind_oid
    • Number
    • 23194074143138
    • 捆绑的子订单号,表示该子订单要和捆绑的子订单一起发货,用于卖家子订单捆绑发货
    • └ logistics_company
    • String
    • 顺风快递
    • 子订单发货的快递公司名称
    • └ invoice_no
    • String
    • 05432465
    • 子订单所在包裹的运单号
    • └ is_daixiao
    • Boolean
    • true
    • 表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单,那么该值为true;反之,该值为false。
    • └ divide_order_fee
    • String
    • 21.00
    • 分摊之后的实付金额
    • └ part_mjz_discount
    • String
    • 21.00
    • 优惠分摊
    • └ ticket_outer_id
    • String
    • 123456abcd
    • 对应门票有效期的外部id
    • └ ticket_expdate_key
    • String
    • 100FFFFFF02374020000002001020304000A
    • 门票有效期的key
    • └ store_code
    • String
    • 南京QDHEWL-0004
    • 发货的仓库编码
    • └ is_www
    • Boolean
    • true
    • 子订单是否是www订单
    • └ tmser_spu_code
    • String
    • 家装干支装服务
    • 支持家装类物流的类型
    • └ zhengji_status
    • String
    • 1
    • 征集预售订单征集状态:1(征集中),2(征集成功),3(征集失败)
    • └ md_qualification
    • String
    • true_免单原因
    • 免单资格属性
    • └ md_fee
    • String
    • 999
    • 免单金额
    • └ sub_order_tax_promotion_fee
    • String
    • 0
    • 天猫国际子订单计税优惠金额
    • └ tax_coupon_discount
    • String
    • 0
    • 天猫国际订单包税金额
    • └ tax_free
    • Boolean
    • true
    • 天猫国际订单是否包税
    • └ special_refund_type
    • String
    • 特殊的退款类型,比如直播返现、价保
    • └ is_devalue_fee
    • Boolean
    • true
    • 子订单优惠贬值
    • └ is_idle
    • String
    • 1
    • 是否为闲鱼订单,1是,0否
    • └ shop_pick
    • String
    • 1
    • 门店自提,总店发货,分店取货的门店自提订单标识
    • └ rx_audit_status
    • String
    • 0
    • 处方药未审核状态
    • └ post_gate_declare
    • Boolean
    • true
    • 邮关订单
    • └ cross_bonded_declare
    • Boolean
    • false
    • 跨境订单
    • └ order_tax_promotion_fee
    • String
    • 0
    • 天猫国际计税优惠金额
    • └ service_type
    • String
    • timedd,jiaju
    • serviceType
    • └ is_o2o_passport
    • Boolean
    • true
    • 是否是智慧门店订单,只有true,或者 null 两种情况
    • └ oaid
    • String
    • 2w2RYE45iahnF4aiaJ7pHKCJ3Hwnbgnq2PH3AfpQVyWZNHKS9wNgAAOUfCVt9XZMetogNHwc
    • (收货人+手机号+座机+收货地址+create)5个字段组合成oaid,原始订单上座机为空也满足条件,否则生成不了oaid
    • └ no_shipping
    • Boolean
    • false
    • 无物流信息返回true,平台属性,业务不要依赖
    • └ aid
    • String
    • 123123
    • 地址aid字段
    has_next Boolean true 是否存在下一页

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TradesSoldIncrementGetRequest req = new TradesSoldIncrementGetRequest();
    req.setFields("tid,type,status,payment,orders,rx_audit_status");
    req.setStartModified(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setEndModified(StringUtils.parseDateTime("2000-01-02 00:00:00"));
    req.setStatus("TRADE_NO_CREATE_PAY");
    req.setType("fixed");
    req.setBuyerNick("zhangsan");
    req.setExtType("service");
    req.setTag("time_card");
    req.setPageNo(1L);
    req.setRateStatus("RATE_UNBUYER");
    req.setPageSize(40L);
    req.setUseHasNext(true);
    req.setBuyerOpenUid("AAHm5d-EAAeGwJedwSHpg8bT");
    TradesSoldIncrementGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <trades_sold_increment_get_response>
        <total_results>100</total_results>
        <trades>
            <trade>
            </trade>
        </trades>
        <has_next>true</has_next>
    </trades_sold_increment_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:start_modified-and-end_modified 查询条件(修改时间)跨度不能超过一天 只能查询3个月内并且跨度为一天的修改过的数据
    isv.invalid-parameter:buyer_nick buyer_nick无效 请填写正确的buyer_nick。
    isp.call-limited 限流 避开限流
    isv.invalid-parameter:search_limit
    isv.invalid-argument

    API工具

    如何获得此API

    FAQ

    返回
    顶部