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

taobao.refund.negotiatereturn (协商退货退款)

协商退货退款

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refund_id Number 必须 112233 退款编号
refund_version Number 必须 1409231007325 退款版本号
refund_fee Number 可选 12 退款金额,单位(分)
address_id Number 可选 112233 地址ID,通过协商退货退款渲染接口获取到的
negotiate_type Number 可选 17 协商类型code,协商2.0必填
refund_type Number 可选 1 协商退款类型,协商售后信息必填
reason_id Number 可选 112233 协商原因id,协商售后信息或协商退款原因必填
negotiate_text String 可选 亲,很抱歉没有让您满意,我们愿意支持您的售后申请,辛苦您接受下协商方案。 协商话术,协商售后信息、协商退款原因、已超售后时效必填
support_refuse Boolean 可选 true 是否支持超时未处理协商自动处理
support_buyer_refuse Boolean 可选 true 是否支持买家拒绝协商自动处理
negotiate_version String 可选 newNegotiate 协商版本,非货在途协商请填newNegotiate
refuse_message RefundRefuseMessage 可选 选自动处理方案必填
  • └ refuse_reason_id
  • Number
  • 可选
  • 112233
  • 拒绝原因id
  • └ refuse_message
  • String
  • 可选
  • 拒绝留言
  • 拒绝留言
  • └ refuse_proof
  • byte[] []
  • 可选
  • 我是被上传的文件内容
  • 拒绝凭证

响应参数

名称 类型 示例值 描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
RefundNegotiatereturnRequest req = new RefundNegotiatereturnRequest();
req.setRefundId(112233L);
req.setRefundVersion(1409231007325L);
req.setRefundFee(12L);
req.setAddressId(112233L);
req.setNegotiateType(17L);
req.setRefundType(1L);
req.setReasonId(112233L);
req.setNegotiateText("亲,很抱歉没有让您满意,我们愿意支持您的售后申请,辛苦您接受下协商方案。");
req.setSupportRefuse(true);
req.setSupportBuyerRefuse(true);
req.setNegotiateVersion("newNegotiate");
RefundNegotiatereturnRequest.RefundRefuseMessage obj1 = new RefundNegotiatereturnRequest.RefundRefuseMessage();
obj1.setRefuseReasonId(112233L);
obj1.setRefuseMessage("拒绝留言");
req.setRefuseMessage(obj1);
RefundNegotiatereturnResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<refund_negotiatereturn_response>
</refund_negotiatereturn_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

返回
顶部