维易淘客联盟接口开发文档:处罚订单查询

淘宝客处罚订单查询API

淘宝客处罚订单查询可以用于查询被处罚的订单,



一、淘宝客处罚订单查询用法:

【使用权限】订单接口会员卡、全能会员卡、多用户

【接口调用地址】使用以下API调用接口查询被处罚的订单

http://api.vephp.com/orderpunish?vekey=xxxx&start_time=2019-05-15+21:00:47&trade_id=441183720754759222&trade_parent_id=441183720754759222

【参数说明】

官方原文档地址:https://open.taobao.com/api.htm?docId=41942&docType=2&scopeId=15738 

sessionkey:可选 ,仅限多用户版客户使用

violation_type:处罚类型:1 店铺淘客,2其他

punish_status:处罚状态,0 正常,1 待处罚,2冻结

start_time:必选,查询开始时间,以淘客订单创建时间开始,如:2019-09-16+11:56:03

trade_id:子订单号:要查询的订单子订单号。

trade_parent_id:父订单号。

relation_id:可选,渠道关系id

special_id:可选,会员关系ID

span:可选,默认1800秒,最大值1800秒,注意,官方文档是“不超过1小时”,但实测最大不超过1800秒。

page_no:可选,当前页码

page_size:可选,每页要显示的记录数,默认值100


二、处罚订单接口返回值:

本站对官方接口做了优化,增加可读性。

处罚订单接口返回值如下:

{

    "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

             }

         ]

     }

}

 

客服

关注