Conector EZY Portal

El conector EZY Portal lee y escribe en la API REST de EZY Portal. Admite ambas direcciones: úsalo como destino para enviar artículos, socios de negocio, listas de precios y otros datos maestros a un tenant de Portal desde un ERP o plataforma de comercio electrónico, y como fuente para extraer cotizaciones y pedidos de ventas del Portal y procesarlos en otro sistema.

Cuándo usar este conector

Sincronizar el catálogo de artículos desde SAP Business One hacia EZY Portal de forma programada.
Enviar socios de negocio junto con sus condiciones de pago, grupos y listas de precios desde un ERP al Portal.
Poblar los datos de referencia del Portal (almacenes, categorías fiscales, grupos de unidades de medida, períodos fiscales) al incorporar un nuevo tenant.
Extraer cotizaciones o pedidos de ventas creados en el Portal y enviarlos a un sistema externo, como un ERP o un archivo plano.
Enrutar productos de comercio electrónico desde Shopify o WooCommerce hacia el Portal como artículos.

Tipos de entidad admitidos

Tipo de entidad	Dirección	Descripción
Artículo (`item`)	Destino	Registro maestro de producto o SKU, incluyendo precios y unidades de medida.
Socio de Negocio (`bp`)	Destino	Registro de socio de negocio (cliente, proveedor o ambos).
Cliente (`customer`)	Destino	Registro de cliente proveniente de una fuente de comercio electrónico (Shopify, WooCommerce, Wix). Se mapea a un socio de negocio en el Portal.
Grupo de Socios de Negocio	Fuente + Destino	Categoría utilizada para agrupar socios de negocio.
Condiciones de Pago	Fuente + Destino	Datos de referencia de condiciones de pago (por ejemplo, Neto 30).
Grupo de Artículos	Fuente + Destino	Categoría utilizada para agrupar artículos.
Lista de Precios	Fuente + Destino	Lista de precios con nombre, típicamente asociada a un grupo de clientes.
Grupo de Unidades de Medida	Destino	Grupo de unidades de medida relacionadas (por ejemplo, Peso: kg, g, lb).
Grupo de Impuestos	Destino	Categoría fiscal aplicada a artículos o socios de negocio.
Almacén	Destino	Ubicación de inventario física o lógica.
Período Fiscal	Destino	Definición de período contable.
Cotización de Ventas	Fuente + Destino	Documento de cotización de ventas.
Pedido de Ventas	Fuente + Destino	Documento de pedido de ventas confirmado.

La extracción como fuente lee de la API del Portal mediante sincronización incremental basada en cursor, usando el campo updatedAt del registro. Los tipos de entidad marcados solo como Destino no tienen un endpoint de extracción en el Portal y únicamente pueden recibir datos.

Prerrequisitos

Antes de configurar este conector necesitas:

Un tenant de EZY Portal activo y accesible por HTTPS (o HTTP para pruebas locales con la validación TLS deshabilitada).
Una clave de API de integración creada en la configuración del Portal. Esta clave es independiente de las credenciales de usuario regulares y otorga al servicio de integración permiso para leer y escribir datos mediante la API.

Campos del perfil de conexión

Navega a Perfiles de Conexión en EZY Integrations y selecciona EZY Portal como tipo de sistema. Completa los siguientes campos.

Campo	Requerido	Descripción	Valor de ejemplo
URL del Portal	Sí	URL base de tu instancia de EZY Portal. Debe incluir el esquema (`https://`).	`https://portal.example.com`
Clave de API	Sí	Clave de API de integración generada en la configuración del Portal. Se almacena cifrada al guardar.	`<TU_CLAVE_API>`
Omitir Validación TLS	No	Deshabilita la verificación del certificado TLS. Útil para entornos locales o con certificados autofirmados. No se recomienda en producción.	Sin marcar

Una vez completados los campos, haz clic en Probar Conexión para verificar que EZY Integrations puede comunicarse con tu tenant del Portal con las credenciales proporcionadas. Un resultado en verde confirma que la autenticación fue exitosa.

Combinaciones habituales

El patrón más frecuente posiciona a EZY Portal como destino de una integración entrante desde un ERP. Un trabajo configurado con SAP Business One como fuente y EZY Portal como destino envía artículos, socios de negocio, grupos de artículos, grupos de socios, listas de precios, condiciones de pago, almacenes, grupos de impuestos, grupos de unidades de medida y períodos fiscales — el conjunto completo de datos maestros que un tenant de Portal necesita para operar. Un segundo trabajo en la dirección inversa (Portal como fuente, SAP B1 Service Layer como destino) gestiona la escritura de cotizaciones de ventas.

Las integraciones de comercio electrónico siguen el mismo patrón: Shopify o WooCommerce como fuente y EZY Portal como destino, con artículos (productos) y opcionalmente clientes fluyendo hacia el Portal.

Una integración multiéntidad de Wix puede distribuir datos a dos destinos simultáneamente: EZY Portal recibe productos, servicios, planes y artículos de menú, mientras que un destino de Archivo Plano archiva los contactos y pedidos.

Limitaciones conocidas

Las escrituras de almacén son individuales. A diferencia de artículos, socios de negocio, listas de precios, grupos de artículos, grupos de socios y condiciones de pago —que admiten creación y actualización masiva en una sola llamada a la API— los registros de almacén se escriben de uno en uno.
Truncado automático de campos. El conector trunca automáticamente los valores que superan los límites de longitud de campo del Portal antes de escribirlos. Si ocurre un truncado, el registro de detalle de la ejecución muestra el valor original y el truncado.
Prevención de duplicados en la primera ejecución. Cuando un trabajo se reinicia y se vuelve a ejecutar contra un tenant de Portal que ya tiene registros, el conector busca cada registro por su código antes de crearlo. Si encuentra una coincidencia, convierte la operación en una actualización. Esto evita registros duplicados tras un reinicio de base de datos o cuando el mismo trabajo se ejecuta contra un tenant ya poblado.
Las referencias de listas de precios base deben existir antes que las dependientes. Si una lista de precios hace referencia a una lista de precios base que aún no se ha sincronizado, el registro se reintenta automáticamente. Asegúrate de sincronizar las listas de precios base en una configuración de mapeo separada que se ejecute antes que las dependientes, o inclúyelas en la misma ejecución para que el orden se gestione de forma natural.
Resolución de conflictos en cotizaciones de ventas. Las cotizaciones de ventas no usan un código estable para la reconciliación. Un conflicto (número de documento duplicado) se marca como CONFLICT_UNRESOLVED en los detalles de la ejecución y requiere revisión manual.
Transición de estado de cotizaciones de ventas. Una post-acción puede opcionalmente avanzar el estado de una cotización recién creada de borrador a ENVIADA inmediatamente después de su creación. Este comportamiento se controla mediante una post-acción en la configuración de mapeo y no se activa por defecto.

Relacionado

Credenciales y Secretos — Cómo se almacenan y cifran las credenciales de los perfiles de conexión.
Configuración de Mapeo — Cómo configurar las reglas de extracción, normalización y transformación para cada tipo de entidad.
Descripción de Trabajos — Cómo vincular un perfil de fuente con un perfil de destino y ejecutar trabajos.
Historial de Ejecuciones — Cómo inspeccionar los resultados de una ejecución completada.
Todos los Conectores — Compara EZY Portal con otros conectores disponibles.