Integraciones y automatización

# Crea una integración autoconfigurable

Intercambia datos con cualquier sistema por API, SQL, FTP, SFTP, webhook o correo, con tus propios disparadores, filtros y asignaciones de campos.

Actualizado el 4 de octubre de 2026

**Quién puede hacerlo:** Nivel de rol 800 o superior y el permiso de integraciones.

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.

Guarda tus datos de ejemplo como prueba para poder volver a ejecutarla después de cada cambio. Consulta [Prueba una integración](/es/help/integration-tests).

## Artículos relacionados

* [Conecta otros sistemas con integraciones](/es/help/integrations)
* [Prueba una integración](/es/help/integration-tests)
* [Supervisa una integración](/es/help/integration-logs)
* [Importa datos desde un archivo](/es/help/data-importer)

## ¿Sigues necesitando ayuda?

Nuestro equipo de soporte responde encantado a cualquier pregunta sobre Transportial.

[Contactar con soporte](/es/contact)[Informar de un problema](/es/report-issue)

---
Canonical page: https://transportial.com/es/help/self-configurable-integration