Glosario

Este glosario define los términos utilizados a lo largo de la documentación de EZY Integrations. Los términos aparecen en orden alfabético.

Clave de API Secreto emitido por tenant que autentica las solicitudes máquina a máquina a la API de EZY Integrations. Las claves de API están limitadas al scope de un único tenant y no pueden acceder a los datos de otro tenant. Consulta Claves de API.

Cola de Mensajes Fallidos (DLQ) El área de retención para registros que han fallado todos los intentos de reintento automático. Los registros permanecen allí hasta que los reintentes (los reinyectes al pipeline después de corregir la causa raíz) o los descartes. La DLQ muestra la categoría de error y el mensaje de cada entrada. Consulta DLQ y Reintento.

Configuración de Mapeo Documento JSON adjunto a una instancia que controla cómo se extraen los datos del sistema fuente, se convierten al formato canónico y se dan forma al payload destino. Una configuración de mapeo cubre un tipo de entidad. Una instancia puede tener múltiples configuraciones de mapeo para distintos tipos de entidad. Consulta Configuración de Mapeo.

Conector El componente responsable de comunicarse con un sistema externo específico — por ejemplo, el conector de Shopify o el conector de SAP Business One. Cada conector sabe cómo extraer datos de su sistema o escribir datos en él. Consulta Conectores.

Cursor Un valor almacenado — típicamente una marca de tiempo — que indica dónde terminó la última extracción incremental. En la siguiente ejecución, la etapa de Ingestión lee el cursor y obtiene solo los registros modificados después de ese punto. El cursor se avanza al final de cada etapa de Finalización exitosa. Se configura en el bloque de extracción de la configuración de mapeo. Consulta Configuración de Mapeo.

Entidad Canónica El formato de datos neutro e intermedio que comparten todos los conectores. Cuando un conector fuente extrae datos crudos, los convierte en una entidad canónica. El conector destino lee la entidad canónica y produce el payload que espera el sistema destino. Este diseño significa que ningún conector fuente habla directamente con ningún conector destino — todos hablan el mismo lenguaje intermedio. Consulta Descripción General de la Arquitectura.

Escritor de Salida El componente que entrega los datos a un sistema destino que no es una API — por ejemplo, escribir en un archivo CSV o XML en disco (Archivo Plano) o publicar en un endpoint HTTP arbitrario (API Genérica). Consulta Escritores de Salida.

Ejecución Una ejecución de una instancia de trabajo. Una ejecución procesa todos los registros pendientes para los tipos de entidad de la instancia y produce un estado de Éxito, Éxito Parcial o Fallida. Los detalles de las ejecuciones se encuentran en Historial de Ejecuciones.

Etapa Cada uno de los cinco pasos secuenciales del pipeline: Ingestión, Normalización, Transformación, Ejecución y Finalización. Cada etapa se reintenta de forma independiente ante un fallo. Consulta Etapas del Pipeline.

Ejecución (etapa) La cuarta etapa del pipeline. El payload transformado se envía al sistema destino. El conector resuelve si crear un nuevo registro o actualizar uno existente basándose en su tabla de mapeo de IDs. Los rechazos del destino (valores de campo inválidos, límites de velocidad, errores de autenticación) se muestran aquí. Consulta Etapas del Pipeline.

Finalización (etapa) La quinta y última etapa del pipeline. El resultado de la ejecución queda registrado, los cursores de sincronización se actualizan y el estado por entidad se escribe en el historial de ejecuciones. Un fallo de Finalización es poco frecuente y suele indicar un problema a nivel de plataforma. Consulta Etapas del Pipeline.

Ingestión (etapa) La primera etapa del pipeline. El conector fuente lee registros del sistema fuente usando las credenciales del perfil de conexión y las reglas de extracción de la configuración de mapeo. Si se configura la sincronización incremental, solo se obtienen los registros modificados después del cursor. Consulta Etapas del Pipeline.

Instancia El término de EZY Integrations para un trabajo — la configuración que vincula un perfil de conexión fuente con un perfil de conexión destino y contiene una o más configuraciones de mapeo. Una instancia define qué sincronizar y entre qué sistemas; una programación o un disparador manual define cuándo sincronizar. Consulta Descripción de Trabajos.

Normalización (etapa) La segunda etapa del pipeline. Los datos crudos del sistema fuente se convierten al formato de entidad canónica. Los campos requeridos se validan y se aplican conversiones de tipo. Un registro que falla la normalización (por ejemplo, un campo requerido está ausente) se envía a la DLQ después de los reintentos. Consulta Etapas del Pipeline.

Perfil de Conexión Un conjunto guardado y cifrado de credenciales para una instancia de un sistema fuente o destino. Por ejemplo, un perfil de conexión para SAP Business One contiene el host de la base de datos, el nombre de usuario y la contraseña. Un perfil de conexión puede reutilizarse en múltiples instancias (trabajos). Consulta la página de tu conector en Conectores.

Pipeline El proceso completo que mueve datos desde el sistema fuente al sistema destino a través de cinco etapas secuenciales. Consulta Descripción General de la Arquitectura.

Programación Un temporizador que dispara automáticamente una ejecución de trabajo en un intervalo definido mediante una expresión cron. Las programaciones se adjuntan a una instancia específica. Múltiples programaciones pueden apuntar a la misma instancia. Consulta Programaciones.

Registro de Sincronización El registro de una única ejecución, incluyendo hora de inicio, hora de fin, estado, recuentos de registros (total, exitosos, fallidos, omitidos) y detalles de error por entidad. Los Registros de Sincronización son la herramienta principal para monitorear el historial de ejecuciones. Consulta Historial de Ejecuciones.

Tenant Un espacio de trabajo aislado en EZY Integrations para un cliente o entorno. Todos los perfiles de conexión, instancias, configuraciones de mapeo, ejecuciones y entradas de la DLQ pertenecen a un tenant. Los usuarios se asignan a uno o más tenants. Consulta Configuración de Tenant.

Transformación (etapa) La tercera etapa del pipeline. La entidad canónica se da forma al payload exacto que espera el sistema destino. Se aplican mapeos de campos, transformadores de valores, campos estáticos y etiquetas condicionales de la configuración de mapeo. Consulta Etapas del Pipeline.

Transformador (Transformador de Valor) Una función nombrada aplicada a un valor de campo durante la etapa de Transformación — por ejemplo, un formateador de fechas, un concatenador de cadenas o un convertidor de decimales. Los transformadores se configuran en el bloque de transformación de la configuración de mapeo. Consulta Transformadores de Valor.

Tipo de Entidad El tipo de registro de datos que se mueve — por ejemplo, item, order, customer o salesquotation. Cada configuración de mapeo se dirige a un tipo de entidad específico. El tipo de entidad determina qué extractor, normalizador y campos destino están disponibles. Consulta Tipos de Entidad.

Writeback Paso opcional posterior a la ejecución en el que el ID de respuesta del sistema destino (típicamente un ID asignado) se envía de vuelta al sistema fuente. Por ejemplo, después de que un pedido de ventas se escribe en SAP Business One, el número de documento SAP puede almacenarse de vuelta en el registro origen de EZY Portal. No todos los conectores admiten writeback.