Tray: importar o XML de uma nota emitida fora do CControle

Objetivo: anexar no CControle o XML autorizado de uma NF-e emitida fora do sistema para um pedido Tray. Resultado esperado: o XML correto fica associado à venda pela chave, sem reenviar o documento à SEFAZ ou à Tray.

1. Saiba quando a importação é necessária

Em pedidos Tray com NF-e externa, o CControle tenta anexar automaticamente o XML autorizado quando a Tray o devolve junto com o pedido. Só use esta rotina quando a nota já foi emitida fora, a chave está correta e o arquivo não apareceu anexado à venda.

Esta é uma rotina de arquivo fiscal, não de emissão. O CControle casa cada XML com a venda pela chave da NF-e. Nada é transmitido pelo CControle durante essa importação.

• Use: XML original da NF-e autorizada que pertence ao pedido Tray.
• Não use: DANFE em PDF, XML de outra venda, arquivo cancelado sem orientação fiscal ou arquivo alterado manualmente.
• Não use para: tentar corrigir a falta de autorização, emitir NF-e nova ou subir XML de venda ainda não conferida.

2. Importe o XML correto

1. Entre em Entradas > Pedidos Externos.
2. Clique em Importar XMLs.
3. Na janela “Importar XMLs de NF-e (emitidas fora)”, arraste o arquivo ou clique para escolhê-lo.
4. Revise os nomes dos arquivos na lista antes de enviar.
5. Clique em Importar XMLs e aguarde o resultado individual de cada arquivo.

É possível enviar até 100 por vez. Cada arquivo é processado separadamente; isso permite identificar qual foi anexado, qual já estava anexado e qual não pôde ser aplicado.

3. Leia o resultado sem tentar “forçar” o documento

• Anexado: o XML foi associado à venda encontrada pela chave.
• Aprovada + anexado: os dados permitiram registrar a nota externa e anexar o XML à venda correspondente.
• Já anexado: a chave já possui o XML; não é necessário reenviar o mesmo arquivo.
• Não aplicado: leia a mensagem e confira chave, CNPJ do emitente, venda correspondente e estado de conversão.

4. Limites e travas da rotina

• Apenas arquivos .xml de até 2 MB são aceitos.
• Envie no máximo 100 arquivos por importação.
• Se houver uma conversão ou outra importação fiscal em andamento, aguarde terminar antes de tentar de novo.
• O arquivo só é anexado quando a chave encontra a venda ou o pedido externo correspondente e os dados fiscais passam nas validações de segurança.

Problemas frequentes

• “Nenhuma venda ou pedido externo corresponde a esta chave”: confira se o XML pertence à empresa atual e se o pedido Tray foi sincronizado e convertido corretamente.
• “O CNPJ do emitente não é desta empresa”: pare. O XML não é do emitente cadastrado nesta empresa do CControle.
• “Já anexado”: é um resultado seguro; abra a venda e confirme o documento existente.
• Não tenho o XML: peça o arquivo original no ambiente onde a NF-e foi emitida. Não gere outro documento apenas por falta do arquivo.

Como confirmar

O resultado da importação fica como anexado ou já anexado, e a venda correspondente passa a exibir o documento com a mesma chave da NF-e externa.

Próximo passo

Volte à venda e arquive o XML conforme a rotina fiscal da empresa. Para entender o fluxo completo de NF-e emitida pela Tray, leia Tray: quando a NF-e já foi emitida na plataforma.

Revisado em: 25/08/2026.