Órdenes de trabajo

Las órdenes de trabajo son otro tipo de registro que se puede cargar en la plataforma. Una órden de trabajo relaciona labores o actividades (previamente creadas) con información extra que puede resultar útil para el usuario y para la hora de llevar a cabo las distintas labores.

A la hora de cargar la hora de trabajo el usuario debe especificar las actividades se van a llevar a cabo, la fecha de la órden, notas o comentarios, y recomendaciones específicas sobre condiciones externas a tener en cuenta cuando se realice cumpla la órden de trabajo.

Recomendaciones

Las recomendaciones son items específicos que se asocian a una órden de trabajo. Las recomendaciones disponibles dependen de las actividades seleccionadas.

APIs

GET

Listado de órdenes de trabajo creadas, separadas por año.

GET /api/work_orders

En la query string es necesario especificar el año bajo el parámentro yeargroup:

• yeargroup : integer, año del cual se quieren obtener las órdenes de trabajo

Ejemplo de respuesta:

{
	"data": [
		{
			"recomendations": [
				{
					"type": {
						"id": 1,
						"name": "Temperatura"
					},
					"value": "25 grados"
				}
			],
			"uuid": "6ecb29ba-004b-1d1e-95ea-0dbd40e43f58",
			"yeargroup": 2022,
			"notes": "Realizar la actividad a las 13hs",
			"labours": [
				{
					"yeargroup": 2022,
					"idLabourType": 2,
					"fieldName": "Nombre del lote",
					"uuid": "7a5ee236-8527-11ec-834d-7b82f1b6b166",
					"farmName": "Nombre del campo"
				},
				{
					"yeargroup": 2022,
					"idLabourType": 1,
					"fieldName": "Nombre de otro lote",
					"uuid": "900c80ac-8527-11ec-834d-0f130893a0a2",
					"farmName": "Nombre del campo"
				}
			],
			"date": "2022-02-03T00:00:00+00:00",
			"name": "Nombre de la órden"
		},
        {...}
    ]
}

GET

Listado de recomendaciones que se pueden utilizar dependiendo del tipo de actividad seleccionada. Solo se pueden utilizar las reocomendaciones que acepten los id de las labores.

Por ejemplo, la recomendación Temperatura solo puede ser utilizada si en la órden de trabajo existe una labor del tipo 1. Ver type_id en la API de labores.

GET /api/work_orders/recomendations/types

Respuesta:

[
	{
		"labourTypeIds": [1],
		"id": 1,
		"name": "Temperatura"
	},
	{
		"labourTypeIds": [2,3],
		"id": 2,
		"name": "Velocidad de avance"
	},
	{
		"labourTypeIds": [1],
		"id": 3,
		"name": "Dirección del viento"
	},
	{
		"labourTypeIds": [1],
		"id": 4,
		"name": "Velocidad del viento"
	},
	{
		"labourTypeIds": [1,2,3],
		"id": 5,
		"name": "Humedad"
	},
	{
		"labourTypeIds": [3],
		"id": 6,
		"name": "Profundidad"
	}
]

POST

Crea una nueva órden de trabajo.

Content-Type: application/json
POST /api/work_orders

En el cuerpo de la consulta se incluyen los siguientes parámetros:

• uuid: String, UUID que servirá de identificador para la órden de trabajo Requerido
• labours: Array, Array de UUIDs de labores Requerido
• recomendations: Array, Array de objetos que contienen el tipo de recomendación y el valor
  • type_id: String, ID de la recomendación. Ver endpoint de recomendaciones
  • value: String, Texto de la recomendación
• date: date, Fecha de la órden de trabajo, en el formato YYYY-MM-DD Requerido
• notes: String, Comentarios o notas
• name: String, Nombre de la órden de trabajo
• yeargroup: date, Año de la campaña Requerido

Ejemplo de cuerpo:

{
    "uuid": "89ccE57E-BDb3-13De-964d-7FA4FcB2db2A",
    "labours": [
        "900c80ac-8527-11ec-834d-0f130893a0a2"
    ],
    "recomendations": [
        {
            "type_id": "1",
            "value": "25 grados"
        }
    ],
    "date": "2022-02-03",
    "notes": "Notas o comentarios",
    "name": "Nombre de la órden de trabajo",
    "yeargroup": "2022"
}

Devuelve un objeto con el UUID en caso de éxito.

Ejemplo de respuesta:

{
	"data": {
		"uuid": "89cce57e-bdb3-13de-964d-7fa4fcb2db2a"
	}
}

PUT

Modifica una órden de trabajo creada.

Content-Type: application/json
PUT /api/work_orders/:uuid

• uuid: String, UUID de la órden de trabajo a modificar

En el cuerpo se envían los mismos datos que en el POST y la respuesta es igual.

Si algún parámetro opcional no se envía, se reemplazará lo que contenga por un null

DELETE

Elimina una órden de trabajo creada.

DELETE /api/work_orders/:uuid

• uuid: String, UUID de la órden de trabajo a eliminar

GET (Descargar)

Descarga una órden de trabajo.

GET /api/work_orders/:uuid/download

• uuid: String, UUID de la órden de trabajo

En la query string se especifica el tipo de archivo bajo el parámetro type. Este puede ser pdf o excel.

Ejemplo de URL completa:

• /api/work_orders/:uuid/download?type=pdf