Sincronización del contenido de productos entre vistas y tiendas Magento independientes
- Compatibilidad
- 2.4.9, 2.4.8, 2.4.7, 2.4.6, 2.4.5, 2.4.4, 2.4.3, 2.4.2, 2.4.1, 2.4.0, 2.3.7, 2.3.6, 2.3.5, 2.3.4
- Gestión mediante IA (MCP)
- No
Descripción / Sincronización del contenido de productos entre vistas y tiendas Magento independientes
MAGENTO 2 · ATRIBUTOS · STORE VIEW · REST API
Actualiza el contenido de productos en varias tiendas sin volver a introducir los datos
¿Gestionas una tienda B2B, una tienda minorista o varias instalaciones independientes de Magento? Cada cambio de descripción implica repetir los mismos pasos en varios paneles. Kowal Product Attribute Copy transfiere valores de atributos seleccionados entre productos existentes mediante mapeos guardados.
Prepara el contenido donde prefieras, define qué copiar y ejecuta la actualización. Tu equipo mantiene descripciones y especificaciones coherentes y controla qué datos se comparten.
Un contenido. Múltiples canales de venta.
01 · Selecciona los datos
Define los atributos que deben compartir los productos.
02 · Guarda los mapeos
Vincula productos locales o indica el SKU remoto y la conexión.
03 · Ejecuta la copia
De forma individual, masiva, por CLI o tras guardar el producto de origen local.
Tres direcciones de copia
- Local: entre productos y vistas de tienda de una misma instalación de Magento 2.
- Importación desde Magento remoto: desde un producto de otra tienda a un producto y una vista locales.
- Exportación a Magento remoto: desde un producto local a un producto existente en otro servidor.
Los productos pueden tener SKU distintos. La conexión guardada identifica la vista remota y el mapeo vincula un producto local con un SKU remoto concreto. La tienda remota utiliza la REST API estándar de Magento y no necesita este módulo.
Elige qué datos compartir
Selecciona en la configuración los atributos permitidos, como nombre, descripción, descripción corta y determinadas especificaciones técnicas. Las exclusiones limitan el alcance de la copia. Los campos técnicos, como SKU, precio, estado, visibilidad y existencias, quedan fuera de la copia.
En las transferencias remotas, las opciones select y multiselect se relacionan mediante etiquetas predeterminadas/admin únicas y exactamente iguales. No es necesario igualar manualmente los distintos ID de opción. La falta de coincidencia o las coincidencias ambiguas detienen el mapeo antes de guardar.
De cambios individuales a actualizaciones masivas de productos
- Ejecuta mapeos individuales con Copy Now o los registros seleccionados con Copy Selected.
- Activa la copia al guardar un mapeo si encaja con tu proceso.
- Ejecuta automáticamente mapeos locales y exportaciones tras guardar el producto de origen local en el panel.
- Utiliza CLI para operaciones manuales o tu propia programación externa. Ejecuta las importaciones remotas manualmente o por CLI.
- Consulta resultados, dirección, conexión y SKU remoto en el historial de copias.
Sincronización de galerías en una instalación
En los mapeos locales, merge añade imágenes que faltan y actualiza los metadatos de las entradas coincidentes. replace también elimina de la galería de destino las entradas ausentes en el origen. La transferencia por API no copia galerías ni archivos de imagen.
Conexiones remotas bajo control
Configura la dirección HTTPS, el código y el ID de la vista remota, el token Bearer y el tiempo de espera de las solicitudes. Los tokens se cifran y se ocultan en el formulario. El módulo verifica el certificado HTTPS y la correspondencia entre el código y el ID de la vista.
Requisitos y alcance
Paquete kowal/module-product-attribute-copy, módulo Kowal_ProductAttributeCopy, versión 1.1.4. Requisitos del paquete: Magento 2, PHP ^8.1 y la extensión cURL. Los productos y las definiciones y asignaciones de atributos compatibles deben existir en ambos lados.
El módulo no crea productos, atributos, opciones ni traducciones. No transfiere galerías remotas, relaciones con categorías ni precios complejos. Se siguen aplicando los ámbitos de atributo de Magento: cambiar un valor global puede afectar a otras vistas. La compatibilidad de backends de atributos personalizados debe probarse en la tienda de destino.
Elige un grupo de productos con contenido compartido y configura el primer mapeo para simplificar la próxima actualización del catálogo.
Instrucciones de instalación del módulo
Instalación y configuración de Kowal Product Attribute Copy 1.1.4
Desde la instalación del paquete hasta el primer mapeo. Estos pasos abarcan la configuración local y las conexiones con instalaciones remotas de Magento.
1. Requisitos y preparación
Necesitas Magento 2, PHP ^8.1, la extensión cURL, acceso a CLI y al panel de administración y los módulos Magento Catalog, Store, Ui, Backend y Config. Los productos de origen y destino deben existir. Las transferencias remotas requieren códigos y tipos de atributo compatibles, asignados a los conjuntos de atributos de los productos.
Antes de instalar, realiza una copia de seguridad de la base de datos y los archivos de configuración, incluida la clave de cifrado de app/etc/env.php. Prueba el primer mapeo en un entorno de pruebas.
2. Instalación mediante Composer
Ejecuta los comandos en el directorio raíz de Magento después de configurar el repositorio y el acceso al paquete adquirido:
composer require kowal/module-product-attribute-copy
bin/magento module:enable Kowal_ProductAttributeCopy
bin/magento setup:upgradeSi utilizas acceso VCS al repositorio indicado en la documentación, añádelo antes de instalar:
composer config repositories.kowal.product.attribute.copy vcs https://github.com/kowalco/module-product-attr-copyEl acceso al repositorio privado requiere permisos y autenticación de Composer. No incluyas tokens en scripts públicos ni en el repositorio del proyecto.
En modo de producción, compila y despliega también los recursos estáticos con los idiomas utilizados en la tienda:
bin/magento setup:di:compile
bin/magento setup:static-content:deploy pl_PL en_US
bin/magento cache:flush
bin/magento module:status Kowal_ProductAttributeCopyPara actualizar una instalación existente, utiliza composer update kowal/module-product-attribute-copy --with-dependencies y luego ejecuta setup:upgrade, los pasos de producción necesarios y la actualización de la caché. No sustituyas manualmente archivos en vendor.
3. Configuración básica
Abre Stores > Configuration > Catalog > Product Attribute Copy.
- Comprueba que Enabled esté en Yes.
- En Attributes > Allowed Attributes, selecciona los campos permitidos, como
name,description,short_descriptiony especificaciones seleccionadas. La lista está vacía por defecto: no se copiarán valores de atributos hasta completarla. - Revisa Excluded Attributes. Las exclusiones tienen prioridad sobre la lista de permitidos. Mantén excluidos los campos técnicos.
- Configura Copy After Product Save y Copy on Mapping Save. Para la primera prueba, desactiva la ejecución automática y copia manualmente.
- En mapeos locales, selecciona Copy Gallery. Mantén Replace Target Gallery = No para conservar imágenes adicionales del destino. Activar replace elimina las entradas ausentes en el origen.
- En Store Views > Excluded Target Store Views, excluye las vistas locales que no deban ser destinos de copia.
- Guarda la configuración. Activar Log Successful Copies facilita verificar las primeras operaciones.
Por defecto, el módulo y Copy After Product Save están activados, Copy on Mapping Save está desactivado, la galería utiliza merge y se registran las operaciones correctas.
4. Conexión con Magento remoto
En el ámbito Default Config, abre Remote Magento Stores. Añade una fila por cada vista remota.
- Name: un nombre de conexión reconocible.
- Magento Base URL (HTTPS): la dirección base de Magento, sin
/rest, parámetros ni credenciales. - Store View Code y Store View ID: el código de una vista activa concreta y su ID correspondiente, mayor que 0. No utilices all ni admin.
- Timeout: de 1 a 120 segundos; un campo vacío equivale a 30 segundos.
- API Bearer Token: un token que la instalación remota acepte como Bearer independiente.
El token necesita acceso a productos (Magento_Catalog::products), definiciones y opciones de atributos (Magento_Catalog::attributes_attributes) y la lista de vistas (Magento_Backend::store). La exportación requiere permiso para guardar productos. El módulo no renueva tokens caducados ni admite firmas OAuth 1.0a.
Los tokens se cifran y se ocultan en el formulario. El identificador de conexión se genera automáticamente y se conserva al editar. La tienda remota no necesita instalar este módulo. Antes de copiar, el módulo comprueba la correspondencia del código y el ID de la vista.
5. Crear un mapeo
Ve a Catalog > Product Attribute Copy > Mappings y selecciona Add New Mapping.
- Local: selecciona el producto y la vista locales de origen, y el producto y la vista de destino.
- Remote → Local (import): selecciona la conexión, introduce el SKU remoto e indica el producto y la vista locales de destino.
- Local → Remote (export): selecciona el producto y la vista locales de origen, la conexión y el SKU de un producto remoto existente.
Activa el mapeo y guarda. El origen y el destino no pueden ser el mismo producto en la misma vista local. Se bloquean los mapeos duplicados y las vistas locales de destino excluidas. Los ajustes del destino local controlan la importación; los del origen local, la exportación.
6. Ejecución y automatización
Utiliza Copy Now para un mapeo o Copy Selected para los registros seleccionados. Comprueba los valores de destino y los registros antes de ejecutar un lote mayor.
bin/magento kowal:product-attribute-copy:mapping:list
bin/magento kowal:product-attribute-copy:mapping:list --active-only
bin/magento kowal:product-attribute-copy:copy --mapping-id=1
bin/magento kowal:product-attribute-copy:copy --mapping-id=1 --mapping-id=2
bin/magento kowal:product-attribute-copy:copy --allCopy After Product Save se aplica a los mapeos locales y a la exportación tras guardar el producto de origen local en el panel. Ejecuta la importación remota manualmente o por CLI. Puedes programarla externamente; el módulo no detecta por sí solo cambios en la tienda remota.
7. Comprobación de resultados y limitaciones
El historial está en Catalog > Product Attribute Copy > Copy Logs. Revisa el estado, el mensaje, la dirección, la conexión y el SKU remoto.
- No se copian valores: comprueba Allowed Attributes, exclusiones, si el mapeo está activo y la configuración de la vista local correspondiente.
- Error select/multiselect: compara las etiquetas predeterminadas/admin exactas y únicas de las opciones en ambas tiendas.
- Error de API: comprueba la URL HTTPS, el certificado, los permisos y la validez del token, el SKU remoto y el código e ID de la vista.
- Tras un tiempo de espera agotado en una exportación, comprueba el producto remoto antes de reintentar. El guardado remoto puede haberse completado pese al error de conexión.
- Tras actualizar, refresca las cachés config/layout/block_html y vuelve a abrir el formulario de mapeo.
La sincronización de galerías es exclusivamente local. No se crean productos, definiciones de atributos, opciones ni traducciones. No se transfieren galerías remotas, rutas de imágenes, relaciones con categorías ni precios complejos. Se mantienen los ámbitos estándar de los atributos de Magento; un atributo global puede afectar a varias vistas.