文档中心 > API类目 > 天猫供应链

taobao.logistics.work.order.operate.callback (淘天物流部--物流客服工单物流服务商回传接口)

淘天物流部--物流客服工单物流服务商回传接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
work_order_task_operate_callback_dto WorkOrderTaskOperateCallbackDTO 必须 工单任务节点回告对象
  • └ extension
  • String
  • 可选
  • {key:value}
  • 扩展信息,实际为Map
  • └ attachments
  • String []
  • 可选
  • URL
  • 附件对象的Url地址
  • └ work_order_type
  • Number
  • 必须
  • 0
  • 工单类型,0: 投诉工单 1: 咨询工单
  • structural_reply
  • StructuralReply
  • 可选
  • 结构化回复内容
  • reply_supplements
  • ReplySupplements []
  • 可选
  • 补充回复
  • 补充回复
  • └ field_name
  • String
  • 可选
  • pickupDate
  • 补充回复字段名
  • └ field_value
  • String
  • 可选
  • YYYY-MM-DD HH:MM:SS
  • 补充回复字段值
  • └ reply_value
  • Number
  • 可选
  • 100
  • 一级回复值
  • └ work_order_code
  • String
  • 必须
  • LW1000012266
  • 工单编码,全局唯一
  • └ operate_time
  • Date
  • 必须
  • 2023-08-22 00:00:00
  • 任务节点的操作时间,格式:YYYY-MM-DD HH:MM:SS
  • └ operate_type
  • Number
  • 必须
  • 1
  • 投诉单: 1 认责 2 不认责举证 咨询单: 101 回复
  • └ operator_name
  • String
  • 必须
  • 张三
  • 操作人名称
  • └ category_code
  • String
  • 必须
  • BEFORE-TIMEOUT
  • 工单问题分类编码
  • └ scenario_code
  • String
  • 必须
  • 110
  • 场景Code
  • └ respondent_type
  • String
  • 必须
  • 3
  • 回复方类型 3:服务商

响应参数

名称 类型 示例值 描述
work_order_task_operate_call_back_response WorkOrderTaskOperateCallBackResponse 处理结果
  • └ success
  • Boolean
  • true
  • 是否处理成功,true为处理成功;false为处理失败,且返回errorCode与errorMsg
  • └ error_code
  • String
  • "PARAM_ERROR"
  • 错误编码
  • └ message
  • String
  • "业务参数错误,工单id不存在."
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsWorkOrderOperateCallbackRequest req = new LogisticsWorkOrderOperateCallbackRequest();
LogisticsWorkOrderOperateCallbackRequest.WorkOrderTaskOperateCallbackDTO obj1 = new LogisticsWorkOrderOperateCallbackRequest.WorkOrderTaskOperateCallbackDTO();
obj1.setExtension("{key:value}");
obj1.setAttachments("URL");
obj1.setWorkOrderType(0L);
LogisticsWorkOrderOperateCallbackRequest.StructuralReply obj2 = new LogisticsWorkOrderOperateCallbackRequest.StructuralReply();
List<LogisticsWorkOrderOperateCallbackRequest.ReplySupplements> list4 = new ArrayList<LogisticsWorkOrderOperateCallbackRequest.ReplySupplements>();
LogisticsWorkOrderOperateCallbackRequest.ReplySupplements obj5 = new LogisticsWorkOrderOperateCallbackRequest.ReplySupplements();
list4.add(obj5);
obj5.setFieldName("pickupDate");
obj5.setFieldValue("YYYY-MM-DD HH:MM:SS");
obj2.setReplySupplements(list4);
obj2.setReplyValue(100L);
obj1.setStructuralReply(obj2);
obj1.setWorkOrderCode("LW1000012266");
obj1.setOperateTime(StringUtils.parseDateTime("2023-08-22 00:00:00"));
obj1.setOperateType(1L);
obj1.setOperatorName("张三");
obj1.setCategoryCode("BEFORE-TIMEOUT");
obj1.setScenarioCode("110");
obj1.setRespondentType("3");
req.setWorkOrderTaskOperateCallbackDto(obj1);
LogisticsWorkOrderOperateCallbackResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_work_order_operate_callback_response>
    <work_order_task_operate_call_back_response>
        <success>true</success>
        <error_code>&quot;PARAM_ERROR&quot;</error_code>
        <message>&quot;业务参数错误,工单id不存在.&quot;</message>
    </work_order_task_operate_call_back_response>
</logistics_work_order_operate_callback_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

返回
顶部