CloseWO

Cierra las órdenes de trabajo que indique, como hace Close Work Order en la página de la orden de trabajo. Utilícelo cuando el trabajo ha terminado en su sistema. Para cancelar órdenes de trabajo, use en su lugar CancelWO; para reabrir las cerradas, use ReopenWO.

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

POST /api/v1/CloseWO
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 cierra las órdenes de trabajo de una en una, en el orden de la lista. Cada una se cierra o se rechaza por separado: un rechazo no detiene las demás ni deshace las ya cerradas. Las demás órdenes de trabajo de sus expedientes no se cierran.

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
Se cumplen las validaciones de su empresa para Save WO Header, Save Job Header y Close Manually.	Sus propios mensajes
Si el flujo de trabajo tiene operaciones de almacén y la orden de trabajo tiene artículos de almacén, estos están confirmados.	Items not committed

Una orden de trabajo que ya está cerrada o cancelada se deja como está, y su Info indica Work Order is already closed. o Work Order is already cancelled.

Respuesta

RetInfo tiene un elemento por cada identificador, en el orden en que los envió. RowsAffected es el número de elementos cuyo Success es true. Code es 1 cuando el Success de al menos un elemento es true, y 0 cuando no lo es el de ninguno; 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": "Items not committed" },
    { "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 TrakIT ha aceptado la orden de trabajo, false si la ha rechazado.
Info	Por qué se ha rechazado la orden de trabajo, o una nota. Vacío si esta solicitud la ha cerrado. Léalo junto con Success: consulte Reglas para una orden de trabajo que ya estaba cerrada o cancelada.

Notas

• Una orden de trabajo cerrada recibe el estado Closed (3 en GetWO), con la fecha y el usuario de la API como usuario que la cerró. Su registro de auditoría indica Closed via API.
• Por cada orden de trabajo cerrada, 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 Close Manually, y avisa a los usuarios que se han suscrito a las notificaciones Close WO.
• Si una solicitud agota el tiempo de espera, puede volver a enviarla: las órdenes de trabajo ya cerradas se dejan como están.