Wialon para desarrolladores Manual de usuario Documentación de API unit create_task

create_task

El método unit/create_task permite crear un asunto para una unidad. Para modificar un asunto existente, utilice unit/update_task. Para obtener información sobre cómo funcionan los asuntos en el sistema de rastreo, consulte Asuntos.

En Wialon Local, este método está disponible a partir de la versión 2504.

Endpoint

Copied!

svc=unit/create_task&params={
	"itemId": <long>,
	"props": {
		"key1": <long>,
		"key2": <text>,
		.....
	}
}

Ejemplo de solicitud:

Copied!

https://hst-api.wialon.com/wialon/ajax.html?
svc=unit/create_task&
params={
  "itemId": 1514,
  "props": {
    "task_sub_type": 22,
    "task_evt_name": "Refueling",
    "task_description": "Refuel the vehicle before the trip",
    "task_priority": 3,
    "task_params": {
      "filled": 40
    }
  }
}&
sid=SESSION_IDENTIFIER

Parámetros

La solicitud debe contener los siguientes parámetros:

Parámetro	Descripción
`itemId`	El ID de la unidad.
`props`	El objeto con las propiedades del asunto (pares clave-valor). La lista de propiedades disponibles se muestra a continuación.

Propiedades del asunto

Las propiedades obligatorias están marcadas con un asterisco (*).

Propiedad	Tipo	Descripción
`task_sub_type`*	Integer	El subtipo del asunto. Los valores admitidos son los siguientes: `21` (personalizado) `22` (llenado de combustible) `23` (recarga de batería) `26` (trabajo de mantenimiento) Para conocer todos los subtipos, consulte Subtipos de eventos y asuntos.
`task_evt_name`*	String	El nombre del asunto. No debe estar vacío.
`task_description`	String	La descripción del asunto.
`task_assignee`	Long	El ID del usuario al que se asigna el asunto. Se requiere el derecho de acceso Actuar en nombre del usuario a este usuario.
`task_priority`	Integer	La prioridad del asunto. Los valores admitidos son los siguientes: `1` (Baja) `2` (Media) `3` (Alta) Si no se indica la propiedad, se utiliza `2`.
`task_status`	Integer	El estado del asunto. Un asunto nuevo siempre recibe el estado `1` (Nuevo), por lo que la propiedad debe ser `1` o no indicarse.
`task_create_time`	Integer	La hora de creación del asunto (hora Unix). Si no se indica la propiedad, es `0` o es posterior a la hora actual del servidor, se utiliza la hora actual del servidor. La hora de actualización del asunto se establece en el mismo valor.
`task_address_x` `task_address_y`	Double	Las coordenadas del asunto. Indique ambas propiedades. Si solo se indica una de ellas, se ignoran ambas.
`task_params`	Object	Parámetros adicionales del asunto. Claves admitidas: `filled` (cantidad de combustible llenado) `charged` (cantidad de energía cargada) `cost` (coste del asunto) `engine_hours` (horas de motor del vehículo) `mileage` (kilometraje del vehículo) Los valores de `filled` y `mileage` se indican en el sistema de medida de la unidad.

Las siguientes propiedades no se pueden establecer al crear un asunto. Si las pasa, utilice los valores que se indican a continuación:

Propiedad	Valor admitido
`task_id`	Cualquiera. El valor se ignora y el servidor genera el ID del asunto.
`task_update_time`	Cualquiera. El valor se ignora y se utiliza el valor de `task_create_time`.
`task_tags`	Una cadena vacía.
`task_comments`	Un array vacío.
`task_done_rejected`	`0`.

Derechos de acceso

Para crear un asunto, se requiere el derecho de acceso Modificar asuntos a la unidad. Para asignar el asunto a un usuario mediante task_assignee, también se requiere el derecho de acceso Actuar en nombre del usuario a este usuario.

El servicio Asuntos debe estar habilitado para la cuenta.

Respuesta

Si la solicitud se completa correctamente, se devuelve una respuesta vacía.

Copied!

{}

Para obtener el ID del asunto creado, utilice messages/get_task_messages.

De lo contrario, se devuelve un código de error. Ejemplo:

Copied!

{
    "error": 4,
    "reason": "INVALID_INPUT_PARAMS"
}

Códigos de error

Código de error	Descripción	Valor del campo `reason`
4	Parámetros de entrada incorrectos. Una de las siguientes situaciones: falta un parámetro o una propiedad obligatoria o su tipo es incorrecto el valor de `task_sub_type` no está en la lista de valores admitidos `task_evt_name` está vacío `task_status` no es `1` el usuario indicado en `task_assignee` no existe `task_tags`, `task_comments` o `task_done_rejected` no está vacío	`INVALID_INPUT_PARAMS`
6	Los asuntos no son compatibles con el elemento con el `itemId` indicado.	`UNKNOWN_ERROR`
7	Acceso denegado. Una de las siguientes situaciones: la unidad con el `itemId` indicado no existe o no está disponible para el usuario actual falta el derecho de acceso a la unidad Modificar asuntos falta el derecho de acceso Actuar en nombre del usuario al usuario indicado en `task_assignee` el servicio Asuntos no está habilitado para la cuenta	`NO_ACCESS_TO_USER` (solo si falta el derecho de acceso al usuario)

Para conocer los códigos de error generales, consulte Códigos de error.

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