淘宝开放平台 - 文档中心

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
search_param	SearchRetailOrderParam	必须			查询条件
└ store_no String 可选 HZ01 门店号与下面参数out_counter_nos必填一项 └ start_index Number 必须 0 页码，从0开始 └ out_trade_no String 可选 20210505000797436155 渠道订单号(平台原始订单号) └ page_size Number 必须 20 每页条数 └ start_time String 必须 2021-05-01 12:24:12 开始时间（退款完成时间） └ end_time String 必须 2021-05-10 12:24:12 结束时间（退款完成时间） └ out_store_id_list String [] 可选 50G5 专柜号 └ refund_status_list String [] 可选 1 退款状态 └ sale_channels String [] 可选 [1,2] 销售渠道编码：1(线下)，2(喵街)，3(天猫)，6(支付宝小程序)，7(淘宝)，8(微信小程序)，10(抖音)，11(其他)，99(手工收单) └ out_counter_nos String [] 可选 HZ01-00092 门店专柜号与上面参数store_no必填一项 └ master_order_no String 可选 20221206000000000012039486070 销售单主单号(正向单的销售主单号) └ out_channel_refund_nos String [] 可选 ["1230-22"] 外部渠道退款单号

名称	类型	示例值	描述
total	Number	30	总条数
data_list	SearchRetailOrderRefundResult []	结果	结果
└ openbuyer_id String 123456 买家openid(会员对接专用) └ attributes String 扩展字段扩展字段 └ out_belong_id String HZ01 门店编号 └ belong_id String HZ01 门店编号 └ refund_no String 5910224 退款单号 └ belong_name String 杭州武林银泰门店名称 └ out_trade_no String 20210711000838160490 渠道订单号(平台原始订单号) └ out_refund_no String 5910224 退款单号 └ mall_id String 门店编号门店编号 └ refund_amount String 40 退款金额 └ refund_time String 2021-05-01 12:24:12 退款时间 └ refund_reason String 不喜欢退款原因 └ refund_status String 销退单：2-退款成功（线下） 3-退款完成（线上），预购返款单(当pre_buy_rebate=true时)：0-等待返款 1-返款处理中 3-返款完成退款状态 └ ticket_no String 777777777 退款小票号 refund_order_items SearchRefundOrderItemDTO [] 退款商品信息 └ outer_sku_id String 10000001 商家outid(供应链对接专用) └ mp_sku_id String 1000000001 银泰内部skuid，一般不用 └ item_title String 中国李宁商品标题 └ quantity String 1 退款商品数量 └ amount String 200 退款商品销售金额 └ art_no String 192333027219 货号 └ bar_code String 192333027219 条码 refund_share_promotions SearchRefundSharePromotionDTO [] 分摊信息 └ pay_line_no Number 1 支付行号 └ out_payment_code String D146 支付方式 └ out_payment_name String 支付宝支付名称 └ split_amount String 200 分摊金额（单位：分） └ rp_master_order_no String 20220212040000000960048002000 逆向销售单主单号 └ master_order_no String 20220212000000000009385746360 正向销售单主单号 └ brand_set_code String code1 品牌组套编码 └ give_away_value Number 1 赠品价值(单位：分） └ brand_set_code_qty Number 2 品牌组套编码套内数量 └ delivered Boolean true 是否已发货，true 是，false 否 └ line_no String 1 销退单明细行号 └ sale_line_no String 1 销售单明细行号(继承自订单) └ pre_buy_rebate Boolean true 是，false 否是否预购返款单 └ sale_channel_name String 喵街销售渠道名称 └ sale_channel Number 2 销售渠道编码：1(线下)，2(喵街)，3(天猫)，6(支付宝小程序)，7(淘宝)，8(微信小程序)，10(抖音)，11(其他)，99(手工收单) └ rp_master_order_no String 20221017000000000012025368676 逆向销售单主单号 └ master_order_no String 20221017000000000012025368676 正向销售单主单号 └ apply_refund_time Date 2021-05-01 12:24:12 退款单创建时间 └ counter_code String 00003 专柜编码 └ out_counter_no String HZ01-00003 门店编码-专柜编码 └ out_channel_refund_no String 1230-22 外部渠道退款编号

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosMosrpQueryOpenRefundlistRequest req = new AlibabaMosMosrpQueryOpenRefundlistRequest();
AlibabaMosMosrpQueryOpenRefundlistRequest.SearchRetailOrderParam obj1 = new AlibabaMosMosrpQueryOpenRefundlistRequest.SearchRetailOrderParam();
obj1.setStoreNo("HZ01");
obj1.setStartIndex(0L);
obj1.setOutTradeNo("20210505000797436155");
obj1.setPageSize(20L);
obj1.setStartTime("2021-05-01 12:24:12");
obj1.setEndTime("2021-05-10 12:24:12");
obj1.setOutStoreIdList("50G5");
obj1.setRefundStatusList("1");
obj1.setSaleChannels("1,2");
obj1.setOutCounterNos("HZ01-00092");
obj1.setMasterOrderNo("20221206000000000012039486070");
obj1.setOutChannelRefundNos(""1230-22"");
req.setSearchParam(obj1);
AlibabaMosMosrpQueryOpenRefundlistResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

XML示例
JSON示例

<alibaba_mos_mosrp_query_open_refundlist_response>
    <total>30</total>
    <data_list>
        <search_retail_order_refund_result>
            <openbuyer_id>123456</openbuyer_id>
            <attributes>扩展字段</attributes>
            <refund_no>5910224</refund_no>
            <belong_name>杭州武林银泰</belong_name>
            <out_trade_no>20210711000838160490</out_trade_no>
            <out_refund_no>5910224</out_refund_no>
            <refund_amount>40</refund_amount>
            <refund_time>2021-05-01 12:24:12</refund_time>
            <refund_reason>不喜欢</refund_reason>
            <refund_status>销退单：2-退款成功（线下） 3-退款完成（线上），预购返款单(当pre_buy_rebate=true时)：0-等待返款 1-返款处理中 3-返款完成</refund_status>
            <ticket_no>777777777</ticket_no>
            <refund_order_items>
                <search_refund_order_item_d_t_o>
                    <outer_sku_id>10000001</outer_sku_id>
                    <item_title>中国李宁</item_title>
                    <quantity>1</quantity>
                    <amount>200</amount>
                    <art_no>192333027219</art_no>
                    <bar_code>192333027219</bar_code>
                    <refund_share_promotions>
                        <search_refund_share_promotion_d_t_o>
                            <pay_line_no>1</pay_line_no>
                            <out_payment_code>D146</out_payment_code>
                            <out_payment_name>支付宝</out_payment_name>
                            <split_amount>200</split_amount>
                        </search_refund_share_promotion_d_t_o>
                    </refund_share_promotions>
                    <rp_master_order_no>20220212040000000960048002000</rp_master_order_no>
                    <master_order_no>20220212000000000009385746360</master_order_no>
                    <brand_set_code>code1</brand_set_code>
                    <give_away_value>1</give_away_value>
                    <brand_set_code_qty>2</brand_set_code_qty>
                    <delivered>true</delivered>
                    <line_no>1</line_no>
                    <sale_line_no>1</sale_line_no>
                </search_refund_order_item_d_t_o>
            </refund_order_items>
            <pre_buy_rebate>true 是，false 否</pre_buy_rebate>
            <sale_channel_name>喵街</sale_channel_name>
            <sale_channel>2</sale_channel>
            <rp_master_order_no>20221017000000000012025368676</rp_master_order_no>
            <master_order_no>20221017000000000012025368676</master_order_no>
            <apply_refund_time>2021-05-01 12:24:12</apply_refund_time>
            <out_counter_no>HZ01-00003</out_counter_no>
            <out_channel_refund_no>1230-22</out_channel_refund_no>
        </search_retail_order_refund_result>
    </data_list>
</alibaba_mos_mosrp_query_open_refundlist_response>

{
    "alibaba_mos_mosrp_query_open_refundlist_response":{
        "total":30,
        "data_list":{
            "search_retail_order_refund_result":[
                {
                    "openbuyer_id":"123456",
                    "attributes":"扩展字段",
                    "refund_no":"5910224",
                    "belong_name":"杭州武林银泰",
                    "out_trade_no":"20210711000838160490",
                    "out_refund_no":"5910224",
                    "refund_amount":"40",
                    "refund_time":"2021-05-01 12:24:12",
                    "refund_reason":"不喜欢",
                    "refund_status":"销退单：2-退款成功（线下） 3-退款完成（线上），预购返款单(当pre_buy_rebate=true时)：0-等待返款 1-返款处理中 3-返款完成",
                    "ticket_no":"777777777",
                    "refund_order_items":{
                        "search_refund_order_item_d_t_o":[
                            {
                                "outer_sku_id":"10000001",
                                "item_title":"中国李宁",
                                "quantity":"1",
                                "amount":"200",
                                "art_no":"192333027219",
                                "bar_code":"192333027219",
                                "refund_share_promotions":{
                                    "search_refund_share_promotion_d_t_o":[
                                        {
                                            "pay_line_no":1,
                                            "out_payment_code":"D146",
                                            "out_payment_name":"支付宝",
                                            "split_amount":"200"
                                        }
                                    ]
                                },
                                "rp_master_order_no":"20220212040000000960048002000",
                                "master_order_no":"20220212000000000009385746360",
                                "brand_set_code":"code1",
                                "give_away_value":1,
                                "brand_set_code_qty":2,
                                "delivered":true,
                                "line_no":"1",
                                "sale_line_no":"1"
                            }
                        ]
                    },
                    "pre_buy_rebate":true 是，false 否,
                    "sale_channel_name":"喵街",
                    "sale_channel":2,
                    "rp_master_order_no":"20221017000000000012025368676",
                    "master_order_no":"20221017000000000012025368676",
                    "apply_refund_time":"2021-05-01 12:24:12",
                    "out_counter_no":"HZ01-00003",
                    "out_channel_refund_no":"1230-22"
                }
            ]
        }
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

银泰开放平台

alibaba.mos.mosrp.query.open.refundlist (退单查询接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ