Tray: guia completo para começar com segurança

Objetivo: preparar a integração Tray em uma ordem segura, do vínculo da loja até a primeira venda convertida. Resultado esperado: o técnico valida um pedido real de ponta a ponta sem criar produto, venda ou ajuste em duplicidade.

1. Siga uma sequência, não pule direto para ações em massa

Uma loja Tray pode ter muitos pedidos e anúncios. O caminho seguro é conectar, sincronizar, conferir um pedido de amostra, vincular somente os itens confirmados e converter uma única venda. Só depois desse teste o time deve usar ações em lote.

1. Conectar a loja Tray: autorize a conta correta no cartão da integração.
2. Sincronizar: traga os pedidos e o catálogo para consulta no CControle.
3. Conferir: compare itens, frete, desconto, pagamento e total com a Tray.
4. Vincular: relacione o item externo ao produto interno apenas quando código e variação estiverem corretos.
5. Converter: crie uma única venda de teste e siga o fluxo fiscal normal da empresa.

2. Conecte a loja e confira a empresa antes do primeiro retorno

1. Acesse Configurações > Vínculo e Integração.
2. Abra o cartão Tray e informe a URL oficial solicitada.
3. Clique em Conectar Tray e conclua a autorização na janela oficial.
4. De volta ao CControle, confirme que o cartão identifica a loja esperada e não apresenta pedido de reconexão.

3. Faça a primeira sincronização e encontre o pedido de amostra

1. Abra Entradas > Pedidos Externos.
2. Solicite Sincronizar uma vez e aguarde a conclusão.
3. Filtre a coluna ou o filtro Origem por Tray.
4. Localize o pedido de amostra pelo número, cliente ou período.
5. Abra os detalhes e compare os dados com o pedido no painel da Tray antes de fazer qualquer alteração interna.

4. Escolha o próximo guia conforme a situação

• Pedido não apareceu ou precisa atualizar: siga sincronizar pedidos Tray e conferir atualizações.
• Produto ou variação ainda não está seguro: consulte variações, SKU e vínculo seguro.
• Total não fecha: confira frete, desconto, embalagem para presente e juros antes de converter.
• Pedido já está pronto para faturar: converta a venda, autorize a NF-e e use o guia de envio da nota para a Tray.

Como confirmar

O primeiro pedido Tray deve ter origem identificada, produto interno correto, forma de pagamento conferida e total igual ao que o comprador pagou. A venda de teste precisa ficar vinculada ao pedido externo, sem uma segunda venda para o mesmo pedido.

Próximo passo

Depois do teste, leia Tray: conferir cliente, pagamento, frete, desconto e total. Para uma visão do que o CControle ainda não envia à loja, abra os limites atuais de catálogo, estoque e preço.

Revisado em: 25/08/2026.