API REST para el transporte ferroviario de contenedores del Puerto de Bilbao

El reto

BilbaoPort necesitaba una plataforma que diera soporte al transporte ferroviario de contenedores: un sistema capaz de recoger y suministrar información a todos los agentes del proceso (operador ferroviario, terminal de carga, resguardo fiscal). La información operativa vivía en sistemas AS400/DB2 y había que exponerla a terceros de forma segura, documentada y escalable.

La solución

Construimos API RAIL EPB, una plataforma de webservices REST con autenticación OAuth2 por token, documentación interactiva con Swagger y soporte de webhooks. La plataforma evolucionó por fases: primero la consulta de listas de carga para empresas ferroviarias, después la recepción de pies de tren con ETA, y finalmente la comunicación bidireccional con las terminales de carga, persistiendo los mensajes y volcándolos al modelo de datos de BilbaoPort. Sobre esta base se construyó además el conector FENIX de la Autoridad Portuaria de Bilbao dentro del piloto español del proyecto europeo FENIX, probado con la terminal de Júndiz e Indra como interlocutor.

Qué aporta la plataforma

• Plataforma de integración central: las empresas ferroviarias comunican sus trenes y consultan listas de carga sin correos ni llamadas
• Comunicación bidireccional con las terminales de carga: notifican lo que cargarán y consultan lo que está en camino
• Seguridad de nivel empresarial: autenticación OAuth2 por token y permisos por servicio y por cliente
• Documentación interactiva con Swagger: cada empresa integra por su cuenta sin pedirnos manuales
• Trazabilidad completa: cada mensaje queda registrado con fecha, hora y origen antes de volcarse a los sistemas centrales
• Conector FENIX: BilbaoPort participó en el piloto español del proyecto europeo sobre esta misma base

El impacto

Desde 2020

en producción y evolución continua

OAuth2

autenticación por token y permisos por cliente

Swagger

documentación interactiva para empresas externas

Webhooks

integración bidireccional con terminales y operadores

Resultados

• API en producción usada por empresas ferroviarias y terminales de carga
• Autenticación OAuth2 y documentación pública con Swagger
• Integración con los sistemas AS400/DB2 de BilbaoPort sin modificar sus procesos internos
• Base técnica del conector FENIX de la APB, validado en el piloto español
• Evolución continua desde 2020 mediante bolsas de horas