淘宝客处罚订单查询可以用于查询被处罚的订单,支持pub_id、site_id、adzone_id、relation_id 多维度查询处罚订单;
【使用权限】订单接口会员卡、全能会员卡、多用户
【接口调用地址】使用以下API调用接口查询被处罚的订单
http://api.veapi.cn/tbk/orderpunish?vekey=xxxx&start_time=2019-05-15+21:00:47&tb_trade_id=441183720754759222
【参数说明】
官方原文档地址:https://open.taobao.com/api.htm?docId=41942&docType=2&scopeId=15738
start_time:必选,查询开始时间,以淘客订单创建时间开始,如:2019-09-16+11:56:03
tb_trade_id:子订单号:要查询的订单子订单号。
relation_id:可选,渠道关系id
span:可选,查询时间跨度,不超过30天,单位是天。
page_no:可选,当前页码
page_size:可选,每页要显示的记录数,默认值100
adzone_id :可选,pid中的第三段,
site_id :可选,pid中的第二段
sessionkey:可选 ,仅限多用户版客户使用
本站对官方接口做了优化,增加可读性。
处罚订单接口返回值如下:
【注意】返回值中,父订单号,special id,union_id 不再支持,返回为空。
{
"error": "0", #当不为0时表示有错。
"msg": "处罚订单查询成功!订单无处罚信息!",
"page_no": 1, #翻页的pageno
"page_size": 100, #翻页的pagesie
"total_count": 1, #一共能查询出来的结果总数
"data": [ #结果
"result":[
{
"relation_id":122344, #渠道关系id
"settle_month":201812, #结算月份
"punish_status":"1", #处罚状态,0 正常,1待处罚,2冻结
"violation_type":"2", #处罚类型,1 店铺淘客,2其他
"tk_trade_create_time":"2018-11-11 00:01:01", #淘客订单创建时间
"tb_trade_id":258897956183171983, #子订单号
"tb_trade_parent_id":258897956183171983, (该字段不再支持,返回空)
"tk_adzone_id":1212, #pid里的adzoneid
"tk_site_id":1212, #pid里的siteid
"tk_pub_id":"1212", #pid里的pubid
"special_id":12123, # 会员运营id (该字段不再支持,返回空)
"union_id":"12weqsa" #淘宝联盟unionid(该字段不再支持,返回空)
}
]
}
}