Mover a estado PENDIENTE

Las Órdenes de Trabajo pueden ser pasadas a PENDIENTE siempre que se encuentren en alguno de estos tres estados.

• PENDIENTE

• PROYECTADA

• ASIGNADA

De esta forma cualquier OT que haya sido completada por el técnico, vencida o cancelada no podrá pasar a estado PENDIENTE. Se recibirá un 409 CONFLICT en tal caso.

POST https://api.persat.com.ar/v1/work-orders/wo_id/topending

Path Parameters

Name	Type	Description
wo_id*	String	Identificador de la OT

Headers

Name	Type	Description
Authorization*	String	Bearer API_KEY
Content-Type*	String	application/json

Request Body

Name	Type	Description
labels_ids	Number[]	Array de numeros. Cada item representa una etiqueta que deberia estar creada en el sistema. De todas maneras, si no existe la etiqueta la consulta continua sin problemas. Debido a que es una referencia débil.

400: Bad Request Error en alguno de los campos enviados. userMessage contiene informacipon adicional.

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'labels_ids' es debe ser un array de enteros representando las etiquetas"
    }
}

404: Not Found El cliente o el schema_id no existen

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No hay una ot con este numero de wo_id: xxxx"
    }
}

200: OK La consulta se ejecutó con éxito

{
    "success": true,
    "data": {
        "wo_id": "9"   /* id identificador de la OT que paso a PENDIENTE */
    }
}

409: Conflict La OT ya no puede ser cancelada

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "No se puede pasar a pendiente la OT cuando se encuentra en estado 'CANCELADA'"
    }
}

Ejemplo de request

El endpoint nos permite, además de pasa la OT a PENDIENTE, modificar sus etiquetas. Podría ser útil para dejar la OT con una identificación indicando que fue pasada a pendiente por determinado motivo.

body

{ 
    "labels_ids": [1,6],        /* Opcional */
}

labels_ids: Es opcional. En caso de no enviarse, la OT será pasada a PENDIENTE y mantendrá las mismas etiquetas que tenia previamente. Si quisiera borrar sus etiquetas, entonces tendría que enviar un array vacio.

"labels_ids": [],

Recuerde que el valor de labels_ids termina pisando el valor original de la OT. Con lo cual si quisieramos agregar una etiqueta, deberíamos primero Obtener OT, para luego agregar al array de labels_ids la nueva etiqueta y asi poder finalmente ejecutar este endpoint para pasar la OT a pendiente y agregarle dicha nueva etiqueta.

Análisis de la respuesta

{
    "success": true,
    "data": {
        "wo_id": "9"   /* id identificador de la OT pasada a PENDIENTE */
    }
}

La respuesta solo indica que la OT fue pasada a PENDIENTE