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.
![Tabla de mapeo de campos con nombres de campo entrantes como firma, kontaktperson, email y telefon a la izquierda, un tipo por campo, rutas salientes como customer.name y customer.contactDetails[0].value a la derecha, una columna de expresión regular y botones Añadir campo](/assets/screens/integration-data-mapping.webp)
- Campo entrante del archivo o la API del socio
- Tipo y transformación por campo
- Ruta saliente hacia la orden, el cliente o el envío
- Añadir campos, o generar el mapeo con IA
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.
Qué hace
Un inventario a nivel de código de lo que cubre Framework de Integración, con los términos que encontrará dentro del producto.
Cuatro formas de conectar
- Conectores preconfigurados
Controladores integrados para telemática, rFMS de fabricantes, terminales, ferris, bolsas de carga, contabilidad, CRM, pagos, correo electrónico, mensajería, calendarios y más, listados en el catálogo de integraciones.
- Autoconfigurable
Cualquier API, webhook, FTP, SFTP, conexión SQL, receptor de correo o el servidor FTP virtual que Transportial aloja para usted; JSON, XML o CSV; entrante y saliente.
- Acceso API
API REST bajo /api con rutas generadas a partir del modelo, documentación OpenAPI renderizada con ReDoc, claves API y tokens de aplicación, y un límite de 500 peticiones por minuto.
- Plantillas de archivo
Analice y produzca archivos con selectores: matriz (posiciones en una hoja), HTML, posición de variable de texto y constantes, para los socios que solo trabajan con archivos.
Mapeo sin código
- Mapeos de campo
Campo entrante a ruta saliente con tipo, expresión regular y opciones como recortar, capitalizar, mayúsculas o minúsculas, eliminar espacios y campos de identificación.
- Mapeos de valor
Traduzca los códigos del socio a valores de la plataforma, incluidos destinos específicos del proveedor para Transics, Webfleet, Mapon, Squarell, ranuras de telemetría y botones del vehículo.
- Filtros y disparadores
Filtros de comparación (==, !=, >, <, in, not in) con AND/OR; disparadores salientes sobre cualquiera de los eventos desencadenantes de la plataforma con una condición.
- Generar con IA
Pegue un archivo de ejemplo o una respuesta de API y se redactan los mapeos de campo; o genere toda la integración a partir de una descripción.
Opérelo como software
- Vista de traza
Pestañas de registros, tareas, objetos, peticiones, pruebas, matriz y HTML, y una traza que vincula objeto → tarea → registro → petición.
- Pruebas de integración
JSON de entrada y esperado, aserciones a nivel de error o advertencia, coincidencia exacta, solo aserciones o ambas, ejecutar todas, con notificaciones de fallo.
- Fiabilidad
Un vigilante de salud que genera alertas de bloqueo y silencio, notificaciones de fallo y estancamiento por correo electrónico, ventanas de sincronización que acotan el segmento pero nunca el alcance, despacho con equilibrio de carga entre trabajadores Kafka, supresión de eco para que una integración nunca reciba su propio cambio, modos de registro de peticiones todo, errores o desactivado, y redacción de secretos.
- Autenticación
Clave API, claves de acceso, básica, OAuth, bearer, OpenID, claves de cliente y cabeceras personalizadas.
Amplíe la plataforma
- App Store
Explore, instale y configure apps con permisos, historial de versiones y hooks: puntos de conexión de webhook o hooks de interfaz que añaden una pestaña al panel de control o al menú.
- Portal de desarrolladores
Apps, editores, claves API, analíticas, reseñas y modelos de precios (gratuito, freemium, pago único, suscripción, por uso por llamada, viaje, envío o vehículo), con autorregistro de proveedores y desarrolladores.
- Webhooks
Webhooks salientes sobre eventos desencadenantes; webhooks entrantes para Stripe, Mollie, Adyen, Burger Ferry y Salesforce.
- Botones de acción
Botones definidos por el inquilino sobre los activos que llaman a una integración, por ejemplo para enviar un mensaje a un ordenador de a bordo.
Cómo funciona
Elija el tipo
Preconfigurada para un socio conocido; autoconfigurable para una API o un intercambio de archivos a medida; acceso API para el cliente propio del socio; plantilla de archivo para hojas de cálculo y archivos de posición fija.
Conecte
Punto de conexión, programación, autenticación y cabeceras, o deje que Transportial aloje una carpeta FTP virtual para usted.
Mapee
Asocie los campos al modelo OTM5, añada mapeos de valor y filtros, o genere el mapeo con IA a partir de un ejemplo.
Pruebe
Cree casos de prueba con salida esperada y aserciones; ejecútelos en cada cambio.
Ejecute y vigile
Siga la traza de cada objeto a través de tareas, registros y peticiones; el vigilante alerta cuando la integración se estanca.
El marco supera a los conectores a medida
A todo transportista le acaban pidiendo "el XML que envía el ERP del cliente". Un script a medida lo gestiona hasta que el formato cambia. Transportial trata cada conexión como configuración sobre el mismo marco: conexión, formato, mapeo, filtros, disparadores, pruebas y registros. Los conectores preconfigurados son simplemente mapeos que el equipo publica y mantiene; la integración propia de un inquilino recibe la misma traza y la misma monitorización de salud.
El marco también incorpora la seguridad operativa: la supresión de eco detiene los bucles entre dos sistemas, las ventanas de sincronización mantienen el sondeo honesto bajo carga, y los mismos eventos desencadenantes que impulsan las automatizaciones impulsan los datos salientes.
FTP virtual y plantillas de archivo para la larga cola
No todos los socios tienen una API. Transportial aloja un servidor FTP para que un socio pueda dejar archivos en una carpeta que pertenece a su plataforma, y las plantillas de archivo analizan texto de posición fija, hojas de cálculo por celda y HTML. El mismo motor de mapeo lleva después los datos a órdenes, envíos y empresas.
Conceptos y terminología
Las palabras que usa este módulo, con enlaces al glosario completo cuando un término tiene su propia página.
- Integración preconfigurada
- Un conector integrado para un sistema de socio concreto, configurado con credenciales y opciones.
- Integración autoconfigurable
- Una conexión definida por el inquilino con cualquier API, servidor de archivos, base de datos o buzón, con su propio mapeo.
- Mapeo de campo
- La regla que copia un campo entrante a una ruta del modelo de la plataforma, con tipo, expresión regular y opciones.
- Mapeo de valor
- Una tabla de traducción de códigos del socio a valores de la plataforma.
- FTP virtual
- Un servidor FTP alojado por Transportial para su plataforma, de modo que los socios pueden intercambiar archivos sin su propio servidor.
- Supresión de eco
- No devolver un cambio a la integración que lo provocó.
- EDIGlosario
- Intercambio electrónico de datos; Transportial intercambia JSON, XML y CSV sobre el marco y habla EDIFACT con los socios de ferris y terminales.
- OTM5Glosario
- El modelo abierto al que apunta cada mapeo.
Así es el producto
Funciona con
Conectores que alimentan o consumen este módulo de serie.
Transics / ZF
Exact Online
SalesforcePensado para
Dónde más pesa este módulo, además de las herramientas gratuitas sobre el mismo tema.
Las tareas de integración se reparten entre workers de Kafka con balanceo de carga, supresión de eco y un vigilante de salud que avisa de integraciones atascadas o silenciosas. Las solicitudes API se limitan a 500 por minuto. Las apps de la App Store amplían la plataforma mediante hooks de webhook y de interfaz.
Preguntas frecuentes
¿Existe una API pública?
Sí. Una API REST con documentación OpenAPI, claves API y tokens de aplicación, y un límite de 500 peticiones por minuto. Una herramienta de conversión OTM5 ayuda con el modelo.
¿Podemos conectar un sistema sin API?
Sí. Use FTP o SFTP, el FTP virtual que aloja Transportial, un receptor de correo, una conexión SQL o plantillas de archivo para hojas de cálculo y archivos de posición fija.
¿Admiten EDI?
El marco intercambia JSON, XML y CSV con cualquier socio, y los mensajes EDIFACT se usan con socios de ferris y terminales como P&O Ferries y DP World. Los mensajes de orden genéricos EDIFACT o X12 se mapean por socio.
¿Cómo sabemos que una integración está sana?
Un vigilante genera alertas de bloqueo y silencio, los fallos y estancamientos notifican por correo electrónico, y la vista de traza vincula cada objeto con sus tareas, registros y peticiones.
¿Pueden probarse las integraciones antes de la puesta en marcha?
Sí. Los casos de prueba con entrada, salida esperada y aserciones se ejecutan individualmente o todos a la vez, y una prueba fallida puede notificar.
¿Pueden terceros desarrollar sobre la plataforma?
Sí. La App Store y el portal de desarrolladores permiten a los editores publicar apps con hooks de webhook y de interfaz y tarificarlas como gratuitas, freemium, de pago único, por suscripción o por uso.
Ver todas las funciones
¿Listo para ponerlo en práctica?
Comienza gratis con acceso completo a la plataforma, o habla con nuestro equipo sobre tu operación.