高级电商API
获取卖家已卖出的交易数据api接口(近期暂停对接)
需要点卡
0人使用 查看优惠

根据订单创建时间、买家昵称、订单状态..等信息查询卖家店铺下的交易订单信息,本接口采用官方taobao.trades.sold.get接口,安全稳定!【调用接口前需联系客服,当前返回参数只列出部分字段,如需更多字段请联系技术客服添加】

接口地址: http://api.tbk.dingdanxia.com/shop/seller_orders 在线测试

接口支持https,非大陆服务器(含港澳台)调用接口会出现网络缓慢现象,请联系客服获取国外专线接口

请求参数、 调用方式 POST

参数接口

参数类型

必填

示例

说明

apikey

string

接口秘钥,请登录后台获取

seller_nick

String

tb129505

卖家昵称

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

交易状态,默认查询所有交易状态的数据,除了默认值外每次只能查询一种状态。所有交易状态:http://open.taobao.com/doc.htm?docId=102856&docType=1

buyer_nick

String

zhangsan

买家昵称

rate_status

String

RATE_UNBUYER

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

tag

String

time_card

卖家对交易的自定义分组标签,目前可选值为:time_card(点卡软件代充),fee_card(话费软件代充)

page_no

Number

1

页码。取值范围:大于零的整数; 默认值:1

page_size

Number

40

每页条数。取值范围:大于零的整数; 默认值:40;最大值:100

use_has_next

Boolean

true

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

返回参数说明

标记

类型

例子

说明

buyer_nick

String

tb129505

买家昵称

buyer_open_uid

String

AAHk5d-EAAeGwJedwSFu0XXX

买家OpenUid

created

Date

2000-01-01 00:00:00

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

discount_fee

String

200.07

可以使用trade.promotion_details查询系统优惠系统优惠金额(如打折,VIP,满就送等),精确到2位小数,单位:元。如:200.07,表示:200元7分

modified

Date

2000-01-01 00:00:00

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

new_presell

Boolean

True

预售单为true,否则false

num

Number

1

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

num_iid

Number

123456

商品数字编号

pay_time

Date

2000-01-01 00:00:00

付款时间。格式:yyyy-MM-dd HH:mm:ss。订单的付款时间即为物流订单的创建时间。

payment

String

200.07

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

receiver_mobile

String

135*******

收货人的手机号码

receiver_name

String

张**

收货人的姓名

receiver_state

String

https://uland.taobao.com/coupon/edetail?e=nqUNB

广东省

receiver_town

String

三墎镇

收货人街道地址

tid

Number

2231958349

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

tid_str

String

2231958349

同tid

total_fee

String

200.07

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

you_xiang

Boolean

true

优享购为true,否则false

返回示例
{
    "code": 200,
    "msg": "请求成功【success】",
    "data": {
        "total_results": "1417",
        "trades": {
            "trade": [
                {
                    "buyer_nick": "t_1487585553688_057",
                    "created": "2019-02-22 04:53:36",
                    "discount_fee": "30.00",
                    "modified": "2019-02-22 04:53:42",
                    "num": "1",
                    "num_iid": "562296340379",
                    "pay_time": "2019-02-22 04:53:42",
                    "payment": "138.00",
                    "receiver_mobile": "166********",
                    "receiver_name": "陈**",
                    "receiver_state": "福建省",
                    "seller_nick": "怡人新娘旗舰店",
                    "tid": "354391011798968475",
                    "total_fee": "388.00"
                },
                {
                    "buyer_nick": "a_loan",
                    "created": "2019-02-21 22:06:46",
                    "discount_fee": "30.00",
                    "modified": "2019-02-21 22:06:52",
                    "num": "1",
                    "num_iid": "562296340379",
                    "pay_time": "2019-02-21 22:06:51",
                    "payment": "138.00",
                    "receiver_mobile": "133********",
                    "receiver_name": "阮********",
                    "receiver_state": "广西壮族自治区",
                    "receiver_town": "东兴镇",
                    "seller_nick": "怡人新娘旗舰店",
                    "tid": "265531525730331495",
                    "total_fee": "388.00"
                }
            ]
        },
        "request_id": "dzqxr3kqssrg"
    }
}			  
返回错误码说明

错误码

错误描述

解决办法

200

返回成功

-1

数据返回失败

请查看 msg 返回提示

4001

接口秘钥不能为空

请传入接口秘钥

4002

接口秘钥出错

登录后台查看接口秘钥是否一致

4003

参数不正确

请检查参数是否符合文档要求

4004

服务已到期请及时续费

登录后台续费

4005

该接口当日调用量已超限

升级套餐

4006

无权调用该接口

升级套餐

4007

接口不存在

4008

signature不正

查看签名构建规则确保正确无误。

4009

点卡已用完

请登录控制台-服务购买-充值点卡

4010

请购买接口次数包才能调用此接口

需充值次数包

4011

次数包已用完,请重新购买

需充值次数包

4012

请求客户端ip未加入白名单

将ip加入白名单

4013

联盟账号授权已过期

请登录控制台【授权管理】下重新授权您的相关账号

4014

PID异常

请登录控制台【授权管理】-【淘宝授权】,检查您的推广位PID是否填写,或是否填写正确。

4015

系统异常

服务端处理异常,请等待......或联系网站在线客服反馈。

4017

请求拒绝

调用请求被拒绝,您的账号状态存在异常,请联系平台管理员解除限制。