tmall.exchange.receive.get (卖家查询换货列表)

卖家查询换货列表

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
end_gmt_modifed_time Date 可选 2000-01-01 00:00:00 查询修改时间段的结束时间点
logistic_no String 可选 NO123456789 快递单号
buyer_nick String 可选 卡卡 买家昵称
start_created_time Date 可选 2000-01-01 00:00:00 查询申请时间段的开始时间点
fields String [] 必须 dispute_id, bizorder_id, num, buyer_nick, status, created, modified, reason, title, buyer_logistic_no, seller_logistic_no, bought_sku, exchange_sku, buyer_address, address, buyer_phone, buyer_logistic_name, seller_logistic_name, alipay_no, buyer_name, seller_nick
  • 最大列表长度:100
  • 返回字段。目前支持dispute_id, bizorder_id, num, buyer_nick, status, created, modified, reason, title, buyer_logistic_no, seller_logistic_no, bought_sku, exchange_sku, buyer_address, address, buyer_phone, buyer_logistic_name, seller_logistic_name, alipay_no, buyer_name, seller_nick,new_bought_sku
    page_size Number 可选 30
  • 默认值:30
  • 每页条数
    dispute_status_array String [] 可选 1,2,3,4
  • 最大列表长度:20
  • 换货状态,具体包括:换货待处理(1), 待买家退货(2), 买家已退货,待收货(3), 换货关闭(4), 换货成功(5), 待买家修改(6), 待发出换货商品(12), 待买家收货(13), 请退款(14)
    end_created_time Date 可选 2000-01-01 00:00:00 查询申请时间段的结束时间点
    buyer_open_uid String 可选 AXADSSDSDD 买家的openId
    refund_id_array String [] 可选 123456,987654
  • 最大列表长度:20
  • 退款单号ID列表,最多只能输入20个id
    page_no Number 可选 1
  • 默认值:1
  • 页码
    start_gmt_modified_time Date 可选 2000-01-01 00:00:00 查询修改时间段的开始时间点
    biz_order_id Number 可选 666666666 正向订单号

    响应参数

    名称 类型 示例值 描述
    page_results Number 10 当前页的换货单数量
    results Exchange [] 返回结果
    • └ alipay_no
    • String
    • 222222222
    • 支付宝ID
    • └ buyer_nick
    • String
    • 卡卡
    • 买家昵称
    • └ seller_nick
    • String
    • 加利亚尼
    • 卖家昵称
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 换货单创建时间
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 换货单最新修改时间
    • └ status
    • String
    • 买家已经申请退款,等待卖家同意
    • 当前换货单状态
    • └ good_status
    • String
    • 已发货
    • 当前商品状态
    • └ payment
    • String
    • 100.00
    • 支付费用
    • └ reason
    • String
    • 7天无理由换货
    • 申请换货原因
    • └ title
    • String
    • AC米兰主场球衣
    • 商品名称
    • └ price
    • String
    • 100.00
    • 价格
    • └ num
    • Number
    • 1
    • 购买数
    • └ address
    • String
    • 浙江省杭州市黄龙体育中心
    • 卖家换货地址
    • └ bought_sku
    • String
    • 红色
    • 购买的商品sku
    • └ exchange_sku
    • String
    • 白色
    • 买家申请换货的商品sku
    • └ buyer_logistic_name
    • String
    • 申通快递
    • 买家发货物流公司
    • └ buyer_logistic_no
    • String
    • NO123456789
    • 买家发货快递单号
    • └ biz_order_id
    • String
    • 456456
    • 正向单号ID
    • └ dispute_id
    • String
    • 123123123
    • 换货单号ID
    • └ seller_logistic_name
    • String
    • 顺丰快递
    • 卖家发货物流公司
    • └ seller_logistic_no
    • String
    • NO987654321
    • 卖家发货快递单号
    • └ buyer_address
    • String
    • 北京市海淀区西土城路十号北京邮电大学
    • 买家换货地址
    • └ time_out
    • String
    • 2000-01-01 00:00:00
    • 超时时间
    • └ buyer_phone
    • String
    • 13344445555
    • 买家联系方式
    • └ buyer_name
    • String
    • 李世民
    • buyerName
    • └ oaid
    • String
    • xxxx
    • 收件人ID (Open Addressee ID),长度在128个字符之内。
    • └ buyer_open_uid
    • String
    • AXSADSADSDSDSD
    • 买家openId
    • └ attributes
    • String
    • {"newExchangeRepair","1"}
    • 扩展属性
    • └ new_bought_sku
    • String
    • 红色
    • 修改后购买的商品sku
    • └ real_receiver_open_id
    • String
    • AAEnVKOdAOIduo9TH9hjf-zb
    • 收件人淘宝加密openId
    • └ real_receiver_display_nick
    • String
    • 这是一个昵称
    • 收件人淘宝加密昵称
    total_results Number 100 所有符合查询条件的换货单的数量
    has_next Boolean true 是否还有下一页
    error_codes String ERROR 错误码
    error_msg String NULL 错误信息

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallExchangeReceiveGetRequest req = new TmallExchangeReceiveGetRequest();
    req.setEndGmtModifedTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setLogisticNo("NO123456789");
    req.setBuyerNick("卡卡");
    req.setStartCreatedTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setFields("dispute_id, bizorder_id, num, buyer_nick, status, created, modified, reason, title, buyer_logistic_no, seller_logistic_no, bought_sku, exchange_sku, buyer_address, address, buyer_phone, buyer_logistic_name, seller_logistic_name, alipay_no, buyer_name, seller_nick");
    req.setPageSize(30L);
    req.setDisputeStatusArray("1,2,3,4");
    req.setEndCreatedTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setBuyerOpenUid("AXADSSDSDD");
    req.setRefundIdArray("123456,987654");
    req.setPageNo(1L);
    req.setStartGmtModifiedTime(StringUtils.parseDateTime("2000-01-01 00:00:00"));
    req.setBizOrderId(666666666L);
    TmallExchangeReceiveGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_exchange_receive_get_response>
        <page_results>10</page_results>
        <results>
            <exchange>
                <alipay_no>222222222</alipay_no>
                <buyer_nick>卡卡</buyer_nick>
                <seller_nick>加利亚尼</seller_nick>
                <created>2000-01-01 00:00:00</created>
                <modified>2000-01-01 00:00:00</modified>
                <status>买家已经申请退款,等待卖家同意</status>
                <good_status>已发货</good_status>
                <payment>100.00</payment>
                <reason>7天无理由换货</reason>
                <title>AC米兰主场球衣</title>
                <price>100.00</price>
                <num>1</num>
                <address>浙江省杭州市黄龙体育中心</address>
                <bought_sku>红色</bought_sku>
                <exchange_sku>白色</exchange_sku>
                <buyer_logistic_name>申通快递</buyer_logistic_name>
                <buyer_logistic_no>NO123456789</buyer_logistic_no>
                <biz_order_id>456456</biz_order_id>
                <dispute_id>123123123</dispute_id>
                <seller_logistic_name>顺丰快递</seller_logistic_name>
                <seller_logistic_no>NO987654321</seller_logistic_no>
                <buyer_address>北京市海淀区西土城路十号北京邮电大学</buyer_address>
                <time_out>2000-01-01 00:00:00</time_out>
                <buyer_phone>13344445555</buyer_phone>
                <buyer_name>李世民</buyer_name>
                <oaid>xxxx</oaid>
                <buyer_open_uid>AXSADSADSDSDSD</buyer_open_uid>
                <attributes>{&quot;newExchangeRepair&quot;,&quot;1&quot;}</attributes>
                <new_bought_sku>红色</new_bought_sku>
                <real_receiver_open_id>AAEnVKOdAOIduo9TH9hjf-zb</real_receiver_open_id>
                <real_receiver_display_nick>这是一个昵称</real_receiver_display_nick>
            </exchange>
        </results>
        <total_results>100</total_results>
        <has_next>true</has_next>
        <error_codes>ERROR</error_codes>
        <error_msg>NULL</error_msg>
    </tmall_exchange_receive_get_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

    返回
    顶部