Tray: sincronização automática, webhooks e reconciliação

Objetivo: entender a atualização automática dos pedidos Tray e decidir quando a ação manual é necessária. Resultado esperado: o operador acompanha o retorno sem disparar sincronizações repetidas e sem confundir atualização externa com conversão em venda.

1. O que acontece automaticamente

Com a integração conectada, o CControle procura atualizar os pedidos Tray periodicamente, hoje a cada 5 minutos, e também executa uma reconciliação mais completa ao longo da rotina do servidor. Mudanças de pedido ou de produto que a Tray notifica podem ser encaminhadas para atualização do registro externo.

• Uma atualização traz pedidos novos ou mudanças relevantes de situação e dados do pedido.
• O processo grava ou atualiza o pedido em Pedidos Externos; ele não converte pedidos em vendas.
• O webhook ajuda a avisar que houve alteração, mas não substitui a conferência do operador nem é garantia de atualização instantânea na tela.

2. Quando clicar em Sincronizar manualmente

Use a sincronização manual em situações pontuais: depois de concluir a conexão, ao procurar uma compra recente, após confirmar uma alteração no painel da Tray ou para repetir uma conferência depois de tratar uma falha indicada pelo CControle.

1. Confirme no cartão Tray que a loja está conectada.
2. Abra Entradas > Pedidos Externos.
3. Clique em Sincronizar uma única vez.
4. Aguarde o estado sair de fila ou em andamento antes de usar a mesma ação de novo.
5. Filtre a origem Tray e confira o pedido pelo número ou período.

3. Leia o estado antes de tentar de novo

• Na fila ou em andamento: aguarde. Repetir a solicitação não acelera a consulta.
• Concluída: confira pedidos, itens e situação pelo filtro de origem Tray.
• Falhou: leia a mensagem, confirme a autorização e o pedido de amostra antes de reconectar ou sincronizar novamente.
• Pedido ainda não apareceu: confira se ele está disponível na Tray, se a loja é a mesma e se o período do filtro não o escondeu.

Problemas frequentes

• Sincronizei e não há venda nova: isso é esperado. A sincronização prepara o pedido externo; a conversão é uma etapa separada e controlada.
• O mesmo pedido parece ter sido consultado de novo: a Tray pode ter informado alteração de situação ou conteúdo. Compare antes de converter.
• Há demora após uma alteração na Tray: aguarde a rotina automática ou faça uma única sincronização manual; não abra várias tentativas ao mesmo tempo.
• Falha de autorização: volte ao cartão Tray e refaça a conexão somente depois de confirmar que a conta e a empresa são as corretas.

Como confirmar

O pedido de amostra aparece na origem Tray com a situação atual e sem duplicidade. Depois da atualização, revise os dados antes de converter ou transmitir documento fiscal.

Próximo passo

Para a conferência operacional, siga conferir cliente, pagamento, frete, desconto e total. Se a execução falhar, use Resolver problemas da Tray.

Revisado em: 25/08/2026.