GetAssetLocation

Devuelve dónde está uno de los contenedores de un cliente: la última posición comunicada para un activo de su orden de trabajo, como el camión que lo transporta, con el último evento que puede ver el cliente. El sistema de un cliente lo usa para seguir un contenedor. Para obtener de una vez todas las órdenes de trabajo abiertas del cliente con sus posiciones, use GetList; para las órdenes de trabajo de un expediente con sus datos, use GetShipment.

En TrakIT, los activos se añaden a una orden de trabajo en su recuadro Assets, y las posiciones de un activo con GPS están en la pestaña Positions del activo.

El punto de conexión responde para un solo cliente: la entidad cuya clave se envía. Cómo enviar la clave y leer la respuesta: Claves de API de las entidades, Respuestas.

GET /api/public/GetAssetLocation?APIKey=your-entity-key&ContainerNo=ABCU1234560&BookingNo=EXL-2610-0042

Envíe la clave en el parámetro APIKey de la cadena de consulta. Es la clave propia del cliente: la API Key que se muestra en la página de la entidad cuando Enable API Access está activado para la entidad (consulte campos de la entidad). La clave cambia cada año, y deja de funcionar cuando se desactiva Enable API Access: consulte Claves de API de las entidades. Codifique para URL la clave y los demás valores. La clave forma parte de la dirección, así que no incluya estas URL en los registros que comparta.

Parámetro	Obligatorio	Significado
APIKey	Sí	La clave de la entidad del cliente.
ContainerNo	Sí	El número de contenedor, como en la orden de trabajo. Las mayúsculas no importan.
BookingNo	Sí	La referencia del expediente del contenedor. Las mayúsculas no importan.

Los tres deben estar en la cadena de consulta: sin uno de ellos, TrakIT responde HTTP 404.

Reglas

Regla	Info si no se cumple
APIKey no está vacío.	API Key is required
APIKey es la clave de una entidad.	API Key is invalid
La clave es la de este año. La clave de cada entidad cambia el 1 de enero: obtenga la nueva desde la página de la entidad.	API Key expiry not found, API Key has expired. Please obtain new key.
La entidad existe.	API Key is invalid
Enable API Access está activado para la entidad.	API access is disabled

Respuesta

Si tiene éxito, Code es 1 y RetInfo es una lista con un elemento como máximo: la última posición registrada de los activos de las órdenes de trabajo que coinciden, entre los expedientes cuyo cliente es la entidad de la clave. RowsAffected es 1.

La lista está vacía, con RowsAffected 0 y Code todavía 1, cuando el cliente no tiene ningún expediente con esa referencia y ese contenedor, o cuando ningún activo de la orden de trabajo ha comunicado una posición.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    {
      "worder": "",
      "containerno": "ABCU1234560",
      "bookingno": "EXL-2610-0042",
      "gpsdate": "2026-10-20T09:42:00",
      "gpslat": 5.6312,
      "gpslong": -0.0174,
      "event": "Truck departed port",
      "eventstatus": "Y"
    }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}

Campo	Significado
worder	Siempre vacío.
containerno	El número de contenedor.
bookingno	La referencia del expediente.
gpsdate	Cuándo se comunicó la posición, en UTC. Consulte Fechas y horas.
gpslat, gpslong	La latitud y la longitud, en grados decimales.
event	El último evento que puede ver el cliente, por su nombre en el flujo de trabajo (el nombre del elemento maestro seguido de su sufijo), no por su nombre externo. Vacío cuando la orden de trabajo no tiene ningún evento así.
eventstatus	Y cuando la orden de trabajo tiene un evento que puede ver el cliente, N cuando no tiene ninguno.