文档中心 > API类目 > 采购宝API

taobao.pc.refund.submit (企业购逆向提交/修改退款)

企业购逆向提交/修改退款

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refund_agreement_order_req RefundAgreementOrderReq 可选 企业购逆向申请页接口参数
  • └ biz_order_id
  • String
  • 必须
  • 10000001
  • 订单ID
  • └ dispute_id
  • String
  • 可选
  • 10000001
  • 售后订单ID
  • └ out_biz_id
  • String
  • 必须
  • 10000001
  • 外部逆向单ID
  • └ biz_claim_type
  • Number
  • 必须
  • 1
  • 逆向业务诉求类型 1-仅退款,3-退货退款
  • └ leave_message_content
  • String
  • 可选
  • 你这是生瓜蛋子
  • 退款说明
  • └ refund_fee
  • Number
  • 必须
  • 100
  • 退款金额
  • └ apply_refund_text_id
  • Number
  • 必须
  • 500032
  • 退货的原因文案id,就是渲染页里边退款理由的textId
  • └ goods_status
  • Number
  • 必须
  • 1
  • 物品状态 4-未发货,6-已发货,1-未收到货,2-已收到货,3-已寄回,5-卖家确认收货
  • refund_message_pic_v_o_list
  • RefundMessagePicVo []
  • 可选
  • 退货图片信息列表
  • └ message_pic
  • String
  • 可选
  • xxxxx
  • 上传凭证图片
  • └ message_pic_desc
  • String
  • 可选
  • xxxxx
  • 凭证图片说明
  • └ buyer_id
  • Number
  • 必须
  • 10000001
  • 买家ID

响应参数

名称 类型 示例值 描述
result Result result
  • └ success
  • Boolean
  • true
  • 操作是否成功
  • └ error_code
  • String
  • 200
  • 结果码
  • └ error_msg
  • String
  • 参数错误
  • 结果描述
  • refund_agreement_order_resp
  • RefundAgreementOrderResp
  • 结果
  • └ biz_order_id
  • String
  • xxxxx
  • 订单ID
  • └ dispute_id
  • String
  • xxxxx
  • 企业购退款单ID
  • └ out_biz_id
  • String
  • xxxxx
  • 外部业务ID

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
PcRefundSubmitRequest req = new PcRefundSubmitRequest();
PcRefundSubmitRequest.RefundAgreementOrderReq obj1 = new PcRefundSubmitRequest.RefundAgreementOrderReq();
obj1.setBizOrderId("10000001");
obj1.setDisputeId("10000001");
obj1.setOutBizId("10000001");
obj1.setBizClaimType(1L);
obj1.setLeaveMessageContent("你这是生瓜蛋子");
obj1.setRefundFee(100L);
obj1.setApplyRefundTextId(500032L);
obj1.setGoodsStatus(1L);
List<PcRefundSubmitRequest.RefundMessagePicVo> list3 = new ArrayList<PcRefundSubmitRequest.RefundMessagePicVo>();
PcRefundSubmitRequest.RefundMessagePicVo obj4 = new PcRefundSubmitRequest.RefundMessagePicVo();
list3.add(obj4);
obj4.setMessagePic("xxxxx");
obj4.setMessagePicDesc("xxxxx");
obj1.setRefundMessagePicVOList(list3);
obj1.setBuyerId(10000001L);
req.setRefundAgreementOrderReq(obj1);
PcRefundSubmitResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<pc_refund_submit_response>
    <result>
        <success>true</success>
        <error_code>200</error_code>
        <error_msg>参数错误</error_msg>
        <refund_agreement_order_resp>
            <biz_order_id>xxxxx</biz_order_id>
            <dispute_id>xxxxx</dispute_id>
            <out_biz_id>xxxxx</out_biz_id>
        </refund_agreement_order_resp>
    </result>
</pc_refund_submit_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

返回
顶部