Tray: sincronizar a lista e associar produto e variação

Aqui o assunto é a tela: como a lista de produtos da Tray se comporta, por que o botão de associar às vezes fica desabilitado e como associar (ou corrigir) um vínculo na mão. O que é a referência, quem manda no estoque e no preço e como o vínculo automático acontece estão no conteúdo sobre referência, estoque e preço nos canais de venda.

ANTES DE MAIS NADA: ONDE ESSA TELA VIVE
A tela de Produtos da Tray é do próprio aplicativo Tray. Ela não é o cadastro de produtos do ERP: são duas listas diferentes, com finalidades diferentes. Esta aqui mostra o que existe na loja Tray e com qual produto do sistema cada item está amarrado.
O que essa tela oferece é isto: listar, sincronizar, filtrar, visualizar e associar. Não há nela nenhum botão de cadastrar, editar ou publicar produto. Quem cadastra produto continua sendo o cadastro de produtos do sistema.
O que acontece do lado da loja — a leitura dos dados da Tray e o casamento por referência — está no conteúdo sobre referência, estoque e preço nos canais de venda.

O QUE A LISTA MOSTRA
A tabela tem quatro colunas, e essa lista é fechada: Produtos Tray (o nome do produto na loja), Produtos seguido do nome do sistema (o produto do sistema que está amarrado àquele item), Sincronizado e Ações.
Sincronizado é um sinal visual: certo verde quando sim, xis vermelho quando não. Passando o mouse aparece Sim ou Não.
Em Ações existem duas opções, e só essas duas: Visualizar e Associar produto.
Abaixo da tabela o sistema informa quantos itens estão sendo exibidos e o total, e quando a loja tem variações ele acrescenta, à parte, quantas variações. A lista é paginada: havendo mais itens do que cabe na página, aparecem os números de página no canto direito.
Vale saber que cada linha pode ser um produto ou uma variação. A variação tem linha própria, com referência própria e vínculo próprio.

O TRIÂNGULO AMARELO E O BOTÃO DESABILITADO
Ao lado do nome do produto pode aparecer um triângulo de alerta. Passando o mouse, ele diz Produto sem Referência!. Ele aparece quando aquela linha veio da loja sem referência preenchida (ou com a referência zerada).
E aqui está o ponto que mais gera chamado: quando a referência está vazia, o botão de associar produto fica desabilitado. Não é travamento, não é permissão, não é erro. O sistema desabilita de propósito, porque sem referência não há como amarrar aquele item com segurança.
Atenção a um detalhe: o triângulo e o botão desabilitado não andam sempre juntos. Existe caso em que a referência veio zerada, o triângulo aparece e o botão continua clicável. Então, se você vê o triângulo, confira antes se o botão está mesmo apagado.
Se o botão está apagado, insistir nele não resolve. O caminho é: preencher a referência daquele produto (ou daquela variação) na Tray e sincronizar a lista de novo. Depois disso o item volta com referência e o botão fica disponível. O papel da referência está no conteúdo sobre referência, estoque e preço nos canais de venda.

ASSOCIAR UM PRODUTO NA MÃO
Além do vínculo automático por referência, existe a associação manual, pelo botão Associar produto na coluna Ações. Abre uma janela chamada Associar produto.
Nela você tem o campo Produto, com o texto Digite para buscar. É uma busca por digitação: conforme você digita, o sistema lista os produtos do sistema mostrando o código, o nome e, embaixo, o código de barras. Isso ajuda quando existem nomes parecidos: use o código ou o código de barras para não errar o item.
Quando o produto escolhido tem variação, aparece um segundo campo, Variação, com uma lista para escolher qual variação daquele produto corresponde ao item da loja. Se o produto tiver só uma variação, o sistema já a seleciona sozinho. Produto e Variação aparecem marcados como campos obrigatórios: o vínculo é produto mais variação, não só produto.
Depois é Salvar. Cancelar fecha sem gravar. Salvo o vínculo, a janela fecha, o sistema atualiza as linhas da lista e avisa Associação de produto realizada com sucesso.

QUANDO O PRODUTO FOI ASSOCIADO ERRADO
Este é o conserto, e vale dizer com todas as letras: dá para trocar o vínculo, não é preciso desfazer nada antes.
Ao escolher um produto do sistema que já está amarrado a outro item da loja, o sistema pergunta: Produto já está vinculado ao produto seguido do nome e da referência do item da loja, e depois Deseja fazer um novo vinculo?. Essa pergunta aparece no momento em que a variação é escolhida (ou logo na escolha do produto, quando ele tem uma variação só).
Um ponto que confunde: confirmar essa pergunta já grava. O vínculo é refeito na hora e a janela fecha — você não precisa clicar em Salvar depois. Se cancelar, o vínculo não é refeito naquele momento.
Ou seja: associou errado, abra o item certo da loja, use Associar produto, escolha o produto (e a variação) correto e confirme a pergunta do novo vínculo. Confira o nome e a referência que aparecem na pergunta antes de confirmar, porque é exatamente o vínculo antigo que está sendo apontado ali.

SINCRONIZAR A LISTA
Sincronizar é ação manual. É você quem começa, pelo botão Sincronizar no topo da lista. Abre a janela Sincronizar produtos, com Cancelar e Sincronizar. Não há escolha de período nem de tipo: é sincronizar e pronto.
A sincronização é feita em partes: o sistema busca um pedaço da lista, avisa quantos produtos já foram sincronizados de um total, e segue automaticamente para o próximo pedaço até terminar. Por isso, em loja com muitos produtos, isso demora e a tela precisa continuar aberta até o fim. Se você fechar a tela, trocar de página ou perder a conexão no meio, a sincronização para onde estava e você vai precisar rodar de novo. Se der erro em um dos pedaços, o sistema mostra a mensagem de erro e encerra ali mesmo.
Terminando, a lista é recarregada. Por isso Sincronizar é o passo depois de qualquer arrumação feita na Tray.

BUSCA AVANÇADA
O botão Busca avançada abre um bloco de filtros. São três campos: Nome do produto e dois campos de data. Tem os botões Buscar e Limpar. Limpar zera os filtros e recarrega a lista completa.
Cuidado com um detalhe que confunde: por uma falha de rótulo, os dois campos de data aparecem escritos Data de criação. O primeiro é mesmo o de criação; o segundo, apesar do rótulo, é o de modificação. Se parecer que existem dois campos iguais, é isso.
Não existe filtro por referência, por SKU nem por sincronizado. Para achar os itens sem referência você percorre a lista procurando o triângulo amarelo.

VISUALIZAR UM PRODUTO DA LOJA
O botão Visualizar abre a ficha daquele item como ele está na Tray, e quando a linha é uma variação a tela já abre na variação correspondente. É leitura, não edição: nada ali altera a loja nem o sistema.
Na aba Dados gerais aparecem nome, altura, largura, comprimento, peso, preço, estoque, cadastrado em e modificado em. Quando o item tem SKU, aparece também uma linha SKU no topo, e é ali que você confere a referência daquele item. Existe também a aba Fotos, com as imagens do produto na loja; clicando numa foto ela abre ampliada.
Use essa tela para conferir o que a loja realmente devolveu. Se o estoque ou o preço da ficha não é o que você esperava, o problema está em quem manda naquele dado, e isso está no conteúdo sobre referência, estoque e preço nos canais de venda.

O QUE COSTUMA DAR ERRADO
Produto não aparece na lista. A lista só mostra o que veio da loja na última sincronização. Produto criado na Tray depois disso não aparece sozinho: rode Sincronizar. Confira também se não há um filtro de busca avançada ligado, principalmente filtro de data.

Produto sem referência. Sai o triângulo Produto sem Referência!. Preencha a referência na Tray e sincronize de novo. Se o botão de associar estiver apagado, não adianta pedir para habilitar: ele volta a funcionar quando o item vier com referência.

Variação sem referência. Cada variação é uma linha. A variação também precisa de referência própria; se ela está sem, a linha dela fica no mesmo impedimento, mesmo que o produto principal esteja certo.

Produto associado ao errado. Não precisa apagar nada. Abra o item certo da loja, use Associar produto, escolha o produto e a variação corretos e confirme a pergunta Deseja fazer um novo vinculo?. Lembre que confirmar já grava.

Estoque que volta ao valor antigo. Isso não é a associação. É quem manda no estoque naquele desenho de integração, e está explicado no conteúdo sobre referência, estoque e preço nos canais de venda.

A lista carrega vazia. A tela mostra a tabela só quando existe produto para mostrar; sem produto ela fica sem tabela e sem nenhuma mensagem, o que assusta. Considere três coisas, nessa ordem: filtro de busca avançada ativo (clique em Limpar), sincronização que nunca foi rodada nessa loja (clique em Sincronizar) e, se mesmo assim continuar vazio, o vínculo da loja com a integração, que é assunto do conteúdo geral de Integrações e do conteúdo de Marketplaces e e-commerce.

O QUE ESTA TELA NÃO FAZ
Nesta tela não existe enviar produto do sistema para a Tray, publicar anúncio, mandar preço ou criar produto na loja. O que existe é ler a lista da loja e amarrar cada item a um produto do sistema. Se a ideia é publicar o catálogo na loja, essa não é a função desta tela.