Traduzca productos importados de WooCommerce: CSV, API, ERP
Mantenga sincronizado un catálogo multilingüe de WooCommerce cuando los productos lleguen mediante importación de CSV, WP All Import, la API REST o una sincronización de ERP.
Actualizado: 16 de noviembre de 2026
Esta guía es para tiendas cuyo catálogo reside fuera de WordPress: en una hoja de cálculo, un PIM, un ERP o un feed de proveedores. Los productos llegan a WooCommerce mediante un importador, la API REST o un trabajo programado, y usted rara vez abre el editor de productos.
Parte 1. Cómo funciona una tienda multilingüe gestionada desde el exterior
Un producto por idioma, vinculado por un grupo de traducción
Cada idioma tiene su propio producto de WooCommerce, con su propio ID. WPML vincula los idiomas en un grupo de traducción. El original es el producto en el idioma predeterminado de su tienda; los otros idiomas son sus traducciones.
En nuestra tienda de ejemplo, la sudadera con capucha Zip-Up Hoodie es el producto 14 en inglés, 121 en alemán y 122 en francés. Toda respuesta de la API REST para cualquiera de ellos incluye el mismo mapa: "translations": {"de":"121","en":"14","fr":"122"}.
El SKU es el mismo en todos los idiomas. Las variaciones de un producto variable también mantienen los mismos SKU de variación.
El SKU es la clave para su sistema externo. La propia búsqueda de WooCommerce, wc_get_product_id_by_sku(), devuelve el producto original, no una traducción.
Las listas devuelven un idioma a la vez.GET /wc/v3/products?sku=HP-HD-ZIP devuelve solo el idioma predeterminado. Añada &lang=de para un idioma, o &lang=all para todos los idiomas.
Qué copia WPML a cada idioma y qué traduce
Cuando el producto original cambia, a través del editor de productos, una importación de CSV o la API REST, WPML copia estos valores a cada traducción:
Precio normal y precio rebajado
Cantidad de inventario y estado del inventario
SKU, peso y dimensiones
Imagen y galería del producto (cada idioma obtiene su propia copia de la imagen)
Categorías y etiquetas (como la categoría o etiqueta traducida)
Ventas dirigidas y ventas cruzadas (que apuntan al producto en el mismo idioma)
Estado de publicación
Para productos variables: el precio y el inventario de cada variación, el rango de precios, un nuevo término de atributo global (como su traducción, por ejemplo, Schwarz y Noir para Black) y una nueva variación
Estos se mantienen diferentes en cada idioma, porque se traducen:
Nombre, descripción y descripción corta
Slug (la dirección del producto, por ejemplo /de/produkt/kapuzenjacke-mit-reissverschluss/)
Términos de atributos, como Blue, Blau y Bleu
Valores de atributos específicos del producto, como un «Material» establecido solo en este producto
El inventario se comparte entre todos los idiomas.
Escriba los precios y atributos en el original. Si su sistema escribe un precio o atributos en una traducción, la traducción mantiene los valores del original. El inventario escrito en cualquier idioma se convierte en el inventario de todos los idiomas, porque se comparte.
Los precios en una segunda moneda también siguen al original (consulte multimoneda para WooCommerce). Establézcalos en el original, con custom_prices en la API REST ("custom_prices": {"USD": {"regular_price": "55.00", "sale_price": "49.00"}}) o con las columnas CSV Meta: _wcml_custom_prices_status, Meta: _regular_price_USD, Meta: _sale_price_USD y Meta: _price_USD. Entonces, cada idioma muestra esos precios en esa moneda.
custom_prices se almacena cuando la función multimoneda está activada y la moneda es una de las monedas de su tienda. Envíelo de la siguiente manera:
Active primero la función multimoneda. Vaya a WPML → Configuración → Multimoneda, marque Activar el modo multimoneda y haga clic en Guardar los cambios. En Mostrar monedas según, elija una opción (por ejemplo, Idioma del sitio) y haga clic en Guardar los cambios. Luego añada cada moneda con Añadir moneda. Con la función multimoneda desactivada, WPML no almacena nada de custom_prices.
Use los códigos de moneda de su tienda. WPML almacena únicamente los precios de las monedas de la tienda. Un precio en cualquier otro código no se almacena.
Para un producto variable, envíe custom_prices en cada variación, no en el padre. WPML lo almacena en la variación original, y todos los idiomas lo muestran. Si se envía en el padre, no se almacena.
Lea los precios almacenados de meta_data (_regular_price_USD, _sale_price_USD, _price_USD). Las respuestas a las llamadas REST no incluyen un campo custom_prices.
Duplicados o traducciones independientes
WPML tiene dos tipos de producto traducido. El tipo que tenga decidirá qué ocurre con el texto que importe.
Duplicado
Traducción independiente
Qué es
Una copia que mantiene WPML
Una traducción con su propio texto
Texto tras el siguiente guardado del original
Reemplazado por el texto del original
Se mantiene solo con Traducir todo desactivado o con Productos configurado en Ninguno
Precio e inventario
Siguen al original
Siguen al original
Dónde lo ve: la caja Idioma de un duplicado dice «This document is a duplicate of ... and it is maintained by WPML.» con el botón Traducir de forma independiente.
Convertir duplicados en traducciones independientes: haga clic en Traducir de forma independiente en la caja Idioma del duplicado, o, para varios productos, vaya a Productos → Todos los productos, cambie al idioma de la traducción, marque los productos y elija Acciones en lote → Traducir de forma independiente.
Qué crean los procesos de la parte 2: el proceso A crea traducciones con Traducir todo. El proceso B importa traducciones independientes. Ninguno de los dos necesita duplicados.
Configure la tienda antes de que llegue el primer producto
Ejecute el asistente de configuración de WooCommerce Multilingual. Se abre al activar WPML Multilingual & Multicurrency for WooCommerce. Sus pantallas son Páginas de la tienda, Atributos globales y Múltiples monedas. La primera crea Tienda, Carrito, Finalizar compra y Mi cuenta en todos los idiomas.
Haga que sus atributos globales sean traducibles. En la pantalla del asistente «¿Qué atributos del producto deberían ser traducibles?», marque cada atributo, por ejemplo Color y Talla. Más adelante, esta misma opción es la casilla ¿Traducible? en Productos → Atributos → Editar.
Traduzca los términos de los atributos antes que los productos. Vaya a WPML → Traducciones, abra la pestaña Taxonomía, elija el atributo en «Seleccionar la taxonomía a traducir» y traduzca cada término. Con Traducir todo activado (proceso A), WPML traduce los términos nuevos por usted.
Parte 2. Constrúyalo sin código
Elija su proceso: un idioma o todos los idiomas
Proceso A: WPML traduce
Proceso B: usted importa todos los idiomas
Qué contiene su sistema
Solo el idioma predeterminado de la tienda
Todos los idiomas
Qué importa
Productos originales
Originales y sus traducciones, enlazados por el SKU
WPML marca la traducción como necesitada de actualización; su siguiente archivo trae el texto nuevo
Precios y existencias
Siguen al original
Siguen al original
El proceso A es adecuado para una tienda que mantiene un idioma y quiere todos los demás idiomas sin archivos de traducción. El proceso B es adecuado para una tienda cuyo PIM o traductores ya tienen los textos en todos los idiomas.
Proceso A con el importador de CSV de WooCommerce o WP All Import
Active Traducir todo una vez:
Vaya aWPML → Traducciones y haga clic en Configurar Traducir todo.
Elija el contenido. En «Contenido a traducir», mantenga Todos los productos y haga clic en Continuar.
Elija cómo se publican las traducciones. En «Método de publicación», mantenga Publicar sin revisar.
Haga clic en Activar Traducir todo automáticamente.
Importe sus productos solo en el idioma predeterminado de la tienda. Use Productos → Importar (el importador de CSV de WooCommerce) o All Import → Nueva importación (WP All Import con su complemento de WooCommerce). Su archivo no necesita columnas de WPML.
La importación misma pone en cola las traducciones. Luego, WPML traduce cada producto, variación, categoría y término de atributo nuevo a cada idioma y los publica. Usted no inicia nada a mano y no es necesario tener abierta ninguna página del panel de administración de WPML. Puede seguir el progreso en WPML → Traducciones.
Cuando edita un original, Traducir todo traduce solo lo que ha cambiado. El resto de la traducción se mantiene palabra por palabra.
Traducir todo traduce los productos publicados, incluidos los productos externos. No traduce los productos privados. Los borradores también esperan: Traducir borradores automáticamente (en WPML → Configuración → Traducción por IA, en la caja Editor de traducción avanzado) está desactivado de forma predeterminada, y cuando lo activa, WPML traduce un borrador solo cuando lo guarda de nuevo. Para traducir borradores y productos privados, envíelos desde WPML → Traducciones (consulte Solución de problemas).
Si quiere cambiar una traducción, ábrala desde la caja Idioma del producto (Editar la traducción de...), edítela en el Editor de traducción avanzado y haga clic en Guardar y completar. Cuando el original cambie más adelante, su edición de las oraciones que no han cambiado se mantendrá.
Proceso B con el importador de CSV de WooCommerce
En el proceso B, su archivo contiene todos los idiomas.
Configure Traducir todo para las traducciones importadas antes de la primera importación:
Vaya aWPML → Traducciones. Si Traducir todo está desactivado, déjelo desactivado y pase al archivo.
Si quiere que WPML traduzca sus páginas, entradas y cadenas automáticamente, haga clic en Configurar Traducir todo. En «Contenido a traducir», establezca Productos en Ninguno. Haga clic en Continuar, mantenga Publicar sin revisar y haga clic en Activar Traducir todo automáticamente.
Si Traducir todo ya está activado, haga clic en el menú de tres puntos en la caja «Traducir todo automáticamente está activado», elija Ajustar límites de contenido, establezca Productos en Ninguno y haga clic en Guardar los cambios. Las traducciones que ya están en progreso terminarán de todos modos.
Con Productos establecido en Ninguno, WPML mantiene las traducciones de sus productos importados palabra por palabra. Cuando un original cambia, WPML marca sus traducciones como necesitadas de actualización, y su siguiente archivo trae el texto nuevo.
Prepare un archivo con todos los idiomas. Use las columnas normales de WooCommerce y añada cuatro columnas de WPML:
Columna
Qué contiene
Ejemplo
Meta: _wpml_import_translation_group
El valor que enlaza los idiomas. Use el SKU.
HP-JK-SHELL
Meta: _wpml_import_language_code
El idioma de la fila
de
Meta: _wpml_import_source_language_code
El idioma del original, que es el idioma predeterminado de la tienda. Vacío en las filas originales.
en
Meta: _wpml_import_after_process_post_status
El estado después de que WPML enlace los productos
publish
Ordene las filas por idioma, los originales primero. En cada idioma, los productos van antes que sus variaciones.
Importe los productos como borradores:Published = -1 en los productos, 1 en las variaciones.
Dé a cada idioma sus propios textos: nombres, descripciones, categorías (Kleidung > Jacken) y valores de los atributos (Blau, Grün).
Mantenga los nombres de los atributos de la tienda (Color, Size) en todos los idiomas. Traduzca las etiquetas de los atributos en WPML → Traducciones → Taxonomía.
Proporcione los productos relacionados y padres por SKU, el mismo SKU en todos los idiomas.
Una fila en alemán de un producto variable de nuestro archivo de ejemplo:
Vaya aProductos → Importar y elija el archivo en «Choose a CSV file from your computer:». Deje sin marcar Actualizar productos existentes. Haga clic en Continuar.
Revise la asignación. Las cuatro columnas Meta: se asignan a Importar como metadatos. Haga clic en Ejecutar el importador.
Vaya aWPML → Exportación e importación. En la pantalla se lee: «Buen trabajo. Vemos 33 entradas importadas que necesitan información de idioma.». Haga clic en Ejecutar importación de WPML.
Espere a que aparezca «Multilingual Import Complete».
Hasta el paso 3, cada producto es un borrador en inglés y cada variación es una variación en inglés, ninguno de ellos vinculado a su original. Después de esto:
Cada producto y cada variación se vinculan en todos sus idiomas.
Todo está publicado.
Las traducciones son traducciones independientes.
Las categorías y los términos de atributos se vinculan en todos los idiomas, y las variaciones de cada idioma usan sus propios términos.
Las ventas dirigidas apuntan al producto en el mismo idioma, y cada idioma tiene su propia copia de las imágenes.
Las categorías y los términos de atributos viajan dentro de las filas del producto, por lo que este importador no necesita una importación de taxonomía separada. Si ya existen términos de atributos traducidos en la tienda, el importador los usa, y Ejecutar importación de WPML los conecta con sus originales.
Para que WPML traduzca los productos elegidos automáticamente mientras Productos está configurado en Ninguno:
Mantenga activado Traducir todo.
Añada la columna Meta: _wpml_import_tea al archivo, con el valor 1 en cada producto que quiera traducir.
Mantenga Meta: _wpml_import_translation_group en el mismo archivo.
Importe el archivo, luego vaya a WPML → Exportación e importación y haga clic en Ejecutar importación de WPML. La lista de progreso muestra «Sending Posts for Automatic Translation» (Enviando entradas para su traducción automática), y WPML traduce y publica esos productos.
Proceso B con WP All Import
Necesita WP All Import Pro y su complemento de WooCommerce. La edición gratuita no importa campos personalizados, y las columnas de WPML son campos personalizados.
El orden de trabajo es: primero los términos de atributos, con sus traducciones conectadas, luego los productos. Las páginas de productos traducidas ofrecen entonces cada valor de atributo en su propio idioma, por ejemplo Bleu marine y no Navy.
Conecte los términos traducidos que ya tiene la tienda. Para cada término de atributo traducido que ya exista en la tienda, vaya a Productos → Atributos, haga clic en Configurar términos para el atributo, cambie la barra de administración al idioma del término y haga clic en el nombre del término. En la caja Idioma, elija su original en Esta es una traducción de y haga clic en Actualizar. Cada término conectado muestra entonces un lápiz debajo de su idioma en WPML → Traducciones → Taxonomía.
Configure el idioma del panel de administración en el idioma predeterminado de la tienda en el selector de idiomas de la barra de administración antes de ejecutar las importaciones.
Importe las categorías. En All Import → New Import → Upload a file, elija Taxonomies → Product categories. En Metadatos de términos, añada tres filas: _wpml_import_language_code, _wpml_import_source_language_code y _wpml_import_translation_group, cada una asignada a la columna del archivo con el mismo nombre. Configure el elemento superior en Other Category Options → Parent Term.
Importe los términos de atributos de la misma manera, por ejemplo Taxonomies → Product Color, con las mismas tres filas de Metadatos de términos.
Conecte los términos. Vaya a WPML → Exportación e importación y haga clic en Ejecutar importación de WPML. Compruebe en WPML → Traducciones → Taxonomía (elija la taxonomía en «Seleccione la taxonomía a traducir») que cada término tenga una fila con un lápiz debajo de la bandera de cada idioma. Pase el cursor sobre un lápiz para ver el nombre traducido. Un «+» significa que ese idioma no tiene traducción. Un término traducido que aparece en su propia fila no está conectado.
Importe los productos. Elija WooCommerce Products. En la sección WooCommerce Add-On, asigne el SKU, los precios, las existencias y los atributos. En Campos personalizados, añada las tres filas _wpml_import_*.
Ejecute la importación de WPML de nuevo y espere a que aparezca Multilingual Import Complete.
Dos ajustes para un archivo de productos que contiene todos los idiomas:
Las filas de variación llevan el tipo variable, el mismo que su elemento superior, en la columna que asigne a Set Product Type With XPath.
Vincule las variaciones con su elemento superior mediante una clave por idioma. En Variations, elija All my variable products have SKUs or some other unique identifier... y asigne SKU element for parent y Parent SKU element for variation a una clave como HP-OW-RAIN-de. Asigne el SKU real, el mismo en todos los idiomas, a General → SKU y al grupo de traducción. La otra forma es realizar una importación por archivo de idioma.
Este orden funciona tanto si inicia las importaciones de WP All Import desde wp-admin, desde WP-CLI o de forma programada.
Actualizar existencias y precios de forma programada
Actualice los productos originales. WPML copia las existencias y los precios a cada idioma de inmediato.
Con el importador de CSV de WooCommerce:
Envíe solo las columnas que cambie. Una columna con una celda vacía escribe un valor vacío. Nuestro archivo de ejemplo:
Añada Meta: _wpml_import_language_code con el idioma del original en cada fila. De esta forma, cada fila actualiza el producto en ese idioma, el original. Sin esta columna, una fila actualiza el producto en el idioma actual del panel de administración, por lo que el resultado depende del selector de idiomas de administración.
Configure el idioma del panel de administración en el idioma predeterminado de la tienda en el selector de idiomas de la barra de administración.
Vaya aProductos → Importar, elija el archivo, marque Actualizar productos existentes, haga clic en Continuar y en Ejecutar el importador.
Justo después de la importación, todos los idiomas muestran las nuevas existencias, los precios y el rango de precios.
Con WP All Import, de forma programada:
All Import → New Import → Download a file → From URL, con la URL del feed de su proveedor. Elija Productos de WooCommerce.
Asigne el SKU, el precio normal y la cantidad de inventario en la sección WooCommerce Add-On.
En Import Settings, marque Attempt to match to existing WooCommerce products before creating new ones y asócielos por el campo personalizado (Custom field) _sku. Desactive Create new WooCommerce products from records newly present in this import file. Active Update existing WooCommerce products with the data in this import file.
En Choose which data to update, desactive todo excepto Custom Fields, y elija Update only these Custom Fields, leave the rest alone: _regular_price, _price, _stock, _manage_stock.
Prográmelo. En All Import → Manage Imports → Scheduling Options, Manual Scheduling muestra una Trigger URL y una Processing URL para el trabajo cron de su servidor.
Cada ejecución asocia las filas con los productos originales, y cada idioma obtiene los nuevos precios y existencias de cada producto y variación.
Si se vuelve a importar un archivo completo del Proceso B como actualización, establezca Published en 1 en cada fila. De lo contrario, los productos activos pasarán a Borrador hasta que haga clic en Ejecutar importación de WPML. Marque Actualizar productos existentes y, a continuación, haga clic en Ejecutar importación de WPML. Los productos se mantienen publicados y los textos del archivo reemplazan las traducciones de inmediato.
Añada un idioma a un catálogo que ya tiene
Proceso A:
Vaya aWPML → Idiomas, haga clic en Administrar y ocultar idiomas del sitio, utilice Buscar y añadir un idioma... y elija el idioma.
Haga clic en Calcular costes. El cuadro de diálogo «Coste de traducir su contenido al...» enumera los elementos y las palabras. Haga clic en Guardar.
Traducir todo inicia el nuevo idioma por sí solo, la próxima vez que se cargue una página del panel de administración de WPML. WPML traduce y publica cada producto y variación en el nuevo idioma. Sus idiomas existentes no se ven afectados.
Proceso B:
Prepare un archivo solo con las filas del nuevo idioma. Utilice el SKU como grupo de traducción, el idioma del original como idioma de origen, Published = -1 y publish como estado final.
Vaya aProductos → Importar. Deje Actualizar productos existentes sin marcar. Ejecute el importador.
Vaya aWPML → Exportación e importación de WPML y haga clic en Ejecutar importación de WPML.
Cada nuevo producto y variación se une al grupo de traducción de su original, asociado por el SKU. Esto funciona en cualquier catálogo, incluso en uno que nunca se haya importado. El nuevo idioma obtiene sus propias categorías y términos de atributos a partir del archivo.
Actualizar productos existentes no añade un idioma: el importador omite esas filas. Enumera cada producto en el nuevo idioma con el mensaje «No matching product exists to update.» (No existe ningún producto coincidente para actualizar) y cada variación en el nuevo idioma con «A new variation cannot be created without a parent product.» (No se puede crear una nueva variación sin un producto principal).
Importe catálogos grandes
Importe un archivo por idioma, primero los originales.
Ejecute la importación de WPML una vez, después del último archivo.
Para ejecuciones largas, utilice WP-CLI:wp wpml import process ejecuta el mismo paso que el botón y muestra el recuento de cada paso.
Cuánto tarda, según nuestro laboratorio, con el importador de WooCommerce y un Ejecutar importación de WPML para un catálogo en tres idiomas:
Productos por idioma
Importación completa
De ese tiempo, Ejecutar importación de WPML
500
alrededor de media hora
unos pocos minutos
1.000
alrededor de una hora
unos 10 minutos
2.000
alrededor de dos horas
alrededor de media hora
Cada tamaño se terminó en una sola sesión, con cada producto y variación presente y conectado en cada idioma. Cada cifra corresponde a una ejecución en un servidor de laboratorio compartido. La mayor parte del tiempo corresponde al importador de WooCommerce y depende de su servidor. Tome estos números como un orden de magnitud.
Exporte productos con sus idiomas (WP All Export)
WP All Export añade las columnas de WPML _wpml_import_language_code, _wpml_import_source_language_code y _wpml_import_translation_group a una exportación de productos de WooCommerce de forma predeterminada. Su sección WPML exporta todos los idiomas o solo uno. Las exportaciones ejecutadas manualmente o de forma programada rellenan las columnas. Lea más en Exportar sitios web multilingües con WP All Export.
Sincronice desde un ERP o PIM
Un ERP (sistema de planificación de recursos empresariales) es el software donde una empresa mantiene el inventario, los precios y los pedidos. Un PIM (sistema de gestión de información de productos) es donde mantiene los textos y datos de los productos.
Un conector entre un sistema de este tipo y WooCommerce normalmente:
Mantiene el catálogo indexado por SKU en un idioma
Encuentra cada producto por su SKU (GET /wc/v3/products?sku=...)
Actualiza el inventario y los precios de los productos existentes, y crea nuevos productos a través de la API REST de WooCommerce
Se ejecuta de forma programada
Este es el flujo que funciona con WPML:
El conector escribe solo en el idioma predeterminado de la tienda.
WPML copia el inventario y los precios a todos los idiomas en la misma petición.
Traducir todo traduce los nuevos productos a todos los idiomas (Proceso A).
Un producto que el conector cambia a borrador pasa a borrador en todos los idiomas.
Un producto que el conector elimina sigue lo establecido en WPML → Configuración → Eliminar contenido, fila Productos. No se le preguntará durante una sincronización, así que configure Eliminar un original con el comportamiento que quiera: Eliminar todos los idiomas elimina las traducciones correspondientes; Solo ese las mantiene publicadas.
Haga tres preguntas al proveedor de su conector:
¿Escribe a través de WooCommerce o directamente en la base de datos? Los cambios escritos directamente en la base de datos solo llegan al original. Las traducciones mantienen el inventario y los precios antiguos.
¿En qué idioma escribe? Debe escribir en el original. Un precio escrito en una traducción no se guarda: la traducción mantiene el precio del original.
¿Crea un producto por idioma? WooCommerce rechaza un segundo producto con el mismo SKU. Sin el SKU, las copias son productos separados que no reciben actualizaciones de inventario ni de precio. Deje que el conector cree solo el original y deje que WPML lo traduzca.
Parte 3. Construir flujos personalizados (desarrolladores)
Crear un producto y sus traducciones con la API REST de WooCommerce
Cree primero los términos, luego el original y después cada traducción con lang y translation_of.
Traduzca la categoría (y cualquier término de atributo): POST /wp-json/wc/v3/products/categories
Cree cada traducción:POST /wp-json/wc/v3/products, con los textos traducidos, la categoría traducida, lang y translation_of (el ID del original). No envíe SKU, precio ni inventario: WPML los copia del original.
Lea el resultado con un GET. La respuesta a la llamada de creación muestra el SKU, el precio y el inventario vacíos, porque WPML los copia después de que se genera la respuesta. GET /wc/v3/products/121 justo después los muestra.
Para un producto variable, cree las variaciones del original solo en el original (POST /wc/v3/products/<id>/variations/batch). Luego, cree cada padre traducido con lang y translation_of. WPML crea las variaciones traducidas por sí mismo, enlaza cada una a su variación original y copia el SKU, el precio, el inventario y los términos de atributos en ese idioma. No envíe variaciones en una traducción.
Lea las variaciones de una traducción con ?lang=:GET /wc/v3/products/137/variations?lang=fr. Cada variación incluye lang, su mapa translations y los nombres de las opciones en ese idioma.
Una traducción de producto por idioma. Una segunda traducción de producto en un idioma que ya tiene una se rechaza con HTTP 400 wcml_translation_exists y no se crea nada. El mensaje indica el ID de la traducción existente. Actualice la traducción existente en su lugar.
Actualizar productos con la API REST de WooCommerce
Actualice el original. WPML copia el cambio a todos los idiomas en la misma petición.
PUT /wc/v3/products/123/variations/124 con {"regular_price": "59.00", "stock_quantity": 3} cambia el precio y el inventario de esa variación en todos los idiomas, y el rango de precios se actualiza en consecuencia.
PUT /wc/v3/products/120 con un nuevo precio normal, precio rebajado o inventario los cambia en todos los idiomas.
Los nuevos términos de atributos se crean en el atributo del original y se traducen con lang y translation_of, como en el paso 1 anterior.
Una nueva variación añadida al original (POST /wc/v3/products/123/variations o .../variations/batch) llega a todos los idiomas en la misma petición, enlazada, con su precio e inventario. La respuesta a la llamada enumera solo el idioma del original; GET /wc/v3/products/130/variations?lang=de justo después enumera la nueva variación traducida.
Un precio o atributos enviados a una traducción no se guardan: la traducción mantiene los valores del original. Un valor de inventario enviado a cualquier idioma se convierte en el inventario de todos los idiomas.
Eliminar a través de la API:DELETE /wc/v3/products/<id> sigue lo establecido en WPML → Configuración → Eliminar contenido, fila Productos. La API nunca pregunta: en Preguntarme solo elimina el original. Configure Eliminar un original con el comportamiento que quiera su tienda. Con Eliminar todos los idiomas, una eliminación mueve todos los idiomas a la papelera, y ?force=true elimina todos los idiomas.
Escribir su propio importador o conector
Use las funciones de producto de WooCommerce. WPML detecta el cambio y lo copia a todos los idiomas.
Después de save(), las traducciones muestran el nuevo precio y las existencias.
Nunca escriba los datos del producto directamente en la base de datos (update_post_meta() o SQL). El original cambia y las traducciones mantienen los valores antiguos.
Ejecute el paso de importación de WPML desde el código después de una importación con las columnas de WPML: wp wpml import process. Ejecuta los mismos pasos que el botón Run WPML Import y muestra cada uno con su recuento.
Trabajos programados
Un trabajo programado (WP-Cron) que cambia el original con las funciones de producto de WooCommerce aplica estos cambios a todos los idiomas en la propia petición del trabajo:
Precio normal, precio rebajado y existencias, con el estado de las existencias que se deriva de ello
Una categoría añadida al producto (como la categoría traducida)
Un nuevo término de atributo en un producto variable (como su traducción)
El rango de precios del producto variable
Parte 4. Solución de problemas
Las traducciones importadas aparecen como productos separados y sin vincular
Lo que ve: faltan las filas traducidas o aparecen como productos en inglés (idioma predeterminado), a menudo como privados y sin enlace al original.
Por qué ocurre:
El archivo no tiene columnas de WPML. Entonces, WooCommerce omite cada fila cuyo SKU ya existe: «Ya existe un producto con este SKU».
El archivo tiene las columnas de WPML, pero no se ejecutó Run WPML Import. Hasta entonces, cada fila es un producto en el idioma predeterminado sin enlace a su original, con el estado que le da la columna Published del archivo (Privado para 0, Borrador para -1). WPML → Exportación e importación de WPML muestra «Buen trabajo. Vemos 12 entradas que están importadas y necesitan información de idioma».
Cómo solucionarlo ahora:
No se ha ejecutado el paso de importación de WPML: vaya a WPML → Exportación e importación de WPML y haga clic en Run WPML Import.
No hay columnas de WPML: añada las cuatro columnas de WPML a las filas de traducción e impórtelas de nuevo como una importación nueva, con la opción Actualizar productos existentes desmarcada. Luego, haga clic en Run WPML Import. Cada traducción se une a su original por el SKU.
Cómo evitarlo: incluya siempre las columnas de WPML y ejecute Run WPML Import después de cada importación.
Las traducciones importadas son reemplazadas por el texto del original
Lo que ve: ha importado nombres y descripciones traducidos y, después del siguiente guardado del original, vuelven a estar en el idioma original.
Por qué ocurre: las traducciones eran duplicados. WPML reescribe un duplicado cada vez que se guarda su original.
Cómo solucionarlo ahora:
Hágalas independientes. Vaya a Productos → Todos los productos, cambie al idioma de la traducción, marque los productos y elija Acciones en lote → Traducir de forma independiente.
Si Traducir todo está activado, establezca Productos en Ninguno. En WPML → Traducciones, haga clic en el menú de tres puntos en el cuadro «Traducir todo automáticamente está activado», elija Ajustar límites de contenido, establezca Productos en Ninguno y haga clic en Guardar los cambios.
Vuelva a importar sus traducciones.
Después de eso, al guardar el original se mantiene el texto importado.
Cómo evitarlo: antes de importar texto a traducciones existentes, establézcalas en Traducir de forma independiente. O bien, importe las traducciones como productos nuevos con las columnas de WPML (Proceso B).
Los productos traducidos muestran los valores de los atributos en el idioma original
Lo que ve: la página del producto traducido ofrece «Blue», «Green» en lugar de los términos traducidos.
Por qué ocurre: los productos se tradujeron antes de que se tradujeran los términos de sus atributos.
Cómo solucionarlo ahora:
Vaya aWPML → Traducciones y abra la pestaña Taxonomía.
En «Seleccionar la taxonomía a traducir», elija el atributo, por ejemplo, el color del producto.
Traduzca cada término en cada idioma y haga clic en Guardar. Traduzca la etiqueta del atributo en la misma pantalla.
Los productos traducidos existentes adoptan cada término a medida que lo guarda. No es necesario volver a guardar ningún producto. Si un término se creó primero como una copia con el nombre del original, su slug mantiene el texto original; cámbielo en el mismo cuadro de diálogo.
Cómo evitarlo: traduzca los términos de los atributos antes de traducir o importar los productos.
Las categorías o términos traducidos mantienen los nombres del original después de una importación
Qué ve: un producto traducido se encuentra en una categoría llamada «Sunglasses» (gafas de sol) u ofrece «Blue» (azul) en la tienda traducida.
Por qué ocurre: las filas de traducción se copiaron de la exportación del original y mantuvieron los nombres de sus categorías, etiquetas y términos de atributos. WPML crea los términos traducidos con esos nombres y los enlaza correctamente, pero no los renombra. Las ventas adicionales, las ventas cruzadas, las imágenes, las galerías y los padres de las variaciones indicados por los ID del original se reasignan al idioma correcto.
Cómo solucionarlo ahora: cambie el nombre de los términos en WPML → Traducciones → Taxonomía, como en la sección anterior. Las migas de pan, los enlaces a los términos, los encabezados de los archivos y las opciones de los atributos muestran los nuevos nombres de inmediato, y no es necesario volver a guardar ningún producto. Los slugs mantienen el texto del original a menos que los cambie en el mismo cuadro de diálogo.
Cómo evitarlo: en las filas de traducción, escriba los nombres traducidos de las categorías, etiquetas y términos de atributos, en el mismo orden que el original. Indique los productos relacionados y los padres mediante el SKU.
El stock o los precios en otros idiomas están por detrás del original
Qué ve: el original muestra el nuevo stock o precio, y las traducciones muestran el antiguo.
Por qué ocurre: el cambio omitió a WooCommerce o WPML:
Un conector escribió directamente en la base de datos.
Se ejecutó una importación mientras WPML estaba desactivado.
Cómo saberlo: abra el original en el editor de productos. Debajo del editor de la descripción dice «Última modificación el» con una fecha y hora. Si esa hora es anterior al nuevo precio o stock en la caja de datos del producto, o si el cambio se hizo mientras WPML estaba inactivo, la actualización omitió la sincronización.
Cómo solucionarlo ahora:
Para productos variables:
Vaya aWPML → Soporte → Corregir traducciones de WCML. Corregir traducciones de WCML forma parte de WPML Troubleshooting, un plugin independiente.
Marque «Sincronizar las variaciones de los productos» y haga clic en Ejecutar las herramientas seleccionadas.
A continuación, todos los idiomas muestran los precios y el stock de las variaciones del original, así como el rango de precios del producto.
Para los productos simples, utilice una de estas vías. Cada una de ellas traslada el precio y el stock del original a todos los idiomas:
Un producto a la vez: abra cada original modificado y haga clic en Actualizar.
Muchos productos mediante importación: con el idioma del panel de administración establecido en el idioma predeterminado, vuelva a importar los productos con Productos → Importar y marque Actualizar productos existentes. El archivo puede contener los valores que ya tienen los originales. Esto también realinea los productos variables.
Muchos productos mediante REST: envíe PUT /wc/v3/products/<id> con el precio de cada producto, por ejemplo, {"regular_price": "19.50"}.
Muchos productos con un solo precio: en Productos → Todos los productos, marque los productos, elija Acciones en lote → Editar en lote y haga clic en Aplicar. En Precio elija Cambiar a:, introduzca el precio y haga clic en Actualizar. Todos los productos marcados obtienen ese mismo precio.
Ejecutar wp wc product update con el valor que ya tiene el original no lo traslada a las traducciones.
Cómo evitarlo: permita que el conector escriba a través de WooCommerce (la API REST o las funciones del producto) y mantenga WPML activo durante las importaciones.
Los productos creados a través de la API REST acaban en el idioma o grupo equivocado
Qué ve: una traducción aparece en el idioma equivocado, o como un producto independiente sin SKU y sin enlace al original.
Por qué ocurre:
Un código de idioma desconocido se rechaza con HTTP 422 Invalid language parameter: "ge", y no se crea nada.
Un código válido pero incorrecto, como un texto en alemán enviado con "lang": "fr", crea una traducción en ese idioma.
La falta de translation_of crea un producto en su propio grupo, sin SKU y sin precio ni stock copiados.
Cómo solucionarlo ahora: envíe el producto de nuevo con el idioma correcto y el enlace, con PUT /wc/v3/products/<id>:
JSON
{
"lang": "de",
"translation_of": 38
}
El producto se mueve al grupo del original y obtiene su SKU, precio y stock. Para un producto variable, WPML reemplaza las variaciones creadas sin enlace por otras nuevas enlazadas. Vuelva a leer los nuevos ID de las variaciones.
Cómo evitarlo: envíe lang y translation_of en cada traducción, cree primero los términos y deje que WPML cree las variaciones de las traducciones.
Los nuevos productos importados no se traducen automáticamente
Qué ve: los productos importados se mantienen solo en el idioma original.
Por qué ocurre: Traducir todo estaba desactivado durante la importación, o los productos son privados, los cuales Traducir todo nunca traduce, o son borradores, los cuales solo traduce cuando la opción Traducir borradores automáticamente está activada y el borrador se guarda de nuevo.
Cómo solucionarlo ahora:
Envíe los productos: vaya a WPML → Traducciones, abra la sección Productos, marque los productos, elija Traducir automáticamente para cada idioma, elija Publicar sin revisar en «¿Qué le gustaría hacer cuando WPML termine de traducir su contenido automáticamente?» y haga clic en Traducir contenido. Esto también funciona para los borradores y los productos privados; sus traducciones obtienen el estado del original.
O active Traducir todo. Traduce todos los productos publicados que aún no se han traducido. WPML los envía mientras se cargan las páginas del panel de administración de WPML.
Vaya aWPML → Traducciones → Configurar Traducir todo → Continuar → Activar Traducir todo automáticamente.
Permanezca enWPML → Traducciones hasta que diga «Se ha terminado de traducir su contenido».
Cómo evitarlo: active Traducir todo antes de la importación (Proceso A) e importe los productos como publicados.
Escrito porAmir·
Busque en la documentación, el blog, los hooks y más.