Crea una integración autoconfigurable

Una integración autoconfigurable es para sistemas que no tienen un conector predefinido. Tú decides cuándo se ejecuta, qué registros trata y cómo se asignan los campos del otro sistema a los campos de Transportial. Una integración puede tener varias fuentes de datos, por ejemplo una que obtiene órdenes y otra que devuelve actualizaciones de estado.

Elige cómo se inicia la integración

Después de elegir Integración autoconfigurable como tipo, elige un disparador en Selecciona el tipo de disparador:

• Programado: se ejecuta a intervalos fijos o con una programación cron, por ejemplo para revisar una carpeta FTP cada 10 minutos.
• Disparador: se ejecuta cuando ocurre algo en Transportial. Elige uno o varios eventos en Selecciona el evento desencadenante, por ejemplo cuando se actualiza un viaje.
• Escucha: espera a que el otro sistema envíe datos, por ejemplo mediante un webhook o por correo electrónico. Sus fuentes de datos se configuran entonces como datos entrantes.

Para Disparador y Escucha, puedes añadir filtros para que la integración solo se ejecute con los registros que coincidan.

Crea la integración

1. Abre el menú lateral (☰, arriba a la derecha), elige Integraciones y haz clic en + Crear integración.
2. Introduce un Nombre y elige Integración autoconfigurable en Selecciona el tipo de integración.
3. Elige el disparador en Selecciona el tipo de disparador y, para una integración programada, fija la programación.
4. Para una integración de tipo Disparador o Escucha, haz clic si quieres en + Añadir filtro y crea una condición: un Selector (el campo), una comparación (por ejemplo Igual a (==) o Está en ...) y un Valor.
5. Haz clic en + Añadir fuente de datos.
6. Elige la dirección en Selecciona la dirección de los datos...: ENTRADA para los datos que llegan a Transportial, SALIDA para los datos que salen.
7. Elige la conexión en Selecciona el tipo de conexión... y rellena sus campos (consulta más abajo).
8. Elige qué tipo de registro crea o lee la fuente de datos en Selecciona la entidad, por ejemplo una orden de transporte o un viaje.
9. Asigna los campos (consulta más abajo) y prueba la asignación.
10. Pon Apagado/Encendido en encendido y haz clic en Guardar.

Tipos de conexión

Conexión	Qué configuras
API	La URL y el método de solicitud en Selecciona el método de solicitud.
Conexión SQL	La dirección de la base de datos y los datos de acceso.
FTP / SFTP	Host, Puerto, Ruta y datos de acceso.
FTP virtual	Transportial aloja el servidor FTP por ti. Los datos de conexión y de acceso se generan al guardar; compártelos con tu socio.
Webhook	Después de guardar, aparece una dirección de webhook. Dásela al otro sistema para que pueda enviar datos a Transportial.
Receptor de correo electrónico	Transportial recibe los datos por correo electrónico.

En cada conexión, el interruptor Con autenticación decide cómo se protege el acceso. Actívalo para introducir datos de acceso. Déjalo desactivado para permitir solo las Direcciones IP que introduzcas. Para los datos salientes, elige el formato de archivo (JSON, XML o CSV) en Selecciona el tipo de dato.

Asigna los campos

Cada línea de asignación conecta un campo del otro sistema con un campo de Transportial.

• Entrante y Saliente: la ruta del campo en cada lado.
• Selecciona el tipo de campo: Texto, Lista, Objeto, Booleano, Fecha y hora, Hora y más. Las listas y los objetos contienen sus propias líneas.
• Formato, Regex y Valor predeterminado: lee una fecha en un formato concreto, toma una parte de un valor o rellena un valor cuando el campo está vacío.
• Opciones como Identificación (el campo identifica el registro, de modo que una segunda entrega lo actualiza en lugar de crear un duplicado), Recortar espacios o Convertir a mayúsculas.

Haz clic en + Añadir campo para añadir una línea, o activa Modo JSON para editar toda la asignación como texto. Con una entidad seleccionada, Generar asignación con IA prepara una asignación por ti. Activa OTM si la fuente de datos usa el estándar Open Trip Model en lugar de tu propia asignación.

Opciones para los datos entrantes

• Procesamiento secuencial: trata las entregas una a una, en orden.
• Actualizaciones parciales: una entrega nombra solo algunos elementos (por ejemplo, una orden de un viaje) y los demás se conservan. Cada elemento debe llevar un identificador; un elemento entregado con deleted = true se elimina.

Prueba la asignación

1. Activa Vista de prueba para la fuente de datos.
2. Pega o introduce datos de ejemplo del otro sistema.
3. Haz clic en Probar y comprueba el resultado que se muestra al lado.