Tray: resolver forma de pagamento pendente antes de converter

Objetivo: liberar com segurança um pedido Tray que não pode ser convertido por causa da forma de pagamento. Resultado esperado: a venda e os recebimentos serão criados com a forma interna correta, sem trocar pagamento de pedido cancelado ou de venda já pronta.

1. Entenda por que o CControle bloqueia a conversão

O pagamento que chega da Tray tem um código externo. Para criar a venda e o contas a receber corretamente, o CControle precisa associar esse código a uma forma de pagamento interna cadastrada. Quando não encontra uma associação válida, aparece o aviso Conversão bloqueada por forma de pagamento não reconhecida.

Esse bloqueio protege a operação: ele evita que uma venda de cartão, PIX ou boleto seja convertida com recebimento vazio ou com uma forma genérica errada.

Onde confirmar o pagamento no painel Tray

Antes de mapear no CControle, abra Vendas > Lista de pedidos na Tray e selecione o pedido pelo mesmo número. A ficha possui a seção Forma de pagamento; use-a junto do resumo do pedido para identificar a forma que realmente foi informada pela plataforma.

Captura oficial da Tray, recortada para preservar privacidade: Base de Conhecimento Tray — ficha de pedidos.

• Código externo pendente: a Tray enviou uma forma que ainda não está reconhecida neste pedido.
• Nenhuma forma cadastrada: primeiro é preciso cadastrar uma forma de pagamento no CControle.
• Pedido já convertido: o ajuste passa a ser feito na venda vinculada, e não no pedido externo.
• Pedido cancelado: não altere o pagamento para forçar uma conversão; confirme primeiro o cancelamento na Tray.

2. Corrija o código externo que está pendente

1. Abra os Detalhes do pedido Tray.
2. Localize o cartão Pagamento e Entrega.
3. Leia o código exibido em Códigos sem cadastro interno. Ele identifica o pagamento recebido no pedido.
4. Na área de mapeamento, escolha a forma interna que representa o pagamento de verdade: por exemplo, PIX, cartão, boleto ou outra forma que a empresa utiliza.
5. Confirme o valor e as parcelas exibidos no cartão. Se houver mais de um código no pedido, revise cada cartão separadamente.
6. Clique em Salvar forma interna e aguarde a mensagem de sucesso.
7. Releia o alerta: a forma deve ficar pronta para conversão antes de usar o botão de converter.

3. Quando usar “Forma de pagamento para conversão”

O mesmo cartão possui uma área chamada Forma de pagamento para conversão. Ela serve para ajustar a forma interna que será usada ao criar a venda e os recebimentos daquele pedido quando o pagamento já é reconhecido, mas precisa de correção operacional.

1. Confirme que o pedido está ativo e ainda não foi convertido.
2. Na lista Forma interna, selecione a opção correta.
3. Leia a indicação “Atual” e verifique se há vários pagamentos no pedido.
4. Clique em Atualizar forma.
5. Volte ao resumo do pagamento e só então converta o pedido.

Quando existem vários pagamentos no mesmo pedido, essa alteração é aplicada a todos os pagamentos dele. Por isso, não use este atalho para corrigir apenas uma parcela ou inventar uma divisão que não veio da Tray.

4. O que não fazer

• Não converta com o alerta ativo: resolva o pagamento antes para não criar financeiro inconsistente.
• Não altere pedido cancelado: o CControle bloqueia a alteração para preservar a coerência com a Tray.
• Não altere pedido já convertido: abra a venda vinculada e trate o recebimento nela, seguindo a rotina financeira da empresa.
• Não use “Outros” por hábito: escolha uma forma que permita à equipe identificar corretamente o recebimento depois.

Problemas frequentes

• Não existe opção na lista: não há forma de pagamento interna cadastrada ou disponível. Cadastre-a primeiro e volte ao pedido.
• O código continua pendente: salve a forma interna, atualize a tela e confirme se todos os códigos externos exibidos foram tratados.
• O pedido já virou venda: não tente desfazer apenas para mudar a forma. Localize a venda vinculada e siga o processo financeiro autorizado pela empresa.
• O valor parece diferente: compare frete, desconto, juros e embalagem para presente antes de mexer na forma de pagamento.

Como confirmar

O alerta de pendência deixa de aparecer, a forma interna correta fica visível no cartão e o pedido pode ser convertido sem bloqueio de pagamento.

Próximo passo

Continue em Tray: conferir cliente, pagamento, frete, desconto e total antes de converter. Se a Tray já tiver emitido a nota, veja Tray: quando a NF-e já foi emitida na plataforma.

Revisado em: 25/08/2026.