CancelWO

Cancela las órdenes de trabajo que indique, como hace Cancel Work Order en la página de la orden de trabajo. Utilícelo cuando un contenedor o una carga se retira de un expediente en su sistema. Para cerrar órdenes de trabajo terminadas, use en su lugar CloseWO; para reabrir las canceladas, use ReopenWO.

Cómo iniciar sesión y leer la respuesta: Autenticación, Respuestas.

POST /api/v1/CancelWO
Token: your-token
Content-Type: application/json

[48211, 48212, 48299]

Campo	Obligatorio	Significado
El cuerpo	Sí	Una lista JSON de identificadores de órdenes de trabajo, números enteros. No un objeto: la propia lista es el cuerpo.

TrakIT cancela las órdenes de trabajo de una en una, en el orden de la lista. Cada una se cancela o se rechaza por separado: un rechazo no detiene las demás ni deshace las ya canceladas. Las demás órdenes de trabajo de sus expedientes no se cancelan.

Reglas

Para la solicitud:

Regla	Info si no se cumple
El encabezado Token contiene un token válido.	Token missing in header, Token invalid or expired, u otra respuesta indicada en Token de inicio de sesión
El usuario es un administrador del sistema con acceso a la API.	API User must be SysAdmin with API Access
El cuerpo es una lista de al menos un identificador.	No WO IDs supplied

Para cada orden de trabajo, en el Info de su elemento de RetInfo:

Regla	Info si no se cumple
Una orden de trabajo tiene ese identificador.	No such work order
Ninguno de sus artículos está confirmado en un almacén.	Cannot cancel Work Order with committed items
Se cumplen las validaciones de su empresa para Save WO Header, Save Job Header y Cancel WO.	Sus propios mensajes
La orden de trabajo está activa o abandonada. Una orden de trabajo cerrada debe reabrirse antes de poder cancelarla.	Work Order is already cancelled, Work Order is already closed

Respuesta

RetInfo tiene un elemento por cada identificador, en el orden en que los envió. RowsAffected es el número de órdenes de trabajo canceladas. Code es 1 cuando se ha cancelado al menos una, y 0 cuando no se ha cancelado ninguna; Info está vacío en ambos casos. Lea siempre los elementos.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    { "WOID": 48211, "Success": true, "Info": "" },
    { "WOID": 48212, "Success": false, "Info": "Work Order is already closed" },
    { "WOID": 48299, "Success": false, "Info": "No such work order" }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
WOID	El identificador de la orden de trabajo, tal como lo envió.
Success	true si la orden de trabajo se ha cancelado, false si se ha rechazado.
Info	Por qué se ha rechazado la orden de trabajo. Vacío si se ha cancelado.

Notas

• Una orden de trabajo cancelada recibe el estado Cancelled (2 en GetWO), con la fecha y el usuario de la API como usuario que la canceló. Su registro de auditoría indica Cancelled via API. La API no registra ningún motivo de cancelación.
• La orden de trabajo sale del seguimiento de retrasos, y sus movimientos de patio dejan de estar vinculados a ella.
• A diferencia de la cancelación en TrakIT, la API no envía ningún correo electrónico al responsable de la orden de trabajo.
• Por cada orden de trabajo cancelada, TrakIT obtiene el valor de sus campos de datos calculados, ejecuta las acciones de eventos y datos que correspondan y las acciones de su empresa para Cancel WO, y avisa a los usuarios que se han suscrito a las notificaciones Cancel WO.
• Si una solicitud agota el tiempo de espera, puede volver a enviarla: las órdenes de trabajo ya canceladas se rechazan con Work Order is already cancelled y siguen canceladas.