taobao.fenxiao.refund.create (创建退款)

用于对分销的子采购单创建退款

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sub_order_id Number 必须 123 需要创建退款的子采购单id
is_return_goods Boolean 必须 true 是否退货,只有子采购单发货后,才能申请退货
is_return_post_fee Boolean 必须 true 此条子采购单是否退邮费,邮费要记在最后一笔申请退款的子单上面
return_fee Number 必须 230 需要退款的金额,单位为分
refund_reason_id Number 必须 1 发货前: 1、缺货,2、拍错商品,3、商品缺少所需样式,4、协商一致退款,5、未及时发货,0、其它 发货后: 经销: 1、商品质量问题,2、收到的商品不符,3、协商一致退款,4、一直未收到货,5、退还多付邮费,6、折扣、赠品、发票等问题,0、其它 代销: 1、商品质量问题,2、收到的商品不符,3、协商一致退款,4、买家一直未收到货,5、退还多付邮费,6、折扣、赠品、发票等问题,0、其它
refund_desc String 必须 退款说明 退款说明,2-200字

响应参数

名称 类型 示例值 描述
is_success Boolean true 退款是否创建成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
FenxiaoRefundCreateRequest req = new FenxiaoRefundCreateRequest();
req.setSubOrderId(123L);
req.setIsReturnGoods(true);
req.setIsReturnPostFee(true);
req.setReturnFee(230L);
req.setRefundReasonId(1L);
req.setRefundDesc("退款说明");
FenxiaoRefundCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<fenxiao_refund_create_response>
    <is_success>true</is_success>
</fenxiao_refund_create_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>

错误码解释

错误码 错误描述 解决方案
isv.invalid-parameter:is_not_null 参数不能为空 检查必传参数是否为空
isv.invalid-parameter:refund_desc_invalid 退款说明必须2-200字 检查退款说明
isv.invalid-parameter:user_id_num 用户数字ID不合法,或者不是分销平台用户 检查当前用户
isv.invalid-parameter:purchaseorder_not_exists 采购单不存在 检查子单id是否正确
isv.invalid-parameter:purchaseorder_not_you 不是自己的采购单 检查要创建退款的采购单,是不是当前用户的
isv.invalid-parameter:refund_reason_invalid 退款原因id不合法 退款原因id不是规定的值,此入参的说明
isv.invalid-parameter:refund_fee_invalid 退款金额超过最大可退金额 检查传入的退款金额
isv.refund-create-service:biz_err 退款创建失败 请查看具体的错误描述信息

API工具

如何获得此API

FAQ

返回
顶部