文档中心 > API类目 > 淘宝退款API

taobao.refund.smart.support.negotiationtypes.get (查询支持发起的协商类型)

查询支持发起的协商类型

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refund_id Number 必须 112233 退款编号

响应参数

名称 类型 示例值 描述
supported_negotiation_plans NegotiationPlanType [] 支持的协商方案列表,本期开放协商方案:协商退货退款、协商部分退款挽回、协商撤销退款
  • └ negotiation_type
  • String
  • partial_refund_retention
  • 协商方案的编码,目前支持:partial_refund_retention(协商部分退款挽回),return_and_refund(协商退货退款),cancel_refund(协商撤销退款)
  • └ params
  • String []
  • 对应每种协商方案需要的参数,示例:[\"refund_amount","negotiation_script"]
trusteeship TrusteeshipSupport 托管协商支持信息
  • └ unsupported_reason
  • String
  • 退款单状态不符
  • 如果不支持,原因枚举: a. 无生效中的托管策略 b. 托管策略未开启服务商回传异常协商方案 c. 售后单不符合托管范围,未通过校验【因子名称】 d. 售后单状态不符合 e. 售后单类型不符合
  • └ support_trusteeship
  • Boolean
  • false
  • 是否支持发起托管协商
max_refund_fee MaxRefundFee 可以协商的最大退款金额
  • └ max_refund_fee
  • Number
  • 12
  • 可以协商的最大退款金额
address_list Address [] 卖家退货地址列表
  • └ address_id
  • Number
  • 112233
  • 地址ID
  • └ receiver_name
  • String
  • 收件人
  • 收件人姓名
  • └ post_code
  • String
  • 311100
  • 邮政编码
  • └ mobile
  • String
  • 131xxxxxxxx
  • 收件人手机
  • └ country_name
  • String
  • 中国
  • 国家
  • └ province_name
  • String
  • 浙江省
  • └ city_name
  • String
  • 杭州市
  • └ area_name
  • String
  • 余杭区
  • └ town_name
  • String
  • 五常街道
  • 城乡/街道
  • └ address_detail
  • String
  • 阿里巴巴西溪B区
  • 乡镇/街道地址详情
  • └ division_code
  • String
  • 112233
  • 行政区划代码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RefundSmartSupportNegotiationtypesGetRequest req = new RefundSmartSupportNegotiationtypesGetRequest();
req.setRefundId(112233L);
RefundSmartSupportNegotiationtypesGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<refund_smart_support_negotiationtypes_get_response>
    <supported_negotiation_plans>
        <negotiation_plan_type>
            <negotiation_type>partial_refund_retention</negotiation_type>
        </negotiation_plan_type>
    </supported_negotiation_plans>
    <trusteeship>
        <unsupported_reason>退款单状态不符</unsupported_reason>
        <support_trusteeship>false</support_trusteeship>
    </trusteeship>
    <max_refund_fee>
        <max_refund_fee>12</max_refund_fee>
    </max_refund_fee>
    <address_list>
        <address>
            <address_id>112233</address_id>
            <receiver_name>收件人</receiver_name>
            <post_code>311100</post_code>
            <mobile>131xxxxxxxx</mobile>
            <country_name>中国</country_name>
            <province_name>浙江省</province_name>
            <city_name>杭州市</city_name>
            <area_name>余杭区</area_name>
            <town_name>五常街道</town_name>
            <address_detail>阿里巴巴西溪B区</address_detail>
            <division_code>112233</division_code>
        </address>
    </address_list>
</refund_smart_support_negotiationtypes_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

返回
顶部