Producto de WooCommerce sin GTIN, UPC, EAN o ISBN

El síntoma

Tu plugin de feed informa de menos productos de los que tiene el catálogo. O Merchant Center limita o rechaza artículos que en la tienda se ven perfectamente. En WooCommerce no hay nada roto: el producto se guarda, se muestra y se vende. El campo del identificador simplemente está vacío, y ninguna pantalla de la administración te avisa.

Dónde está el campo del GTIN. WooCommerce tiene un campo propio para él desde la versión 9.2, sin necesidad de plugins. Abre el producto y ve a Datos del producto → Inventario: el campo que hay debajo del SKU es GTIN, UPC, EAN o ISBN. En un producto variable, cada variación tiene el mismo campo, en la pestaña Variaciones, debajo del SKU de la variación. Un solo campo admite cualquiera de los cuatro tipos de número. La base de datos lo guarda como _global_unique_id, la API REST lo llama global_unique_id, y en el CSV de productos está en la columna «GTIN, UPC, EAN o ISBN». Si no encuentras el campo, tu WooCommerce es anterior a la 9.2.

Lo que cuesta

El GTIN es la forma en que cualquier sistema fuera de tu tienda sabe que tu producto y el de otro vendedor son la misma cosa. Sin él:

• El producto pierde visibilidad o desaparece. Según Google, un producto sin GTIN o con un GTIN incorrecto puede tener una visibilidad limitada, y uno que tiene GTIN pero no lo envía puede rechazarse. La mayoría de los comparadores también se apoyan en el identificador. Nada de esto se ve en tu tienda.
• Pierdes la comparación. Una oferta que coincide con un producto conocido se une a una ficha con opiniones, valoraciones y precios de la competencia. Una que no coincide se queda sola, sin nada de eso.
• Los marketplaces lo piden antes de que puedas publicar. Amazon exige un GTIN para crear un anuncio nuevo en la mayoría de las categorías (una marca sin códigos de barras tiene que solicitar una exención), y eBay lo pide en la mayoría de los artículos nuevos de marca. Un anuncio sin él o falla o acaba sin vincularse al producto que venden los demás, donde nadie lo encuentra.

En un producto variable, el identificador va en cada variación, porque cada variación es un artículo distinto que se compra por separado. Un producto superior con identificador y seis variaciones sin él se exporta como seis productos sin identificador.

Si lo que te ha traído aquí es un feed de compras, este es uno de varios requisitos por los que se retiran productos sin avisar. Por qué se rechazan productos en Google Merchant Center repasa los demás del mismo modo, con la consulta para cada uno.

Si te ha traído aquí el aviso de Search Console sobre el identificador global que falta («No global identifier provided» en la versión en inglés): lo que WooCommerce envía a Google y por qué un código rellenado puede seguir faltando.

Cómo comprobarlo tú mismo

En la administración, sin ningún plugin. Desde WooCommerce 10.4, la lista de productos tiene una columna «GTIN, UPC, EAN o ISBN», oculta por defecto. En Productos, abre Opciones de pantalla (desde WooCommerce 11.0 es el icono del engranaje arriba a la derecha), marca esa columna y haz clic en su encabezado: los productos sin número aparecen arriba, con un guion en la columna. La lista muestra productos, no variaciones: un guion junto a un producto variable no dice nada de sus variaciones, cuyos números solo ves dentro del producto, en la pestaña Variaciones, una por una.

Desde WP-CLI. WooCommerce guarda el campo como _global_unique_id. Sin ningún plugin:

wp db query "SELECT p.ID, p.post_title \
  FROM wp_posts p \
  LEFT JOIN wp_postmeta g ON g.post_id = p.ID AND g.meta_key = '_global_unique_id' \
  WHERE p.post_type IN ('product','product_variation') AND p.post_status = 'publish' \
  AND (g.meta_value IS NULL OR TRIM(g.meta_value) = '') LIMIT 50"

Cambia wp_ por el prefijo de tus tablas. Para ver qué parte del catálogo usa identificadores, cuenta los que están rellenados:

wp db query "SELECT COUNT(*) AS rellenados FROM wp_postmeta \
  WHERE meta_key = '_global_unique_id' AND TRIM(meta_value) <> ''"

Si devuelve cero, tu tienda no usa identificadores: mira los falsos positivos más abajo.

Desde una exportación, sin instalar nada. Exporta tus productos a CSV (en WooCommerce: Productos → Exportar) y abre el archivo en el validador de códigos EAN. Lista las filas sin código, con el nombre del producto y el SKU, y de paso marca los códigos con un dígito de control incorrecto. En una exportación de WooCommerce omite los productos variables, porque los códigos están en sus variaciones. El archivo no sale de tu navegador.

Cómo corregirlo

1. Abre el producto, ve a Datos del producto → Inventario y rellena el campo GTIN, UPC, EAN o ISBN. El número lo asigna el fabricante y está impreso debajo del código de barras del envase.
2. En un producto variable, rellénalo en cada variación, no en el producto superior. Las distintas tallas y colores son artículos comerciales distintos y llevan números distintos.
3. En un catálogo grande, rellena los números en un CSV e impórtalo: el importador de WooCommerce acepta la columna «GTIN, UPC, EAN o ISBN». El importador limpia el valor y rechaza un número que ya tiene otro producto, pero no comprueba el dígito de control ni la longitud.
4. Si los números ya están en el campo de otro plugin, cópialos en lugar de volver a escribirlos. EAN for WooCommerce lo hace por sí mismo (comprobado en la versión 5.6.0): WooCommerce → Settings → EAN → Tools → Copy to product meta, con la clave meta _global_unique_id, y sus Automatic actions para productos nuevos y actualizados mantienen el campo rellenado a partir de entonces. Las dos opciones vienen desactivadas. La copia escribe el campo directamente y se salta las comprobaciones de WooCommerce, así que un número repetido entra sin objeciones: vuelve a ejecutar la auditoría después, y la comprobación de identificadores duplicados muestra los que se copiaron dos veces. Y si los números se han quedado en el campo de un plugin de GTIN que se ha cerrado en el directorio de WordPress.org, consulta cómo pasarlos al campo de WooCommerce.
5. No te inventes números. Un GTIN inventado es peor que uno vacío: choca con un producto real en algún sitio y hace que la oferta se rechace en lugar de ignorarse.

De dónde sale el número. El producto de otra marca ya tiene un número de su fabricante o del titular de la marca: cópialo del envase, y no compres uno ni asignes uno propio. Si tu propia marca necesita números (porque te los pide un marketplace o un distribuidor), los obtienes de GS1, a través de la organización GS1 de tu país; el precio depende del país. No compres números fuera de GS1: GS1 US advierte que pueden estar vinculados a otra empresa, y Amazon comprueba los UPC de los productos con la base de datos de GS1 (GS1 US sobre los códigos de barras para Amazon, en inglés).

Cuándo es un falso positivo

• Fabricas lo que vendes. Los productos artesanales, los de fabricación propia, los artículos por encargo y los servicios no tienen código de barras del fabricante ni lo necesitan.
• Tu tienda no usa identificadores en absoluto. Si ningún producto del catálogo tiene el campo rellenado, esta comprobación no se ejecuta: una lista con todos los productos no te diría nada. En lugar de mil hallazgos verás una nota que lo explica.
• Tu WooCommerce es anterior a la 9.2. El campo no existía antes de esa versión, así que todavía no hay nada que rellenar. La comprobación lo dice expresamente en lugar de informar de todo tu catálogo.
• El identificador está en el campo de un plugin. Esta comprobación lee el campo propio de WooCommerce. Desde Merchlint 0.3.3, la auditoría dice cuántos productos tienen su número solo en un campo de EAN for WooCommerce, Germanized for WooCommerce, Trusted Shops Easy Integration, Google for WooCommerce, Customer Reviews for WooCommerce o Product Feed Manager for WooCommerce, y nombra el campo; las versiones posteriores añadieron los campos de los dos plugins de GTIN cerrados. Mientras el número no esté también en el campo de WooCommerce, los hallazgos sobre esos productos describen ese campo, no tus datos. Germanized pasa sus números a través del campo propio de WooCommerce cuando ese campo está vacío, así que con Germanized esta comprobación sí los ve.
• Tarjetas regalo: desde la versión 0.3.5, Merchlint omite las tarjetas regalo creadas con plugins de tarjetas regalo. Un vale no tiene código de barras del fabricante.

Cómo lo encuentra Merchlint

Merchlint lee _global_unique_id de cada producto publicado y, en los productos variables, de cada variación. Un producto variable genera un hallazgo con la prueba «N variaciones sin GTIN», no un hallazgo por variación, de modo que un catálogo de doscientos productos variables no se convierte en mil filas.

La comprobación no se ejecuta en absoluto cuando el campo está vacío en todo el catálogo; en su lugar dice qué comprobación se saltó y por qué. Esa decisión se toma sobre el catálogo completo, nunca sobre un lote, así que dos exploraciones de una tienda sin cambios siempre coinciden.

Merchlint no valida el dígito de control, no mira la marca ni el MPN y nunca opina sobre lo que exige ninguna normativa. Informa de un hecho: el campo está vacío. Desde la versión 0.3.5, un campo que solo contiene caracteres invisibles (por ejemplo, un espacio de no separación pegado desde una hoja de cálculo) también cuenta como vacío.

Fiabilidad: F, dato de la base de datos. Sin interpretación, sin umbral.

Esta comprobación está en la versión gratuita, en todos los productos, sin tope.