Todos os artigos
Tutorial

Enviar o XML da NF-e ao marketplace

Siga o fluxo correto após a NF-e autorizada: envio manual, em massa ou automático e conferência pela coluna de XML.

Atualizado em 31/07/2026

Objetivo: entender o fluxo completo para comunicar ao canal o XML de uma NF-e autorizada pelo C Controle. Resultado esperado: a equipe escolhe entre envio individual, em massa ou automático e confere o retorno pela coluna correta, sem duplicidade.

Antes de começar

Perfil ou permissão: Usuário com acesso fiscal e permissão para consultar a venda e a integração.

Caminho: Vendas > localizar venda do marketplace ou Entradas > Pedidos Externos > engrenagem

  • NF-e autorizada e XML disponível no C Controle.
  • Venda originada de um canal com suporte ao envio.
  • Integração conectada e sem alerta de autenticação.
  • Procedimento fiscal validado pelo contador.

1. Ative o envio automático, quando aplicável

  1. Abra Entradas > Pedidos Externos e clique na engrenagem.
  2. Localize Enviar XML automaticamente ao marketplace.
  3. Leia o escopo da opção e salve somente se o processo da empresa já estiver validado.
  4. Acompanhe os primeiros pedidos para confirmar o retorno do canal.
Central de Pedidos Externos com acesso às configurações de envio de XML
A configuração de envio automático fica na engrenagem da Central de Pedidos Externos.

2. Faça o envio manual quando a ação estiver disponível

  1. Abra a lista de Vendas e localize a venda de origem externa.
  2. Confirme que a NF-e está autorizada e que a chave pertence à venda.
  3. Em Ações, escolha o envio de XML apresentado para o canal.
  4. Confirme uma vez e leia a mensagem de retorno.
Filtros da lista de vendas para localizar uma nota autorizada antes de enviar o XML
Filtre a venda e confira sua situação fiscal antes de usar qualquer ação de envio do XML.

3. Siga a ordem correta antes de qualquer envio

  1. Sincronize e confira: confirme origem, itens, comprador, valores e situação do pedido externo.
  2. Converta com segurança: o pedido precisa apontar para uma única venda correta antes de existir documento para o canal.
  3. Emita e autorize: o XML só é elegível depois da NF-e autorizada pelo fluxo fiscal normal.
  4. Comunique ao marketplace: use envio individual, em massa ou automático de acordo com o canal e a regra configurada.
  5. Confira o retorno: deixe a coluna XML marketplace visível e trate somente os pedidos que continuam pendentes ou falharam.
NecessidadeFluxo recomendado
Uma venda específica precisa de conferência pontual.Abra a venda e use a ação manual disponível para o canal.
Há várias NF-e autorizadas pendentes.Use Enviar XML ao marketplace em massa depois de conferir a coluna.
As próximas notas de canais compatíveis devem seguir após a autorização.Configure Envio automático de XML ao marketplace e valide a primeira amostra.
O operador não sabe se deve reenviar.Leia Conferir a coluna XML marketplace antes de clicar novamente.
Atenção: o envio do XML não transmite, emite, corrige ou cancela uma nota na SEFAZ. Nunca envie arquivo de outra venda e não repita a ação sem antes conferir o retorno e a situação do pedido.

Problemas frequentes

  • A ação não aparece: a nota pode não estar autorizada, o canal pode não oferecer envio ou a venda pode não ter origem externa reconhecida.
  • Autorização expirada: reconecte a conta em Configurações > Vínculo e Integração.
  • Canal já tem a nota: não reenvie; confirme se o documento nasceu no próprio marketplace.

Como confirmar

O retorno deve informar sucesso ou o motivo da falha. Atualize o pedido e verifique a coluna de XML, a origem, a venda vinculada e a situação fiscal antes de tentar novamente. O estado Enviado evita reenvio; Falhou exige correção; Não se aplica e Chave capturada têm significados próprios.

Próximo passo

Para entender todos os estados e mensagens, consulte Conferir a coluna XML marketplace. Para um lote já pendente, siga Enviar XML ao marketplace em massa.

Revisado em: 31/07/2026.

Esse artigo foi útil?

Obrigado pelo retorno!

Sem problemas — fale direto com o nosso suporte que a gente resolve com você:

(32) 3721-6702