注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > API类目 > IoT售后解决方案API

cainiao.iot.ticket.sp.maintain.update (IoT售后服务商维修方案更新)

IoT售后服务商维修方案更新

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param UpdateMaintainPlanTopRequest 必须 请求参数
  • └ operator_phone
  • String
  • 必须
  • 18222222222
  • 操作人联系方式
  • └ operator_id
  • String
  • 必须
  • 84784346
  • 操作人编码
  • └ operator_name
  • String
  • 必须
  • 李四
  • 操作人名称
  • └ sp_code
  • String
  • 必须
  • testUser05
  • 服务商唯一编码
  • └ ticket_id
  • Number
  • 必须
  • 123413
  • 工单Id
  • iot_maintain_plan_item_list
  • IotMaintainPlanItemTopRequest []
  • 必须
  • 维修项
  • └ pay_role
  • String
  • 必须
  • merchant
  • 付款角色:merchant-商家记账;customer-客户支付
  • └ item_code
  • String
  • 必须
  • 3241
  • 设备编码(需要映射)
  • └ maintain_abilities
  • String
  • 必须
  • SEND_BACK_AND_SEND_OUT
  • 运维方案:SEND_BACK_AND_SEND_OUT-客户寄回服务商寄出;SEND_OUT-服务商寄出;ONSITE-上门服务
  • └ receiver_name
  • String
  • 可选
  • 李四
  • 客户寄回设备 服务商收件人名称
  • └ other_fee
  • String
  • 必须
  • 100.23
  • 其它费用
  • └ receiver_address
  • String
  • 可选
  • 浙江省杭州市西湖区西溪首座B-1
  • 客户寄回设备 服务商收货地址
  • └ features
  • 可选
  • 扩展字段
  • └ maintain_method
  • String
  • 必须
  • 323
  • 维修方式(需要映射)
  • └ receiver_phone
  • String
  • 可选
  • 18222222222
  • 客户寄回设备 服务商联系方式
  • └ pay_method
  • String
  • 必须
  • payBefore
  • 支付方式:payBefore-维修前付费;payAfter-维修后付费;noNeedPay-无需付费
  • └ fee_remark
  • String
  • 必须
  • 维修费用
  • 费用描述
  • └ warranty_type
  • String
  • 必须
  • under_warranty
  • 保内保外(需要映射)
  • └ event_type_list
  • String []
  • 必须
  • 342
  • 事件类型(需要映射)

响应参数

名称 类型 示例值 描述
result ResultDto 返回结果
  • └ success
  • Boolean
  • true
  • 执行结果
  • └ error_desc
  • String
  • 系统错误
  • 异常描述
  • └ error_code
  • String
  • SYSTEM_ERROR
  • 异常编码

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
CainiaoIotTicketSpMaintainUpdateRequest req = new CainiaoIotTicketSpMaintainUpdateRequest();
CainiaoIotTicketSpMaintainUpdateRequest.UpdateMaintainPlanTopRequest obj1 = new CainiaoIotTicketSpMaintainUpdateRequest.UpdateMaintainPlanTopRequest();
obj1.setOperatorPhone("18222222222");
obj1.setOperatorId("84784346");
obj1.setOperatorName("李四");
obj1.setSpCode("testUser05");
obj1.setTicketId(123413L);
List<CainiaoIotTicketSpMaintainUpdateRequest.IotMaintainPlanItemTopRequest> list3 = new ArrayList<CainiaoIotTicketSpMaintainUpdateRequest.IotMaintainPlanItemTopRequest>();
CainiaoIotTicketSpMaintainUpdateRequest.IotMaintainPlanItemTopRequest obj4 = new CainiaoIotTicketSpMaintainUpdateRequest.IotMaintainPlanItemTopRequest();
list3.add(obj4);
obj4.setPayRole("merchant");
obj4.setItemCode("3241");
obj1.setIotMaintainPlanItemList(list3);
obj1.setMaintainAbilities("SEND_BACK_AND_SEND_OUT");
obj1.setReceiverName("李四");
obj1.setOtherFee("100.23");
obj1.setReceiverAddress("浙江省杭州市西湖区西溪首座B-1");
obj1.setMaintainMethod("323");
obj1.setReceiverPhone("18222222222");
obj1.setPayMethod("payBefore");
obj1.setFeeRemark("维修费用");
obj1.setWarrantyType("under_warranty");
obj1.setEventTypeList("342");
req.setParam(obj1);
CainiaoIotTicketSpMaintainUpdateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<cainiao_iot_ticket_sp_maintain_update_response>
    <result>
        <success>true</success>
        <error_desc>系统错误</error_desc>
        <error_code>SYSTEM_ERROR</error_code>
    </result>
</cainiao_iot_ticket_sp_maintain_update_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

返回
顶部