Cancelar OT

Las Órdenes de Trabajo pueden ser canceladas 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 o que se haya vencido no podrá ser cancelada. Se recibirá un 409 CONFLICT en tal caso.

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

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.
cause*	String	Motivo de la cancelación. Max 500 caracteres

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

{
    "success": false,
    "error": {
        "status": 400,
        "type": "BAD_REQUEST",
        "userMessage": "'cause' es un campo requerido de 500 caracteres máx."
    }
}

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 cancelada */
    }
}

409: Conflict La OT ya no puede ser cancelada

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "No se puede cancelar la OT cuando se encuentra en estado 'CERRADA_NO_CUMPLIDA'"
    }
}

Ejemplo de request

El endpoint nos permite, además de cancelar la OT, modificar sus etiquetas. Podría ser útil para dejar la OT con una identificación indicando que fue cancelada por determinado medio. Ej: "Cancelada por email" (Previamente debería estar creada esta etiqueta)

body

{
    "cause": "No me encuentro en el domicilio por vacaciones",
    "labels_ids": [1,6],        /* Opcional */
}

cause: Requerido. Motivo de la cancelación

labels_ids: Es opcional. En caso de no enviarse, la OT será cancelada 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 cancelar la OT y agregarle dicha nueva etiqueta.

Análisis de la respuesta

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

La respuesta solo indica que la OT fue cancelada.