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.
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
- Abra Entradas > Pedidos Externos e clique na engrenagem.
- Localize Enviar XML automaticamente ao marketplace.
- Leia o escopo da opção e salve somente se o processo da empresa já estiver validado.
- Acompanhe os primeiros pedidos para confirmar o retorno do canal.
2. Faça o envio manual quando a ação estiver disponível
- Abra a lista de Vendas e localize a venda de origem externa.
- Confirme que a NF-e está autorizada e que a chave pertence à venda.
- Em Ações, escolha o envio de XML apresentado para o canal.
- Confirme uma vez e leia a mensagem de retorno.
3. Siga a ordem correta antes de qualquer envio
- Sincronize e confira: confirme origem, itens, comprador, valores e situação do pedido externo.
- Converta com segurança: o pedido precisa apontar para uma única venda correta antes de existir documento para o canal.
- Emita e autorize: o XML só é elegível depois da NF-e autorizada pelo fluxo fiscal normal.
- Comunique ao marketplace: use envio individual, em massa ou automático de acordo com o canal e a regra configurada.
- Confira o retorno: deixe a coluna XML marketplace visível e trate somente os pedidos que continuam pendentes ou falharam.
| Necessidade | Fluxo 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. |
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