Skip to content
Navo24Navo24
Empieza gratis

Primeros pasos

Primeros pasos

Guía rápida de la API de seguimiento de contenedores: tu primera llamada a Navo24 en dos minutos sin clave, luego una API key y un envío en seguimiento.

Navo24 es inteligencia de carga a la que llamas directamente: seguimiento de contenedores y guías aéreas, itinerarios de navegación y fiabilidad, tarifas spot y planificación de carga. Cada producto ofrece una API REST, y la mayoría también un servidor MCP, todo con una única clave bearer.

Haz una llamada sin cuenta

La forma más rápida de ver datos reales es el endpoint público de la API de seguimiento de contenedores. No necesita clave.

curl -X POST https://api.trackingmcp.com/v1/track/public \
  -H "Content-Type: application/json" \
  -d '{"reference":"MEDU1234562"}'

Recibes un estado normalizado, el buque, los hitos y una ETA que indica si todavía es una previsión:

{
  "ok": true,
  "data": {
    "identifier": "MEDU1234562",
    "identifier_type": "container_id",
    "carrier_code": "MSCU",
    "carrier_name": "MSC",
    "status": "in_transit",
    "eta": "2026-07-03T06:00:00Z",
    "eta_is_estimated": true,
    "origin": "Ningbo",
    "destination": "Rotterdam",
    "vessel": { "name": "MSC TERESA", "lat": null, "lng": null },
    "events": [
      {
        "description": "Loaded on vessel",
        "location": "Ningbo",
        "event_code": "LOAD",
        "unlocode": "CNNGB",
        "datetime": "2026-06-18T22:10:00Z",
        "actual": true
      }
    ]
  }
}

Cuatro campos concentran casi todo el significado:

  • identifier_type es lo que hemos determinado que es realmente la referencia, que puede no coincidir con lo que suponías.
  • eta_is_estimated es true mientras la ETA es una previsión, false cuando ya es la llegada real y null cuando no tenemos ninguna ETA. Una fecha por sí sola no es una promesa.
  • actual en un evento es true para algo que ya ocurrió y false para algo planificado. Nunca tomes un movimiento planificado como un hecho.
  • carrier_code, origin, destination y unlocode son null cuando el transportista no indicó nada que pudiéramos resolver, en lugar de inventarlo.

Los endpoints públicos tienen límite de peticiones por IP y están pensados para una comprobación rápida. Cualquier uso a escala de cartera necesita una clave.

Obtén una API key

  1. Regístrate en trackingmcp.com.
  2. Abre la configuración de desarrollador y genera una clave. Lleva un prefijo de producto, por ejemplo tmcp_ para el seguimiento.
  3. Envíala como token bearer en cada petición autenticada.
curl https://api.trackingmcp.com/v1/containers/summary \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY"
{
  "ok": true,
  "data": {
    "total_active": 128,
    "exceptions": 6,
    "arriving_this_week": 14,
    "demurrage_risk_usd": 4820.5,
    "containers": []
  }
}

Empieza a seguir un envío

La superficie con clave requiere dos campos obligatorios, identifier e identifier_type. El tipo es uno de container_id, bill_of_lading o booking.

curl -X POST https://api.trackingmcp.com/v1/containers \
  -H "Authorization: Bearer tmcp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"identifier":"MEDU1234562","identifier_type":"container_id"}'
{
  "ok": true,
  "data": {
    "id": "8f1c2d4e-6a3b-4f52-9c70-11ab22cd33ef",
    "identifier": "MEDU1234562",
    "status": "in_transit",
    "carrier_code": "MSCU",
    "source": "direct_carrier"
  }
}

Guarda el id. Es un UUID, y todos los demás endpoints de contenedores se basan en él, no en el número de contenedor. Un contenedor que aceptamos pero no podemos resolver en el primer intento se devuelve con "status": "unknown" y un warning, y se completa en pocos minutos a medida que se ejecuta la nueva consulta.

La misma clave funciona en toda la familia cuando un producto acepta la credencial común. Consulta la guía de autenticación para conocer todos los detalles sobre prefijos y cabeceras.

Siguientes pasos