NuvemShop: associar produto, SKU e a sincronização que roda em segundo plano

A tela Produtos do aplicativo NuvemShop é onde você vê os produtos que vieram da sua loja, diz ao sistema qual produto do ERP corresponde a cada um deles e dispara a sincronização. Uma coisa dessa tela só existe na NuvemShop: o tipo de sincronização Por movimentação de estoque. A sincronização também roda em segundo plano, e aqui a listagem se atualiza sozinha quando ela termina.

AS QUATRO COLUNAS DA LISTA

A lista tem quatro colunas e a lista é fechada: Produto Nuvemshop, Produto (com o nome do sistema), Sincronizado e Ações. Produto Nuvemshop é o nome que veio da sua loja. Produto é o item do ERP que está vinculado àquela linha. Sincronizado mostra um sinal verde para Sim e um vermelho para Não. Em Ações existem apenas dois botões: Visualizar e Associar produto. Não há adicionar, editar nem excluir aqui, porque o produto não é cadastrado por esta tela.

Em telas pequenas, as colunas Produto e Sincronizado ficam ocultas e sobram o nome e as ações. Se você está no celular e não acha a coluna do produto vinculado, abra em uma tela maior.

O rodapé conta separado: mostra o total de produtos e, quando existem, o total de variações. Cada linha da lista corresponde a uma variação de um produto da loja, e é por isso que a quantidade de linhas pode ser maior do que o número de produtos da sua loja.

O TRIÂNGULO VERMELHO DO SKU

Quando o produto veio da loja sem código SKU, aparece um triângulo vermelho ao lado do nome com a explicação Produto sem código SKU. O SKU é o código do produto do lado da NuvemShop. É ele que aparece como Código na tela de visualização e é o único código que a busca avançada aceita procurar.

A consequência prática é direta: produto sem SKU não pode ser encontrado pelo filtro SKU, e você fica dependendo de rolar a lista para achá-lo. O SKU vem da loja, então quem preenche é o cadastro do produto dentro da NuvemShop. Não afirmamos aqui que a falta do SKU impede a sincronização, porque isso depende do lado da loja.

ASSOCIAR PRODUTO

Associar é dizer ao sistema que aquele produto da NuvemShop é este produto do ERP. Sem o vínculo, o produto não participa da sincronização de estoque e de valores.

O botão Associar produto abre uma janela com no máximo dois campos, e os dois são obrigatórios. O primeiro é Produto: você digita e o sistema vai buscando; cada resultado mostra o código, o nome e, embaixo, o código de barras. O segundo é Variação, e ele só aparece quando o produto escolhido tem variação; nesse caso você precisa dizer qual variação corresponde àquela linha da NuvemShop. Se o produto escolhido tem um único registro de estoque, o sistema já o seleciona sozinho. Depois é Salvar ou Cancelar. Não há outro campo nessa janela.

Se aquela linha já tem vínculo, a janela abre com o produto e a variação já preenchidos — é assim que se confere um vínculo antigo.

Um detalhe que responde por boa parte das dúvidas: a busca de produtos leva junto a loja do usuário logado. Antes de concluir que o produto sumiu, confira em qual loja ele foi cadastrado e em qual loja o usuário está.

QUANDO O PRODUTO JÁ ESTÁ VINCULADO

Se o produto ou a variação que você escolheu já estiver vinculado a outro item, o sistema pergunta antes: Produto já está vinculado. Deseja fazer um novo vinculo ? Se você confirmar, ele salva o novo vínculo na hora, sem esperar você clicar em Salvar. Se cancelar, nada muda e a janela continua aberta para você escolher outro produto.

Essa pergunta pode aparecer logo depois de escolher o produto (quando ele tem um único registro de estoque) ou depois de escolher a variação.

Dando certo, aparece Associação de produto realizada com sucesso! e a listagem se recarrega já com a coluna Produto preenchida.

SINCRONIZAR PRODUTOS: OS TRÊS TIPOS

O botão Sincronizar abre uma janela com três tipos de sincronização, e a lista é fechada: Tudo, Por data e Por movimentação de estoque.

Tudo passa por todos os produtos. Por data usa o período informado. Por movimentação de estoque é exclusiva da NuvemShop, nenhum outro canal tem esse tipo, e a própria dica do sistema explica o que ela faz: sincroniza apenas os produtos vinculados que tiveram movimentação de estoque, entrada ou saída, no período, e por isso é mais rápida. É a opção certa para o dia a dia de quem vende e repõe todo dia.

Escolhendo Por data ou Por movimentação de estoque, aparece o campo Período, já preenchido com o mês corrente. Você pode trocar as datas.

OS DOIS MARCADORES E O SENTIDO DA SINCRONIZAÇÃO

Abaixo dos tipos existem dois marcadores, e a lista é fechada: Sincronizar estoque, que já vem marcado, e Sincronizar valores de venda, que vem desmarcado.

O sentido é o que mais confunde, então guarde assim: a sincronização sai do ERP e vai para a NuvemShop. A dica do próprio sistema diz isso em cada marcador — será enviado o estoque atual dos produtos do sistema para os produtos da NuvemShop, e será enviado o valor de venda padrão do sistema para os produtos da Nuvemshop. Não é o contrário. Se você marcar Sincronizar valores de venda esperando trazer o preço que está na NuvemShop para dentro do ERP, vai acontecer o oposto: o preço do ERP passa a valer na loja.

Por isso, antes de marcar Sincronizar valores de venda, confira o valor de venda dos produtos no ERP.

A SINCRONIZAÇÃO RODA EM SEGUNDO PLANO

Clicando em Sincronizar, o botão muda para Iniciando... e o sistema responde Sincronização iniciada! O progresso será exibido na listagem. A janela fecha na hora. O trabalho não termina nesse clique: ele segue rodando em segundo plano.

Enquanto ela roda, a listagem mostra uma tarja amarela no topo: Sincronização em andamento. Você pode continuar utilizando o sistema normalmente. O processo será finalizado em alguns minutos. Pode continuar trabalhando, inclusive em outras telas.

Quando termina, a tela avisa a conclusão e a listagem se recarrega sozinha, já com os dados atualizados. Esse aviso automático depende de uma conexão que a página mantém com um serviço externo; se ela cair, a tela tenta reconectar sozinha, e só volta a tentar com a aba visível.

Sobre tempo, o único número que existe é o do próprio texto: alguns minutos. Não trabalhamos com prazo fechado, nem com quantidade de produtos processados por vez, nem explicamos como o servidor faz o processamento.

A sincronização atualiza estoque e valor dos produtos vinculados. Não afirme que ela cria produto novo na NuvemShop ou no ERP.

BUSCA AVANÇADA: UM FILTRO POR BUSCA

A busca avançada de produtos tem três filtros, e a lista é fechada: Código sku, Data de criação e Data de modificação.

O comportamento real é este, e ele explica o filtrei por data e veio errado: os filtros se excluem. Preenchendo o SKU, os dois períodos ficam bloqueados. Preenchendo qualquer período, o campo SKU fica bloqueado. E preenchendo o período de Data de modificação, o que estava em Data de criação é apagado e aquele campo fica bloqueado. Ou seja, na prática vale um filtro por busca. Se você quer trocar de filtro, use o botão Limpar antes de montar a busca nova, e depois Buscar.

VISUALIZAR PRODUTO

O botão Visualizar abre os dados que vieram da NuvemShop para aquela linha. São dez informações, e a lista é fechada: Código, Nome, Largura, Altura, Preço, Preço promocional, Estoque, Código de barras, Cadastrado em e Modificado em. Não existe peso nem profundidade nessa tela; não peça ao cliente para procurar.

Esses valores são um retrato do que está na loja, não do ERP. Se o Estoque ou o Preço aí estão diferentes do sistema, é sinal de que a sincronização ainda não rodou para esse produto ou de que ele não está vinculado.

O QUE COSTUMA DAR ERRADO

O produto não aparece na busca da janela Associar produto. A busca leva a loja do usuário logado. Confira em qual loja o produto foi cadastrado e em qual loja o usuário está.

A tarja Sincronização em andamento fica presa na tela. O aviso de conclusão chega por uma conexão com um serviço externo; rede corporativa, proxy ou bloqueador do navegador podem barrar essa conexão, e aí a tarja não some sozinha. Recarregue a página: isso resolve a exibição. A sincronização em si segue no servidor.

O cliente marcou Sincronizar valores de venda esperando puxar o preço da loja para o ERP. O sentido é o inverso, do ERP para a NuvemShop. Reveja o valor de venda no cadastro do produto e rode de novo.

Na janela Associar produto, o cliente trocou o produto escolhido e o campo Variação continuou aparecendo. A tela não desfaz sozinha a marcação de que o produto tem variação. Feche a janela e abra de novo antes de escolher o produto certo.

Produto vinculado mas a coluna Sincronizado continua com o sinal vermelho. Vínculo e sincronização são coisas diferentes: associar só cria o de-para. Depois de associar, rode a sincronização.

O QUE NÃO SE RESPONDE POR AQUI

Cadastro de produto, código SKU, variação, grade e valor de venda são do ERP e se respondem pelas fontes do ERP, não por esta. Quem é dono do estoque e do preço entre o canal e o sistema está na pasta de Marketplaces e e-commerce, junto com o desenho comum dos cinco canais e as travas de autorização. Vínculo da integração com a loja, o efeito de remover a integração e a opção Gerar venda estão na fonte da raiz de Integrações.