Grupo W3 — página inicial do blog
Pagamentos

Como configurar IBS e CBS na NF-e do seu e-commerce

Passo a passo para parametrizar seu ERP e checkout para a emissao da NF-e com IBS e CBS sem travar a operacao das suas vendas.

Por Equipe W39 min de leitura

Ao seguir a implementação de IBS e CBS no e-commerce passo a passo, sua operação sairá do processo com a base de dados do ERP higienizada, as regras de checkout ajustadas e a emissão de NF-e homologada na SEFAZ. A adequação à Reforma Tributária não trava na atualização do software do emissor fiscal. As empresas de software entregam os campos do XML prontos em atualizações de rotina. A falha real ocorre nos dados que você insere neles: cadastros de produtos com NCM desatualizada, regras tributárias divergentes entre a loja virtual e o ERP e payloads incompletos enviados ao gateway de pagamento.

Para estruturar essa transição na operação sem interromper o faturamento diário, a execução precisa seguir cinco fases organizadas por ordem de dependência:

  1. Auditando o cadastro de NCM e CST no sistema de gestão
  2. Atualizando a estrutura XML do emissor de Nota Fiscal Eletrônica
  3. Sincronizando as regras do checkout com o motor de cálculo fiscal
  4. Homologando a emissão em lote antes do prazo obrigatório
  5. O erro mais comum na transição e a validação final com a contabilidade

Auditando o cadastro de NCM e CST no sistema de gestão

O motor de cálculo do ERP calcula impostos com base na Nomenclatura Comum do Mercosul (NCM) e no Código de Situação Tributária (CST) atribuídos a cada SKU. Se o cadastro contiver códigos extintos ou desalinhados das tabelas publicadas no Portal da NF-e, o sistema aplicará alíquotas incorretas de Imposto sobre Bens e Serviços (IBS) e Contribuição sobre Bens e Serviços (CBS).

A fase de transição da Reforma Tributária estipula a alíquota de teste de 0,9% para a CBS e 0,1% para o IBS. Determinadas categorias de produtos possuem regimes diferenciados com redução de alíquota ou isenção integral, conforme os anexos da Lei Complementar nº 206/2024. Se um produto da sua loja se enquadra em alíquota reduzida mas está cadastrado com NCM genérica, a nota sairá tributada pela alíquota cheia, gerando pagamento indevido e perda de margem de contribuição no ato da venda.

Priorize a revisão pela Curva A de faturamento. Exporte do ERP a lista dos SKUs que correspondem a 80% do volume de vendas acumulado nos últimos 12 meses.

Para cada item da Curva A, cruze a NCM cadastrada com a Tabela de NCMs e Alíquotas do IBS/CBS disponibilizada pela Receita Federal. Substitua CSTs legados pelos novos códigos de tributação do modelo dual (IBS/CBS), mapeando se o item terá incidência padrão, tributação concentrada (monofásica) ou imunidade.

Critério de conclusão: 100% dos produtos da Curva A revisados no ERP, com NCM ativa verificada na tabela da Receita Federal e CST do regime regular devidamente atribuído.


Atualizando a estrutura XML do emissor de Nota Fiscal Eletrônica

A Secretaria da Fazenda ajustou o leiaute da NF-e para comportar os grupos de tributação do IBS e da CBS. As mudanças estão detalhadas na Nota Técnica 2024.002 (e suas atualizações posteriores) no Portal da NF-e. O emissor de nota precisa estruturar essas tags corretamente no XML para evitar a rejeição do lote na SEFAZ.

As alterações exigem a criação do grupo de tags <IBSCBS> dentro do detalhamento de cada item (<det>), contendo a base de cálculo, a alíquota e o valor apurado do IBS estadual, do IBS municipal e da CBS federal.

<!-- Exemplo de estrutura simplificada das novas tags no item -->
<imp>
  <IBSCBS>
    <vBCIBSCBS>100.00</vBCIBSCBS>
    <gIBSUF>
      <pIBSUF>0.1000</pIBSUF>
      <vIBSUF>0.10</vIBSUF>
    </gIBSUF>
    <gCBS>
      <pCBS>0.9000</pCBS>
      <vCBS>0.90</vCBS>
    </gCBS>
  </IBSCBS>
</imp>

Se o produto usufruir de benefício fiscal de transição, o campo do Código de Benefício Fiscal (cBenef) deve ser informado obrigatoriamente no mesmo bloco. Emissores que utilizam rotinas customizadas via API precisam ajustar o payload de envio para incluir esses nós XML antes de acionar o ambiente de homologação.

Acesse o painel do seu emissor fiscal ou ERP, atualize os esquemas de validação XML para a versão vigente e acione o ambiente de testes da SEFAZ (homologação). Gere uma nota fiscal de teste para um produto da Curva A.

Critério de conclusão: Arquivo XML retornado do ambiente de homologação da SEFAZ com status de autorização (Código 100), sem erros de schema ou ausência de tags obrigatórias do grupo <IBSCBS>.


Sincronizando as regras do checkout com o motor de cálculo fiscal

O erro que gera divergência financeira no e-commerce ocorre na comunicação entre o checkout, o gateway de pagamento e o ERP. Se o checkout calcular o frete ou desconto de forma inconsistente em relação à base de cálculo do IBS e da CBS, a nota fiscal gerada no ERP terá valor diferente do pedido capturado no meio de pagamento.

O IBS e a CBS incidem sobre o valor total da operação, o que inclui o preço do produto somado ao frete e despesas acessórias, deduzidos os descontos incondicionais (aplicados diretamente no carrinho).

Base de Cálculo (IBS/CBS) = (Valor dos Produtos + Frete + Despesas) - Descontos Incondicionais

Ao exibir os tributos ao consumidor no checkout — conforme exigido pela legislação de transparência fiscal —, o sistema deve destacar a parcela correspondente ao IBS e à CBS sem somar esses valores ao preço final do produto. Os impostos já compõem o preço de venda exibido na vitrine.

Mapeie o fluxo da API do checkout até a criação do pedido no ERP. Garanta que o payload JSON enviado pela plataforma de e-commerce especifique claramente quais valores são frete, quais são descontos incondicionais e qual é a base tributável exata do pedido.

Verifique se a integração do gateway de pagamento autoriza o valor bruto correto, sem retenções originadas por divergência na discriminação do imposto.

Critério de conclusão: Pedido de teste realizado na plataforma virtual importado pelo ERP com exatamente os mesmos valores de base de cálculo, frete, desconto e valor total autorizados pelo gateway de pagamento.


Homologando a emissão em lote antes do prazo obrigatório

Testar uma única nota isolada não valida a operação real de um e-commerce. As falhas operacionais aparecem no processamento de cenários complexos, como vendas interestaduais com alíquotas de destino distintas, operações via marketplace e pedidos com frete contratado via transportadora terceira.

No regime do IBS, a arrecadação pertence ao estado e município de destino da mercadoria (princípio do destino).

Monte uma planilha de testes com 50 pedidos simulados cobrindo quatro cenários operacionais:

  1. Venda intraestadual para consumidor final Pessoa Física.
  2. Venda interestadual para consumidor final Pessoa Física (avaliando a distribuição da alíquota do IBS do estado de destino).
  3. Venda para Pessoa Jurídica contribuinte (avaliando a geração de crédito integral de IBS e CBS para o comprador).
  4. Venda realizada via marketplace sob modelo de Fulfillment ou entrega própria.

Processe esse lote de 50 pedidos no ERP, enviando as notas em lote para o ambiente de homologação da SEFAZ.

Após o retorno da SEFAZ, exporte o relatório de faturamento do ERP e passe o lote pelo validador do sistema fiscal da empresa. Compare a retenção calculada em cada nota com as alíquotas vigentes do regime regular para identificar desvios de arredondamento de centavos nas bases de cálculo.

Critério de conclusão: Lote de 50 pedidos de teste processado e emitido em homologação sem nenhuma rejeição de alíquota, erro de arredondamento de centavos ou divergência de tributação por estado de destino.


O erro mais comum na transição e a validação final com a contabilidade

O erro recorrente na transição fiscal de e-commerces é a duplicação da base de cálculo por acúmulo inadequado de regimes tributários. Durante a fase de convivência entre os sistemas tributários, o ICMS e o ISS continuam existindo ao lado do IBS e da CBS.

Inserir a alíquota de IBS e CBS sobre uma base de cálculo que já inclui o ICMS por dentro (sem o devido expurgo da base ou ajuste do valor do produto) infla o preço final e gera cálculo em cascata.

O IBS e a CBS são tributos calculados por fora. Eles não integram a sua própria base de cálculo, diferentemente do modelo antigo do ICMS.

Preço do Produto (Sem imposto por dentro) = R$ 100,00
CBS (0,9%) = R$ 0,90
IBS (0,1%) = R$ 0,10
Valor Total da Nota = R$ 100,00 (Impostos destacados: R$ 1,00)

Antes da entrada em vigor definitiva, exporte os arquivos XML gerados durante os testes e envie o pacote para a validação da sua contabilidade. O contador deve rodar esses arquivos no validador contábil para checar a correta escrituração dos créditos e débitos no EFD-Reinf e no SPED Fiscal.

Com a validação aprovada pela contabilidade, trave os cadastros de NCM e tabelas de regras fiscais no ERP para impedir alterações manuais da equipe de operacioal ou do time de catálogo.

No início da vigência, o fluxo diário exigirá apenas o acompanhamento das rejeições no painel do ERP durante as primeiras horas de expedição.


Perguntas frequentes

O frete cobrado do cliente entra na base de cálculo do IBS e da CBS na nota fiscal?

Sim. O valor do frete cobrado do comprador integra a base de cálculo bruta dos novos tributos, do mesmo modo que ocorria com o ICMS. O cálculo é aplicado sobre a soma do valor dos produtos mais o frete, descontando apenas os abatimentos concedidos de forma incondicional no momento da compra.

Como tratar devoluções de vendas realizadas no regime antigo quando a nota de devolução for emitida no regime do IBS e CBS?

A nota fiscal de devolução deve espelhar a estrutura tributária da nota de origem. Se a venda original ocorreu sob as regras legadas de ICMS, PIS e COFINS, a devolução será emitida utilizando os mesmos códigos e tributos da nota de saída correspondente, sem gerar estorno sob as regras novas de IBS e CBS.

Operações de e-commerce realizadas em marketplace (como Mercado Livre ou Shopee) mudam o responsável pelo recolhimento do IBS e CBS?

Não muda o contribuinte principal, mas altera o fluxo de retenção. A legislação atribui responsabilidade aos intermediadores digitais para prestação de informações e retenção do imposto na fonte em operações específicas. A loja virtual continua emitindo a NF-e de venda da mercadoria, enquanto o marketplace emite a nota do serviço de intermediação com a incidência própria de IBS e CBS sobre a comissão cobrada.

Da leitura à operação rodando

Tráfego pago, marketplaces, pagamentos e gestão de e-commerce — as quatro frentes dentro de um time só.

///

Receba os próximos conteúdos

Um e-mail por semana sobre tráfego pago, marketplaces e operação de e-commerce. Sem spam.