GetContainerPosition

Devuelve dónde está un contenedor en un patio de contenedores: su zona y su posición de pila, cuándo se hizo su último movimiento, si está vacío y la orden de trabajo de ese movimiento. Un sistema de patio, como un sistema de terminal o de puerta, lo usa para comprobar un contenedor antes de moverlo, y registra el movimiento con ExecuteMove. En TrakIT, la misma información está en Inventario del patio y en Lista de contenedores.

Cómo enviar la clave y leer la respuesta: Claves de API, Respuestas.

GET /api/public/GetContainerPosition?Cont=ABCU1234560&WHKey=your-yard-key
Authorization: Bearer your-api-key

Envíe la clave en un encabezado Authorization con el esquema Bearer. La clave debe tener permiso para consultar contenedores (yard.contquery); el soporte de TrakIT lo configura. Sin el encabezado, o con otro esquema, TrakIT responde HTTP 401 sin cuerpo.

Parámetro	Obligatorio	Significado
Cont	Sí	El número de contenedor. Solo letras, cifras, - y _. Las mayúsculas no importan.
WHKey	Sí	La clave del patio, que el soporte de TrakIT le facilita con la clave de API. Codifíquela para URL.

Ambos deben ir en la cadena de consulta: sin uno de ellos, TrakIT responde HTTP 404.

Reglas

Regla	Info si no se cumple
Cont no está vacío.	Cont parameter is required
Cont solo contiene letras, cifras, - y _.	Container Number must be alphanumeric
La solicitud tiene un encabezado Authorization: Bearer.	Sin Info: HTTP 401 sin cuerpo.
La clave está activa y tiene permiso para consultar contenedores.	Key is disabled, not recognized or permission denied
WHKey es la clave de un patio.	WHKey is missing or invalid
TrakIT conoce el contenedor: está en la Lista de contenedores.	Container ... not found, con el número

Respuesta

Una respuesta correcta no es el sobre: es el propio contenedor.

{
  "ContNum": "ABCU1234560",
  "ISO": "45G1",
  "Zone": "Block A",
  "Position": "B4-R2-T1",
  "Bay": 4,
  "Row": 2,
  "Tier": 1,
  "LastMove": "2026-10-20T08:30:12",
  "IsEmpty": false,
  "WOID": 48211
}

Cuando TrakIT conoce el contenedor pero este no está en este patio, Position es Not in yard y los demás campos, salvo ContNum e ISO, son null.

Un rechazo es el sobre habitual, con Code e Info. Compruebe si hay ContNum antes de leer el contenedor.

Campo	Significado
ContNum	El número de contenedor.
ISO	El código de tipo del contenedor, por ejemplo 45G1.
Zone	El nombre de la zona en la que está el contenedor.
Position	La posición de pila, por ejemplo B4-R2-T1 para la bahía 4, la fila 2 y el nivel 1. Un contenedor que está en el patio sin posición de pila muestra On Truck si su último movimiento fue una entrada al patio o un movimiento sobre camión, o In Zone en caso contrario. Not in yard cuando no está en este patio.
Bay, Row, Tier	La bahía, la fila y el nivel de la posición de pila, o null si no la hay.
LastMove	Cuándo se realizó el último movimiento del contenedor, en UTC. Consulte Fechas y horas.
IsEmpty	true si el contenedor estaba vacío en su último movimiento, false si estaba lleno.
WOID	El identificador de la orden de trabajo vinculada al último movimiento, o null.