tmall.exchange.get (获取单笔换货详情)

获取单笔换货详情

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
dispute_id Number 必须 123123123 换货单号ID
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,attributes
  • 最大列表长度: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

    响应参数

    名称 类型 示例值 描述
    result ExchangeBaseResponse 返回结果
    • └ message
    • String
    • FAILED
    • 错误信息说明
    • └ msg_code
    • String
    • 10000
    • 错误码
    • └ success
    • Boolean
    • true
    • 返回结果是否符合要求
    • exchange
    • Exchange
    • 换货单详情
    • └ buyer_logistic_no
    • String
    • NO1234567
    • 买家发货物流单号
    • └ alipay_no
    • String
    • 123456789
    • 支付宝单号ID
    • └ desc
    • String
    • 无理由换货
    • 换货理由说明
    • └ reason
    • String
    • 7天无理由换货
    • 换货申请理由
    • └ attributes
    • String
    • {"storeCode","SS"}
    • attributes
    • └ refund_phase
    • String
    • yes
    • 申请换货的状态:售中换货 or 售后换货
    • └ exchange_sku
    • String
    • AC米兰客场球衣
    • 换货商品的sku
    • └ buyer_address
    • String
    • 买家换货地址
    • buyerAddress
    • └ operation_contraint
    • String
    • refund_onweb
    • 操作场景
    • └ title
    • String
    • 卡卡球衣
    • 商品名称
    • └ created
    • Date
    • 2000-01-01 00:00:00
    • 换货单创建时间
    • └ seller_nick
    • String
    • AC米兰官方旗舰店
    • 卖家昵称
    • └ advance_status
    • Number
    • 1
    • 先行垫付状态
    • └ buyer_nick
    • String
    • 伊布拉希莫维奇
    • 买家昵称
    • └ buyer_logistic_name
    • String
    • 顺丰快递
    • 买家发货物流公司名称
    • └ status
    • String
    • 卖家已发货
    • 换货状态,具体包括:换货待处理(1), 待买家退货(2), 买家已退货,待收货(3), 换货关闭(4), 换货成功(5), 待买家修改(6), 待发出换货商品(12), 待买家收货(13), 请退款(14)
    • └ refund_version
    • Number
    • 111
    • 换货版本
    • └ seller_logistic_name
    • String
    • 天天快递
    • 卖家发货物流公司名称
    • └ bought_sku
    • String
    • 白色
    • 所购买的商品sku
    • └ modified
    • Date
    • 2000-01-01 00:00:00
    • 换货单修改时间
    • └ dispute_id
    • String
    • 123123
    • 换货单号ID
    • └ num
    • Number
    • 1
    • 换货数量
    • └ seller_logistic_no
    • String
    • NO3321231
    • 卖家发货快递单号
    • └ price
    • String
    • 23123
    • 价格
    • └ time_out
    • String
    • 2000-01-01 00:00:00
    • 超时时间
    • └ cs_status
    • Number
    • 23312
    • 小二托管状态
    • └ address
    • String
    • 浙江省杭州市西湖名胜风景区
    • 卖家换货地址
    • └ good_status
    • String
    • 已发货
    • 商品状态
    • └ biz_order_id
    • String
    • 2131232
    • 正向订单号ID
    • └ buyer_phone
    • String
    • 13344445555
    • 买家联系方式
    • └ buyer_name
    • String
    • 喜多福
    • buyerName
    • └ oaid
    • String
    • xxxx
    • 收件人ID (Open Addressee ID),长度在128个字符之内。
    • └ buyer_open_uid
    • String
    • AAXSDSDSDSDSD
    • 买家openId
    • └ new_bought_sku
    • String
    • 353555165311
    • 所购买的修改后商品sku
    • └ real_receiver_open_id
    • String
    • AAEnVKOdAOIduo9TH9hjf-zb
    • 收件人淘宝加密openId
    • └ real_receiver_display_nick
    • String
    • 这是一个昵称
    • 收件人淘宝加密昵称

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TmallExchangeGetRequest req = new TmallExchangeGetRequest();
    req.setDisputeId(123123123L);
    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,attributes");
    TmallExchangeGetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <tmall_exchange_get_response>
        <result>
            <message>FAILED</message>
            <msg_code>10000</msg_code>
            <success>true</success>
            <exchange>
                <buyer_logistic_no>NO1234567</buyer_logistic_no>
                <alipay_no>123456789</alipay_no>
                <desc>无理由换货</desc>
                <reason>7天无理由换货</reason>
                <attributes>{&quot;storeCode&quot;,&quot;SS&quot;}</attributes>
                <refund_phase>yes</refund_phase>
                <exchange_sku>AC米兰客场球衣</exchange_sku>
                <buyer_address>买家换货地址</buyer_address>
                <operation_contraint>refund_onweb</operation_contraint>
                <title>卡卡球衣</title>
                <created>2000-01-01 00:00:00</created>
                <seller_nick>AC米兰官方旗舰店</seller_nick>
                <advance_status>1</advance_status>
                <buyer_nick>伊布拉希莫维奇</buyer_nick>
                <buyer_logistic_name>顺丰快递</buyer_logistic_name>
                <status>卖家已发货</status>
                <refund_version>111</refund_version>
                <seller_logistic_name>天天快递</seller_logistic_name>
                <bought_sku>白色</bought_sku>
                <modified>2000-01-01 00:00:00</modified>
                <dispute_id>123123</dispute_id>
                <num>1</num>
                <seller_logistic_no>NO3321231</seller_logistic_no>
                <price>23123</price>
                <time_out>2000-01-01 00:00:00</time_out>
                <cs_status>23312</cs_status>
                <address>浙江省杭州市西湖名胜风景区</address>
                <good_status>已发货</good_status>
                <biz_order_id>2131232</biz_order_id>
                <buyer_phone>13344445555</buyer_phone>
                <buyer_name>喜多福</buyer_name>
                <oaid>xxxx</oaid>
                <buyer_open_uid>AAXSDSDSDSDSD</buyer_open_uid>
                <new_bought_sku>353555165311</new_bought_sku>
                <real_receiver_open_id>AAEnVKOdAOIduo9TH9hjf-zb</real_receiver_open_id>
                <real_receiver_display_nick>这是一个昵称</real_receiver_display_nick>
            </exchange>
        </result>
    </tmall_exchange_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

    返回
    顶部