Fiscal 6 min de leitura
Nota fiscal no e-commerce: o caminho da NF-e do pedido ao marketplace
Nota fiscal no e-commerce multicanal: onde a NF-e nasce, por que guardar o XML no pedido, como devolver a nota ao marketplace e por que ela trava o despacho.
Equipe Axiom connect 6 min
A nota fiscal no e-commerce é a NF-e emitida a cada venda de mercadoria. Quando a loja vende em vários canais, essa nota precisa estar em três lugares ao mesmo tempo: no pedido, com o XML; no ERP, para o fiscal e o estoque; e no canal de venda, para o cliente e para o despacho. Se faltar em qualquer um deles, o pedido para. Este guia mostra o caminho completo da NF-e, do momento em que ela nasce até o cancelamento, e os pontos onde ela costuma travar.
O que muda na nota fiscal no e-commerce multicanal?
Numa loja só, com um emissor só, o caminho é curto: o pedido chega, alguém fatura, a nota sai. No multicanal, há pedidos de marketplaces e de lojas virtuais, cada canal com o próprio jeito de receber a nota, e um ERP que precisa registrar tudo.
Três fatos ajudam a organizar a conversa:
- A NF-e é o XML. O documento fiscal é o arquivo eletrônico assinado e autorizado pela SEFAZ, identificado pela chave de acesso. PDF e DANFE são representações dele.
- A nota pertence a um pedido. Número, série e chave precisam estar ligados ao pedido certo. É isso que permite conciliar, atender o cliente e tratar devoluções.
- Cada sistema precisa de uma parte da informação. O ERP quer o documento completo. O canal normalmente quer saber que o pedido foi faturado e com qual nota.
Onde a NF-e nasce: no ERP ou no canal de venda?
A primeira decisão é quem emite. Existem dois modelos, e muitas operações usam os dois ao mesmo tempo.
| Onde a nota nasce | O que precisa entrar | O que precisa sair |
|---|---|---|
| No ERP ou num emissor da empresa | O pedido, com cliente, itens, valores e frete | A nota, de volta ao canal de venda |
| No próprio canal (alguns marketplaces emitem) | A nota, para o pedido e para o ERP | Normalmente nada: o canal já tem a nota |
No primeiro modelo, o ERP precisa receber o pedido completo e correto antes de faturar. No segundo, o risco se inverte: a nota existe no canal, mas o ERP não sabe dela. O estoque e o fiscal ficam desalinhados até alguém importar o XML.
A regra prática é simples: um emissor por canal, decidido e documentado. Dois emissores para o mesmo pedido geram nota em duplicidade, que depois precisa ser cancelada.

Por que guardar o XML junto do pedido?
Parece detalhe, mas resolve três problemas de uma vez.
- Prova e consulta. O XML é o documento com validade fiscal. Quando o atendimento, o financeiro ou a contabilidade precisam da nota, ela está ao lado do pedido que a originou, e não perdida numa pasta compartilhada.
- Vínculo confiável. A chave de acesso identifica a nota sem ambiguidade. Usar a chave, e não só o número, evita confundir notas de séries ou emitentes diferentes.
- Ordem dos eventos. Em integrações, a nota pode chegar antes do pedido. Com o vínculo pela chave, ela espera e é anexada quando o pedido aparece.
Como a NF-e volta ao marketplace e à loja virtual?
Quando a nota nasce no ERP, ela precisa voltar ao canal. Na NF-e para marketplace e loja virtual, o que costuma voltar é o mínimo para o canal saber que o pedido foi faturado: número, série, chave de acesso e, em alguns casos, o próprio XML ou um link para a nota.
Esse retorno muda a situação do pedido no canal e libera as etapas seguintes: despacho e rastreio, que também precisam voltar ao canal.
Pedido #SH-10482
Exemplo · 1 item · R$ 219,90
- Pendente
- Pago
- Faturado
- Despachado
- Entregue
Repare na ordem: pago, faturado, despachado, entregue. O faturamento fica no meio do caminho, e é por isso que uma nota atrasada atrasa todo o resto.
Por que a nota fora de sincronia trava o despacho?
A mercadoria circula acompanhada do documento fiscal. Sem nota autorizada, o pacote não deveria sair do depósito, e a transportadora precisa do DANFE para coletar. Quando a nota existe num sistema e não no outro, aparecem sintomas conhecidos:
- Pedido pago há horas sem nota no canal. O ERP faturou, mas o retorno ao canal falhou. Para o cliente, nada aconteceu.
- Nota no canal, nada no ERP. A nota nasceu no marketplace e não foi importada. O estoque e o fiscal da empresa ficam desatualizados.
- Faturamento parado por falta de mercadoria. Se o estoque não cobre o pedido, ele não deveria ser faturado. O certo é registrar a falta e segurar o faturamento até resolver. Veja como evitar venda furada no estoque multicanal.
- Envio que falhou em silêncio. O ERP estava fora do ar, a credencial venceu, um cadastro faltava. Ninguém soube, ninguém reenviou.
O último caso é o mais caro, porque não aparece em lugar nenhum. A defesa é tratar falha de envio como evento: guardar, tentar de novo e avisar quem pode resolver — e monitorar pedidos pagos sem nota além do tempo normal da operação. O lado técnico está em como não perder pedidos na integração.
- 14:02:07 pedido recebido Mercado Livre #2000012841 ✓
- 14:02:08 estoque reservado CAM-AZ-M · Filial Centro ✓
- 14:05:11 nota autorizada NF-e 12.345 ✓
- 14:05:12 envio ao ERP ERP indisponível · nova tentativa em 30 s ↻
- 14:05:12 alerta aberto ERP indisponível · pedido #2000012841 ↻
- 14:05:42 envio ao ERP NF-e 12.345 registrada ✓
- 14:05:42 alerta fechado resolvido pela nova tentativa ✓
- 14:07:03 pedido recebido VTEX #1093421-01 · Filial Moema ✓
- 14:07:15 envio ao canal credencial vencida · alerta aberto ↻
- 14:09:02 credencial renovada reprocessando 1 envio, na ordem ⇄
- 14:09:03 envio ao canal rastreio devolvido · alerta fechado ✓
- 14:11:19 pedido entregue Nuvemshop #NS-5521 · loja atualizada ✓
Cancelamento da nota fiscal no e-commerce: o caminho de volta
Cancelar uma NF-e é registrar um evento de cancelamento na SEFAZ, dentro do prazo que a legislação permite. Fora dele, o tratamento é outro e deve ser alinhado com a contabilidade. Do ponto de vista da integração, o cancelamento precisa percorrer o mesmo caminho da emissão:
- o pedido passa a mostrar a nota como cancelada;
- o ERP registra o cancelamento, para o fiscal e o estoque;
- o canal é avisado, para não exibir uma nota que não vale mais.
Outros eventos, como a carta de correção, também ficam ligados à nota e devem estar visíveis no pedido. Devoluções geram documentos próprios, que precisam apontar para o pedido original.
Como fazer essa integração com o Axiom connect
No Axiom connect, NF-e e NFS-e ficam no pedido com o XML. A nota é registrada no ERP — no Linx, por exemplo, as notas fiscais voltam para o ERP — e devolvida ao canal de venda: Shopify e Nuvemshop recebem a nota, o despacho e a entrega. Do Mercado Livre, as notas emitidas por lá entram junto com os pedidos. Uma nota que chega antes do pedido espera por ele, e só nota autorizada é anexada. O cancelamento segue o mesmo caminho.
Se o ERP ou o canal não responde, o envio é refeito sozinho, na ordem, e vira alerta com o motivo até dar certo. Veja os detalhes em notas fiscais e reprocessamento e alertas, e como isso funciona por canal na integração Mercado Livre com ERP e na integração Linx com e-commerce.
Quer ver o caminho da nota na sua operação? Fale com a gente.
Perguntas frequentes
Quem emite a nota fiscal de uma venda feita no marketplace?
Quem vende. O marketplace intermedeia a venda, mas a nota é do vendedor. Mesmo quando o canal oferece uma ferramenta de emissão, a responsabilidade pelo documento continua sendo do lojista.
Qual a diferença entre NF-e, XML e DANFE?
A NF-e é o documento fiscal eletrônico, e o XML é o arquivo que o contém, assinado e autorizado. O DANFE é uma representação impressa que acompanha a mercadoria e não substitui o XML.
O que fazer quando a NF-e é rejeitada pela SEFAZ?
Uma nota rejeitada não tem validade. É preciso corrigir o dado apontado na rejeição — em geral, cadastro ou tributação — e transmitir de novo. Até a autorização, ela não deve ser anexada ao pedido nem enviada ao canal.
Quando o e-commerce precisa emitir NFS-e?
Quando vende serviço, como instalação ou montagem. A NFS-e é a nota de serviço, de competência municipal, e é emitida separada da NF-e da mercadoria.