UMI.CMS y 1C con Eofferix: catálogo, external

Esta guía trata del flujo de catálogo 1C -> Eofferix -> UMI.CMS. Úsala cuando 1C exporta productos, secciones, ofertas, precios, stock, imágenes y propiedades, y se necesita una correspondencia fiable entre productos, ofertas y pedidos.

Si el módulo UMI.CMS todavía no está instalado, empieza por Importar un catálogo a UMI.CMS con Eofferix. Esta página se centra solo en el escenario 1C: identificadores, perfiles completo y de cambios, y comprobaciones antes de un pedido de prueba.

Qué Hace Eofferix

Eofferix recibe el catálogo desde 1C, lee import.xml, offers.xml y archivos de imágenes, aplica las reglas del snapshot y envía los elementos preparados al módulo instalado en UMI.CMS. El módulo escribe el resultado en el catálogo del sitio.

Eofferix no admite intercambio de pedidos. Los pedidos deben enviarse a 1C mediante la integración nativa de pedidos entre UMI.CMS y 1C. Eofferix debe cargar primero el catálogo para que UMI.CMS pueda enviar a 1C identificadores reconocibles del producto y de la oferta elegida.

Resultado Esperado

Después de la configuración, un producto de 1C debe encontrarse en el sitio por la clave elegida, cada oferta debe estar vinculada a su producto, y precio, stock y propiedades de la variante deben guardarse en la oferta. Una importación repetida sin cambios debe omitir rápidamente los elementos sin cambios.

Para los pedidos no basta con el nombre del producto ni con el artículo visible. UMI.CMS necesita los identificadores nativos de 1C tanto del producto como de la oferta elegida. Sin ellos, 1C puede recibir un pedido sin artículo reconocible o crear un duplicado.

Orden Mínimo De Configuración

Conecta el sitio UMI.CMS y espera una comprobación de conexión correcta.
Selecciona el tipo de datos UMI.CMS para productos y el tipo para secciones.
Para productos de 1C, selecciona external_id en los campos de identificación del producto.
Para ofertas, selecciona external_id de la oferta en los campos de identificación.
En el snapshot, marca roles de sección, producto y oferta.
Vincula precio, stock y propiedades de variante dentro del rol de oferta.
Ejecuta una exportación de prueba pequeña antes del perfil completo.

Campos De Identificación

Campo	Para qué usarlo	Importante
`external_id` del producto	Clave principal del producto desde 1C.	Normalmente es lo que UMI.CMS necesita para reconocer el producto en un pedido.
`external_id` de la oferta	Clave de una variante: talla, color, paquete u otra opción.	Producto y oferta tienen valores distintos. No los mezcles.
Artículo del producto `artikul`	Campo normal de producto en plantillas de datos UMI.CMS.	Úsalo para búsqueda solo si el negocio realmente empareja por artículo de producto.
Artículo de oferta `vendor_code`	Artículo de sistema de la oferta en UMI.CMS.	Es el artículo visible de la oferta. No sustituye `external_id` para pedidos 1C.
Clave de servicio Eofferix `guid`	Emparejamiento interno dentro de Eofferix.	No es un campo de intercambio de pedidos UMI.CMS y 1C.
ID de página UMI `id`	ID interno dentro de una instalación UMI.CMS.	Úsalo solo para carga inversa al mismo sitio.

Regla Principal De Búsqueda

Eofferix busca productos, secciones y ofertas existentes solo por los campos elegidos en la plantilla. Si se selecciona external_id, busca por external_id. Si se selecciona artículo, busca por ese artículo. El servicio no debe cambiar silenciosamente a vendor_code, sku u otro campo.

Si no se selecciona un campo de identificación para secciones, es más seguro usar la ruta completa de secciones después de las transformaciones. Así Electronics / Other y Sensors / Other no se unen por error.

Roles En El Snapshot

En el catálogo completo, marca tres roles: sección, producto y oferta. Vincula el identificador del producto a external_id del producto. Vincula el identificador de la oferta a external_id de la oferta.

Las variables y transformaciones pueden preparar claves antes de la exportación. Comprueba el valor transformado, no el XML original.

Roles de producto y oferta en el snapshot XML de 1C

Configura La Vinculación De La Oferta Con El Producto

Una oferta no es el primer producto de la lista ni una copia del producto padre. Es una variante separada con su propio identificador, precio, stock y propiedades. Si las ofertas están dentro del producto, márcalas con el rol de oferta. Si productos y ofertas llegan por separado en import.xml y offers.xml, configura la clave que vincula la oferta con el producto.

1C transmite su propia clave de producto en forma productGuid#offerGuid. Para la integración recomendamos usarla para exportar a external_id (clave de la oferta) y a product_external_id (clave que vincula la oferta con el producto).

Propiedades, Precios Y Stock De Oferta

Las propiedades de producto van al producto, las de sección a la sección y las de oferta al objeto de datos de esa oferta. Usa los campos de oferta que devuelve el sitio UMI.CMS conectado. Talla, color, precio de oferta, stock de oferta y vendor_code no deben escribirse por accidente en el producto padre.

Vincular un valor de origen a un campo UMI.CMS

Catálogo Completo Y Cambios

Para proyectos 1C, usa dos perfiles cuando sea posible. El primero recibe el catálogo completo y puede ser propietario del catálogo del sitio. El segundo recibe solo cambios y no debe quitar la propiedad al perfil completo.

Ajuste	Catálogo completo	Intercambio de cambios
Fuente	Archivo o intercambio con todo el catálogo actual.	Exportación separada de 1C solo con objetos modificados.
Escenario	Sincronización completa de la fuente.	Actualización cuidadosa sin limpieza completa.
Propiedad del perfil	Activada cuando este perfil posee el catálogo.	Desactivada cuando el perfil completo debe seguir siendo propietario.
Eliminar ausentes	Solo dentro de esta fuente y con límite de protección.	Normalmente desactivado. Ausente en cambios no significa eliminado.
Stock cero	Puede seguir las reglas del catálogo completo.	Aplicar solo a objetos presentes en el intercambio actual.
Imágenes	Borrar imágenes ausentes solo si la fuente es completa.	Conservar imágenes existentes cuando no aparecen en el archivo de cambios.

Dos Fuentes

Crea o conserva la fuente para el catálogo completo 1C.
Crea una segunda fuente para cambios.
Configura 1C para enviar la exportación completa a la primera fuente y los cambios a la segunda.
Copia el perfil completo para mantener tipos, roles y campos.
Cambia la copia a la fuente de cambios.
Desactiva las opciones que hacen al perfil de cambios propietario del catálogo o ejecutan limpieza completa.
Prueba un cambio pequeño: precio, stock, una propiedad o una imagen.

Limpieza E Imágenes

La eliminación debe activarse solo cuando la fuente es la verdad completa. En un archivo parcial de 1C, un producto o imagen ausente normalmente significa sin cambios, no eliminado.

No actives limpieza completa en el perfil de cambios. Si la fuente envía solo productos modificados, la limpieza completa puede tratar el resto del catálogo como ausente.

Usa borrado forzado de imágenes ausentes solo para un catálogo completo con un conjunto de imágenes garantizado. Si el archivo de imágenes no llega temporalmente, esta opción puede borrar imágenes ya cargadas en el sitio.

Ajustes avanzados de imágenes para UMI.CMS

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.

Importación Repetida Y Coste

Después de la primera importación, los siguientes lanzamientos deben encontrar productos y ofertas existentes. Si los datos transformados no cambiaron, el elemento debe pasar como la acción más barata UMI.CMS · elemento sin cambios. Si cada lanzamiento crea el catálogo otra vez, revisa los campos de identificación y si external_id se guardó.

Comprobar En UMI.CMS

Abre un producto en la administración UMI.CMS.
Comprueba que el identificador 1C del producto esté rellenado.
Abre las ofertas y verifica que se crearon dentro del producto.
Comprueba external_id, vendor_code, precio y stock de la oferta elegida.
Comprueba que las propiedades de variante estén en la oferta, no en el producto padre.
Abre las imágenes del producto y verifica que los archivos aparecieron realmente en UMI.CMS.

Pedido De Prueba

Haz un pedido con una oferta concreta en el sitio de prueba.
Envía el pedido a 1C mediante la integración nativa de pedidos entre UMI.CMS y 1C.
En 1C, confirma que el pedido coincide con un producto existente y la variante elegida.
Si 1C crea un producto nuevo o recibe un pedido sin artículo, vuelve a los identificadores de producto y oferta.

Si El Pedido No Coincide

Síntoma	Qué comprobar
El pedido no tiene artículo	Si `external_id` del producto y de la oferta elegida están rellenados en UMI.CMS.
1C crea un producto nuevo	Qué clave externa envió UMI.CMS y si esa clave existe en 1C.
El pedido usa producto sin variante	Si existen ofertas y la tienda selecciona una oferta concreta.
Hay stock en producto pero no en oferta	Si el stock de oferta se escribió en el campo del producto padre.
La importación repetida crea duplicados	Si los campos de identificación elegidos coinciden con los valores realmente cargados.
Las imágenes desaparecieron	Si el borrado forzado de imágenes está activado en un perfil parcial.

Lista Final

El perfil completo carga secciones, productos, ofertas, precios, stock, propiedades e imágenes.
Cada producto tiene su propio external_id.
Cada oferta tiene su propio external_id.
vendor_code se usa como artículo de oferta, pero no sustituye el identificador 1C.
Las propiedades de oferta se guardan en la oferta concreta, no en el producto padre.
El perfil de cambios no ejecuta limpieza completa ni toma propiedad del catálogo.
Una importación repetida sin cambios se cobra como elementos sin cambios.
Un pedido de prueba en 1C coincide con un producto existente y la oferta elegida.