Integração com Tray

Configurando a integração com o Tray

Instalando na Loja de Apps

1. No Fácil123, clique na Engrenagem
2. Clique em Loja de Apps
3. Localize Tray e clique em Instalar
4. Preencha o campo URL da loja com o link da sua loja. Não esqueça o https://
5. Clique em Salvar

Configurando a plataforma de vendas

1. Clique na Engrenagem
2. Clique em Plataforma de Vendas
3. Clique em Incluir
4. Clique em Tray
5. Preencha o nome da plataforma
6. Em Aplicativo, selecione Tray
7. Selecione o Quadro e a Etapa de vendas
8. Se desejar, vincule a um Canal de vendas
9. Selecione o Depósito
10. Clique em Salvar e em seguida em Solicitar autorização
11. Uma nova tela abrirá para que você conecte na sua conta da Tray. Entre na conta que deseja cadastrar e clique em Autorizar

É possível cadastrar várias contas da Tray no sistema. Para isso, repita o processo acima para cada conta.

Importando pedidos

Para importar pedidos da Tray, consulte Importando pedidos na plataforma de vendas.

Os dados de entrega da Tray serão utilizados pelo Fácil123 para dados de faturamento e cadastro da pessoa.

O meio de pagamento do pedido é importado automaticamente por correspondência de nome com os meios de pagamento cadastrados no Fácil123.

O campo Observação da venda importada começa com o número do pedido Tray, seguido pelos dados de pagamento e frete. Assim você consulta o número do pedido direto na venda, sem precisar voltar ao painel da Tray.

Ao gerar a nota fiscal a partir de um pedido Tray, o campo Observação da nota é preenchido automaticamente com o número do pedido Tray, o meio de pagamento e a modalidade de frete (por exemplo: Pedido Tray: 123 * Pagamento: Cartão * Modalidade de frete: SEDEX). O número do pedido aparece sempre. Pagamento e frete só são incluídos quando estiverem disponíveis no pedido.

Cadastrando código do produto

Para que o Fácil123 reconheça o produto que foi vendido é necessário que o código esteja cadastrado no produto.

1. No Fácil123, acesse Compras → Produtos
2. Pesquise o produto, clique nos três pontinhos e clique em Plataforma de Vendas
3. Selecione Tray, preencha o campo Chave do produto com o ID e clique em Salvar

Você pode localizar o código do produto de duas formas:

• Tray — clique em Produtos → Lista de Produtos, o código aparecerá na primeira coluna da tabela, do lado esquerdo da tela
• Fácil123 — ao importar um produto que ainda não está cadastrado, o código aparecerá na mensagem de erro da importação

Resolvendo código repetido entre produto e variação

Nos pedidos com produto com variação, a Tray envia apenas o código da variação vendida, sem o código do produto pai. Por isso, a Chave do produto de cada variação no Fácil123 deve ser o código da própria variação.

A Tray gera esses códigos automaticamente, e o código de um produto pode acabar igual ao código de uma variação de outro produto. Quando isso acontece, o Fácil123 não consegue identificar qual produto foi vendido e o pedido não é importado.

Para resolver, troque o código do produto pai por um número que não esteja em uso em nenhum outro produto ou variação da loja. Na Tray, esse código só pode ser definido ao cadastrar os produtos por planilha. Depois, atualize a Chave do produto desse produto no Fácil123 com o novo código, seguindo os passos de Cadastrando código do produto.

Gravando a previsão de entrega

A Tray envia a previsão de entrega junto com o pedido. Escolha em qual campo da venda você quer gravar essa data, e o Fácil123 preenche esse campo automaticamente sempre que importar um pedido com previsão de entrega.

A lista mostra apenas campos de data e hora da venda. Recomendamos criar um campo personalizado na entidade Venda, do tipo Data e hora, e apontar a previsão de entrega para ele.

1. No Fácil123, clique na Engrenagem → clique em Plataforma de Vendas
2. Localize a plataforma da Tray, clique nos três pontinhos → clique em Editar
3. Clique no campo Previsão de entrega
4. Selecione o campo desejado em Atributo
5. Clique em Adicionar
6. Clique em Salvar

Se você não selecionar nenhum campo, nada é gravado e a importação continua funcionando normalmente. Pedidos sem previsão de entrega também não preenchem o campo.

A data é gravada no fuso de Brasília, então o dia é sempre o mesmo que a Tray informou.

Cadastrando meios de pagamento

Para que o Fácil123 reconheça o meio de pagamento de um pedido importado da Tray, é preciso ter um meio de pagamento ativo cujo nome corresponda ao informado pela Tray (a comparação ignora maiúsculas e minúsculas). Meios de pagamento arquivados não são considerados.

1. Acesse Vendas → Meios de pagamento → Incluir
2. No campo Nome, digite exatamente o nome da forma de pagamento conforme vem da Tray
3. Preencha as demais configurações e clique em Salvar

Tratando pedidos cancelados ou devolvidos na Tray

Ao importar pedidos, o Fácil123 traz da Tray apenas os pedidos que não estão cancelados. Depois que um pedido chega ao Fácil123, ele não é mais atualizado, e a Tray não avisa o Fácil123 quando um pedido é cancelado ou devolvido. Por isso, acompanhe os cancelamentos e as devoluções no painel da Tray e trate cada caso no Fácil123.

Pedido cancelado antes de virar venda

Um pedido que já aparece na lista de pedidos da plataforma de vendas, ainda pendente, continua com a situação que tinha quando chegou ao Fácil123 (por exemplo, Aprovado), mesmo que seja cancelado na Tray depois. Antes de importar os pedidos pendentes, confira a situação de cada um na Tray. Se o pedido foi cancelado, marque-o como ignorado na tela de pedidos da plataforma de vendas, para não gerar uma venda de um pedido que já foi cancelado.

Pedido cancelado ou devolvido depois de importado

A venda gerada pelo pedido continua como estava, e as parcelas continuam no financeiro. Escolha como desfazer a venda conforme a situação da nota:

• Nota autorizada há menos de 24 horas: cancele a venda. As parcelas em aberto saem do financeiro junto com o cancelamento.
• Mercadoria não entregue ao cliente: faça um estorno.
• Mercadoria devolvida pelo cliente: faça uma devolução de venda.

O estorno e a devolução não excluem as parcelas da venda original. Exclua as parcelas no financeiro ou, se o cliente já pagou, lance a saída do reembolso, como explicado em Sobre o financeiro na devolução.

Erros na importação de pedidos

Não autorizado. Verifique se a plataforma de vendas está autorizada.

A autorização da Tray deixou de valer, e o Fácil123 não consegue mais buscar os pedidos da loja. Na importação, os pedidos novos param de aparecer. Para voltar a receber os pedidos, autorize a plataforma de vendas de novo:

1. Clique na Engrenagem → clique em Plataforma de Vendas
2. Clique na plataforma da Tray
3. Clique em Solicitar autorização
4. Entre na sua conta da Tray e clique em Autorizar
5. Importe os pedidos novamente

Forma de pagamento "XXXXXX" não encontrada.

A Tray enviou uma forma de pagamento que não corresponde a nenhum meio de pagamento ativo no Fácil123. Cadastre um meio de pagamento com o nome indicado no erro seguindo esse passo a passo.

Total da venda diferente do valor das parcelas

O Fácil123 calculou ICMS-ST sobre os produtos do pedido e somou esse valor ao total da venda. Como a Tray não cobra esse imposto do cliente final, o total da venda fica maior do que o valor pago no pedido, e o pedido não é importado porque as parcelas não fecham com o total.

Isso acontece quando a natureza da operação padrão das vendas é de venda para contribuinte e os produtos têm tributação com ICMS-ST. Para vendas ao consumidor final, ajuste a natureza padrão:

1. Clique na Engrenagem → clique em Vendas
2. Selecione Venda – consumo / não contribuinte em Natureza da operação padrão para vendas
3. Clique em Salvar
4. Importe o pedido novamente

Antes de alterar, confirme com a sua contabilidade qual natureza e tributação se aplicam às suas vendas. Saiba mais em Configurando vendas.

Perguntas e respostas

1 - O Fácil123 faz a busca do Tray para informações do frete?
R: Sim. O valor do frete é importado do pedido. Além disso, a modalidade de frete (por exemplo: SEDEX, PAC, nome da transportadora) é registrada automaticamente no campo Observação da nota fiscal gerada a partir do pedido.

2 - O Fácil123 traz as informações de desconto do Tray?
R: Sim. O desconto de cupom e o desconto do meio de pagamento são importados junto com o pedido, inclusive quando o desconto varia conforme o valor da compra, como costuma acontecer no PIX. Eles aparecem como desconto na venda e na nota fiscal.

3 - O Fácil123 traz o meio de pagamento do Tray?
R: Sim. Ao importar um pedido, o Fácil123 busca automaticamente um meio de pagamento ativo cujo nome corresponda ao informado pela Tray (a comparação ignora maiúsculas e minúsculas). Meios de pagamento arquivados não são considerados. Veja Cadastrando meios de pagamento.

4 - O Fácil123 traz a previsão de entrega do Tray?
R: Sim, desde que você escolha em qual campo da venda gravar essa data. Veja Gravando a previsão de entrega.

5 - Como fazer com que o telefone do cliente apareça na nota, quando pedido é importado do Tray?
R: Nas configurações do Tray você pode tornar o campo de telefone obrigatório. Saiba mais nesse material.