Pular para o conteúdo
Axiom connect

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
Ilustração isométrica de um documento com selo viajando entre um prédio de ERP, uma caixa de papelão e uma pequena loja

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 nasceO que precisa entrarO que precisa sair
No ERP ou num emissor da empresaO pedido, com cliente, itens, valores e freteA nota, de volta ao canal de venda
No próprio canal (alguns marketplaces emitem)A nota, para o pedido e para o ERPNormalmente 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.

Ilustração isométrica de uma mesa de expedição com uma caixa de papelão fechada, uma folha com um selo oficial presa com clipe sobre a tampa, um carimbo e uma pequena pilha de pastas ao lado
A nota acompanha a mercadoria: sem ela, o pacote não sai.

Por que guardar o XML junto do pedido?

Parece detalhe, mas resolve três problemas de uma vez.

  1. 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.
  2. 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.
  3. 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

Entregue
  1. Pendente
  2. Pago
  3. Faturado
  4. Despachado
  5. 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.

eventos da integração · exemplo ao vivo
  1. 14:02:07 pedido recebido Mercado Livre #2000012841 ✓
  2. 14:02:08 estoque reservado CAM-AZ-M · Filial Centro ✓
  3. 14:05:11 nota autorizada NF-e 12.345 ✓
  4. 14:05:12 envio ao ERP ERP indisponível · nova tentativa em 30 s ↻
  5. 14:05:12 alerta aberto ERP indisponível · pedido #2000012841 ↻
  6. 14:05:42 envio ao ERP NF-e 12.345 registrada ✓
  7. 14:05:42 alerta fechado resolvido pela nova tentativa ✓
  8. 14:07:03 pedido recebido VTEX #1093421-01 · Filial Moema ✓
  9. 14:07:15 envio ao canal credencial vencida · alerta aberto ↻
  10. 14:09:02 credencial renovada reprocessando 1 envio, na ordem ⇄
  11. 14:09:03 envio ao canal rastreio devolvido · alerta fechado ✓
  12. 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.

Sua operação inteira, conectada num hub só.

Conte quais canais e qual ERP a sua empresa usa. A gente mostra o Axiom rodando com eles e monta o plano de implantação.

  • Implantação acompanhada
  • Configuração por filial
  • Sem trocar de ERP