当前位置:淘客联盟接口开发文档(旧版) > 处罚订单查询
接口文档

淘宝客处罚订单查询API

迁移提示这是 旧版 文档, 最新文档请点击这里查看

淘宝客处罚订单查询可以用于查询被处罚的订单,支持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(该字段不再支持,返回空)

               }

          ]

     }

}


三、错误码:

具体错误码参考 http://wsd.591hufu.com/doc/taobaokeapijiekoucuowuma

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部