Conector Wix

El conector Wix extrae datos de sitios Wix Studio usando las APIs REST de Wix y los incorpora al pipeline de EZY Integrations como fuente. Dado que Wix va mucho más allá de una tienda en línea típica, este conector cubre ocho tipos de entidad distintos — incluyendo reservas de citas, suscripciones recurrentes, servicios reservables, planes de precios y elementos de menú de restaurante — además de contactos, pedidos y productos estándar.

Cuándo usar este conector

Sincronizar contactos de Wix con EZY Portal o SAP Business One como clientes o socios de negocio.
Enviar pedidos de la tienda Wix a un ERP para gestión de cumplimiento o facturación.
Extraer reservas de Wix Bookings para reportes o enriquecimiento de CRM.
Obtener suscripciones a planes de precios para hacer seguimiento de ingresos recurrentes en un sistema de destino.
Exportar elementos del menú de Wix Restaurants a un archivo plano o destino de API genérica.
Replicar servicios reservables y planes de precios en EZY Portal para gestión de catálogo.
Alimentar datos de productos Wix en un catálogo central o sistema de inventario.

Tipos de entidad admitidos

Tipo de entidad	Nombre amigable	Dirección	Descripción
`customer`	Cliente	Fuente	Un registro de contacto de la app Wix Contacts. Se mapea a la entidad canónica de cliente.
`order`	Pedido	Fuente	Un pedido de comercio electrónico realizado en la tienda Wix.
`booking`	Reserva	Fuente	Una cita o sesión reservada a través de Wix Bookings.
`subscription`	Suscripción	Fuente	Una suscripción recurrente a un plan de precios (Wix Pricing Plans). Siempre realiza un escaneo completo — la sincronización incremental no es compatible con este tipo.
`product`	Producto	Fuente	Un producto del catálogo de Wix Stores, incluyendo variantes y precios.
`service`	Servicio	Fuente	Una oferta de servicio reservable definida en Wix Bookings.
`plan`	Plan	Fuente	Un plan de precios definido en Wix Pricing Plans.
`menuitem`	Elemento de Menú	Fuente	Un elemento del menú de restaurante definido en Wix Restaurants.

La sincronización incremental está disponible para todos los tipos de entidad excepto subscription. Para los tipos compatibles, el conector filtra por la marca de tiempo de última actualización, de modo que solo se extraen los registros modificados después del primer ciclo de sincronización.

Prerrequisitos

Antes de crear un perfil de conexión para el conector Wix, necesitas dos datos de tu cuenta de Wix:

Una clave de API de Wix — genérala en el panel de control de Wix en Administrador de Claves de API. La clave debe tener permisos de lectura para las APIs de Wix correspondientes a los tipos de entidad que planeas extraer (por ejemplo, Wix Stores, Wix Bookings, Wix Pricing Plans, Wix Restaurants).
El ID de tu sitio Wix — el identificador único del sitio Wix al que deseas conectarte. Puedes encontrarlo en el panel de control de Wix en Configuración → Información General, o en la URL del panel de tu sitio.

Campos del perfil de conexión

Al crear un perfil de conexión Wix en EZY Integrations, completa los siguientes campos:

Campo	Requerido	Descripción	Valor de ejemplo
Clave de API	Sí	La clave de API de Wix obtenida del Administrador de Claves de API de Wix. Se almacena cifrada.	`<TU_CLAVE_API_WIX>`
ID del sitio	Sí	El identificador único de tu sitio Wix.	`a1b2c3d4-e5f6-7890-abcd-ef1234567890`

Después de ingresar ambos campos, usa el botón Probar conexión para verificar que la clave de API y el ID de sitio sean válidos. Una prueba exitosa confirma que EZY Integrations puede comunicarse con las APIs de Wix usando las credenciales proporcionadas.

Limitaciones conocidas

Las suscripciones siempre realizan un escaneo completo. La API de Wix Pricing Plans no expone un filtro de fecha de modificación, por lo que cada ciclo de sincronización del tipo de entidad subscription obtiene todos los registros desde el inicio. Para sitios con un gran volumen de suscripciones, esto aumenta la duración de la sincronización. Planifica los horarios de sincronización en consecuencia.
Las suscripciones en borrador se excluyen. Los registros con estado DRAFT (sesiones de pago abandonadas) se filtran automáticamente. Solo se entregan al sistema de destino las suscripciones con estado PENDING o con un último estado de pago de UNPAID o PENDING.
Reservas, servicios, planes y elementos de menú requieren apps de Wix instaladas. Si la app de Wix correspondiente no está activa en el sitio, el conector omite ese tipo de entidad sin interrumpir el trabajo. Revisa los detalles de la ejecución del trabajo para confirmar qué tipos de entidad fueron extraídos.
Los servicios usan filtrado incremental del lado del cliente. La API de servicios de Wix Bookings no admite filtros de rango de fechas de forma nativa, por lo que el conector obtiene todos los servicios y aplica el filtro incremental localmente. Para sitios con muchos servicios, esto es menos eficiente que el filtrado del lado del servidor.
Límites de velocidad de la API. La API de Wix aplica límites de velocidad en las solicitudes. El conector incluye un limitador de velocidad incorporado; si tus trabajos de sincronización son grandes o se ejecutan con frecuencia, considera programarlos en horarios de menor actividad para evitar throttling.
Conector solo de fuente. El conector Wix extrae datos de Wix — no escribe de vuelta a Wix. Para enviar datos procesados a Wix, sería necesario un perfil de destino de API genérica apuntando a la API REST de Wix.

Relacionado

Tipos de Entidad — Lista completa de tipos de entidad canónicos y los conectores que los admiten.
Etapas del Pipeline — Cómo los registros extraídos de Wix avanzan por las etapas de Ingesta, Normalización, Transformación, Ejecución y Finalización.
Perfiles de Conexión — Cómo crear, editar y probar perfiles de conexión.
Descripción General de Conectores — Todos los conectores admitidos de un vistazo.