Conectar Terminal49: rastrear contenedores por contenedor, conocimiento de embarque o reserva
Obtenga usted mismo una Developer Key gratuita en app.terminal49.com/developers/api-keys, péguela como único campo api_key en Integration, pruebe, mapee y active.
El conector de Terminal49 hace un solo trabajo: tracking de contenedores para drayage. Usted inicia el seguimiento con un número de contenedor, de conocimiento de embarque o de reserva, y el conector devuelve hitos, programas de buques y disponibilidad en terminal, incluido el Last Free Day, las retenciones (holds) y los cargos que reporta la terminal. Ese es todo el alcance: no trae pedidos, no crea envíos ni despachos, no reserva citas en terminal y no escribe nada de vuelta en Terminal49. Una conexión trabaja con una API Key de Terminal49.
Requisitos previos#
- Una cuenta de Terminal49 con la que pueda entrar en app.terminal49.com, para abrir usted mismo la página de claves API para desarrolladores. La clave es autoservicio: para empezar no hace falta llamar a ventas ni esperar aprobación.
- Al menos un número de contenedor, de conocimiento de embarque o de reserva que de verdad quiera rastrear, para contrastar los primeros resultados con un envío que conoce.
- Calcule su volumen de seguimiento antes de depender de la clave gratuita: una Developer Key gratuita rastrea hasta 100 contenedores. Es más que suficiente para evaluar la conexión, pero planifique la clave de producción según el número de contenedores que rastrea a la vez.
Obtener credenciales#
- Inicie sesión en app.terminal49.com y abra la página de claves API para desarrolladores: app.terminal49.com/developers/api-keys.
- Cree una clave en esa página. Una Developer Key gratuita basta para conectar y evaluar: rastrea hasta 100 contenedores.
- Copie la API Key completa de una vez y téngala lista para pegar. No la acorte y no le añada ningún prefijo: la clave por sí sola es toda la credencial.
- Solo hay esta credencial. No hay un usuario, contraseña, clave de sandbox ni segunda clave por separado que recoger, y pruebas y producción usan la misma dirección de Terminal49: la misma clave es la que prueba y la que queda en producción.
Completar en Integration#
- Abra Integration → Marketplace → Terminal49 → Nueva conexión.
- api_key, obligatorio, Terminal49 API Key: pegue la clave completa que copió de app.terminal49.com/developers/api-keys. Es el único campo de esta conexión. Es un campo de tipo contraseña y se guarda como secreto. Pegue solo la clave, sin la palabra "Token" ni "Bearer" delante: el sistema añade por sí mismo la forma del encabezado.
- Guarde la conexión y ejecute la prueba antes de cambiar cualquier otra cosa: con un solo campo, una prueba fallida trata de esa clave, no de averiguar cuál de muchos campos está mal.
Probar la conexión#
Haga clic en Probar la conexión. Con su clave completada, la prueba envía una solicitud real de solo lectura: GET https://api.terminal49.com/v2/tracking_requests?page[size]=1, con su clave enviada como "Authorization: Token <API_KEY>", con un tiempo límite de 12 segundos. Solo lee la primera página de sus solicitudes de seguimiento existentes, así que no cambia nada en Terminal49. Una respuesta aprobada vuelve como "Terminal49 authentication passed". Si la clave es rechazada, la prueba reporta HTTP_401. Si api_key está vacío, se detiene con MISSING_CREDENTIALS. Una solicitud que no puede completarse reporta CONNECTION_FAILED. Corrija la causa que indica el resultado y pruebe de nuevo.
Mapping / elegir plantilla#
Elija el mapping estándar de Terminal49. Toma cada resultado de seguimiento que devuelve Terminal49 (hitos, programa del buque y disponibilidad en terminal como Last Free Day, retenciones y cargos) y lo alinea con el registro del contenedor que sigue aquí en el tracking de drayage. Tras aprobar la prueba, inicie el seguimiento de un contenedor, conocimiento de embarque o reserva que conozca y compare los hitos y las fechas de terminal lado a lado con lo que Terminal49 muestra para el mismo envío. Si coinciden, el mapping es correcto y puede activar.
Activar#
Tras activar, puede iniciar el seguimiento desde un número de contenedor, de conocimiento de embarque o de reserva (dé uno de los tres, más el SCAC del transportista cuando lo tenga) y la conexión mantiene actualizados aquí los hitos, el programa del buque y la disponibilidad en terminal de esos contenedores. Las solicitudes de seguimiento están limitadas a 100 por minuto del lado de Terminal49, así que los inicios masivos muy grandes se reparten en lugar de lanzarse todos a la vez. Vigile los primeros resultados en Runs / Logs y compare algunos contenedores con Terminal49 antes de dejar la conexión sin supervisión.
Lo que esta conexión no hace: no trae pedidos ni envíos de ningún otro sistema, no crea despachos ni cargas, no reserva ni cambia citas en terminal y no envía datos de seguimiento de vuelta a Terminal49. Además, solo rastrea los contenedores para los que usted inicia el seguimiento: no descubre ni importa todo su historial de envíos desde Terminal49.
Preguntas frecuentes#
La prueba falla con HTTP_401
Terminal49 rechazó la clave enviada. Las causas habituales son una clave recortada al copiarla, una palabra extra pegada delante, o una clave eliminada o reemplazada en su cuenta de Terminal49 después de copiarla. La dirección y la conexión están bien: este código trata solo de la clave.
Abra app.terminal49.com/developers/api-keys, cree una clave nueva, cópiela completa y sin nada delante, péguela en el campo api_key, guarde y pruebe de nuevo. Si estaba comprobando la API a mano, recuerde que la forma del encabezado es "Authorization: Token <API_KEY>": una comprobación estilo Bearer falla incluso con la clave correcta.
La prueba se detiene con MISSING_CREDENTIALS
El campo api_key está vacío, así que no hay clave que enviar y la prueba no puede comprobar nada. Esta conexión tiene exactamente un campo, así que la credencial no puede estar escondida en otra parte.
Pegue la clave completa de app.terminal49.com/developers/api-keys en api_key, guarde la conexión y pruebe de nuevo.
La prueba falla con CONNECTION_FAILED, o vence a los 12 segundos
La solicitud de solo lectura a la API de Terminal49 no pudo completarse a tiempo. Es un problema de alcance en el camino a api.terminal49.com, o una lentitud temporal de Terminal49: no es prueba de que la clave esté mal, porque la clave solo se juzga cuando la API responde de verdad.
Espere un poco y pruebe de nuevo sin cambiar la clave. Si sigue fallando, anote la hora del fallo de Runs / Logs cuando pida ayuda, para poder contrastar la ventana con el lado de Terminal49.
Iniciar el seguimiento falla con INVALID_REQUEST
No se dio ningún identificador para la solicitud de seguimiento. Terminal49 inicia el seguimiento desde un identificador (un número de contenedor, de conocimiento de embarque o de reserva) y, sin ninguno de los tres, no hay nada que iniciar.
Inicie el seguimiento de nuevo con uno de los tres números de ese envío, y añada el SCAC del transportista cuando lo tenga: ayuda a Terminal49 a asignar la solicitud al transportista correcto.
Iniciar el seguimiento falla con HTTP_429 al iniciar muchos contenedores a la vez
Alcanzó el límite de velocidad de Terminal49: las solicitudes de seguimiento tienen un tope de 100 por minuto. No hay nada mal en la clave ni en los contenedores que fallaron: simplemente se enviaron más rápido de lo que Terminal49 los acepta.
Vuelva a iniciar los contenedores fallidos en lotes más pequeños, repartidos en más de un minuto, en lugar de reintentar todo el conjunto a la vez. Los que ya empezaron siguen rastreándose con normalidad.
Los contenedores nuevos dejan de rastrearse después de unos 100
Está usando la Developer Key gratuita, que rastrea hasta 100 contenedores. La conexión y la clave funcionan (los primeros cien lo prueban), pero la clave gratuita no tiene sitio para más contenedores a la vez.
Pase la conexión a una clave de Terminal49 con un cupo de contenedores acorde a su volumen real: cree u obtenga esa clave en su cuenta de Terminal49, péguela en api_key en lugar de la clave gratuita, guarde y pruebe. El seguimiento ya iniciado con la clave gratuita no es un ajuste de este sistema: revise primero el cupo de la clave cada vez que el volumen crezca.