Transferir complementos de producto con el CSV de WooCommerce

Usa las herramientas de CSV de productos de WooCommerce para hacer copias de seguridad o mover la configuración de Product Add-Ons que pertenece a productos individuales. Este flujo de trabajo admite productos simples, productos variables y filas de variación. No repite los grupos que se aplican globalmente mediante asignaciones de todos los productos, de categoría o de producto directo.

Requisitos previos

• Activa Product Add-Ons en Settings → POM Tweaks → E-Commerce → Products.
• Usa una cuenta que pueda exportar y editar productos de WooCommerce.
• Al mover productos entre sitios, crea o importa cualquier grupo global que los productos excluyan explícitamente antes de importar el CSV de productos.
• Mantén intactas las celdas JSON generadas. Edita Product Add-Ons a través de la interfaz de POM y crea una nueva exportación en lugar de editar manualmente las definiciones anidadas.

Exportar productos

1. Ve a Products → All Products.
2. Selecciona Export.
3. Incluye estas columnas:
   • POM Add-Ons: Local definition (JSON)
   • POM Add-Ons: Exclude global groups (JSON)
   • POM Add-Ons: Excluded groups (JSON)
4. Elige los tipos de productos o productos requeridos y selecciona Generate CSV.
5. Guarda el CSV de forma segura junto con el resto de la exportación de productos.

Cada celda POM rellenada es un objeto JSON con schema_version: 1, un type específico de la columna, una mode de configuración y el estado de herencia o anulación del producto. La celda de definición local contiene el paquete JSON de POM autónomo, que incluye las opciones reutilizables referenciadas y las imágenes de opción admitidas. Contiene UUID en lugar de IDs de producto, opción, grupo o adjunto de origen. No contiene rutas del sistema de archivos de subida.

La celda de grupos excluidos contiene solo UUID de grupo exactos. Un grupo de origen que no pueda representarse de forma segura se indica dentro de la celda como una referencia no resuelta; en ese caso, la importación de esa fila se bloquea en lugar de omitir silenciosamente la exclusión.

Importar productos

1. Ve a Products → All Products y selecciona Import.
2. Sube el CSV y elige si se deben actualizar los productos existentes.
3. En Column mapping, confirma que los tres nombres de columna de POM se asignan a sus campos de POM correspondientes.
4. Ejecuta la importación.
5. Revisa el informe de importación de WooCommerce. Un valor de POM mal formado o no resuelto se notifica en la fila de su producto.
6. Edita un producto importado y abre Product data → Add-Ons para verificar sus campos locales y exclusiones.

En el caso de las opciones reutilizables, la importación usa la identidad UUID exacta. Una opción de destino existente con el mismo UUID se vincula sin sobrescribir su contenido de destino. Una opción ausente se crea a partir del registro incrustado conservando su UUID y su estado activado o desactivado. Las etiquetas nunca se usan para vincular. Los UUID duplicados, las opciones no incrustadas que faltan, los esquemas futuros, el JSON no válido y los grupos excluidos no disponibles detienen esa fila.

Todas las escrituras de POM de una fila correcta se aplican conjuntamente. Si las opciones reutilizables, las imágenes, la definición local o las exclusiones no pueden completarse, POM las revierte y deja intactos los metadatos de producto de POM anteriores. WooCommerce notifica el error de la fila. Solo cambia la generación de caché del modelo resuelto del producto importado; las importaciones de CSV de productos no reconstruyen el índice de asignación global.

Productos simples, productos variables y variaciones

WooCommerce exporta un producto matriz variable y sus filas de variación según la selección usada en el exportador nativo. POM escribe solo la configuración almacenada directamente en cada fila exportada:

• Los campos locales de un producto matriz variable siguen siendo la capa del matriz usada por sus variaciones.
• Una fila de variación puede llevar sus propios campos locales y exclusiones como la capa de variación posterior.
• Los grupos globales efectivos no se copian en ninguna de las dos filas.
• La herencia de Polylang o una anulación de traducción explícita se conserva cuando la fila de destino pertenece a la estructura de producto traducido correspondiente.

Incluye e inspecciona siempre las filas de variación cuando el catálogo de origen almacene una configuración de Product Add-Ons específica de la variación.

Convertir una columna oficial de Product Add-Ons

Una exportación oficial de Product Add-Ons de WooCommerce suele exponer sus campos de producto como Meta: _product_addons. POM detecta ese origen mediante una opción de asignación explícita; nunca inicia una migración global durante la importación de productos.

1. En la pantalla de Column mapping de WooCommerce, localiza Meta: _product_addons.
2. Cambia su destino de metadatos genéricos a POM Add-Ons: Convert official _product_addons.
3. Importa el CSV y revisa los errores de fila.

La fila seleccionada se convierte mediante el mismo validador de campos de POM que se usa en la administración y la migración. Los IDs de adjunto oficiales se eliminan porque no son portables entre sitios. La conversión no crea opciones reutilizables emparejando etiquetas, no escribe _product_addons y no altera los grupos oficiales globales. Deja la columna asignada como metadatos genéricos cuando necesites conservar el valor oficial sin convertirlo.

Verificar el resultado

1. Abre un producto simple importado y confirma sus campos, precios, exclusiones y opciones reutilizables.
2. Abre un producto variable importado y al menos una variación que tuviera su propia configuración.
3. Visualiza ambos productos en la tienda y envía una selección válida.
4. En una importación entre sitios, confirma que los grupos excluidos se resuelven en grupos de destino con el mismo UUID.
5. Confirma que el informe de importación rechaza una fila de prueba con JSON no válido o un UUID no disponible sin cambiar la configuración de POM anterior de ese producto.

Solución de problemas y recuperación

• Falta el UUID del grupo excluido: importa o crea primero el grupo correspondiente y vuelve a ejecutar la fila del producto. POM no adivina por el nombre del grupo.
• El UUID de la opción reutilizable está duplicado: resuelve los registros duplicados en el sitio de destino antes de reintentar. Un UUID debe identificar una única opción reutilizable.
• La celda informa de un error de exportación: corrige la opción, referencia de grupo, imagen o problema de tamaño no disponibles en el producto de origen y exporta de nuevo.
• El paquete supera el límite: reduce los tamaños de las imágenes incrustadas o divide la transferencia del producto. Cada celda JSON está limitada a 1 MiB.
• Necesitas deshacer una importación correcta: importa la copia de seguridad CSV de productos anterior o restaura los campos y exclusiones en Product data → Add-Ons. Elimina las opciones reutilizables recién creadas solo después de que su recuento de Usage sea cero.

Guía relacionada: Crear grupos, opciones reutilizables y transferencias JSON independientes y Migrar un catálogo oficial existente.