Como Detectar SKUs Duplicados e Resolver com o Modelo Commit & Remote Push

O SKU (Stock Keeping Unit) é o código de identificação universal de cada item do seu estoque.

Quando múltiplos anúncios — sejam no Mercado Livre, na Shopee ou entre lojas diferentes — usam o mesmo código de SKU para produtos físicos distintos, cria-se uma verdadeira bomba-relógio na operação:

• Uma venda de um produto dá baixa no estoque do outro.
• A expedição e separação etiquetam a mercadoria errada.
• Pedidos são cancelados por ruptura fictícia de estoque.

Para solucionar isso de forma definitiva e segura, a Linka ERP conta com um Scanner Inteligente de Conflitos de SKU e uma arquitetura moderna baseada no padrão Commit & Remote Push (inspirada no Git).

---

1. Como o Scanner da Linka Identifica SKUs Duplicados

Assim que você conecta suas lojas e importa seus anúncios, o robô da Linka realiza uma varredura contínua em todo o catálogo da empresa:

   [ Mercado Livre: Anúncio A ] ── SKU: "DA00" ── (Farol Sem Meia Luz)
   [ Mercado Livre: Anúncio B ] ── SKU: "DA00" ── (Farol Com Meia Luz)  ⚠️ CONFLITO DETECTADO!
   [ Shopee:        Anúncio C ] ── SKU: "DA00" ── (Farol Fusca)

Para visualizar todos os conflitos:

1. Acesse o menu Anúncios no painel lateral.
2. Ative o filtro "SKU Duplicado" ou clique diretamente no banner de alerta de conflito no topo da tela.
3. A Linka agrupa todos os anúncios problemáticos em caixas vermelhas de Conflito de SKU.

---

2. Entendendo os Elementos de Cada Grupo de Conflito

Dentro de cada caixa de conflito, você verá os anúncios agrupados com informações cruciais:

• 🟢 Já no ERP (Dono do SKU): É o primeiro anúncio cadastrado ou mais antigo. A Linka preserva o código original para ele (ex.: DA00), sem alterar nada no marketplace desnecessariamente.
• 🟡 Não mapeado: São os anúncios que colidiram com o SKU original. Para eles, a IA da Linka sugere automaticamente sufixos organizados (ex.: DA00-2, DA00-3), garantindo que se tornem itens únicos.
• 👁️ Ícone de Visualização (Olho): Ao passar o mouse sobre o título de qualquer anúncio, surge um ícone de "Olho". Clique nele para abrir o anúncio ao vivo no Mercado Livre ou Shopee em nova aba e conferir os detalhes antes de alterar.
• ☑️ Checkbox "Mesmo produto":
  • Deixe DESMARCADO se forem produtos físicos diferentes (como peças com especificações distintas). Eles receberão SKUs únicos.
  • Marque apenas se os anúncios forem literalmente a MESMA mercadoria física (ex.: anúncio Clássico e Premium do mesmo item, ou o mesmo produto anunciado no ML e na Shopee). Ao marcar, o SKU compartilhado é mantido e o estoque passa a ser compartilhado.

---

3. O Padrão "Commit & Remote Push" (Segurança Estilo Git)

Sistemas tradicionais frequentemente geram dessincronia silenciosa: se o marketplace recusar a alteração do SKU por qualquer trava interna, o sistema comum mente para você ou apaga o que você digitou.

Na Linka, implementamos o padrão Commit & Remote Push com política Fail-Closed:

Ciclo de Estados de Sincronização:

1. 🟢 Sincronizado (synced): O código exibido na Linka é 100% idêntico ao cadastrado lá no Mercado Livre e Shopee.
2. 🟡 Rascunho Local (staged): Você propôs ou digitou um novo SKU, mas ele está guardado localmente como rascunho no Linka ERP, sem impacto imediato no canal.
3. 🔵 Sincronizando (syncing): O Linka está comunicando a alteração via API oficial do canal.
4. 🔴 Erro de Sincronização (sync_failed): Se o marketplace recusar (ex.: anúncio travado por catálogo oficial ou campanha comercial), seu rascunho NÃO se perde. O Linka grava o motivo exato retornado pela API e mantém seus dados preservados para correção ou descarte.

---

4. Passo a Passo: Como Resolver os Conflitos na Prática

Você tem duas formas de trabalhar com os conflitos:

Opção A: Resolução Imediata em Lote (Recomendada)

1. Acesse Anúncios > Conflito de SKU.
2. Revise as propostas automáticas geradas pela Linka para cada grupo.
3. Se quiser ajustar algum código sugerido, basta digitar o novo valor no campo de texto correspondente.
4. Clique em "Aplicar este grupo" (para o card atual) ou em "Aplicar desta página" (para todos os conflitos da tela).
5. Acompanhe a barra de progresso em tempo real:
   • A Linka atualiza cada anúncio diretamente na API do Mercado Livre ou Shopee.
   • Assim que o canal aprova, o anúncio vira um produto oficial e único no ERP.
   • Ao finalizar, o grupo some da tela e seu catálogo fica 100% limpo!

Opção B: Trabalhar com Rascunhos ("Salvar Rascunhos")

1. Se você quiser editar dezenas de anúncios com calma e revisar antes de publicar nos canais:
2. Ajuste os SKUs propostos nos campos de texto.
3. Clique em "Salvar Rascunhos".
4. As alterações ficam armazenadas localmente no Linka ERP com a badge 🟡 Modificado, sem mexer nas suas contas do marketplace.
5. Quando estiver pronto para efetivar tudo, clique em "Aplicar" para disparar o push remoto.
6. Se mudar de ideia sobre algum item, basta clicar em Descartar na badge do anúncio para reverter o rascunho.

---

5. Auditoria e Relatório de Execução

A Linka mantém histórico completo de cada resolução:

• Ao término do processamento, você pode clicar em "Baixar relatório" para exportar uma planilha CSV com todos os anúncios processados, seus SKUs antigos, os novos SKUs aplicados e o status individual de sucesso.