Ir al contenido

GetJob

Devuelve un expediente, buscado por su referencia, con todas sus órdenes de trabajo. Utilícelo para seguir un expediente que ha creado con CreateJob, o para copiar un expediente en su propio sistema. Para leer una orden de trabajo por su identificador, use GetWO.

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

GET /api/v1/GetJob?Num=EXBL2610045
Token: your-token
Parámetro Obligatorio Significado
Num Sí La referencia del expediente (campo de cabecera TD), por ejemplo el número de conocimiento de embarque, tal como la guarda TrakIT: sin espacios. Las mayúsculas no importan. No es el identificador del expediente.

Sin Num, la solicitud no llega al punto de conexión y TrakIT responde con el estado HTTP 404 (consulte Errores).

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
Num no está vacío. ... not supplied, que empieza por el nombre corto que su instalación da a la referencia del expediente: de forma predeterminada T/D not supplied
Un expediente tiene esa referencia. No such record

Si tiene éxito, RetInfo es el expediente. RowsAffected e Identity son 0. Created está en UTC, sin zona horaria (consulte Fechas y horas).

{
"Code": 1,
"Info": "",
"RetInfo": {
"JobID": 10457,
"Num": "EXBL2610045",
"Customer": "Example Trading Ltd",
"Shipper": "Example Exports Co",
"Receiver": "Example Trading Ltd",
"RevDate": null,
"JobType": "Door to Door",
"CargoType": "FCL",
"Commodity": "Ceramic tiles",
"Incoterms": "CIF",
"Created": "2026-10-19T08:41:27.13",
"WFSerial": "IMPSEA/26/0412",
"Workflow": "Import Sea Freight",
"WFType": "Import",
"WOCount": 2,
"WOList": [
{ "WorkOrderID": 48211, "Workflow": "Import Sea Freight", "...": "..." },
{ "WorkOrderID": 48212, "Workflow": "Import Sea Freight", "...": "..." }
]
},
"RowsAffected": 0,
"Scalar": null,
"Identity": 0
}

Las etiquetas en negrita son las de la cabecera del expediente y de los campos de cabecera.

Campo Significado
JobID El identificador del expediente.
Num La referencia del expediente (Transport Document, o el nombre que le da su instalación).
Customer, Shipper, Receiver Los nombres de las entidades Customer, Shipper y Receiver, o null. Sus identificadores están en cada orden de trabajo: CustomerID, ShipperID, ReceiverID.
RevDate La fecha de reconocimiento de ingresos y gastos del expediente, a medianoche, o null.
JobType Los nombres de los tipos de expediente del expediente (Job Type), separados por una coma y un espacio. Vacío si no tiene ninguno.
CargoType El Cargo Type como nombre, por ejemplo FCL o BreakBulk: consulte Tipos de mercancía. Vacío si el expediente no tiene ninguno.
Commodity La mercancía de las órdenes de trabajo del expediente que no están canceladas. Si difieren, la última por orden alfabético.
Incoterms Los Incoterms, separados por comas, o null.
Created Cuándo se creó el expediente, en UTC.
WFSerial El Workflow Serial del expediente, su número de serie en su flujo de trabajo, o null si el flujo de trabajo no numera sus expedientes.
Workflow El nombre del flujo de trabajo.
WFType El tipo del flujo de trabajo: Import, Export, RoundTrip o NonShipment.
WOCount El número de órdenes de trabajo del expediente que no están canceladas.
WOList Todas las órdenes de trabajo del expediente, incluidas las canceladas, por orden de identificador. Cada una es un objeto orden de trabajo, el mismo que devuelve GetWO.