淘宝开放平台

登录
文档中心 > API类目 > 淘宝定制行业API

淘宝定制行业API

taobao.industry.dajian.rp.pickup.result (淘宝大件行业退货退款上门取件结果回传)

淘宝大件行业退货退款上门取件结果回传

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
refund_operate_result_request RefundOperateResultRequest 必须 入参
  • └ biz_action_type_code
  • String
  • 必须
  • pickup
  • 业务事件类型。DOOR_IDENTIFY("identify", "上门鉴定"),DOOR_PICKUP("pickup", "上门取件"),DOOR_IDENTIFY_RESULT("identifyResult", "上门鉴定结果"),AGREE_REFUND_GOODS("agreeRefundGoods", "是否同意退货");
  • └ pic_list
  • String []
  • 可选
  • ["xxx.png"]
  • 回传结果图片列表
  • └ actual_finish_time
  • Date
  • 必须
  • 2024-11-11 23:23:23
  • 实际完成时间。yyyy-MM-dd HH:mm:ss
  • └ result
  • Boolean
  • 必须
  • true
  • 业务事件结果。结果：成功true｜失败false
  • └ seller_id
  • Number
  • 必须
  • 123456
  • 卖家ID
  • └ plan_pick_slice
  • String
  • 可选
  • day
  • 计划上门取件时间片枚举code。DAY("day", "9:00-21:00")
  • └ is_refund
  • Boolean
  • 必须
  • false
  • 是否立即退款:true|false。上门取件事件类型必传
  • └ plan_pick_date
  • Date
  • 可选
  • 2024-03-01 00:00:00
  • 计划上门取件时间 yyyy-MM-dd 00:00:00
  • └ fail_code
  • String
  • 可选
  • 不符合退货条件
  • 失败原因枚举
  • └ comment
  • String
  • 可选
  • 自定义文案描述
  • 例：鉴定成功=成功备注。鉴定失败=其他时自定义备注
  • └ extend_fields
  • String
  • 可选
  • {"key":"value"}
  • 拓展字段
  • └ refund_id
  • Number
  • 必须
  • 2134
  • 逆向交易订单号
  • └ refund_collaborative_code
  • String
  • 必须
  • rp1234
  • 行业逆向取退协同单号
  • └ actual_pickup_time
  • Date
  • 可选
  • 2024-11-11 23:23:23
  • 取鉴一体商家，在是否同意退货事件传入。传入当前字段后，上门取件事件不需要再调用
  • └ sc_item_id
  • Number
  • 可选
  • 12345
  • 货品ID
  • └ sc_item_num
  • Number
  • 可选
  • 2
  • 货品数量
  • └ goods_state
  • Number
  • 可选
  • 1
  • 货物状态枚举code；1（已质检、已封箱） 2（未质检、未开箱）等

响应参数

名称 类型 示例值 描述
result Result 返回值
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ error_code
  • String
  • SYSTEM_ERROR
  • 业务错误编码
  • └ error_msg
  • String
  • 系统错误
  • 业务错误描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
IndustryDajianRpPickupResultRequest req = new IndustryDajianRpPickupResultRequest();
IndustryDajianRpPickupResultRequest.RefundOperateResultRequest obj1 = new IndustryDajianRpPickupResultRequest.RefundOperateResultRequest();
obj1.setBizActionTypeCode("pickup");
obj1.setPicList(""xxx.png"");
obj1.setActualFinishTime(StringUtils.parseDateTime("2024-11-11 23:23:23"));
obj1.setResult(true);
obj1.setSellerId(123456L);
obj1.setPlanPickSlice("day");
obj1.setIsRefund(false);
obj1.setPlanPickDate(StringUtils.parseDateTime("2024-03-01 00:00:00"));
obj1.setFailCode("不符合退货条件");
obj1.setComment("自定义文案描述");
obj1.setExtendFields("{\"key\":\"value\"}");
obj1.setRefundId(2134L);
obj1.setRefundCollaborativeCode("rp1234");
obj1.setActualPickupTime(StringUtils.parseDateTime("2024-11-11 23:23:23"));
obj1.setScItemId(12345L);
obj1.setScItemNum(2L);
obj1.setGoodsState(1L);
req.setRefundOperateResultRequest(obj1);
IndustryDajianRpPickupResultResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
7
<industry_dajian_rp_pickup_result_response>
    <result>
        <success>true</success>
        <error_code>SYSTEM_ERROR</error_code>
        <error_msg>系统错误</error_msg>
    </result>
</industry_dajian_rp_pickup_result_response>

异常示例

  • XML示例
  • JSON示例
1
2
3
4
5
6
<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测试工具 错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问
返回
顶部