文档中心 > API类目 > 银泰开放平台

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

退单查询接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
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>

异常示例

  • 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工具

如何获得此API

FAQ

返回
顶部