UpdateWOHeader

Cambia algunos campos de cabecera de una orden de trabajo abierta: lo que hace Modificar una orden de trabajo en TrakIT, para los campos que se listan a continuación. Utilícelo cuando su sistema conoce un dato después de crear el expediente con CreateJob, por ejemplo el número de contenedor de una reserva o el transportista por carretera que lo recogerá. Para registrar eventos y campos de datos, use en su lugar SaveSeqData.

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

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

{
  "WOID": 48211,
  "Fields": [
    { "ContNum": "ABCU1234560" },
    { "SealNum": "SL778812" },
    { "TransID": 2210 },
    { "Weight": 21450.5 }
  ]
}

Campo	Obligatorio	Significado
WOID	Sí	El identificador de la orden de trabajo, un número entero.
Fields	Sí	Los campos de cabecera que se cambian: una lista de objetos, cada uno con un campo de la tabla siguiente y su nuevo valor. Ponga un campo en cada objeto: TrakIT solo lee el primero.

TrakIT lee WOID y Fields por su nombre, y estos dos nombres distinguen entre mayúsculas y minúsculas. Los nombres de los campos de Fields no: ContNum y contnum son el mismo.

Campos de cabecera que puede cambiar

Nombre cada campo como se indica a continuación. Los campos que no envíe conservan sus valores.

Campo	Significado
ContNum	Container No., como máximo 20 caracteres. TrakIT lo guarda tal como lo envía: envíelo en mayúsculas y sin espacios. Una cadena vacía lo borra. No se cambia mientras la orden de trabajo tiene una Yard Position.
SealNum	Seal Number, como máximo 100 caracteres: letras de la A a la Z, cifras, espacios y # $ % + , - . / @ _.
Commodity	Commodity, como máximo 500 caracteres.
LoadType	Load Type: el código o el código alternativo de un tipo de carga activo, por ejemplo 22G1. TrakIT guarda el código propio del tipo de carga.
OpID	Carrier: un identificador de entidad, o 0 para quitar el transportista.
TransID	Transporter: un identificador de entidad, o 0 para quitarlo.
RetTransID	Return Transporter: un identificador de entidad, o 0 para quitarlo.
OwnCont	Shipper Container: true si el contenedor es propiedad del cargador; si no, false.
Resp	Responsible Person: un identificador de usuario, por ejemplo JSMITH.
Weight	Weight, en kilogramos, de 0 a 50 000 000.
Priority	La prioridad de la orden de trabajo, un número entero: 1 Critical, 2 High, 3 Normal, 4 Low o 5 Very Low. 0 establece 3.

Envíe los números como números JSON y OwnCont como true o false. Para estos campos se rechaza un null: para quitar una entidad, envíe 0.

Los demás campos de cabecera, como el cliente, los agentes, el volumen o el tipo de expediente, no se pueden cambiar aquí. Un cambio solo se aplica a esta orden de trabajo, no a las demás órdenes de trabajo de su expediente.

Reglas

TrakIT lee los campos en el orden en que los envía y se detiene en el primero que rechaza. Después comprueba la cabecera de la orden de trabajo tal como quedaría tras el cambio: las comprobaciones del responsable, el peso, el tipo de carga, la mercancía, el número de precinto y la prioridad también se aplican a los valores que no envía. No se guarda nada salvo que se superen todas las comprobaciones.

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
La solicitud tiene un cuerpo JSON.	No request body found
WOID es un número entero.	WOID missing or invalid
Fields es una lista.	No field list found
Una orden de trabajo tiene ese identificador.	No such work order
La orden de trabajo está activa o abandonada, no cerrada ni cancelada.	WO ... is not open
Cada campo de Fields es uno de los campos anteriores.	... is not recognized or supported
OpID, TransID, RetTransID, Weight y Priority son números.	OpID should be numeric, TransID should be numeric, RetTransID should be numeric, Weight should be numeric, Priority should be numeric
OwnCont es true o false.	OwnCont must be boolean
El responsable no está vacío.	Responsible Person must be specified.
El peso está entre 0 y 50 000 000.	Weight must be in range 0 to 50,000,000 Kg
El tipo de carga, si lo hay, es el código o el código alternativo de un tipo de carga activo.	Load Type is not valid
Si el contenedor está en la lista de contenedores con un tipo de carga verificado, la orden de trabajo tiene ese tipo de carga.	Load Type '...' does not match Container Master
La mercancía no contiene ningún script.	Commodity contains invalid characters
El número de precinto solo contiene los caracteres admitidos.	Seal Number contains invalid characters
La prioridad está entre 1 y 5.	Priority must be between 1 (Urgent) and 5 (On Hold)
El número de precinto tiene como máximo 100 caracteres.	Seal Number can be a maximum of 100 characters
Se cumplen las validaciones de su empresa para Save WO Header y Save Job Header.	Sus propios mensajes
Resp es un identificador de usuario.	Unable to save. User ... is not valid
OpID, TransID y RetTransID son identificadores de entidades, y ContNum tiene como máximo 20 caracteres.	Unable to save

Respuesta

Si tiene éxito, Code es 1, Info está vacío y RetInfo es null. Lea la orden de trabajo con GetWO para verla.

{
  "Code": 1,
  "Info": "",
  "RetInfo": null,
  "RowsAffected": 0,
  "Scalar": null,
  "Identity": 0
}

Notas

• El cambio queda registrado en el registro de auditoría de la orden de trabajo a nombre del usuario de la API, cuando un valor ha cambiado.
• Los campos de datos del transportista, de los transportistas por carretera y de los agentes de la orden de trabajo se copian en sus eventos y datos cuando su empresa lo ha configurado así: consulte Copiar valores en las órdenes de trabajo.
• Después, TrakIT ejecuta las acciones de su empresa para Save WO Header y avisa a los usuarios que se han suscrito a las notificaciones Update WO Header.
• Envíe los valores que exige su flujo de trabajo: un campo de cabecera que este hace Mandatory en su pestaña Header Fields no debe borrarse, una mercancía debe proceder de la lista del flujo de trabajo si la tiene, y un número de contenedor debe ser válido para el flujo de trabajo.