Conector Archivo Plano

El conector Archivo Plano escribe datos transformados en archivos en el sistema de archivos del servidor. Es un conector solo de destino — recibe registros que ya han sido extraídos, normalizados y transformados por el pipeline y los escribe en disco en formato CSV o XML. Úsalo cuando el sistema receptor ingiere datos desde archivos en lugar de una API en tiempo real.

Cuándo usar este conector

• El sistema receptor recoge archivos desde una carpeta compartida o una ubicación de depósito SFTP.
• Necesitas un archivo local de cada ejecución de integración para auditoría o revisión manual.
• Estás exportando datos a una herramienta de informes o analítica que lee archivos planos.
• Quieres preparar la salida antes de cargarla en un sistema que no tiene conector de API.

Tipos de entidad compatibles

El conector Archivo Plano acepta cualquier tipo de entidad. Como escribe la salida sin interpretar la estructura del registro, es compatible con todos los tipos de entidad que la plataforma admite. El tipo de entidad se refleja en el nombre de archivo predeterminado cuando no se establece un patrón personalizado.

Tipo de entidad	Nombre descriptivo	Notas
item	Artículo / Producto
bp	Socio Comercial
customer	Cliente
bpgroup	Grupo de Socios Comerciales
paymentterms	Términos de Pago
itemgroup	Grupo de Artículos
pricelist	Lista de Precios
warehouse	Almacén
taxgroup	Grupo de Impuestos
uomgroup	Grupo de Unidades de Medida
fiscalperiod	Período Fiscal
salesquotation	Cotización de Venta
salesorder	Orden de Venta
order	Pedido
booking	Reserva
subscription	Suscripción
service	Servicio
plan	Plan
menuitem	Elemento de Menú

Consulta Tipos de Entidad para ver la descripción de cada tipo.

Prerrequisitos

Antes de crear un perfil de conexión para el conector Archivo Plano:

• El directorio de salida debe existir y tener permisos de escritura para el proceso del servicio de EZY Integrations.
• Si varios trabajos escribirán en el mismo directorio al mismo tiempo, el perfil de conexión de cada trabajo debe usar un patrón de nombre de archivo que incluya {correlationId} para evitar colisiones de archivos.
• No hay un sistema externo contra el que autenticarse — las credenciales consisten únicamente en la ruta y la configuración de formato.

Campos del perfil de conexión

Campo	Requerido	Descripción	Valor de ejemplo
Directorio de salida	Sí	Ruta absoluta en el servidor donde se escriben los archivos de salida. El directorio debe ser accesible para el servicio de integración.	/var/integrations/output
Formato	Sí	Formato de archivo para la salida. Elige CSV o XML. Por defecto es CSV si no se establece.	csv
Patrón de nombre de archivo	No	Plantilla para el nombre del archivo de salida. Admite los tokens indicados abajo. Cuando se deja en blanco, se usa el patrón predeterminado {entityType}_{correlationId}_{date}.	pedidos_{date}_{correlationId}

Tokens del patrón de nombre de archivo

Token	Se reemplaza por	Ejemplo de salida
{entityType}	El tipo de entidad de los registros de la ejecución.	item
{date}	Fecha UTC actual en formato yyyy-MM-dd.	2025-03-15
{correlationId}	Los primeros ocho caracteres del identificador de correlación de la ejecución.	a1b2c3d4

Si el patrón de nombre de archivo no incluye una extensión, el conector agrega .csv o .xml automáticamente según el campo Formato.

Detalles del formato de archivo

CSV

Cada ejecución de trabajo agrega filas al archivo de salida. Si el archivo no existe al inicio de la ejecución, el conector lo crea y escribe primero una fila de encabezado. Los nombres de columna se derivan de los campos del payload transformado, usando notación de puntos para estructuras anidadas (por ejemplo, address.city). Los campos que contienen comas, comillas dobles o saltos de línea se entrecomillan automáticamente.

XML

Cada ejecución de trabajo agrega un nuevo elemento <item> dentro del elemento raíz <items>. Si el archivo no existe al inicio de la ejecución, el conector lo crea con una declaración XML válida y un contenedor <items>. Los objetos JSON anidados se convierten en elementos XML anidados; los arreglos se convierten en hijos <element> repetidos. Los nombres de campo JSON que no son nombres de elemento XML válidos se sanean automáticamente (los dígitos iniciales se prefijan con _; los caracteres especiales se reemplazan con _).

Limitaciones conocidas

• Solo de destino. El conector Archivo Plano no puede usarse como origen — no tiene extractor. Siempre aparece en el lado de destino de un trabajo.
• Riesgo de colisión de archivos. Si se establece un patrón de nombre de archivo pero no incluye {correlationId}, dos ejecuciones de trabajo simultáneas escribirán en la misma ruta de archivo. El conector serializa el acceso dentro de un solo proceso, pero si se ejecutan múltiples instancias del servicio de integración pueden entrar en conflicto. La interfaz muestra una advertencia cuando se detecta esta condición.
• Sin confirmación de entrega. El conector no puede confirmar que el sistema receptor haya recogido el archivo. El seguimiento del consumo del archivo es responsabilidad del proceso que está aguas abajo.
• Solo se agrega contenido. Tanto la salida CSV como la XML se agregan en cada ejecución. El conector no sobrescribe ni trunca los archivos existentes. Si necesitas un archivo nuevo por ejecución, incluye {correlationId} o {date} en el patrón de nombre de archivo.
• Solo ruta del lado del servidor. El directorio de salida debe ser accesible desde el servidor que ejecuta EZY Integrations. Los recursos compartidos de red remotos deben estar montados a nivel de servidor.

Relacionado

• Tipos de Entidad — Lista completa de tipos de entidad compatibles.
• Descripción de la Arquitectura — Cómo el conector Archivo Plano encaja en el pipeline como destino.
• Descripción General de Trabajos — Cómo configurar un trabajo que use este conector como destino.
• Descripción General de Conectores — Compara todos los conectores disponibles.