Tecnologia e automação fiscal

Como funciona a integração entre sistema de vendas e nota fiscal

A venda acontece na loja virtual, no marketplace, na plataforma de cursos ou no balcão. A nota fiscal sai de outro sistema. No meio, alguém exporta pedidos, copia dados e confere planilhas. Integrar vendas e emissor fecha essa lacuna, mas só funciona bem quando cada etapa do caminho está clara.

Publicado em 16/10/2026 · Equipe FazNota

Vender em mais de um canal virou regra para pequenas empresas: loja virtual, um ou dois marketplaces, Instagram com link de pagamento, balcão. Cada canal tem o seu painel de pedidos. A nota fiscal, porém, precisa sair de um emissor só, com o cadastro fiscal correto e a numeração em sequência. Este artigo explica como funciona o caminho da venda até o XML, quais tipos de integração existem e onde costumam aparecer os problemas.

O caminho da venda até o XML

Independentemente do canal, o fluxo de uma venda integrada passa pelas mesmas etapas:

1. Venda: o cliente fecha o pedido no canal (loja, marketplace, plataforma, PDV).
2. Pagamento: o gateway ou a maquininha aprova. Esse costuma ser o gatilho da nota.
3. Envio ao emissor: o canal, ou a integração, manda ao emissor cliente, itens, valores, frete, descontos e forma de pagamento.
4. Regra fiscal: o emissor aplica o que está cadastrado para cada produto ou serviço (NCM, CFOP, CST ou CSOSN, código de serviço, retenções e, no regime regular, IBS e CBS).
5. Autorização: o emissor assina e transmite à Sefaz ou ao ambiente da NFS-e.
6. Retorno ao canal: chave de acesso, XML e PDF voltam para o pedido. Em e-commerce, a chave da NF-e libera a etiqueta de envio.
7. Efeitos internos: baixa no estoque, lançamento no financeiro e XML disponível para o contador.

Quando uma dessas etapas é manual, ela vira gargalo e fonte de erro. A integração automatiza da 3 à 6; a 7 depende de o emissor também cuidar de estoque e financeiro.

Qual documento sai de cada canal

Esses são os casos mais comuns, não regras absolutas: o documento correto depende da natureza do que é vendido, do regime e do estado ou município. Confirme o enquadramento com o seu contador.

Tipos de integração

Integração pronta

O emissor já tem conector com a plataforma: você autoriza o acesso, configura o gatilho e as regras, e os pedidos começam a virar nota. É o caminho mais rápido para quem usa plataformas conhecidas de e-commerce, marketplace ou infoproduto. A integração com a Tray é um exemplo. Ao configurar, confira três pontos: qual status do pedido dispara a nota (pago, faturado, enviado), como o conector trata pedidos com produtos e serviços misturados e se o cancelamento no canal é refletido no emissor ou precisa ser feito à mão.

Integração por API

Para sistemas próprios ou de nicho, o sistema de vendas chama a API do emissor. Exige desenvolvimento, mas dá controle total sobre o momento e os dados. Os critérios para escolher estão em API fiscal: o que é e como integrar.

Importação de arquivos

Planilha ou arquivo exportado do canal e importado no emissor. É melhor que digitar, mas continua manual, sujeito a atraso e a esquecimento. Serve como transição.

PDV e emissor no mesmo sistema

No balcão, a melhor integração é não precisar de integração: a venda é registrada e a nota emitida na mesma tela, com o mesmo cadastro.

Onde a integração costuma falhar

• Cadastro de produto incompleto no canal. O produto foi criado na loja sem NCM ou com SKU diferente do emissor. A nota é rejeitada ou sai com o item errado. Defina o SKU como chave entre os sistemas e mantenha os dados fiscais em um só lugar.
• Endereço e documento do cliente. CPF inválido, CEP que não confere com a cidade, falta de número. Valide no checkout, não na nota.
• Frete e desconto rateados de forma diferente. O total da nota não bate com o total do pedido por centavos. Confirme como o conector distribui frete e desconto entre os itens.
• Pedido duplicado. A plataforma reenvia o aviso de pagamento e o emissor gera duas notas. Uma boa integração usa o número do pedido como identificador único.
• Cancelamento e reembolso esquecidos. O reembolso é feito no canal e a nota continua válida. Veja reembolso, chargeback e cancelamento de nota no e-commerce.
• Leiaute desatualizado. Com a reforma tributária, o grupo de IBS e CBS passou a ser exigido na NF-e e na NFC-e do regime regular para fatos geradores a partir de 03/08/2026, e para o Simples Nacional a partir de 01/01/2027, segundo o Ato Conjunto RFB/CGIBS 4/2026. Manter o leiaute em dia é responsabilidade do emissor; manter a classificação dos produtos é da empresa.

Um dia de vendas integrado, na prática

Considere uma pequena empresa fictícia que vende cosméticos na loja virtual própria, em um marketplace e no balcão. Num dia comum, entram 30 pedidos on-line e 40 vendas no balcão.

Sem integração, alguém abre o painel da loja e o do marketplace, copia os pedidos pagos para o emissor, confere o frete de cada um e emite 30 NF-e. No balcão, a venda é registrada num caixa e o cupom sai de outro sistema, quando sai. No fim do mês, o estoque não bate com o que foi vendido e o contador recebe uma pasta incompleta de XMLs.

Com integração, os 30 pedidos viram NF-e conforme os pagamentos são aprovados, cada um com a chave gravada no pedido para liberar a etiqueta. As 40 vendas do balcão saem com NFC-e no PDV. O estoque é um só e baixa a cada venda, de qualquer canal. A rotina passa a ser olhar a lista de exceções: um CEP inválido, uma rejeição por cadastro, um reembolso para tratar.

O XML depois da venda

O XML autorizado é o documento fiscal de verdade; o PDF é só a representação. Ele precisa ser guardado pelo prazo legal e chegar ao contador para a escrituração. Numa integração bem feita, o emissor mantém todos os XMLs, de todos os canais, num único lugar, com busca por período, cliente e pedido. Os prazos de guarda estão em por quanto tempo guardar o XML.

Por que a integração importa ainda mais a partir de 2027

Dois movimentos aumentam o peso do documento fiscal correto. Primeiro, na reforma tributária, o crédito de IBS e CBS do comprador fica condicionado a documento fiscal eletrônico idôneo, segundo a Lei Complementar 214/2025 (art. 47). Cliente empresa vai cobrar nota certa e no prazo. Segundo, para o Simples Nacional, a imprensa especializada informa que a Resolução CGSN 190/2026 passa a considerar o faturamento pela emissão do documento fiscal. Venda sem nota, ou nota emitida muito depois, distorce a apuração.

Checklist para integrar

1. Liste todos os canais de venda e o documento fiscal de cada um.
2. Defina, com o contador, o gatilho de emissão por canal.
3. Padronize SKU e cadastro fiscal dos produtos e serviços.
4. Conecte um canal por vez, começando pelo de maior volume.
5. Acompanhe as primeiras semanas: rejeições, divergências de valor, pedidos sem nota.
6. Defina o tratamento de reembolsos e cancelamentos.
7. Garanta que os XMLs cheguem ao contador todo mês. Veja como enviar notas e relatórios ao contador.

Com a integração no lugar, o trabalho fiscal deixa de ser emitir e passa a ser acompanhar exceções. A página de soluções para e-commerce mostra como isso funciona para lojas virtuais.

Conteúdo informativo, escrito com base nas normas vigentes na data de publicação. Regras fiscais mudam e variam por estado, município, atividade e regime tributário: confirme a aplicação no seu caso com o seu contador.