淘宝订单API接口获取订单

最新推荐文章于 2026-04-14 15:45:21 发布

原创最新推荐文章于 2026-04-14 15:45:21 发布 · 1.4w 阅读

11 ·

本内容遵循CC 4.0 BY-SA版权协议

淘宝专栏收录该内容

4 篇文章

订阅专栏

本文详细介绍了一个交易数据结构，包括卖家昵称、买家昵称、商品标题等关键字段，以及交易状态、退款状态、支付和邮费等交易详情。此外，还介绍了TaobaokeShop和TaobaokeReportMember的数据结构。

Trade 数据结构

名称	类型	是否隐私	描述
seller_nick	String	Y	卖家昵称
buyer_nick	String	Y	买家昵称
title	String	Y	商品标题
type	String	Y	交易类型
refund_status	String	Y	退款状态.可选值:WAIT_SELLER_AGREE(买家已经申请退款,等待卖家同意),WAIT_BUYER_RETURN_GOODS(卖家已经同意退款,等待买家退货),WAIT_SELLER_CONFIRM_GOODS5(买家已经退货,等待卖家确认收货),CLOSED(退款关闭),SUCCESS(退款成功),SELLER_REFUSE_BUYER(卖家拒绝退款),NO_REFUND(没有退款)
created	Date	Y	交易创建时间。格式:yyyy-MM-dd HH:mm:ss
iid	String	Y	商品Item的id.可以通过 taobao.item.get获取详细的商品Item的信息
price	String	Y	商品价格。精确到2位小数;单位:元。如:200.07，表示:200元7分
pic_path	String	Y	商品图片的绝对路径
num	int	Y	购买数量。取值范围:大于零的整数
tid	String	Y	子订单id
buyer_message	String	Y	买家留言
sid	String	Y	物流Shipping的id
shipping_type	String	Y	创建交易时的物流方式（交易完成前，物流方式有可能改变，但tc里的这个字段一直不变）。可选值:free(卖家承担运费),post(平邮),express(快递),ems(EMS),virtual(虚拟物品)
alipay_no	String	Y	支付宝交易号
payment	String	Y	实付金额。精确到2位小数;单位:元。如:200.07，表示:200元7分
discount_fee	String	Y	系统优惠金额。精确到2位小数;单位:元。如:200.07，表示:200元7分
adjust_fee	String	Y	卖家优惠金额.格式为:1.01;单位:元;精确到小数点后两位.
snapshot_url	String	Y	订单快照URL
status	String	Y	订单状态.可选值:WAIT_BUYER_PAY(等待买家付款),WAIT_BUYER_CONFIRM_GOODS(卖家已发货),WAIT_SELLER_SEND_GOODS(买家已付款),TRADE_FINISHED(交易成功),TRADE_CLOSED(交易关闭),TRADE_CLOSED_BY_TAOBAO(交易被淘宝关闭),TRADE_NO_CREATE_PAY(没有创建外部交易(支付宝交易)),OTHER(其他状态)
seller_rate	Boolean	Y	卖家是否已评价。可选值:true(已评价),false(未评价)
buyer_rate	Boolean	Y	买家是否已评价。可选值:true(已评价),false(未评价)
buyer_memo	String	Y	买家备注
seller_memo	String	Y	卖家备注
pay_time	Date	Y	付款时间。格式:yyyy- MM-dd HH:mm:ss
end_time	Date	Y	交易成功时间(更新交易状态为成功的同时更新)/确认收货时间。格式:yyyy-MM-dd HH:mm:ss
modified	Date	Y	交易修改时间(用户对订单的操作会更新此字段)。格式:yyyy-MM-dd HH:mm:ss
buyer_obtain_point_fee	String	Y	买家获得积分,返点的积分。格式:100;单位:个
point_fee	String	Y	买家使用积分。格式:100; 单位:个.
real_point_fee	String	Y	买家实际使用积分。格式:100;单位:个.
total_fee	String	Y	应付金额。精确到2位小数;单位:元。如:200.07，表示:200元7分
post_fee	String	Y	邮费。精确到2位小数;单位: 元。如:200.07，表示:200元7分
buyer_alipay_no	String	Y	买家支付宝账号
receiver_name	String	Y	收货人的姓名
receiver_state	String	Y	收货人的所在省份
receiver_city	String	Y	收货人的所在城市
receiver_district	String	Y	收货人的所在地区
receiver_address	String	Y	收货人的详细地址
receiver_zip	String	Y	收货人的邮编
receiver_mobile	String	Y	收货人的手机号码
receiver_phone	String	Y	收货人的电话号码
consign_time	Date	Y	卖家发货时间。格式:yyyy-MM-dd HH:mm:ss
buyer_email	String	Y	买家Email
commission_fee	String	Y	交易佣金。精确到2位小数;单位:元。如:200.07，表示:200元7分
seller_alipay_no	String	Y	卖家支付宝账号
seller_mobile	String	Y	卖家手机
seller_phone	String	Y	卖家电话
seller_name	String	Y	卖家姓名
seller_email	String	Y	卖家Email
available_confirm_fee	String	Y	能够确认收货的实付款。精确到 2位小数;单位:元。如:200.07，表示:200元7分
has_postFee	String	Y	是否包含邮费。与 available_confirm_fee同时使用。可选值:true(包含),false(不包含)
received_payment	String	Y	卖家实际收到的支付宝打款金额。精确到2位小数;单位:元。如:200.07，表示:200元7分
cod_fee	String	Y	货到付款服务费。精确到2位小数;单位:元。如:200.07，表示:200元7分
timeout_action_time	Date	Y	订单超时到期时间。格式:yyyy-MM-dd HH:mm:ss
orders	Order[]	Y	订单列表
sku_id	String	Y	商品的最小属性单元Sku的 id.可以通过APItaobao.item.sku.get获取详细的Sku信息
sku_properties_name	String	Y	sku的值。如：机身颜色:黑色;手机套餐:官方标配
item_meal_name	String	Y	套餐的值。如：M8原装电池: 便携支架:M8专用座充:莫凡保护袋
outer_iid	String	Y	商家外部编码(可与商家外部系统对接).外部商家自己定义的商品Item的id,可以通过APITaobao.fullitems.get获取商品的Item的信息
outer_sku_id	String	Y	外部网店自己定义的Skuid

TaobaokeShop 数据结构

名称	类型	是否隐私	描述
user_id	String	N	店铺用户id
shop_title	String	N	店铺名称
click_url	String	N	店铺推广URL
shop_commission.rate	String	N	淘宝客店铺佣金比率

TaobaokeReportMember 数据结构

名称	类型	是否隐私	描述
app_key	String	Y	应用授权码
outer_code	String	Y	推广渠道
trade_id	Long	Y	淘宝交易号
pay_time	Date	Y	成交时间
pay_price	Double	Y	成交价格
auction_id	Long	Y	商品ID
auction_title	String	Y	商品标题
auction_number	Long	Y	商品成交数量
category_id	Long	Y	所购买商品的类目ID
category_name	String	Y	所购买商品的类目名称
shop_title	String	Y	店铺名称
discount	Double	Y	佣金比例
taoke_amount	Double	Y	用户获得的佣金