Conectores
Un conector es el componente que gestiona la autenticación y la comunicación con un sistema externo específico. Cada trabajo en EZY Integrations tiene un conector de origen y uno de destino. El conector que elijas depende del sistema al que te conectas, la dirección en que deben fluir los datos y los tipos de entidad que necesitas mover. Antes de seleccionar un conector, consulta la descripción general de la arquitectura para entender cómo encajan los orígenes y destinos en el pipeline, y la página de etapas del pipeline para entender qué ocurre con los registros después de que salen del conector de origen.
Comparación de conectores
Sección titulada «Comparación de conectores»| Conector | Dirección | Modelo de autenticación | Tipos de entidad principales | Página |
|---|---|---|---|---|
| SAP Business One | Origen + Destino | Credenciales SQL Server; URL de Service Layer + usuario/contraseña para escritura inversa; credenciales de red opcionales para rutas de archivo | Item, Socio de Negocio, Lista de Precios, Cotización de Venta, Pedido de Venta | SAP B1 |
| EZY Portal | Origen + Destino | URL de Portal + clave de API de integración | Item, Socio de Negocio, Lista de Precios, Cotización de Venta, Pedido de Venta | EZY Portal |
| Shopify | Origen + Destino | OAuth (Client ID + Client secret) o token de acceso heredado, por tienda | Item, Cliente, Pedido | Shopify |
| WooCommerce | Solo origen | Consumer key + consumer secret de la API REST; contraseña de aplicación de WordPress opcional | Item, Cliente, Pedido | WooCommerce |
| Wix | Solo origen | Clave de API de Wix + ID de sitio | Cliente, Pedido, Reserva, Producto, Servicio, Plan, Elemento de Menú, Suscripción | Wix |
| Archivo Plano | Solo destino | Ruta del directorio de salida + formato (CSV o XML) — sin autenticación externa | Cualquier tipo de entidad | Archivo Plano |
| API Genérica | Solo destino | Ninguna, clave de API, token Bearer o HTTP Basic | Cualquier tipo de entidad | API Genérica |
Descripción de los conectores
Sección titulada «Descripción de los conectores»SAP Business One
Sección titulada «SAP Business One»El conector de SAP Business One lee datos maestros y documentos transaccionales directamente desde la base de datos SQL Server de SAP B1, y escribe cotizaciones y pedidos de venta a través de la API REST de SAP Service Layer. Es el conector más completo: admite once tipos de entidad como origen y flujo bidireccional para documentos de ventas. La sincronización incremental utiliza la columna UpdateDate o SQL Server Change Tracking. Usa este conector cuando SAP B1 sea tu ERP principal y necesites sincronizar datos maestros, enviar documentos o ambos. Detalles completos.
EZY Portal
Sección titulada «EZY Portal»El conector de EZY Portal lee y escribe en la API REST de EZY Portal utilizando una clave de API de integración. Es el destino más habitual en una integración típica: SAP B1 o una plataforma de comercio electrónico envía datos maestros a Portal, y Portal devuelve documentos de ventas. Admite el conjunto completo de tipos de entidad de datos maestros — items, socios de negocio, listas de precios, tablas de referencia — además de cotizaciones y pedidos de venta bidireccionales. Detalles completos.
Shopify
Sección titulada «Shopify»El conector de Shopify utiliza la API GraphQL Admin de Shopify y admite las direcciones de origen y destino. Como origen extrae productos, clientes y pedidos. Como destino escribe productos (incluidas variantes, imágenes, metafields e inventario) de vuelta en Shopify. La autenticación usa OAuth con el Client ID y Client secret de una aplicación personalizada, o un token de acceso heredado. Una verificación inteligente basada en hash omite los registros sin cambios para reducir el consumo de cuota de API. Detalles completos.
WooCommerce
Sección titulada «WooCommerce»El conector de WooCommerce extrae productos, clientes y pedidos de una tienda WooCommerce mediante la API REST v3 de WooCommerce con una consumer key y un consumer secret. Es solo de origen — los datos salen de WooCommerce, no entran. La sincronización incremental usa un cursor de marca de tiempo sobre date_modified. Una contraseña de aplicación de WordPress opcional solo es necesaria cuando tu configuración de mapeo realiza operaciones sobre archivos o medios. Detalles completos.
El conector de Wix extrae datos de sitios Wix Studio a través de las API REST de Wix con una clave de API de Wix y un ID de sitio. Es solo de origen y admite ocho tipos de entidad: contactos, pedidos, reservas, productos, servicios, planes de precios, elementos de menú y suscripciones. Esta amplitud lo hace adecuado para negocios que usan Wix no solo como tienda en línea, sino también para reservas, restaurantes y facturación por suscripción. Detalles completos.
Archivo Plano
Sección titulada «Archivo Plano»El conector de Archivo Plano escribe la salida del pipeline en archivos CSV o XML en el sistema de archivos del servidor. Es solo de destino y acepta todos los tipos de entidad que admite la plataforma. No requiere autenticación externa: la configuración consiste en una ruta de directorio de salida y una elección de formato. Úsalo cuando el sistema receptor ingiera datos desde archivos en lugar de una API en tiempo real, o cuando necesites un archivo de auditoría de cada ejecución. Detalles completos.
API Genérica
Sección titulada «API Genérica»El conector de API Genérica entrega registros transformados a cualquier endpoint HTTP o REST. Es solo de destino, acepta todos los tipos de entidad y admite cuatro modos de autenticación: Ninguno, clave de API, token Bearer y HTTP Basic. La URL de la solicitud y el método HTTP se pueden sobreescribir por registro desde la configuración de mapeo. Úsalo para integrarte con cualquier sistema que acepte solicitudes HTTP estructuradas pero no tenga un conector dedicado. Detalles completos.
Cómo elegir un conector
Sección titulada «Cómo elegir un conector»Usa esta guía para acotar tu elección:
- Tu ERP es SAP Business One — usa el conector de SAP Business One como origen y EZY Portal o Shopify como destino.
- Estás poblando un tenant de Portal — usa EZY Portal como destino, combinado con SAP Business One, Shopify, WooCommerce o Wix como origen.
- Vendes en Shopify y necesitas sincronización bidireccional — usa Shopify como origen y destino en trabajos separados: un trabajo lleva pedidos a Portal, otro empuja el catálogo de items desde Portal de vuelta a Shopify.
- Vendes en WooCommerce — usa WooCommerce como origen; es solo de extracción, así que combínalo con EZY Portal, Archivo Plano o API Genérica como destino.
- Usas Wix para reservas, suscripciones o menú de restaurante — usa el conector de Wix como origen para capturar tipos de entidad más allá de los productos y pedidos estándar.
- El sistema destino lee archivos — usa Archivo Plano como destino. Elige CSV o XML según lo que espere el sistema receptor.
- El sistema destino tiene una API HTTP pero no tiene un conector dedicado — usa API Genérica como destino y configura la autenticación y la URL del endpoint en el perfil de conexión.
- Necesitas una fuente HTTP personalizada — el conector de API Genérica es solo de destino; para una inserción HTTP entrante consulta la referencia de API o contacta a soporte.
Relacionado
Sección titulada «Relacionado»- Credenciales y Secretos — Cómo se almacenan y protegen las credenciales del perfil de conexión.
- Tipos de Entidad — Lista completa de tipos de entidad y los conectores que admite cada uno.
- Configuración de Mapeos — Cómo configurar mapeos de campos para cualquier par de conectores.