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

Copied!
svc=unit/update_events&params={
    "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.

Respuesta

Si la solicitud se completa correctamente, se devuelve una respuesta en el siguiente formato:

Copied!
{
  "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:

Copied!
svc=unit/update_events&params={
  "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:

Copied!
{
  "items": [
    {
      "itemId": 1285,
      "error": 0
    },
    {
      "itemId": 1285,
      "error": 0
    }
  ]
}

Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.