barcodeUsar IDs de producto alternativos en pedidos

Aprende cómo el mapeo de IDs alternativos ayuda a Channable a asociar los artículos del pedido del marketplace con los productos correctos de tu tienda online.

Usa el mapeo de ID alternativo cuando los artículos del pedido no coincidan con los productos. Esto suele pasar cuando los marketplaces usan un identificador distinto al de tu tienda online.

¿Qué es una conexión de pedidos?

Una conexión de pedidos sincroniza los pedidos del marketplace con tu plataforma de e-commerce. Para crear una línea de pedido, Channable tiene que asociar cada artículo del pedido con un producto.

Términos clave (para que el resto de esta página tenga sentido)

  • ID único (identificador de producto de la tienda online): El identificador que usa tu plataforma de e-commerce para referirse a un producto (a menudo un SKU, pero no siempre).

  • ID alternativo: Otro identificador guardado en el mismo producto, como EAN/GTIN o MPN.

  • Identificador del artículo en el marketplace: El identificador que llega en los datos del pedido. Suele ser SKU del vendedor.

Por qué importan los ID únicos

Los ID únicos vinculan el artículo del pedido con el producto correcto de la tienda online. Si el identificador del pedido no existe en tu tienda online, la creación del pedido falla.

Configura un ID único en Channable

  • Cuando configuras una API para un marketplace en Channable, tienes que seleccionar el campo que corresponde al ID único durante el paso de Configuración de la API. Después, ese identificador se envía al marketplace y se usa para hacer coincidir los productos.

  • En concreto, cuando se realiza un pedido en el marketplace, Channable usa este ID único para asociar el producto del pedido con el producto correspondiente en tu plataforma de e-commerce.

Problemas con ID únicos incorrectos o faltantes

  • Los problemas aparecen si tus productos no se publicaron originalmente en el marketplace a través de Channable, o si el ID único es distinto del que usa tu plataforma de e-commerce. En esos casos, Channable no podrá asociar los productos de los pedidos.

  • Este desajuste provocará un error indicando que no se pudo encontrar el producto, lo que impide crear el pedido.

Ahí es donde el mapeo de ID alternativo ayuda.

Cómo funciona el mapeo de ID alternativo

Cuando importas tus productos en Channable, hacemos seguimiento tanto de los identificadores principales de tu fuente de importación principal (tu plataforma de e-commerce) como de identificadores alternativos de uso común, como los códigos EAN y los códigos SKU.

Al procesar un pedido, Channable puede:

  1. Leer el identificador recibido en los datos del pedido del marketplace.

  2. Intentar hacer coincidir ese valor con los ID alternativos registrados (como EAN/GTIN).

  3. Si encuentra una única coincidencia, crear la línea de pedido de la tienda online para ese producto coincidente.

Esto te permite procesar pedidos incluso cuando los identificadores del marketplace difieren del identificador principal de tu tienda online.

Actualmente, Channable ofrece compatibilidad con las siguientes plataformas de e-commerce y sus campos de identificador estándar correspondientes:

Plataforma
Campos de identificador

BigCommerce

sku, GTIN

CCVShop

sku_number, ean, ean_number, mpn

Lightspeed Eseries

sku

Lightspeed

sku, article_code, ean

Magento

sku, ean

MijnWebWinkel

sku, uuid

Prestashop

ean13, GTIN, reference

Shopify

sku, GTIN

Shoptrader

sku, ean

Shopware

ean, article_number

Squarespace

sku

WooCommerce

sku

Si quieres usar campos de identificador que no están admitidos actualmente, no dudes en ponerte en contacto con nuestro equipo de soporte. Revisaremos tu solicitud y la valoraremos para futuras actualizaciones si es posible.

circle-info

Nota: Si añades una segunda importación (como un CSV) y sobrescribes el valor de un identificador, los pedidos pueden fallar. El mapeo de ID alternativo se basa en los identificadores registrados de tu fuente de importación principal al hacer coincidir los artículos del pedido.

Cuándo usar el mapeo de ID alternativo

El mapeo de ID alternativo es especialmente útil en varios escenarios para garantizar un procesamiento correcto de los pedidos. Situaciones habituales en las que esta función resulta útil:

  • Se usan varios identificadores

    • Escenario: tus listados de productos en marketplaces usan una combinación de códigos EAN y códigos SKU como identificador principal.

    • Ventaja: el mapeo de ID alternativo ayuda a asegurar que los pedidos se asocien correctamente con los productos correspondientes en tu plataforma de e-commerce, independientemente del identificador que use el marketplace.

  • Sistemas antiguos con estructuras de ID diferentes

    • Escenario: tu plataforma de e-commerce o sistema de gestión de pedidos usa una estructura de ID distinta de la que requiere el marketplace.

    • Ventaja: con el mapeo de ID alternativo, Channable puede conectar ambos sistemas de ID y garantizar que los pedidos se vinculen a los productos correctos sin intervención manual.

  • Transición entre sistemas

    • Escenario: estás migrando a una nueva plataforma de e-commerce o actualizando tu sistema de ID, y durante este periodo tus productos pueden tener identificadores antiguos y nuevos.

    • Ventaja: el mapeo de ID alternativo te permite seguir operando sin interrupciones al reconocer ambos conjuntos de identificadores y evitar problemas en el procesamiento de pedidos.

Antes de activar la función, revisa el mapeo de ID registrado de tu proyecto. Mira la siguiente sección para saber cómo acceder a estos registros.

Acceder a los registros de mapeo de ID

Hay dos formas de ver los registros de mapeo de ID.

1

Ver el mapeo de ID de todos los ítems

Esta página te permite comprobar los mapeos de ID que Channable está registrando antes de activar la función. Al revisar estos registros, puedes asegurarte de que todo está asignado correctamente. Este paso es clave para evitar posibles problemas que podrían surgir si activas la función sin verificarlo bien.

Para ver una vista completa de los registros de mapeo de ID pasados y actuales de todos los ítems (no solo de los pedidos):

  • Ve a Configuración > Pedidos en tu proyecto.

  • Haz clic en el botón Mapeo de ID alternativo. Aparecerá una ventana emergente con todos los registros pasados y actuales de ID asociados a tus productos.

Alternative ID mapping overview for all items
Resumen del mapeo de ID alternativo (todos los ítems).
  • Usa el cuadro de búsqueda en la esquina superior derecha de la ventana emergente para filtrar los registros por ID, título u otros criterios y navegar más fácil.

Search within Alternative ID mapping records
Filtra los registros de mapeo por ID, título u otros campos.
2

Ver el mapeo de ID de los ítems usados en pedidos

Para ver los registros pasados y actuales de los ítems usados en pedidos:

  • Ve a la página de Pedidos de tu proyecto y haz clic en Mapeo de ID alternativo.

  • Consulta los registros de mapeo de ID pasados y actuales de todos los ítems usados en pedidos.

Alternative ID mapping records used in orders
Registros de mapeo de ID alternativo usados en pedidos.

Explicación de las columnas de la interfaz de mapeo de ID

  • ID único: el identificador que usa tu plataforma de e-commerce para referenciar el producto.

  • ID alternativo: el tipo de identificador que Channable está siguiendo, como SKU o EAN/GTIN.

  • Valor: el valor real del ID alternativo (por ejemplo, el SKU o código EAN concreto).

  • Creado: la fecha y hora en que se creó el registro de mapeo.

  • Estado: indica si el mapeo está activo o inactivo.

Antes de activar el mapeo de ID alternativo

Primero revisa estos puntos. Te ahorrará tiempo después.

  • Confirma qué identificador devuelve el marketplace en los datos del pedido (normalmente el SKU del vendedor).

  • Confirma que ese valor de identificador existe en algún punto del producto coincidente de la tienda online.

    • Ejemplo: el marketplace envía EAN, pero tu producto de la tienda online tiene el EAN vacío.

  • Comprueba si hay duplicados en los ID alternativos.

    • Ejemplo: dos productos comparten el mismo EAN/GTIN.

  • Comprueba si una segunda importación sobrescribe los identificadores usados para la coincidencia.

Lista de comprobación detallada de configuración (recomendada)

Usa esta lista antes de activar el ajuste. Evita la mayoría de los problemas de “producto no encontrado”.

1

1) Elige tu estrategia de coincidencia

Elige un identificador con el que quieras asociar los pedidos.

Opciones habituales:

  • SKU: Mejor si cada artículo vendible tiene un SKU estable.

  • EAN/GTIN: Mejor si cada artículo vendible tiene un código de barras válido.

Evita mezclar identificadores entre listados, salvo que sea necesario.

2

2) Verifica que el ID elegido exista en el artículo vendible (a menudo, en las variantes)

Comprueba tu catálogo de productos con el ID elegido:

  • Debe existir a nivel de variante si vendes variantes.

  • Debe estar rellenado para los productos que vendes en el marketplace.

Haz una comprobación rápida de al menos 10 ítems:

  • 3 productos simples

  • 3 productos con variantes (varios tamaños/colores)

  • 2 productos más vendidos

  • 2 productos “problemáticos” que fallaron antes

3

3) Comprueba la coherencia del formato

La coincidencia es exacta. Las pequeñas diferencias la rompen.

Comprueba:

  • Espacios al inicio o al final

  • Distinto uso de mayúsculas y minúsculas (sobre todo relevante para los SKU)

  • Que desaparezcan ceros a la izquierda (algo común con exportaciones CSV)

  • Separadores distintos (SKU-001 frente a SKU001)

Primero corrige el formato en tu sistema de origen.

4

4) Elimina los duplicados del ID alternativo elegido

Los duplicados provocan la situación de “se encontraron varias coincidencias”. Entonces, Channable no puede elegir un producto con fiabilidad.

Haz una comprobación de duplicados en tu catálogo para el ID elegido:

  • Si dos productos comparten el mismo EAN/GTIN, corrige o elimina uno de los valores.

  • Si existen SKU de marcador de posición (NA, 0, DEFAULT), sustitúyelos.

Si no puedes eliminar los duplicados, cambia a otra estrategia de coincidencia.

5

5) Confirma que tu importación principal es la fuente de referencia

El mapeo de ID alternativo se basa en los identificadores registrados de tu fuente de importación principal.

Antes de activarlo:

  • Asegúrate de que tu importación principal contiene los valores correctos de SKU/EAN.

  • Evita sobrescribir esos identificadores mediante una segunda importación (como un enriquecimiento por CSV).

Si tienes que importar identificadores mediante CSV, mantenlo coherente y cuenta con un periodo de transición.

6

6) Revisa los registros de mapeo de ID alternativo

Abre el resumen de mapeo y comprueba lo que registró Channable. Mira Acceder a los registros de mapeo de ID.

Qué debes buscar:

  • ID alternativos faltantes en los productos que vendes

  • Valores duplicados en distintos productos

  • Valores antiguos o desactualizados después de una migración

7

7) Activa y valida con una muestra pequeña

Activa Usar IDs alternativos para los artículos del pedido en la conexión de pedidos.

Después, valida al menos uno:

  • Un pedido que antes fallaba (ideal), o

  • Un pedido nuevo entrante

Comprueba ambos:

  • El pedido se crea correctamente.

  • La la variante correcta se asocia.

8

8) Despliega y supervisa

Una vez que la coincidencia sea correcta:

  • Actívalo en otras conexiones de pedidos (si las tienes).

  • Vigila los errores de “producto no encontrado” y “se encontraron varias coincidencias”.

Si aumentan los errores, corrige primero los datos del catálogo. Evita soluciones provisionales que introduzcan más incoherencias en los identificadores.

Activar el mapeo de ID alternativo

1

Selecciona la casilla de verificación Usar IDs alternativos para los artículos del pedido en la conexión de pedidos que quieras activar.

Enable Use alternative IDs for order items
Activa los ID alternativos para los artículos del pedido.
2

Haz clic en Guardar. Luego puedes abrir el mapeo de ID alternativo (Configuración > Pedidos) para comprobar los mapeos registrados.

Qué no hace este ajuste

El mapeo de ID alternativo ayuda a asociar los artículos del pedido con productos existentes de la tienda online. No:

  • Cambia el identificador que envías a un marketplace al publicar productos.

  • Corrige valores duplicados de EAN/SKU en el catálogo de tu tienda online.

  • Garantiza la creación del pedido cuando el marketplace envía identificadores de producto desconocidos.

Escenarios de coincidencia de identificadores alternativos

Los identificadores alternativos como los códigos EAN y SKU no siempre son únicos. En tu catálogo de productos, puede que tengas varios productos con el mismo EAN o productos sin EAN. Channable asocia el ID correcto de la base de datos de la plataforma de e-commerce basándose en el identificador alternativo recibido del marketplace.

Comprobamos si algún ID de base de datos de la plataforma de e-commerce corresponde al ID del producto en los datos del pedido en todos los identificadores alternativos que se están supervisando. Pueden darse tres escenarios:

1

No se encontraron coincidencias

Channable no puede asociar el identificador del marketplace con un producto de la tienda online. Channable intentará crear el pedido usando el identificador del marketplace. Esto puede fallar si tu tienda online no reconoce ese identificador.

Solución: añade el ID alternativo que falta al producto de la tienda online o cambia lo que envía el marketplace.

2

Se encontró exactamente una coincidencia

Channable encuentra un producto de la tienda online que coincide con el identificador del marketplace. Channable crea la línea de pedido para ese producto coincidente de la tienda online.

3

Se encontraron varias coincidencias

  • Valores idénticos entre identificadores: Channable puede estar siguiendo varios valores de identificador alternativo para tu plataforma de e-commerce (por ejemplo, tanto SKU como EAN), y ambos tienen valores idénticos para un producto. En este caso hay un único ID de base de datos de la plataforma de e-commerce, y el pedido se creará usando ese único ID. Channable verifica que el ID de base de datos de la plataforma de e-commerce vinculado al registro coincidente de SKU y EAN sea el mismo.

  • Varios productos con el mismo identificador: varios productos distintos de tu plataforma de e-commerce comparten el mismo valor para un ID alternativo. Channable no puede elegir el correcto. Channable recurrirá al identificador del marketplace al crear el pedido. Esto puede provocar un error al crear el pedido en tu tienda online.

Solución: elimina los duplicados de los valores de identificador en tu tienda online o cambia qué identificador usa el marketplace.

Comprobaciones rápidas de solución de problemas

circle-exclamation
  • El valor del ID alternativo está vacío en el producto de la tienda online.

  • El marketplace envía un identificador distinto al que esperas.

    • Ejemplo: esperabas EAN, pero envía el SKU del vendedor.

  • El valor del ID alternativo existe, pero está duplicado en varios productos.

  • Una importación secundaria sobrescribió los valores de los identificadores después de que se registraran.

Última actualización

¿Te fue útil?