Escritores de Salida

Un escritor de salida es el componente que entrega un payload transformado a un sistema destino que no tiene una integración de API estructurada. EZY Integrations incluye dos escritores de salida: uno que escribe registros en archivos del sistema de archivos del servidor y otro que envía payloads a cualquier endpoint HTTP. Ambos se configuran a través del perfil de conexión del conector correspondiente, no en la configuración de mapeo.

Los escritores de salida son utilizados exclusivamente por el conector de Archivo Plano y el conector de API Genérica. Todos los demás conectores (EZY Portal, SAP Business One, Shopify, WooCommerce, Wix) tienen su propia lógica de escritura dedicada y no usan escritores de salida.

Escritor de Archivo Plano

El escritor de Archivo Plano recibe el payload transformado de cada registro y lo agrega a un archivo en el sistema de archivos del servidor de integración. Se crea un nuevo archivo al inicio de cada ejecución; los registros posteriores dentro de la misma ejecución se agregan al mismo archivo.

Se admiten dos formatos:

Formato Comportamiento

CSV El primer registro escrito en un nuevo archivo produce una fila de encabezado usando los nombres de campos destino del bloque de transformación de la configuración de mapeo. Cada registro posterior produce una fila de datos en el mismo orden de columnas. Los campos se encierran entre comillas cuando contienen comas o saltos de línea. El escritor es seguro para hilos: las ejecuciones concurrentes que escriben en la misma ruta se serializan para prevenir la corrupción de datos.

XML El primer registro escrito en un nuevo archivo crea un elemento raíz <items> que contiene un único elemento hijo <item>. Cada registro posterior agrega otro elemento <item>. Las rutas destino anidadas en la configuración de mapeo (por ejemplo, address.city) producen elementos XML anidados. El escritor es seguro para hilos en ejecuciones concurrentes.

Formato	Comportamiento
CSV	El primer registro escrito en un nuevo archivo produce una fila de encabezado usando los nombres de campos destino del bloque de transformación de la configuración de mapeo. Cada registro posterior produce una fila de datos en el mismo orden de columnas. Los campos se encierran entre comillas cuando contienen comas o saltos de línea. El escritor es seguro para hilos: las ejecuciones concurrentes que escriben en la misma ruta se serializan para prevenir la corrupción de datos.
XML	El primer registro escrito en un nuevo archivo crea un elemento raíz `<items>` que contiene un único elemento hijo `<item>`. Cada registro posterior agrega otro elemento `<item>`. Las rutas destino anidadas en la configuración de mapeo (por ejemplo, `address.city`) producen elementos XML anidados. El escritor es seguro para hilos en ejecuciones concurrentes.

Patrón de nombre de archivo

El perfil de conexión del conector de Archivo Plano incluye un campo opcional de patrón de nombre de archivo. Puedes usar el token {correlationId} en el patrón para incluir un identificador de ejecución único en el nombre del archivo, por ejemplo: items-{correlationId}. Esto se recomienda especialmente cuando múltiples ejecuciones de trabajos pueden ejecutarse concurrentemente — sin un nombre de archivo único, dos ejecuciones que escriban en la misma ruta intercalarán sus registros en el mismo archivo.

Si no incluyes {correlationId} en el patrón de nombre de archivo, la interfaz muestra una advertencia en el formulario del perfil de conexión.

Escritor de API Genérica

El escritor de API Genérica envía el payload transformado como cuerpo de una solicitud HTTP al endpoint configurado en el perfil de conexión. Se envía una solicitud HTTP por registro.

Los modos de autenticación admitidos son:

Modo de autenticación	Descripción
Ninguno	No se agrega encabezado de autenticación.
Clave de API	Agrega un encabezado personalizado con el valor de la clave de API. El nombre del encabezado es configurable (por ejemplo, `X-Api-Key`).
Bearer	Agrega un encabezado `Authorization: Bearer <token>`.
Basic	Agrega un encabezado `Authorization: Basic <base64>` usando el usuario y contraseña configurados.

Método HTTP

La URL destino en el perfil de conexión puede incluir un prefijo de método para especificar el verbo HTTP: por ejemplo, POST::https://api.example.com/items. Si no se proporciona prefijo, el método predeterminado es POST. Los prefijos comunes son POST::, PUT:: y PATCH::.

Tipo de contenido

El perfil de conexión incluye un campo de tipo de contenido que establece el encabezado Content-Type de la solicitud. El valor predeterminado es application/json. El cuerpo del payload es el JSON producido por el bloque de transformación de la configuración de mapeo — se envía tal cual.

Cómo elegir entre formatos

Necesidad	Escritor recomendado
Entregar registros a un sistema que lee archivos CSV	Archivo Plano — CSV
Entregar registros a un sistema que lee XML	Archivo Plano — XML
Enviar registros en tiempo real a un endpoint HTTP	API Genérica
El destino es uno de los conectores dedicados (EZY Portal, SAP B1, Shopify)	No aplica — usa el conector dedicado

Relacionado

Transformadores de Valor — Cómo se dan forma a los valores de campo antes de llegar al escritor de salida.
Configuración de Mapeo — Cómo las rutas destino del bloque de transformación se convierten en columnas de archivo o claves JSON.
Conector de Archivo Plano — Campos del perfil de conexión y pasos de configuración para el conector de Archivo Plano.
Conector de API Genérica — Campos del perfil de conexión y pasos de configuración para el conector de API Genérica.