Integração de nota fiscal com loja virtual e ERP

A integração de nota fiscal com loja virtual e ERP é a ligação entre o pedido feito na loja, o sistema de gestão que guarda produtos e estoque e o emissor que transmite a NF-e para a SEFAZ. Ela funciona quando o cadastro fiscal e a regra de tributação são definidos antes e conferidos pelo contador; sem isso, a automação só emite nota errada mais rápido.

Como funciona a integração de nota fiscal com loja virtual e ERP

O fluxo típico tem quatro peças. A loja virtual ou o marketplace recebe o pedido e o pagamento. O ERP recebe o pedido, baixa o estoque e monta a nota com os dados do produto e do cliente. O emissor, que pode estar dentro do ERP, assina e transmite a nota. A SEFAZ devolve a autorização, e o XML e o DANFE voltam para o ERP e para a loja.

A base legal da NF-e é o Ajuste SINIEF 07/05, do CONFAZ. A cláusula primeira institui a NF-e, modelo 55, e define que a validade jurídica dela vem de uma assinatura eletrônica qualificada e da autorização de uso da administração tributária. Na prática, sem certificado digital e sem autorização da SEFAZ, não existe nota, só um arquivo.

Passo 1: credenciamento e certificado antes de qualquer integração

A cláusula segunda do Ajuste SINIEF 07/05 diz que, para emitir NF-e, o contribuinte precisa estar previamente credenciado na unidade federada em que tem inscrição estadual. Isso vem antes de qualquer conversa com o fornecedor do ERP. O caminho está em Credenciamento para emitir NF-e como fazer em São Paulo, passo a passo.

Depois vem o certificado digital da empresa, que assina as notas. Se o ERP fica na nuvem, ele vai pedir o arquivo do certificado instalado no servidor dele. Combine quem guarda o arquivo, quem sabe a senha e quem avisa quando o certificado estiver perto de vencer.

Diagnóstico WJR, gratuito e sem compromisso

Chama no WhatsApp, conta o que te incomoda e a gente responde em algumas horas.

Quero meu Diagnóstico WJR

Passo 2: cadastro fiscal de cada produto

O ERP só monta a nota certa se cada produto tiver os campos fiscais preenchidos e conferidos:

NCM, a classificação do produto na nomenclatura do Mercosul, que define tratamento de ICMS e outros tributos. Veja NCM: o que é, onde consultar e como classificar o produto na nota.
Origem da mercadoria, nacional ou importada.
Unidade, peso e código de barras, que o marketplace também usa.
CEST, quando o produto estiver sujeito a substituição tributária.

O erro mais caro é importar a planilha do fornecedor com NCM errado e espalhar o erro em centenas de notas. Vale revisar os itens mais vendidos primeiro, um a um.

Passo 3: regra de tributação no ERP

A regra de tributação diz ao sistema qual CFOP, qual código de situação tributária e qual alíquota usar em cada tipo de venda. Ela muda conforme o regime da empresa, o estado do cliente e o tipo de cliente:

venda dentro do estado ou para outro estado, que muda o CFOP e o ICMS (veja Nota fiscal interestadual: como vender de São Paulo para outro estado);
empresa do Simples, que usa CSOSN, ou fora do Simples, que usa CST (veja CST e CSOSN na nota fiscal: o que cada código diz e qual a sua empresa usa);
consumidor final ou revendedor;
produto com substituição tributária ou sem.

O CFOP de cada operação está explicado em CFOP: o que é, o que cada dígito diz e como escolher o código certo. Essas regras devem ser montadas ou validadas pelo contador e documentadas. Quando a regra muda, por exemplo com a reforma tributária, alguém precisa atualizar o ERP no dia certo.

Passo 4: o gatilho de emissão

Defina em que momento a nota sai: na confirmação do pagamento, na separação do pedido ou no despacho. Cada escolha tem efeito em cancelamento, estoque e prazo. A discussão completa está em Quando emitir nota fiscal na loja virtual pedido pago ou enviado?.

Regras práticas que evitam retrabalho:

Não emitir antes de o pagamento ser aprovado em compras com risco de fraude.

Bloquear a emissão quando faltar dado do cliente, como CPF ou endereço completo.

Separar pedidos que precisam de conferência humana, como venda para empresa.

Registrar no pedido o número e a chave da nota autorizada.

Passo 5: retorno do XML para a loja e para o marketplace

Em muitos marketplaces, o vendedor precisa informar a nota do pedido para liberar a etiqueta de envio. A integração deve devolver a chave e o XML para a plataforma automaticamente. Quando isso falha, o pedido trava, e a tentação é emitir outra nota, o que gera duplicidade.

Guarde os XML autorizados em local próprio, fora do ERP também. Se trocar de sistema, os arquivos continuam com a empresa.

Passo 6: cancelamento, devolução e troca dentro do fluxo

A integração precisa prever o caminho de volta. Pedido cancelado depois da nota, devolução do cliente e troca de produto têm documentos próprios, e cada um precisa aparecer no ERP e no estoque. Teste esses fluxos antes de colocar a integração em produção, não depois da primeira devolução.

Passo 7: conciliação mensal

Uma vez por mês, compare três números: pedidos faturados na loja, notas autorizadas no ERP e valores recebidos da plataforma ou do meio de pagamento. Divergência entre eles costuma apontar nota que não saiu, nota em duplicidade ou venda cancelada sem cancelamento da nota. A escolha do sistema pesa nesse ponto, e os critérios estão em ERP para pequena empresa: o que um sistema de gestão resolve e como escolher o seu.

Erros comuns na integração

Copiar a regra de tributação de outra empresa ou do modelo padrão do ERP.
Deixar o certificado vencer sem aviso e parar todas as vendas.
Emitir nota de produto para serviço, que tem nota municipal própria.
Usar o cadastro do fornecedor sem conferir NCM e origem.
Não testar devolução e cancelamento.

Para quem é MEI, a lógica de emissão é diferente e mais simples; o assunto está em Nota fiscal de MEI para empresa: o que o cliente pessoa jurídica exige. Para lojas em operação, o panorama do setor fica em Contabilidade para e-commerce: o que a sua loja precisa acertar.

Como a WJR ajuda

A WJR é um escritório de contabilidade na Mooca, em São Paulo, com mais de 30 anos de experiência e atendimento presencial e online (Quem somos: a WJR Contabilidade, na Mooca desde 1995). O primeiro passo é o Diagnóstico WJR, gratuito e sem compromisso, com resposta em algumas horas. Mais sobre o tema em Emissor de nota fiscal para a sua empresa emitir sem erro.

Perguntas frequentes

Preciso de ERP para emitir nota na loja virtual?+

Não obrigatoriamente. Lojas pequenas emitem por um emissor avulso. O ERP passa a compensar quando o volume de pedidos torna a digitação manual lenta e sujeita a erro.

Quem é responsável se o ERP emitir nota errada?+

A empresa emitente. O sistema executa a regra que recebeu, e a responsabilidade pelo documento é de quem o emite. Por isso a regra de tributação precisa ser validada e documentada.

O certificado digital fica com o fornecedor do ERP?+

Em sistemas na nuvem, o arquivo do certificado costuma ser instalado no servidor do fornecedor. Combine por contrato quem guarda o arquivo e a senha e como o acesso é retirado se o contrato acabar.

A integração resolve a nota de serviço também?+

Nem sempre. Serviço usa NFS-e, emitida em outro ambiente. Se a loja vende serviço junto com produto, confirme se o ERP emite os dois documentos.

Com que frequência devo revisar a regra de tributação?+

Sempre que mudar o regime da empresa, entrar um produto novo ou mudar a legislação, e pelo menos uma vez por ano. Reforma tributária e mudança de alíquota pedem revisão antes da data de vigência.

Integração de nota fiscal com loja virtual e ERP: como montar o fluxo certo