Lee documentos con una integración de plantilla de archivo
Enseña a Transportial dónde están los valores en un diseño de documento, como el formulario de pedido de un cliente, para leer esos archivos automáticamente.
Actualizado el 4 de octubre de 2026
Muchos clientes envían pedidos como archivos PDF, Word o Excel que siempre tienen el mismo aspecto. Una integración de plantilla de archivo describe ese diseño una sola vez: qué valor está dónde y qué campo de Transportial rellena. Así, los archivos con el mismo diseño se pueden leer automáticamente, por ejemplo cuando creas un pedido a partir de un archivo.
Antes de empezar
- Ten a mano un archivo de ejemplo con el diseño que quieres leer. Entre los archivos admitidos están PDF, Word, Excel, CSV, XML e imágenes.
Crea la plantilla
- Abre el menú lateral (☰, arriba a la derecha), elige Integraciones y haz clic en + Crear integración.
- Introduce un Nombre, por ejemplo el nombre del cliente y del documento.
- En Selecciona el tipo de integración, elige Integración de plantilla de archivo. El panel se amplía.
- En Selecciona la entidad, elige lo que crea el archivo, normalmente una orden de transporte.
- Suelta tu archivo de ejemplo en la zona de carga o haz clic en ella para elegir el archivo.
- Haz clic en + Añadir campo para cada valor que quieras leer.
- Configura cada campo (consulta más abajo).
- Haz clic en Probar y comprueba el resultado.
- Pon Apagado/Encendido en encendido y haz clic en Guardar.
Configura un campo
- Selecciona el tipo de selector: cómo se encuentra el valor.
- HTML: el valor se encuentra en la estructura de texto del documento.
- Matriz: el valor está en una posición de la cuadrícula de la página.
- Posición de variable de texto: el valor se encuentra en relación con una etiqueta, por ejemplo el texto a la derecha de «Fecha de entrega». Usa Arriba, A la derecha, Abajo y la opción de la izquierda para indicar dónde.
- Selector: qué buscar.
- Mapeo JSON: el campo de Transportial en el que va el valor.
- Selecciona el tipo de campo, Formato y Regex: lee correctamente fechas y números y toma una parte de un texto.
Las pestañas Matriz y HTML junto a los campos muestran cómo ve Transportial tu archivo de ejemplo y resaltan lo que encuentran tus selectores. Úsalas para ajustar las posiciones. Activa Modo JSON para editar todos los campos como texto.
Marca con Identificación el campo que identifica la orden (por ejemplo, el número de pedido del cliente), para que un archivo corregido actualice la orden en lugar de crear una nueva.
Usa la plantilla
Cuando creas una orden a partir de un archivo, Transportial usa tu plantilla para rellenar la orden. Consulta Importa una orden de transporte desde un archivo.