El módulo Eofferix se instala en el sitio UMI.CMS y recibe el catálogo preparado: secciones, productos, ofertas, precios, stock, imágenes, archivos y propiedades. El servicio puede tomar fuentes desde email, servicios de archivos, FTP, 1C, enlaces directos y portales de proveedores protegidos por contraseña, luego transforma los datos según las reglas configuradas y los escribe en la estructura de UMI.CMS.
Qué Necesitas
- Acceso a los archivos del sitio por SSH, SFTP, FTP o gestor del hosting.
- Acceso de administrador a UMI.CMS.
- El instalador
eofferix-umi-install.zipo el archivo del móduloeofferix-umi-cms-module.zip.
Paso 1. Instalar El Módulo UMI.CMS
- Entra en UMI.CMS en el mismo navegador.
- Descomprime
eofferix-umi-install.zip. - Sube
eofferix-umi-installa la raíz del sitio, junto aindex.php. - Abre
https://site.com/eofferix-umi-install/install.php. - Espera el mensaje de éxito.
- Elimina la carpeta del instalador.
Paso 2. Conectar El Perfil
Abre el perfil, elige UMI.CMS, introduce el sitio y el administrador, y pulsa Comprobar conexión. Después se cargan tipos de datos, campos y secciones raíz.
Paso 3. Elegir Tipos De Datos, Sección Raíz Y Campos De Identificación
En el bloque Identificación de elementos UMI.CMS, elige los tipos de datos para productos y secciones, la sección raíz de importación y los campos con los que Eofferix buscará secciones, productos y ofertas existentes.
Los campos de identificación indican cómo el servicio compara la fuente con el catálogo UMI.CMS existente. Elige la clave estable de tu fuente: external_id, artículo/SKU, id, una combinación como nombre del producto más artículo, u otro campo fiable.
Cómo funcionan Y y O. Las fichas de identificación separadas se combinan con Y. Dentro de una ficha, el botón «o …» añade campos alternativos que se prueban de izquierda a derecha. Por ejemplo: (SKU O Código externo O Código de barras) Y Proveedor Y (Marca O Fabricante).
Eofferix se detiene en la primera combinación completa que encuentra objetos existentes. Si esa combinación encuentra varios objetos, todo el conjunto se entrega a la regla de duplicados elegida; la búsqueda no pasa a la alternativa siguiente. Cada grupo obligatorio debe tener un valor. El usuario puede elegir cualquier campo disponible y las alternativas adicionales no consumen créditos adicionales.
La sección raíz define dónde se crearán las nuevas secciones de la fuente. Si se selecciona una sección concreta, las nuevas ramas del catálogo se crearán dentro de ella. Si se selecciona la raíz del sitio, se crearán desde la raíz.
Para 1C, es mejor usar external_id tanto para productos como para ofertas: estos identificadores siempre son únicos.
Para secciones, elige un campo de identificación separado principalmente cuando las secciones llegan como un bloque separado en la fuente. Si la sección está dentro del producto como ruta completa o nombre simple, normalmente no hace falta una comparación separada: usa la ruta transformada de la sección.
Paso 4. Elegir El Escenario De Importación
En los ajustes del perfil puedes elegir un escenario de intercambio preparado. Define qué hace Eofferix con productos nuevos, productos encontrados, ofertas y objetos que ya no están en la fuente.
| Escenario | Cuándo usarlo |
|---|---|
| Sincronización segura | Eofferix crea productos nuevos y actualiza los encontrados, pero no elimina automáticamente los objetos ausentes. Tampoco vincula productos y ofertas a un perfil concreto. |
| Sincronización completa de la fuente | El perfil vincula a sí mismo todos los productos y ofertas importados. Un nuevo lanzamiento del perfil elimina los productos y ofertas que desaparecieron de la fuente y añade los nuevos que aparecieron con la actualización. |
| Actualizar encontrados | Este escenario sirve cuando necesitas cambiar precios, stock, nombres o propiedades solo en productos y ofertas ya encontrados. No se crean productos nuevos. |
| Agregar solo nuevos | Cuando necesitas añadir productos y ofertas que faltan, pero no cambiar lo que ya existe en el sitio. |
| Sobrescritura completa del catálogo | Este escenario elimina productos, ofertas y secciones ausentes dentro del ámbito elegido y después crea o actualiza los objetos de la fuente actual. Las propiedades y los valores de diccionario se conservan. |
También puedes configurar manualmente el comportamiento del intercambio para productos, ofertas y secciones.
Paso 5. Marcar Roles Del Snapshot
Marca qué nodo es producto, sección y oferta. Si las ofertas están dentro del producto, Eofferix lee la relación desde la estructura XML. Si llegan en un bloque separado, vincula el campo de servicio product_external_id — vinculación de oferta con producto.
Paso 6. Vincular Campos De Producto, Sección Y Oferta
Las propiedades del producto se escriben en el tipo de producto. Las propiedades de la sección se escriben en la sección. Las propiedades de oferta se escriben en el objeto de la oferta concreta, usando los campos de oferta que devuelve el sitio UMI.CMS conectado.
Antes de escribir un valor en la CMS, puedes prepararlo: limpiar texto, normalizar un número o una fecha, montar un valor desde varios nodos, buscarlo en un diccionario o añadir condiciones de exportación. Ejemplos útiles: transformaciones de valores, condiciones de exportación de campo, mapeo por diccionario y varios valores en un campo.
Paso 7. Configurar Imágenes Y Archivos
XML, CSV, Excel y otras fuentes normalmente contienen URL, rutas o nombres de archivos de imagen, no las imágenes como binarios. Eofferix descarga imágenes por URL, las extrae de archivos 1C o de archivos y paquetes subidos junto con la fuente, y luego envía los archivos preparados a UMI.CMS. En los ajustes avanzados del campo de imagen, Eofferix puede guardar el archivo en el servicio, convertir el formato, reducir imágenes grandes a la anchura y altura elegidas y definir la calidad JPEG/WEBP. Esto influye mucho en el tamaño de los archivos y en la velocidad de carga de las páginas.
En los mismos ajustes puedes activar una marca de agua: sube un archivo PNG/WEBP, elige posición, opacidad y tamaño máximo. Para galerías puedes configurar el separador de imágenes, el rango y el salto de carga repetida si el archivo no cambió.
Paso 8. Ejecutar Una Prueba
Usa la exportación de prueba para comprobar la configuración. Envía a UMI.CMS una muestra limitada de 5 productos y no elimina elementos, secciones ni otros objetos ausentes.
Una exportación de prueba normal no ejecuta la limpieza de objetos ausentes. Si se activa Prueba como ejecución completa, las reglas de ejecución completa se aplican a la muestra limitada: la limpieza puede afectar a productos, ofertas, secciones e imágenes ausentes dentro del ámbito elegido.
El módulo Eofferix para UMI.CMS no elimina propiedades, características ni valores de diccionario. Puede vincular una propiedad o un valor existente, o crear el que falta, pero no elimina ni desvincula las propiedades y los valores creados en ejecuciones posteriores. Las reglas para productos, ofertas, secciones e imágenes ausentes funcionan por separado.
La importación en UMI.CMS no permite volver al estado de una ejecución anterior y no crea puntos de reversión. Una ejecución detenida solo puede continuar si existe un punto de reanudación confirmado; de lo contrario, corrige la causa e inicia una importación normal nueva. Haz una copia de seguridad del sitio y de la base de datos antes de una ejecución completa con reglas de eliminación.
Costes Y Elementos Sin Cambios
Antes del lanzamiento, Eofferix calcula el coste estimado. En importaciones repetidas, los productos y ofertas sin cambios deben pasar por la acción más barata UMI.CMS · elemento sin cambios. Así un intercambio regular no cuesta como una reconstrucción completa del catálogo.
Si el catálogo ya se importó, pero el siguiente lanzamiento vuelve a parecer la creación de miles de objetos nuevos, revisa los campos de identificación del producto y de la oferta, el escenario de importación y la vinculación al perfil.
Si necesitas forzar la reescritura de los elementos encontrados del catálogo, desmarca No actualizar el elemento UMI si los datos no cambiaron en Ajustes avanzados de importación. El servicio dejará de omitir rápidamente los elementos sin cambios y enviará una actualización completa; esa ejecución puede tardar más y costar más.
