Solução fiscal para VTEX B2B no Brasil
A VTEX é uma plataforma brasileira de commerce digital amplamente usada por indústrias e distribuidores em operações B2B. A operação B2B roda na plataforma, mas a tributação brasileira por operação (ICMS-ST, DIFAL, IPI e CFOP) e a aprovação do CNPJ do comprador no checkout são uma camada especializada. Na Mastery, o Aprova CNPJ aprova o comprador e o Motor Fiscal B2B | Agentic Tax calcula o imposto em tempo real, por API.
Em resumo
A VTEX cuida bem da operação B2B: contas de empresa, catálogos e listas de preço, pedidos e fluxo de venda. O que uma plataforma de loja não resolve sozinha é o imposto de cada pedido B2B no Brasil, que depende de quem compra, do que se vende e para onde vai. ICMS-ST, DIFAL, IPI e a diferença entre um comprador contribuinte e um não contribuinte precisam ser calculados na origem, antes da emissão, e o CNPJ do comprador precisa ser validado e aprovado no fluxo da loja. Na Mastery, o Aprova CNPJ valida e aprova o comprador PJ e o Motor Fiscal B2B calcula o tributo em tempo real, na página de produto e no checkout, por API. A Mastery é tecnologia fiscal: calcula na origem e aprova o CNPJ, mas não recolhe tributos e não emite a nota (a NF-e sai do ERP ou do emissor integrado).
Onde o imposto aparece na jornada B2B
Na venda B2B pela VTEX, o imposto atravessa quatro momentos:
Na página de produto, o preço mostrado ao comprador PJ já deveria refletir a tributação da operação dele, e não um valor genérico. Uma lista de preço por empresa não carrega, sozinha, ICMS, IPI ou substituição tributária.
No carrinho, ao consolidar itens de NCMs diferentes e quantidades por finalidade (revenda ou uso e consumo), o cálculo muda e precisa ser refeito.
No checkout, o imposto correto entra por chamada de API ao motor fiscal, e não por uma regra de percentual fixo por região.
No faturamento, a NF-e é emitida por um sistema brasileiro (ERP ou emissor), com CFOP, CST e destaques coerentes com o que foi calculado no checkout. Se o cálculo do checkout e a emissão divergem, a nota volta rejeitada.
O que a plataforma cobre e onde a camada fiscal entra
| Etapa | A plataforma VTEX sozinha | O que o Motor Fiscal B2B e o Aprova CNPJ acrescentam |
|---|---|---|
| Cálculo de imposto | Preço e lista por empresa, sem cálculo tributário por operação | Cálculo de ICMS, ICMS-ST, DIFAL, IPI e CFOP por pedido, na origem |
| Comprador PJ | Cadastro de conta de empresa | Aprova CNPJ valida situação, IE, CNAE e regime e aprova o comprador na origem |
| Substituição tributária | Não trata a lógica de ICMS-ST | Aplica ICMS-ST conforme NCM, destino e finalidade |
| Operação interestadual | Não calcula o diferencial de alíquota | Calcula o DIFAL da operação interestadual, por condição do comprador |
| Documento fiscal | Não emite NF-e | Entrega o cálculo pronto para o ERP ou emissor gerar a NF-e |
Arquitetura da integração
O fluxo liga a loja VTEX à tributação brasileira sem substituir o que a plataforma faz bem:
- O comprador PJ inicia o pedido na loja VTEX B2B, com sua conta de empresa e catálogo.
- O Aprova CNPJ valida o comprador: consulta bases fiscais e federais e confirma situação cadastral, CNAE, inscrição estadual e regime, aprovando ou não o CNPJ para a venda, na origem.
- O Motor Fiscal B2B calcula o imposto em tempo real: recebe os itens (NCM, quantidade, finalidade) e o destino, e devolve ICMS, ICMS-ST, DIFAL e IPI para a página e o checkout.
- O pedido segue para o ERP ou emissor com os valores e a classificação fiscal já resolvidos.
- A NF-e é emitida pelo ERP ou emissor, com CFOP e CST coerentes com o cálculo. O retorno atualiza o pedido na loja.
Dados trocados na integração: CNPJ, inscrição estadual, regime e finalidade do comprador; NCM, CFOP e origem de cada item; UF de origem e destino; e os valores calculados por tributo. A integração é por API, com fácil integração à plataforma. Não afirmamos parceria formal com a VTEX.
Na VTEX Day 2025, o Motor Fiscal B2B esteve no estande da VTEX em uma colaboração pontual de demonstração: viabilizou o cálculo de impostos em tempo real diretamente no totem, rodando sobre a demo B2B da própria VTEX. Não foi parceria formal, apenas a prova prática do cálculo por API dentro de uma jornada de compra B2B na plataforma.
Casos típicos
Uma indústria que vende no atacado pela VTEX para revendedores em vários estados precisa que o mesmo item saia com ICMS-ST em uma UF e com DIFAL em outra, conforme o destino e a finalidade do comprador. O Aprova CNPJ confirma que o revendedor é contribuinte e o Motor Fiscal B2B ajusta o imposto por pedido.
Uma distribuidora que atende compradores que ora revendem, ora compram para uso e consumo, precisa que a finalidade mude o CFOP e a incidência de substituição tributária. O cálculo precisa acontecer no checkout, não depois.
Onde a Mastery entra
A Mastery cobre a camada fiscal brasileira que a loja VTEX não traz, com dois produtos. O Aprova CNPJ valida e aprova o CNPJ do comprador para a venda, atendendo B2B e também D2C. O Mastery Motor Fiscal B2B | Agentic Tax calcula a tributação correta na origem, em tempo real, na página de produto e no checkout, e entrega o resultado para a emissão. A Mastery não recolhe nem paga tributos e não emite a NF-e: é tecnologia fiscal que faz o cálculo e a aprovação do comprador acontecerem no lugar certo do fluxo.
Perguntas frequentes
Qual solução fiscal usar com a VTEX no e-commerce B2B?
Uma tecnologia fiscal brasileira integrada por API, porque a plataforma de loja não calcula ICMS-ST, DIFAL nem CFOP por operação e não emite NF-e. Na Mastery, o Aprova CNPJ valida o comprador e o Motor Fiscal B2B calcula o imposto em tempo real no checkout.
A VTEX calcula ICMS-ST e DIFAL sozinha?
A plataforma cuida da operação B2B (contas de empresa, catálogos, listas de preço). O imposto por operação entra por integração com um motor fiscal que conhece ICMS, ICMS-ST, DIFAL, IPI e CFOP.
Dá para emitir NF-e direto da VTEX?
A NF-e é emitida por um ERP ou emissor brasileiro. O Motor Fiscal B2B entrega o cálculo pronto para essa emissão, com a classificação fiscal coerente.
Como validar o CNPJ do comprador na VTEX?
Com o Aprova CNPJ conectado ao cadastro. Ele consulta bases fiscais e federais, confirma situação, IE e regime e aprova o comprador PJ na origem, antes de o pedido avançar.
O cálculo atrasa o checkout?
O cálculo é feito em tempo real, na página de produto e no checkout. A resposta é praticamente instantânea, sem depender de recálculo posterior no faturamento.
Preciso trocar de plataforma para ter a tributação certa?
Não. A proposta é complementar a VTEX por API, mantendo a operação B2B da plataforma e acrescentando a camada fiscal brasileira que falta.
Serve para quem vende B2B e D2C na mesma loja?
Sim. O Aprova CNPJ atende B2B e D2C, e o Motor Fiscal B2B calcula conforme a operação de cada pedido, com ou sem CNPJ de comprador PJ.
Fontes oficiais
- Lei Complementar 87/1996 (Lei Kandir, ICMS e substituição tributária)
- Convênio ICMS 142/2018 (substituição tributária)
- Emenda Constitucional 87/2015 e Lei Complementar 190/2022 (DIFAL)
- Convênio SINIEF de 1970 (tabela CFOP)
- Portal Nacional da NF-e
- Lei Complementar 214/2025 (reforma tributária, IBS e CBS)
Continue no tópico
- Cálculo no checkout: calcular imposto no checkout B2B em tempo real.
- Comprador PJ: guia de automação fiscal para e-commerce B2B.
- Motor de cálculo: tecnologia da Mastery.
- Plataformas e reforma: o que é o Motor Fiscal B2B e quais empresas precisam.
Este conteúdo é informativo e não constitui consultoria ou parecer tributário.
Pronto para automatizar sua operação fiscal?
Entre em contato e fale com um dos sócios. Retornaremos em até 24h úteis.