Envio automático de XML ao marketplace

Objetivo: configurar o envio automático do XML após a autorização fiscal de pedidos externos compatíveis. Resultado esperado: o canal recebe o documento sem um segundo clique, enquanto a equipe continua acompanhando o resultado pela lista.

Quando o envio automático acontece

Com a opção ativa, o C Controle tenta informar o XML ao marketplace depois que a NF-e de um Pedido Externo compatível é transmitida e autorizada. A regra não gera a NF-e, não autoriza uma nota pendente e não transforma pedido em venda.

A configuração atual descreve o disparo automático para Mercado Livre, Shopee, WooCommerce e Magalu. Para outros canais, não presuma o mesmo comportamento: confira a coluna de XML e siga o fluxo manual ou em massa quando a integração o oferecer.

1. Ative a regra com segurança

1. Abra Entradas > Pedidos Externos e selecione a engrenagem.
2. Em Integrações fiscais, localize Enviar XML automaticamente ao marketplace.
3. Ative somente depois de validar manualmente um pedido de cada canal que sua empresa opera.
4. Salve e registre internamente quem será responsável por acompanhar as primeiras notas enviadas.

2. Entenda a sequência completa

1. O canal sincroniza um pedido externo.
2. A equipe vincula produtos, revisa cliente, pagamento e estoque e converte o pedido em venda.
3. A empresa emite a NF-e pelo processo fiscal aplicável e a nota fica autorizada.
4. O C Controle dispara a tentativa de comunicação do XML ao canal compatível.
5. O operador confere o retorno em XML marketplace e trata somente os itens que não chegaram a um estado final.

3. Confira o retorno depois da autorização

1. Volte a Pedidos Externos e abra Colunas.
2. Marque XML marketplace para não depender somente de mensagens momentâneas da emissão.
3. Procure o pedido recém-faturado. O estado esperado é Enviado; se houver horário exibido, ele corresponde à tentativa registrada.
4. Se aparecer Falhou, leia a mensagem antes de usar envio em massa ou individual. Repetir sem corrigir a causa normalmente repete o erro.

Situações que não disparam o envio

• Venda ainda sem NF-e autorizada: a prioridade é concluir a etapa fiscal, não reenviar XML.
• Pedido não convertido: não existe venda e nota a serem comunicadas.
• Canal fora do escopo da opção: use a coluna e o artigo de lote para saber se há ação manual disponível.
• NF-e do próprio marketplace: não emita ou envie outra nota apenas para forçar um status; valide o cenário fiscal do canal.
• Falha de integração: reconecte ou trate a autorização antes de tentar novamente.

Como confirmar

Não considere a configuração concluída apenas porque o interruptor ficou ligado. Confirme, em uma amostra real autorizada, que a coluna passa para Enviado. Para entender os outros estados, consulte Conferir a coluna XML marketplace.

Próximo passo

Se houver notas anteriores para tratar, siga Enviar XML ao marketplace em massa. O lote continua sendo uma ação diferente da automação futura.

Revisado em: 31/07/2026.