淘宝联盟维权订单接口（上线时间：2020年5月27号）

【好消息】

维权订单接口新增增量查询的功能，增加参数search_type=5按订单更新时间查询，返回值增加出参：更新字段modified_time

【适用范围】目前只支持淘宝联盟的渠道订单和会员订单维权（即带渠道relationId参数和sid的订单）查询，

暂时不支持普通常规淘客维权订单。

如图：

一、淘宝联盟维权订单API调用方法：

【权限会员卡】核心接口会员或订单会员卡可调用。

【调用接口】

http://api.veapi.cn/tbk/refundorder?vekey=xx&start_time=...

【参数详解】

具体参数和返回值，可以参考官方文档：https://open.taobao.com/api.htm?docId=43755&docType=2&scopeId=16322

本文档和淘宝联盟官方文档在参数名及其大小写上保持一致。

入参：

page_no 可选，默认值1，表示页码。翻页时使用。

page_size 可选：默认值30，即每页返回30笔维权订单。

search_type 可选：默认值1，可选值含义：1-维权发起时间，2-订单结算时间（正向订单），3-维权完成时间，4-订单创建时间，5-订单更新时间，即增量查询订单（出参更新字段modified_time）。

refund_type 可选：默认值0，可选值含义：1 表示2方，2表示3方，0表示不限

start_time 必选：表示开始时间，格式如2018-10-10 00:00:00，默认是一天时间。

biz_type 可选1和2：默认值1，1代表渠道关系id，2代表会员关系id

【示例】

http://api.veapi.cn/tbk/refundorder?vekey=xxx&start_time=2020-12-20+11:40:00&search_type=1&refund_type=1&biz_type=1

二、淘宝联盟维权订单接口返回值：

参考官方维权订单接口文档：

https://open.taobao.com/api.htm?docId=43755&docType=2&scopeId=16322

返回值主要字段 refund_status 说明：

"refund_status": 

维权创建(淘客结算回执) 4,

维权成功(淘客结算回执) 2,

维权失败(淘客结算回执) 3,

发生多次维权，待处理 11,

从淘客处补扣（钱已结给淘客） 等待扣款 12,

从淘客处补扣（钱已结给淘客） 扣款成功 13,

从卖家处补扣（钱已结给卖家） 等待扣款 14,

从卖家处补扣（钱已结给卖家） 扣款成功 15

下面是一个示例：

{

    "error": "0",

    "msg": "操作成功",

    "data": {

        "biz_error_code": 0,

        "data": {

            "page_no": 1,

            "page_size": 30,

            "results": {

                "result": [

                    {

                        "earning_time": "2020-12-20 11:44:25",

                        "refund_fee": "59.0000",  #维权金额

                        "refund_status": 2, #维权状态

                        "refund_type": 1,  #1 表示2方订单，2表示3方订单

                        "relation_id": 2648201592,

                        "tb_auction_title": "南极人男士睡衣男薄款夏季夏天长袖纯棉春秋冬全棉青年家居服套装",

                        "tb_trade_create_time": "2020-12-17 16:48:36",

                        "tb_trade_finish_price": "59.0000",

                        "tb_trade_id": 1448841458045748332,

                        "tb_trade_parent_id": 1448841458045748332,

                        "tk_commission_fee_refund_pub": "1.4200",

                        "tk_pub_id": 316680049,

                        "tk_pub_show_return_fee": "1.8300",

                        "tk_refund_suit_time": "2020-12-22 12:20:55",

                        "tk_refund_time": "2020-12-20 12:41:22",

                        "tk_subsidy_fee_refund_pub": "0.0500"

                    }

                ]

            },

            "total_count": 1

        },

        "result_code": 200

    }

}

三、维权订单查询接口说明：

1.本接口常规订单维权查询，目前还不支持。只能查询渠道订单或会员运营的维权订单，即在高佣转链时，附加了rid参数的订单。

如果您不了解什么是渠道，请参考http://wsd.591hufu.com/doc/taokequdaojiekou

2.目前参数只能通过start_time参数开始的时间点，不断翻页查询淘宝联盟维权订单，不能指定时间段，因此，目前只能通过不断地翻页来查，建议你每次查询，固定一个时间类型（比如以维权发起时间），然后如果有取得返回值，则提取最后一笔订单的维权发起时间（tk_refund_time），做为下一次查询的start_time参数时间起点。

3.请多关注本文档，如有新进展，将会更新本文档。比如支持常规维权订单查询。