文档中心 > API类目 > 淘天物流API

taobao.logistics.wms.device.report (仓内传感器设备数据回告接口)

仓内传感器设备数据回告接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
logistics_device_event_dto LogisticsDeviceEventDTO 必须 设备回告事件
  • └ supplier_id
  • String
  • 必须
  • 12123123
  • 服务商ID,请调用前咨询实施
  • └ unique_code
  • String
  • 必须
  • 4234123123
  • 幂等码,全局唯一,若超时重复回告,请确保该字段不变
  • └ resource_code
  • String
  • 必须
  • WAREHOUSE0001
  • 资源编码,若关联的是仓库,请填入仓库编码
  • records
  • DeviceRecordDTO []
  • 必须
  • LIST
  • 设备回告事件中的数据
  • └ record_type
  • String
  • 必须
  • TEMPERATURE
  • 设备回告数据类型,温度:TEMPERATURE;湿度:HUMIDITY
  • └ record_unit
  • String
  • 必须
  • 设备回告数据的单位,若为温度,请传入摄氏度的单位 ℃,若为湿度,请传入相对湿度的单位 %
  • └ record_value
  • String
  • 必须
  • 25
  • 回告数据的值
  • └ outer_event_code
  • String
  • 必须
  • EVENT0001
  • 外部事件编码
  • └ event_time
  • Date
  • 必须
  • 2024-01-04 08:12:20
  • 数据生成的时间
  • └ device_code
  • String
  • 必须
  • DEVICE0001
  • 设备编码
  • └ event_type
  • String
  • 必须
  • DATA_RECORD
  • 事件类型,数据回告请填写: DATA_RECORD
  • └ device_name
  • String
  • 可选
  • 常温仓西北角温湿度传感器
  • 设备名称,建议填写
  • └ resource_type
  • String
  • 必须
  • WAREHOUSE
  • 资源类型,若是仓库,请填写 WAREHOUSE

响应参数

名称 类型 示例值 描述
result DataResult 结果
  • └ success
  • Boolean
  • success
  • 是否成功
  • └ error_code
  • Boolean
  • OK
  • 错误码
  • └ message
  • String
  • 无错误
  • 错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
LogisticsWmsDeviceReportRequest req = new LogisticsWmsDeviceReportRequest();
LogisticsWmsDeviceReportRequest.LogisticsDeviceEventDTO obj1 = new LogisticsWmsDeviceReportRequest.LogisticsDeviceEventDTO();
obj1.setSupplierId("12123123");
obj1.setUniqueCode("4234123123");
obj1.setResourceCode("WAREHOUSE0001");
List<LogisticsWmsDeviceReportRequest.DeviceRecordDTO> list3 = new ArrayList<LogisticsWmsDeviceReportRequest.DeviceRecordDTO>();
LogisticsWmsDeviceReportRequest.DeviceRecordDTO obj4 = new LogisticsWmsDeviceReportRequest.DeviceRecordDTO();
list3.add(obj4);
obj4.setRecordType("TEMPERATURE");
obj4.setRecordUnit("℃");
obj4.setRecordValue("25");
obj1.setRecords(list3);
obj1.setOuterEventCode("EVENT0001");
obj1.setEventTime(StringUtils.parseDateTime("2024-01-04 08:12:20"));
obj1.setDeviceCode("DEVICE0001");
obj1.setEventType("DATA_RECORD");
obj1.setDeviceName("常温仓西北角温湿度传感器");
obj1.setResourceType("WAREHOUSE");
req.setLogisticsDeviceEventDto(obj1);
LogisticsWmsDeviceReportResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<logistics_wms_device_report_response>
    <result>
        <success>success</success>
        <error_code>OK</error_code>
        <message>无错误</message>
    </result>
</logistics_wms_device_report_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

返回
顶部