Tray: o que é tela do aplicativo e o que é tela do ERP

O aplicativo da Tray não é um sistema à parte. Ele abre dentro do próprio ERP, e boa parte das telas que você usa lá dentro são telas do ERP reaproveitadas. Entender essa fronteira resolve a maior parte das dúvidas do tipo "estou na Tray, mas parece o sistema", "editei um cliente aqui e mudou lá" e "a integração sumiu".

A TELA INICIAL DO APLICATIVO
São cinco atalhos, e essa lista é fechada: Produtos, Pedidos, Situações, Integração e Usuários. Todos abrem telas de dentro do aplicativo. Existe também um caminho de volta pronto, que devolve você para o início do sistema.

O QUE É TELA DO PRÓPRIO APLICATIVO
São as telas que só existem por causa da integração: a lista e a visualização de produtos da Tray, a lista e a visualização de pedidos recebidos da loja, a tela que gera a venda a partir do pedido, as situações de pedido, os meios de pagamento da Tray, a lista e a visualização dos clientes vindos da loja e a tela de Integração. É nelas que aparecem colunas como Sincronizado e Data de sincronização, e o botão Sincronizar, que só fazem sentido no contexto do canal.

O QUE É TELA DO ERP REAPROVEITADA
Estas não são cópias: o aplicativo abre a mesma tela do ERP de dentro dele. A lista é fechada: marcas de produtos, grades, campos extras de produtos, lojas, usuários, logs de usuários, grupos de usuários, permissões, planos e ajuda. O cadastro e a edição de produto também são os do ERP — o que o aplicativo tem de próprio, em produtos, é a lista e a visualização dos produtos da Tray, com o vínculo entre o produto da loja e o produto do sistema.
Consequência prática: cadastrar usuário, criar grupo, mexer em permissão ou editar produto "pela Tray" é mexer no ERP. Não existe cadastro paralelo.
Por isso, conceito do ERP se responde pelas fontes do ERP. Cadastro de cliente, cadastro de produto, forma de pagamento, venda e nota fiscal têm fonte própria. Esta fonte aponta, não reexplica.

O CLIENTE DA TRAY É SÓ LEITURA
A tela de clientes do aplicativo lista quem veio da loja, com número, nome, tipo de pessoa, ativo/inativo, telefone, celular, e-mail e a Data de sincronização. A única ação da linha é Visualizar. A visualização abre em abas os dados gerais, os atributos (quando houver), contatos, endereços e foto, e só mostra.
Se você pedir para editar um cliente pela tela do aplicativo, o sistema leva direto para o cadastro de cliente do ERP. Ou seja: a alteração vale para o sistema inteiro, não só para o canal. Isso é o esperado, não é falha.

GERAR VENDA ABRE A VENDA DO ERP
Na lista de pedidos, o botão Gerar venda aparece somente em pedido ainda não sincronizado. Ele abre o formulário de venda de produtos do próprio ERP, com o card de entrega oculto, e grava como uma venda de produtos do ERP. Depois de salvar, o aplicativo registra o vínculo do pedido e devolve você para a lista de pedidos da Tray.
Portanto, dúvida sobre campos, totais, estoque, financeiro ou faturamento dessa venda é dúvida de venda do ERP.

LINKS QUE LEVAM PARA FORA DO APLICATIVO
Três atalhos tiram você do aplicativo. O nome do cliente na lista de pedidos e o nome do cliente dentro da visualização do pedido viram link para a ficha do cliente no ERP — mas só quando aquele pedido já tem um cliente correspondente no sistema; quando não tem, o nome aparece como texto simples, sem link. E o atalho do pedido já sincronizado abre a venda de produtos correspondente. Não é erro nem "saiu da Tray": é o sistema mostrando o registro no lugar onde ele realmente mora.

QUANDO A LOJA NÃO ESTÁ INTEGRADA
As telas do aplicativo dependem da integração da loja em que você está. A tela de Situações consulta a integração assim que abre e devolve você para a tela de Integração em dois casos: quando aquela loja não tem integração e quando a consulta volta com erro — nesse segundo caso, a mensagem do sistema aparece antes. As listas de produtos, pedidos e clientes seguem o que o servidor responder e também podem devolver você para outra tela do aplicativo com a mensagem que vier.
Existe ainda, na tela de Integração, um aviso com o texto "Esta loja não está integrada com a Tray." Ele não aparece em toda volta para essa tela: depende de por onde você chegou nela. Então não trate a ausência do aviso como prova de que a loja está integrada — quem diz a verdade é o botão que a tela exibe (veja abaixo). Muita gente lê esse aviso como "a integração sumiu". Quase sempre é outra loja ou outro acesso, porque o vínculo é por loja. Antes de tratar como perda de integração, confirme em qual loja você está. A fonte da raiz de Integrações e a pasta "Marketplaces e e-commerce" explicam o vínculo por loja.

ADICIONAR, ALTERAR E REMOVER INTEGRAÇÃO
A tela de Integração mostra um botão só, conforme a situação: se não existe integração, aparece Adicionar integração; se existe, aparece Remover integração. Esse botão é o jeito mais rápido de saber se aquela loja está integrada.
Adicionar integração leva à tela Configurar integração, onde o sistema pede dois dados obtidos no painel da Tray: a URL de integração e o Code, ambos obrigatórios. Enquanto existir integração naquela loja, essa tela não abre: o sistema devolve você para a tela de Integração. Nunca cole a URL de integração nem o Code em conversa com o suporte; se já colou, gere outros no painel da Tray.
Se, ao cadastrar, o sistema responder que já existe uma integração, abre a janela Alterar integração com a explicação vinda do servidor; confirmando, o cadastro é reenviado autorizando desconectar a integração existente. Leia a mensagem da janela antes de confirmar — é ela que diz o que será desconectado.
Para remover, o sistema pergunta na janela "Remover integração?": "Você tem certeza que deseja remover a integração com a Tray? Esta ação não poderá ser desfeita.", com Cancelar e Confirmar. Depois de confirmada, a tela consulta a integração de novo e passa a oferecer Adicionar integração. O que a remoção provoca no restante do sistema está descrito na fonte da raiz de Integrações, consulte lá.

O QUE COSTUMA DAR ERRADO
"Estou na Tray mas a tela é a do sistema": é isso mesmo, a tela é reaproveitada, conforme a lista fechada acima.
"Editei o cliente pela Tray e mudou no ERP": o pedido de edição leva ao cadastro de cliente do ERP, e cliente é um só.
"Não consigo editar o cliente da Tray": a tela do aplicativo é só leitura, por isso só tem Visualizar.
"Cliquei no cliente e saí do aplicativo": o nome do cliente é link para a ficha no ERP, quando esse cliente já existe no sistema.
"O nome do cliente não é clicável": aquele pedido ainda não tem cliente correspondente no ERP.
"A integração sumiu": confira a loja e o acesso; a tela de Integração diz a verdade pelo botão que exibe.
"Voltou sozinho para a tela de Integração": aquela loja não estava integrada naquele momento, ou a consulta de integração voltou com erro — e nesse caso a mensagem aparece antes de voltar.
"Removi sem querer": a remoção é confirmada em janela e avisa que não pode ser desfeita; para voltar, é adicionar a integração de novo.

O QUE ESTA FONTE NÃO RESPONDE
O que acontece do lado do servidor da integração, como sincronizar, importar pedido ou conversar com a Tray, não está descrito aqui e não deve ser afirmado a partir desta fonte. Também não está aqui o motivo de uma tela do aplicativo não abrir ou voltar com erro: isso é caso para o suporte técnico, não para dedução. E não é assunto desta fonte o desenho comum dos canais de venda, o de-para de situações e meios de pagamento e quem é dono do pedido, do estoque e do preço: isso está na pasta "Marketplaces e e-commerce". Vale lembrar uma regra do ERP que também se aplica aqui: para uma integração de pagamento funcionar precisa existir uma forma de pagamento apontando para ela, e se a forma desejada não aparece na lista é porque já está vinculada a outra integração.