Mapeamento de produtos: SKU do canal ↔ produtos internos

Vincule cada SKU do canal a um produto interno para que os pedidos recebidos criem pedidos OMS automaticamente. Inclui referência de Client, Channel Product ID e Channel Inventory Item ID.

O mapeamento de produtos é um dado mestre compartilhado: vincula um SKU externo do canal (como o marketplace chama o item) a um produto interno (o que o armazém envia). OMS, WMS e TMS leem a mesma tabela; um vínculo serve a todos os fluxos.

Quando é necessário#

• Um pedido recebido tem um SKU sem vínculo: não consegue criar um pedido OMS e fica na aba pendente.
• Um canal novo entra no ar: vincule os SKUs do catálogo antes da primeira extração.
• Um produto é substituído ou renomeado: atualize o vínculo em vez de mexer em cada fluxo.

Referência de campos#

• External SKU (obrigatório): o SKU como o canal o reporta, ex. "AMZ-B08XYZ". A correspondência não diferencia maiúsculas.
• External Title: nome do produto no canal, apenas para referência; não afeta a correspondência.
• Channel: código do canal ao qual o vínculo pertence (ex. shopify). "Global" aplica-se a todos os canais.
• Client: qual cliente possui este vínculo. Vazio = compartilhado por todos os clientes; use para seu próprio catálogo. Escolha um cliente específico quando o mesmo SKU significar produtos diferentes por cliente (3PL).
• Channel Product ID: identificador de produto do canal que não é o SKU, ex. o product_id do Shopify ou o listing ID interno da Amazon. Usado quando a API do canal fala em IDs de produto, não em SKUs (sync de produtos, push de estoque).
• Channel Inventory Item ID: identificador do item de inventário do canal, que o canal guarda após um push de estoque bem-sucedido (ex. inventory_item_id do Shopify). Acelera pushes seguintes. Deixe vazio e será preenchido automaticamente após o primeiro push bem-sucedido.
• Product ID: o produto interno ao qual este SKU do canal é mapeado.
• Active: interruptor. Desligue para aposentar um vínculo sem excluí-lo (o histórico continua legível).

Prioridade de correspondência#

1. Primeiro vence o vínculo atado à conexão específica.
2. Depois o vínculo genérico por código de canal (aplica-se a todas as conexões desse canal).
3. O escopo por cliente aplica-se por cima: um vínculo específico de cliente vence o genérico para os pedidos desse cliente.

Configurar um vínculo#

1. Abra Master Data → Product Mappings.
2. Clique em Novo. Escolha o canal (e a conexão se o vínculo for específico), digite o External SKU exatamente como o canal o reporta.
3. Escolha o produto interno. Preencha Client apenas quando o SKU significar produtos diferentes por cliente.
4. Opcionalmente preencha Channel Product ID (do admin / API do canal) para que o sync e o push de estoque localizem o item diretamente.
5. Salve e receba um pedido de teste: o SKU deve ser resolvido sem etapa pendente.

Perguntas frequentes#

• SKU não mapeado: abra a aba pendente e vincule cada SKU; geralmente é um erro de digitação no External SKU.
• Um SKU significa produtos diferentes por cliente: crie um vínculo por cliente (preencha Client), não um compartilhado.
• O push de estoque está lento para um SKU: verifique se Channel Inventory Item ID está preenchido; vazio força uma busca extra a cada vez.