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>,
"mark_type": <text>
}
}
]
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
events |
Array de eventos que se deben 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. |
mark_type |
Subtipo del evento que se debe marcar: fillings (llenado de combustible) o thefts (descarga de combustible). Obligatorio si eventType es lls. |
Para el mismo intervalo de tiempo se pueden registrar un llenado y una descarga de combustible. Utilice
mark_typepara indicar cuál de ellos se debe marcar como falso. Sin este parámetro, la marca se aplica a ambos.
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. */
}
]
}
El array items contiene un objeto por cada evento de la solicitud, en el mismo orden.
El campo error contiene 7 si el usuario no tiene el derecho de acceso Crear, modificar y eliminar plantillas de informes al recurso o el derecho de acceso Ver objeto y sus propiedades básicas a la unidad.
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. |
| 7 | El servicio de eventos no está disponible. Si no hay derecho de acceso a la unidad o al recurso, el error se devuelve para cada evento por separado en el campo error de la respuesta. |
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:
{
"items": [
{
"itemId": 1285,
"error": 0
},
{
"itemId": 1285,
"error": 0
}
]
}