Enviar XML ao marketplace em massa

Objetivo: enviar, em uma única operação assistida, o XML das NF-e já autorizadas para pedidos externos elegíveis. Resultado esperado: cada pedido selecionado recebe um resultado claro de enviado, pulado ou erro, sem reenviar XML que o canal já registrou.

O que este lote faz — e o que ele não faz

O lote usa a mesma lógica do envio individual da venda para comunicar uma NF-e AUTORIZADA ao canal. Ele é voltado aos pedidos de Mercado Livre, Shopee, Tray, WooCommerce, Magalu e Nuvemshop descritos na configuração da tela.

1. Habilite a ação em massa uma única vez

1. Em Entradas > Pedidos Externos, abra a engrenagem.
2. Na área de ferramentas de produtividade, ative Enviar XML ao marketplace em massa e salve.
3. Retorne à lista. A barra de ações passa a exibir o botão Enviar XML ao marketplace quando houver pedidos elegíveis selecionados.
4. Se a opção não aparecer, confirme se você está no perfil administrador e na empresa correta.

2. Prepare a lista antes de selecionar

1. Em Colunas, marque XML marketplace. Esta leitura evita selecionar documentos que já foram enviados ou que não se aplicam.
2. Filtre o canal, a situação do pedido e o período que deseja tratar. Trabalhe com uma amostra pequena na primeira utilização.
3. Para cada linha, confira a venda vinculada e a situação da NF-e. O pedido precisa estar convertido e a nota precisa estar autorizada.
4. Selecione somente linhas com estado Pendente ou Falhou depois de entender o motivo da falha.

3. Execute o lote e aguarde o resumo

1. Depois de selecionar, clique em Enviar XML ao marketplace.
2. Leia a confirmação: o sistema avisa que usará somente XML de notas já autorizadas e que itens já atendidos serão ignorados.
3. Confirme uma vez e mantenha a página aberta até terminar. Cada pedido exige uma chamada ao canal.
4. O processamento é dividido em grupos de até 5 pedidos. Quando restarem itens por limite de tempo, a tela continua com o próximo grupo; não clique novamente apenas porque há muitos selecionados.
5. Ao fim, leia o resumo por pedido. Uma falha não interrompe os outros pedidos do grupo.

Como interpretar o resultado do lote

Erros que parecem problema de lote, mas não são

• Pedido ainda não convertido: conclua a conferência de produto, cliente, pagamento e estoque e gere a venda primeiro.
• NF-e não autorizada: acompanhe a emissão fiscal; o XML só pode ser comunicado depois da autorização.
• Nota emitida pelo próprio canal: a linha pode aparecer como Não se aplica; não envie uma segunda NF-e sem validar o processo fiscal da empresa.
• Token ou integração com erro: trate a conexão do canal antes de repetir vários pedidos, para não produzir a mesma falha em sequência.
• Pedido já enviado: o lote o pula por segurança. Use o envio individual apenas se houver motivo comprovado para um reenvio.

Como confirmar

Atualize a página, mantenha a coluna XML marketplace visível e confira o estado de cada linha. Para uma investigação completa de estados e mensagens, consulte Conferir a coluna XML marketplace.

Próximo passo

Quando o processo estiver validado para os canais compatíveis, avalie Envio automático de XML ao marketplace. Isso não elimina a necessidade de acompanhar os primeiros retornos.

Revisado em: 31/07/2026.