关于主流电商平台|淘宝|拼多多|抖音|1688官方平台接口的接入和返回

taobao.trades.sold.get( 查询卖家已卖出的交

搜索当前会话用户作为卖家已卖出的交易数据（只能获取到三个月以内的交易信息）
1. 返回的数据结果是以订单的创建时间倒序排列的。
2. 返回的数据结果只包含了订单的部分数据，可通过taobao.trade.fullinfo.get获取订单详情。
注意：type字段的说明，如果该字段不传，接口默认只查4种类型订单，其他非默认查询的订单需要在type加上对应订单类型才能返回。

公共参数

请求地址:

环境	HTTP地址	HTTPS地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数:

名称	类型	必须	描述
method	String	是	API接口名称，例如:taobao.trades.sold.get
app_key	String	是	TOP分配给应用的AppKey，例如：12345678
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟
v	String	是	API协议版本，可选值：2.0
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5，hmac-sha256。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false

公共响应参数:

名称	类型	描述
request_id	String	平台颁发的每次请求访问的唯一标识
error_response	String	请求访问失败时返回的根节点
code	String	请求失败返回的错误码
msg	String	请求失败返回的错误信息
sub_code	String	请求失败返回的子错误码
sub_msg	String	请求失败返回的子错误信息
***_response	String	请求成功返回的根节点，'***' 为API名称的下划线模式

请求参数

名称

类型

必须

示例值

描述

fields

String

true

tid,type,status,payment,orders,rx_audit_status

需要返回的字段列表，多个字段用半角逗号分隔，可选值为返回示例中能看到的所有字段。rx_audit_status=0,处方药未审核

start_created

Date

false

2000-01-01 00:00:00

查询三个月内交易创建时间开始。格式:yyyy-MM-dd HH:mm:ss

end_created

Date

false

2000-01-01 23:59:59

查询交易创建时间结束。格式:yyyy-MM-dd HH:mm:ss

status

String

false

ALL_WAIT_PAY

交易状态），默认查询所有交易状态的数据，除了默认值外每次只能查询一种状态。

buyer_nick

String

false

zhangsan

买家昵称

type

String

false

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订单类型）

ext_type

String

false

service

可选值有ershou(二手市场的订单）,service（商城服务子订单）mark（双十一大促活动异常订单）作为扩展类型筛选只能做单个ext_type查询，不能全部查询所有的ext_type类型

rate_status

String

false

RATE_UNBUYER

评价状态，默认查询所有评价状态的数据，除了默认值外每次只能查询一种状态。
可选值：RATE_UNBUYER(买家未评)RATE_UNSELLER(卖家未评)RATE_BUYER_UNSELLER(买家已评，卖家未评)RATE_UNBUYER_SELLER(买家未评，卖家已评)RATE_BUYER_SELLER(买家已评,卖家已评)

tag

String

false

time_card

卖家对交易的自定义分组标签，目前可选值为：time_card（点卡软件代充），fee_card（话费软件代充）

page_no

Number

false

页码。默认值:1，可填整数，通过传入page_no来控制获取的页数，总页数=total_results÷page_size

page_size

Number

false

每页条数。默认值:40;最大值:100，可填整数。通过page_no和page_size组合多次调用实现翻页获取全量数据。

use_has_next

Boolean

false

true

是否启用has_next的分页方式，如果指定true,则返回的结果中不包含总记录数，但是会新增一个是否存在下一页的的字段，通过此种方式获取增量交易，接口调用成功率在原有的基础上有所提升。

buyer_open_id

String

false

AAHm5d-EAAeGwJedwSHpg8bT

买家的openId

响应参数

名称

类型

示例值

描述

total_results

Number

100

搜索到的交易信息总数

trades

Trade []

搜索到的交易信息列表，返回的Trade和Order中包含的具体信息为入参fields请求的字段信息

seller_nick

String

我在测试

卖家昵称

buyer_open_uid

String

AAHk5d-EAAeGwJedwSFu0XXX

买家OpenUid

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元购机交易)

created

Date

2000-01-01 00:00:00

交易创建时间。格式:yyyy-MM-dd HH:mm:ss

tid

Number

2231958349

交易编号 (父订单的交易编号)

acookie_id

String

1a11a0987628772c002ec7d0eec2a352

Acookie订单唯一ID。

sid

String

NP1021246146

物流运单号

seller_rate

Boolean

true

卖家是否已评价。可选值:true(已评价),false(未评价)

buyer_rate

Boolean

true

买家是否已评价。可选值:true(已评价),false(未评价)。如买家只评价未打分，此字段仍返回false

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(拼团中订单或者发货强管控的订单，已付款但禁止发货)

payment

String

200.07

实付金额。精确到2位小数;单位:元。如:200.07，表示:200元7分

discount_fee

String

200.07

建议使用trade.promotion_details查询系统优惠系统优惠金额（如打折，VIP，满就送等），精确到2位小数，单位：元。如：200.07，表示：200元7分

adjust_fee

String

200.07

卖家手工调整金额，精确到2位小数，单位：元。如：200.07，表示：200元7分。来源于订单价格修改，如果有多笔子订单的时候，这个为0，单笔的话则跟[order].adjust_fee一样

post_fee

String

200.07

邮费。精确到2位小数;单位:元。如:200.07，表示:200元7分

total_fee

String

200.07

商品金额（商品价格乘以数量的总金额）。精确到2位小数;单位:元。如:200.07，表示:200元7分

pay_time

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

modified

Date

2000-01-01 00:00:00

交易修改时间(用户对订单的任何修改都会更新此字段)。格式:yyyy-MM-dd HH:mm:ss

async_modified

Date

2000-01-01 00:00:00

同步到卖家库的时间，taobao.trades.sold.incrementv.get接口返回此字段

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分

commission_fee

String

200.07

交易佣金。精确到2位小数;单位:元。如:200.07，表示:200元7分

alipay_no

String

2009112081173831

支付宝交易号，如：2009112081173831

alipay_id密文

Number

2011082299567459

买家的支付宝id号，在UIC中有记录，买家支付宝的唯一标示，不因为买家更换Email账号而改变。

buyer_area

String

浙江省杭州市

买家下单的地区

nut_feature

String

;buyernick:tester;card:123;buyerArea:杭州

卡易售垂直表信息，去除下单ip之后的结果

pic_path

String

http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg

商品图片绝对途径

num_iid

Number

3424234

商品数字编号

price

String

200.07

商品价格。精确到2位小数；单位：元。如：200.07，表示：200元7分

cod_fee

String

12.07

货到付款服务费。精确到2位小数;单位:元。如:12.07，表示:12元7分。

cod_status

String

EW_CREATED(订单已创建)

货到付款物流状态。初始状态 NEW_CREATED,接单成功 ACCEPTED_BY_COMPANY,接单失败 REJECTED_BY_COMPANY,接单超时 RECIEVE_TIMEOUT,揽收成功 TAKEN_IN_SUCCESS,揽收失败 TAKEN_IN_FAILED,揽收超时 TAKEN_TIMEOUT,签收成功 SIGN_IN,签收失败 REJECTED_BY_OTHER_SIDE,订单等待发送给物流公司 WAITING_TO_BE_SENT,用户取消物流订单 CANCELED

shipping_type

String

free

创建交易时的物流方式（交易完成前，物流方式有可能改变，但系统里的这个字段一直不变）。可选值：free(卖家包邮),post(平邮),express(快递),ems(EMS),virtual(虚拟发货)，25(次日必达)，26(预约配送)。

num

Number

商品购买数量。取值范围：大于零的整数,对于一个trade对应多个order的时候（一笔主订单，对应多笔子订单），num=0，num是一个跟商品关联的属性，一笔订单对应多比子订单的时候，主订单上的num无意义。

point_fee

Number

买家使用积分,下单时生成，且一直不变。格式:100;单位:个.

real_point_fee

Number

买家实际使用积分（扣除部分退款使用的积分），交易完成后生成（交易成功或关闭），交易未完成时该字段值为0。格式:100;单位:个

buyer_obtain_point_fee

Number

买家获得积分,返点的积分。格式:100;单位:个。返点的积分要交易成功之后才能获得。

receiver_name

String

****东方

收货人的姓名(加密)

receiver_state

String

浙江省

收货人的所在省份

receiver_city

String

杭州市

收货人的所在城市
注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的receiver_city的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了receiver_district里面
建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有receiver_district参数，该参数作为城市

receiver_district

String

西湖区

收货人的所在地区
注：因为国家对于城市和地区的划分的有：省直辖市和省直辖县级行政区（区级别的）划分的，淘宝这边根据这个差异保存在不同字段里面比如：广东广州：广州属于一个直辖市是放在的receiver_city的字段里面；而河南济源：济源属于省直辖县级行政区划分，是区级别的，放在了receiver_district里面
建议：程序依赖于城市字段做物流等判断的操作，最好加一个判断逻辑：如果返回值里面只有receiver_district参数，该参数作为城市

receiver_town

String

三墎镇

收货人街道地址

receiver_address

String

****淘宝城

收货人的详细地址(加密)

receiver_zip

String

223700

收货人的邮编

receiver_mobile

String

****1826

收货人的手机号码(加密)

receiver_phone

String

****5372

收货人的电话号码(加密)

seller_flag

Number

卖家备注旗帜（与淘宝网上订单的卖家备注旗帜对应，只有卖家才能查看该字段）红、黄、绿、蓝、紫分别对应 1、2、3、4、5

is_lgtype

Boolean

true

是否保障速递，如果为true，则为保障速递订单，使用线下联系发货接口发货，如果未false，则该订单非保障速递，根据卖家设置的订单流转规则可使用物流宝或者常规物流发货。

lg_aging_type

String

次日达

次日达，三日达等送达类型

lg_aging

String

2012-06-19 15:16:14

次日达订单送达时间

is_brand_sale

Boolean

true

表示是否是品牌特卖（常规特卖，不包括特卖惠和特实惠）订单，如果是返回true，如果不是返回false。当此字段与is_force_wlb均为true时，订单强制物流宝发货。

is_force_wlb

Boolean

true

订单是否强制使用物流宝发货。当此字段与is_brand_sale均为true时，订单强制物流宝发货。此字段为false时，该订单根据流转规则设置可以使用物流宝或者常规方式发货

has_buyer_message

Boolean

true

判断订单是否有买家留言，有买家留言返回true，否则返回false

credit_card_fee

String

30.5

使用信用卡支付金额数

trade_from

String

WAP,JHS

交易内部来源。WAP(手机);HITAO(嗨淘);TOP(TOP平台);TAOBAO(普通淘宝);JHS(聚划算)一笔订单可能同时有以上多个标记，则以逗号分隔

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

该订单需要延长收货时间

订单出现异常问题的时候，给予用户的描述,没有异常的时候，此值为空

has_yfx

Boolean

true

订单中是否包含运费险订单，如果包含运费险订单返回true，不包含运费险订单，返回false

yfx_fee

String

0.50

订单的运费险，单位为元

yfx_id

String

135751716473138

运费险支付号

yfx_type

String

taojinbi

运费险类型

trade_source

String

ownshop

交易外部来源：ownshop(商家官网)

send_time

String

2000-01-01

订单将在此时间前发出，主要用于预售订单

seller_can_rate

Boolean

true

卖家是否可以对订单进行评价

is_part_consign

Boolean

true

是否是多次发货的订单如果卖家对订单进行多次发货，则为true否则为false

is_wt

Boolean

true

表示订单交易是否网厅订单。如果该订单是网厅订单，那么该值为true；反之，该值为false。

is_daixiao

Boolean

true

表示订单交易是否含有对应的代销采购单。如果该订单中存在一个对应的代销采购单，那么该值为true；反之，该值为false。

o2o

String

crm

导购宝=crm

o2o_guide_id

String

123456

导购员id

o2o_guide_name

String

西湖门店导购员1

导购员名称

o2o_shop_id

String

123456

导购员门店id

o2o_shop_name

String

西湖门店

导购门店名称

o2o_delivery

String

inshop

导购宝提货方式，inshop：店内提货，online：线上发货

o2o_out_trade_id

String

123456

外部订单号

orders

Order[]

订单列表

title

String

山寨版测试机器

商品标题

pic_path

String

http://img08.taobao.net/bao/uploaded/i8/T1jVXXXePbXXaoPB6a_091917.jpg

商品图片的绝对路径

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信息

outer_iid

String

152e442aefe88dd41cb0879232c0dcb0

商家外部编码(可与商家外部系统对接)。外部商家自己定义的商品Item的id，可以通过taobao.items.custom.get获取商品的Item的信息

outer_sku_id

String

81893848

外部网店自己定义的Sku编号

refund_status

String

SUCCESS(退款成功)

退款状态。退款状态。可选值 WAIT_SELLER_AGREE(买家已经申请退款，等待卖家同意) WAIT_BUYER_RETURN_GOODS(卖家已经同意退款，等待买家退货) WAIT_SELLER_CONFIRM_GOODS(买家已经退货，等待卖家确认收货) SELLER_REFUSE_BUYER(卖家拒绝退款) CLOSED(退款关闭) SUCCESS(退款成功)

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(国际信用卡支付付款确认中)

oid

Number

2231958349

子订单编号

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;单位:元;精确到小数点后两位.

divide_order_fee

String

21.00

分摊之后的实付金额