update_events
Para marcar un llenado o una descarga de combustible como falsos, o para eliminar dicha marca, utilice el método unit/update_events.
Los eventos marcados como falsos se muestran en los informes solo si la opción Mostrar eventos falsos está habilitada en los ajustes de la plantilla de informes.
Endpoint
svc=unit/update_events¶ms={
"events": [
{
"itemId": <long>,
"resourceId": <long>,
"eventType": <text>,
"timeFrom": <uint>,
"timeTo": <uint>,
"params": {
"mark": <uint>
}
}
]
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
| events | Matriz de eventos a actualizar. |
| itemId | ID de la unidad. |
| resourceId | ID del recurso en el que se almacena el informe ejecutado. |
| eventType | Tipo de evento: lls (nivel de combustible), theft (descarga de combustible), filling (llenado de combustible). |
| timeFrom | Inicio del evento, fecha y hora UNIX. |
| timeTo | Fin del evento, fecha y hora UNIX. |
| params | Objeto con los parámetros actualizados. |
| mark | Marca de evento falso: 1 para marcar el evento como falso, 0 para eliminar la marca. |
Respuesta
Si la solicitud se completa correctamente, se devuelve una respuesta en el siguiente formato:
{
"items": [
{
"itemId": <long>, /* ID de la unidad. */
"error": <uint>, /* Resultado del evento: 0 si la marca se actualizó, 7 si no hay derecho de acceso. */
"msgs": <uint> /* Cantidad de mensajes actualizados. */
}
]
}
La matriz items contiene un objeto por cada evento de la solicitud, en el mismo orden.
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos. |
| 5 | Los eventos están deshabilitados para la unidad. |
| 7 | No cuenta con el derecho de acceso Crear, modificar y eliminar plantillas de informes al recurso, o con el derecho de acceso Ver objeto y sus propiedades básicas a la unidad. |
Ejemplo
Para marcar como falsos dos eventos de llenado de combustible de la unidad con ID 1285, se utiliza la siguiente solicitud. El parámetro mark_type se establece como fillings para marcar solo los llenados, y no las descargas de combustible registradas en el mismo momento:
svc=unit/update_events¶ms={
"events": [
{
"itemId": 1285,
"resourceId": 123,
"eventType": "lls",
"timeFrom": 1689734883,
"timeTo": 1689734883,
"params": {
"mark": 1,
"mark_type": "fillings"
}
},
{
"itemId": 1285,
"resourceId": 123,
"eventType": "lls",
"timeFrom": 1689737145,
"timeTo": 1689737145,
"params": {
"mark": 1,
"mark_type": "fillings"
}
}
]
}
La respuesta contiene un objeto por cada evento de la solicitud. En este ejemplo, error: 0 en ambos eventos significa que la marca de evento falso se actualizó correctamente, y msgs: 1 significa que se actualizó un mensaje para cada evento:
{
"items": [
{
"itemId": 1285,
"error": 0,
"msgs": 1
},
{
"itemId": 1285,
"error": 0,
"msgs": 1
}
]
}