Producto
Framework de Integración
Conecta Transportial a cualquier sistema externo — ERPs, telemática, plataformas de pedidos y más — con una API REST completa y App Store.
REST
Full OpenAPI spec
FTP
Embedded server
EDI
File parsing
App Store
UI extensions
Las operaciones logísticas modernas funcionan con múltiples sistemas. Transportial está diseñado para estar conectado. Una API REST completa con documentación OpenAPI, un servidor FTP incorporado para integraciones heredadas, análisis de archivos EDI y una App Store para extender la UI — cada escenario de integración está cubierto.
Aspectos clave
- API REST con OpenAPI 3.0: Cada entidad en Transportial es accesible a través de una API REST completamente documentada con una UI de Swagger para exploración y pruebas.
- Autenticación por clave API: Crea múltiples claves API con diferentes alcances y límites de velocidad por clave. Cada clave puede asignarse a un consumidor de integración específico.
- Servidor FTP incorporado: Para sistemas heredados que solo admiten integración basada en archivos, Transportial incluye un servidor FTP incorporado.
- Análisis de archivos EDI: Los formatos EDI estándar de flete (EDIFACT, X12) se analizan y convierten automáticamente a órdenes de transporte de Transportial.
- Pipeline de integración: Un pipeline de procesamiento estructurado con gestión de colas, lógica de reintentos, colas de letras muertas, seguimiento de estado y alertas de errores.
- App Store: Los desarrolladores externos pueden publicar apps en la App Store de Transportial que pueden incrustar paneles de UI personalizados en dashboards y vistas de viajes usando el SDK.
Cómo funciona
Elige el tipo de integración
Parte de un conector preset para sistemas comunes de telemática y logística, una integración auto-configurable para cualquier cosa con API o interfaz de archivos, acceso directo a la API para tus propios desarrolladores, o una plantilla de archivo para hojas de cálculo recurrentes.
Configura la conexión
Establece el endpoint, el calendario de sondeo o el evento desencadenante, y la autenticación: claves API, basic auth o cabeceras personalizadas. Los flujos de archivos entrantes pueden usar en su lugar el servidor FTP incorporado, de modo que los sistemas heredados solo tienen que soltar un archivo.
Mapea los datos visualmente
Empareja cada campo entrante con un campo del modelo de datos de Transportial en el editor visual de mapeo, incluidas estructuras anidadas como paradas y líneas de mercancía. No se requiere scripting, y las sugerencias de mapeo generadas por IA te llevan la mayor parte del camino en un clic.
Prueba y activa
Ejecuta la integración contra datos de muestra reales, inspecciona las órdenes o actualizaciones resultantes y entonces actívala. Cada ejecución queda registrada para que veas exactamente qué entró y qué se creó.
Monitorea el pipeline
El pipeline de integración encola, reintenta y envía a la cola de letras muertas los mensajes fallidos, y puede alertarte cuando algo necesita atención. Los fallos son visibles y re-ejecutables, nunca silenciosos.
Conectores preset e integraciones propias, un mismo framework
La mayoría de las plataformas te obligan a elegir entre un catálogo fijo de conectores y un proyecto a medida caro. Transportial trata ambos como lo mismo: una integración preset es simplemente una configuración pre-rellenada del mismo framework que puedes configurar tú mismo. Existen presets para computadoras de a bordo comunes, proveedores de telemática y sistemas portuarios comunitarios, y cada uno expone sus ajustes, de modo que puedes cambiar intervalos de sondeo, funciones habilitadas o credenciales sin esperar a un proveedor.
Cuando no hay preset, el constructor de integraciones auto-configurables cubre los sistemas que hablan HTTP, archivos o FTP. Defines el endpoint o el punto de entrega de archivos, el calendario o evento desencadenante y la autenticación, y luego mapeas la carga útil sobre el modelo de datos de Transportial. Como las órdenes, viajes y consignaciones siguen internamente el estándar abierto OTM5, un mapeo construido una vez sigue funcionando mientras la plataforma evoluciona, y los mismos datos de orden pueden fluir hacia cualquier socio que entienda el estándar.
Para todo lo demás está la API REST, documentada con OpenAPI 3.0 y navegable mediante Swagger. Cada entidad que ves en la interfaz, desde órdenes de transporte hasta facturas y vehículos, está disponible por la misma API que usa el propio producto, de modo que una integración puede hacer cualquier cosa que pueda hacer un usuario.
Construido para la realidad desordenada de los datos logísticos
La integración logística rara vez es JSON limpio sobre HTTPS. Un cliente envía órdenes como hoja de cálculo cada mañana, el ERP de un socio solo exporta EDIFACT, un sistema de almacén antiguo solo puede subir a FTP. Transportial cubre estos caminos de forma nativa: un servidor FTP incorporado acepta entregas de archivos y las procesa automáticamente, los formatos EDI estándar de flete como EDIFACT y X12 se analizan y convierten en órdenes de transporte sin scripting a medida, y las plantillas de archivo convierten hojas de cálculo recurrentes en órdenes estructuradas.
Los datos entrantes tampoco suelen ser consistentes. Los nombres de campo llegan en distintos idiomas, las direcciones se dividen de formas diferentes, las referencias viven en columnas extrañas. El editor visual de mapeo está construido exactamente para esto: ves los campos entrantes reales junto al modelo de destino y los conectas directamente, incluso dentro de estructuras anidadas como la segunda parada de la primera consignación. El generador de mapeos por IA lee una carga útil de muestra y propone el mapeo completo, que revisas y ajustas en lugar de construir desde cero.
Fallos que puedes ver, no tickets que descubres después
El fallo de integración más caro es el silencioso: una orden que nunca llegó, descubierta cuando el cliente llama. El pipeline de integración de Transportial está basado en colas, con lógica de reintentos para errores transitorios y una cola de letras muertas para mensajes que fallan repetidamente. Cada mensaje lleva su estado de procesamiento, de modo que una orden atascada es un elemento visible que puedes inspeccionar y re-ejecutar, no una ausencia que tienes que notar.
A las integraciones se les pueden adjuntar aserciones y notificaciones de fallo, de modo que se avisa a la persona correcta cuando un feed se queda mudo o una carga útil deja de coincidir con lo esperado. Combinado con límites de velocidad por clave API y claves API con alcances, una integración que se porta mal queda contenida: puedes limitar o revocar un único consumidor sin tocar el resto.
Detalles técnicos
El pipeline de integración está respaldado por Apache Kafka para entrega fiable de mensajes. Las solicitudes API están limitadas por velocidad por clave usando un algoritmo de ventana deslizante.
Preguntas frecuentes
¿Puede Transportial integrarse con nuestro ERP o TMS existente?
Sí. Si el sistema expone una API o puede intercambiar archivos, puede conectarse mediante una integración auto-configurable, la API REST, el servidor FTP incorporado o el análisis EDI. Los sistemas comunes de telemática y logística están disponibles como presets que solo necesitan credenciales.
¿Necesitamos desarrolladores para construir una integración?
No en la mayoría de los casos. Los conectores preset y el editor visual de mapeo de datos están diseñados para equipos operativos: configuras la conexión y emparejas campos en pantalla. La participación de desarrolladores solo hace falta cuando quieres construir directamente contra la API REST o publicar una app en la App Store.
¿Qué pasa cuando una integración falla?
Los mensajes fallidos se reintentan automáticamente, y los mensajes que siguen fallando aterrizan en una cola de letras muertas con su error y carga útil conservados. Puedes inspeccionarlos, corregirlos y re-ejecutarlos, y configurar notificaciones para que los fallos alerten a la persona correcta en lugar de aflorar semanas después.
¿Qué formatos EDI se admiten?
Los formatos EDI estándar de flete, incluidos EDIFACT y X12, se analizan y convierten automáticamente en órdenes de transporte y consignaciones de Transportial. Los formatos de archivo personalizados o específicos de un socio pueden gestionarse con plantillas de archivo y el editor de mapeo.
¿Hay un límite de velocidad en la API?
Los límites de velocidad se configuran por clave API en lugar de por cuenta. Puedes crear varias claves con distintos alcances y límites, asignar una a cada sistema consumidor, y revocar o limitar una sola clave sin afectar a las demás integraciones.
¿Podemos extender la propia interfaz de Transportial?
Sí. La App Store permite a desarrolladores externos publicar apps que incrustan paneles personalizados dentro del dashboard, las vistas de viaje y las páginas de orden mediante un SDK con sandbox, de modo que puedes añadir funcionalidad sin modificar ni bifurcar el producto base.
Ver todas las funciones
Gestión de Órdenes de TransporteTablero de Planificación InteractivoOptimización de Viajes con IAGestión de Flota y RecursosPlanificación de Carga 3DApp OpenMove para ConductoresSeguimiento de Vehículos en Tiempo RealEnrutamiento MultimodalMotor de PreciosFacturación y Gestión FinancieraAutomatizaciones de MensajesGestión y Generación de DocumentosBandeja de Entrada de Email IntegradaChat en la AppPortal de Clientes y EmpresasFramework de IntegraciónInformes e InsightsMulti-Tenancy y White-LabelSeguridad y Control de Acceso
¿Listo para ponerlo en práctica?
Comienza gratis con acceso completo a la plataforma, o habla con nuestro equipo sobre tu operación.