Mapeo de productos: SKU del canal ↔ productos internos

Vincule cada SKU del canal con un producto interno para que los pedidos recibidos creen pedidos OMS automáticamente. Incluye referencia de Client, Channel Product ID y Channel Inventory Item ID.

El mapeo de productos es un dato maestro compartido: vincula un SKU externo del canal (como lo llama el marketplace) con un producto interno (lo que el almacén envía). OMS, WMS y TMS leen la misma tabla; un vínculo sirve para todos los flujos.

Cuándo se necesita#

• Un pedido recibido tiene un SKU sin vínculo: no puede crear un pedido OMS y queda en la pestaña pendiente.
• Un canal nuevo entra en vivo: vincule los SKU de su catálogo antes de la primera extracción.
• Un producto se reemplaza o cambia de marca: actualice el vínculo en lugar de tocar cada flujo.

Referencia de campos#

• External SKU (obligatorio): el SKU como lo reporta el canal, p. ej. "AMZ-B08XYZ". La coincidencia no distingue mayúsculas.
• External Title: nombre del producto en el canal, solo para referencia; no afecta la coincidencia.
• Channel: código del canal al que pertenece el vínculo (p. ej. shopify). "Global" aplica a todos los canales.
• Client: qué cliente posee este vínculo. Vacío = compartido por todos los clientes; úselo para su propio catálogo. Elija un cliente específico cuando el mismo SKU signifique productos distintos por cliente (3PL).
• Channel Product ID: identificador de producto del canal que no es el SKU, p. ej. el product_id de Shopify o el listing ID interno de Amazon. Se usa cuando la API del canal habla en IDs de producto, no en SKUs (sync de productos, push de inventario).
• Channel Inventory Item ID: identificador del artículo de inventario del canal, que el canal guarda tras un push de inventario exitoso (p. ej. inventory_item_id de Shopify). Acelera pushes posteriores. Déjelo vacío y se completará solo tras el primer push exitoso.
• Product ID: el producto interno al que se mapea este SKU del canal.
• Active: interruptor. Apáguelo para retirar un vínculo sin borrarlo (el historial sigue legible).

Prioridad de coincidencia#

1. Primero gana el vínculo atado a la conexión específica.
2. Luego el vínculo genérico por código de canal (aplica a todas las conexiones de ese canal).
3. El alcance por cliente se aplica encima: un vínculo específico de cliente gana al genérico para los pedidos de ese cliente.

Configurar un vínculo#

1. Abra Master Data → Product Mappings.
2. Clic en Nuevo. Elija el canal (y la conexión si el vínculo es específico), escriba el External SKU exactamente como lo reporta el canal.
3. Elija el producto interno. Complete Client solo cuando el SKU signifique productos distintos por cliente.
4. Opcionalmente complete Channel Product ID (del admin / API del canal) para que el sync y el push de inventario localicen el artículo directamente.
5. Guarde y reciba un pedido de prueba: el SKU debe resolverse sin paso pendiente.

Preguntas frecuentes#

• SKU sin mapear: abra la pestaña pendiente y vincule cada SKU; suele ser un error tipográfico en el External SKU.
• Un SKU significa productos distintos por cliente: cree un vínculo por cliente (complete Client), no uno compartido.
• El push de inventario es lento para un SKU: revise si Channel Inventory Item ID está completo; vacío fuerza una búsqueda extra cada vez.