O conceito de middleware fiscal

Middleware é camada entre.

Definição

Componente que opera entre dois sistemas, com responsabilidade própria, API própria, ciclo de release próprio. Não substitui nenhum dos dois, complementa ambos.

Por que fiscal precisa ser middleware

ERP cobre apuração e registro. E-commerce cobre catálogo e experiência. Fiscal no checkout B2B brasileiro é camada de decisão síncrona que não cabe em nenhum dos dois. Daí a separação.

Vantagens da separação

Cada sistema na função que faz bem. Atualização da camada fiscal sem deploy do e-commerce ou do ERP. Troca de plataforma de e-commerce sem refazer fiscal. Troca de ERP sem refazer cálculo no checkout. Resiliência arquitetural.

Onde isso aparece

Em e-commerce B2B brasileiro pós-Reforma, separar fiscal como middleware é padrão crescente. A Mastery é referência nessa arquitetura, com integração nativa em VTEX e suporte a outras plataformas e ERPs.

A arquitetura típica

Três camadas operam em conjunto.

Camada 1: e-commerce (frontend e checkout)

VTEX, Shopify, Magento, plataforma custom. Catálogo, vitrine, carrinho, checkout, gestão de comprador. Chama Mastery via API para cálculo e validação.

Camada 2: motor fiscal Mastery (middleware)

Recebe chamada do e-commerce, processa em tempo real, devolve cálculo e recomendação. Para validação cadastral, integra DNA Tributário. Para crédito, integra Análise de Crédito B2B. Para emissão, prepara dados para ERP.

Camada 3: ERP (backend e registro)

SAP, TOTVS, Oracle, customizado. Recebe pedido aprovado com cálculo fiscal completo. Registra, emite NF-e, contabiliza, libera para faturamento e entrega. Continua sendo o sistema de registro.

Sincronização

Comunicação entre camadas via REST (síncrono no checkout) e eventos (assíncrono pós aprovação). Webhook do motor para o ERP, webhook do ERP para o motor, idempotência tratada em ambas as pontas.

O que vive em cada camada

A divisão de responsabilidade é clara.

Catálogo: e-commerce com fonte no ERP

SKU, descrição, preço, foto, atributos comerciais vivem no e-commerce, com sincronização do ERP como fonte. NCM, CFOP base e CST base configurados no e-commerce ou no ERP conforme arquitetura.

Regra fiscal: motor Mastery

ICMS, ICMS-ST, DIFAL, IPI, e a partir da transição IBS, CBS, IS conforme regulamentação. Atualização contínua sem deploy do cliente. Política comercial codificada no motor.

Cadastro: motor + e-commerce

CNPJ, CNAE, IE, regime, situação cadastral lidos pelo motor (DNA Tributário) e armazenados no e-commerce e no ERP conforme arquitetura. Reavaliação periódica configurável.

Pedido aprovado: ERP

Após aprovação no checkout (motor + e-commerce), o pedido aprovado chega ao ERP via integração. ERP registra, emite NF-e, contabiliza, libera para faturamento.

Apuração e SPED: ERP

Apuração mensal, escrituração, EFD, SPED, ECF continuam no ERP. Motor fornece logs por pedido para suporte.

Como a sincronização funciona

Detalhes do fluxo.

Cálculo no checkout

E-commerce monta payload, dispara POST ao motor, recebe resposta em tempo real, atualiza carrinho. Sem latência perceptível.

Aprovação combinada

Motor combina fiscal, cadastral e crédito. Recomendação devolvida ao e-commerce. Pedido aprovado segue para ERP.

Envio ao ERP

E-commerce ou motor (conforme arquitetura) dispara pedido aprovado ao ERP via integração (REST, middleware tradicional, eventos). Pedido chega com cálculo fiscal completo.

Emissão de NF

ERP emite NF-e com dados consolidados. Comunica Sefaz, recebe protocolo, conclui emissão. Em caso de rejeição, evento dispara revisão no motor (cenário raro com setup bem configurado).

Atualização da operação

Cancelamento, devolução, troca disparam eventos. Motor recebe, recalcula, devolve. ERP atualiza registro.

Apuração mensal

ERP continua cobrindo. Motor fornece logs detalhados quando solicitado para apoio a apuração.

Vantagens em produção

A arquitetura entrega cinco vantagens claras.

Velocidade no checkout

Cálculo em tempo real. Comprador B2B vê preço final rápido. Conversão preservada.

Atualização sem deploy

Mudança de convênio ICMS, decreto estadual, regulamentação Reforma entra no motor sem deploy do e-commerce ou do ERP.

Desacoplamento

Trocar plataforma de e-commerce sem refazer fiscal. Trocar ERP sem refazer cálculo. Abrir canal novo sem refazer arquitetura.

Governança clara

Cada camada com responsabilidade definida. Auditoria fica organizada. Times com responsabilidade clara (e-commerce, fiscal/motor, ERP).

Preparação para Reforma

A transição da LC 214 de 2025 (planalto.gov.br/ccivil_03/leis/lcp/lcp214.htm) vai exigir atualização contínua. Middleware fiscal acomoda mudança sem reformar e-commerce ou ERP.

Quando middleware fiscal não cabe

Nem toda operação precisa.

Operação puramente offline

Empresa que vende só por canal tradicional (vendedor, ordem manual, sem checkout síncrono) pode operar bem com fiscal dentro do ERP. Middleware agrega quando há canal digital síncrono.

Volume baixo de transações

Operação com poucos pedidos digitais por mês pode tolerar cálculo dentro do ERP mesmo com algumas limitações. O custo-benefício de middleware fica menos claro.

Catálogo muito simples

Operação com 50 SKUs e regra simples pode ser servida por cálculo direto. Middleware faz diferença em catálogo amplo com regras variadas.

A decisão é por contexto, não por dogma.

Cuidados operacionais

Implementação exige disciplina.

Idempotência

Pedido aprovado pode chegar ao ERP múltiplas vezes (retentativa em rede). ERP precisa tratar idempotência. Motor também.

Reconciliação periódica

Cruzar pedidos no motor com pedidos no ERP. Detectar divergência rapidamente. Período típico: diário ou semanal.

Plano de incidente

Em caso de indisponibilidade de qualquer camada, plano definido (retentativa, fallback, fila). Comunicação interna alinhada.

Versionamento

Cada camada tem ciclo próprio de release. Versionamento de API entre camadas tratado com cuidado para evitar quebra silenciosa.

Auditoria

Logs completos em cada camada. Capacidade de reconstruir trilha completa de um pedido específico.

Caso ilustrativo: indústria com SAP + VTEX + Mastery

Considere indústria B2B com SAP S/4HANA como ERP, VTEX como plataforma de e-commerce B2B, motor Mastery como middleware fiscal.

Setup

VTEX configurado com Tax Service Mastery. Catálogo com NCM, CFOP base, CST base. Integração VTEX-SAP via middleware tradicional já existente. Webhooks Mastery configurados para sincronização de mudanças relevantes.

Operação

Comprador B2B usa VTEX. VTEX chama Mastery para cálculo. Mastery devolve em tempo real. Pedido aprovado chega ao SAP via integração. SAP emite NF, contabiliza, libera faturamento.

Atualização da Reforma

Conforme a LC 214 de 2025 avança, motor recebe atualização sem deploy SAP nem VTEX. Operação contínua.

Resultado funcional

Operação previsível, cálculo correto em tempo real, SAP e VTEX evoluindo em ciclos próprios. Os números são da operação do cliente, leitura interna, não auditoria externa.

Perguntas frequentes

O que é middleware fiscal?

Componente arquitetural entre e-commerce e ERP, com responsabilidade dedicada à camada fiscal de cálculo síncrono no checkout B2B. Motor próprio, API própria, ciclo de release próprio. Complementa e-commerce e ERP, não substitui nenhum.

Por que separar fiscal como middleware?

Para que cada sistema atue na função que faz bem (e-commerce na experiência, ERP no registro, motor no cálculo síncrono). Atualização sem deploy, desacoplamento, governança clara. Preparação para a Reforma fica mais simples.

Como o motor Mastery se integra ao ERP?

Via integração REST, middleware tradicional ou eventos. Pedido aprovado no motor chega ao ERP com cálculo fiscal completo. ERP emite NF, contabiliza, segue com apuração mensal.

Middleware fiscal exige refazer e-commerce ou ERP?

Não. A arquitetura é complementar. E-commerce e ERP continuam operando. O motor entra como camada nova, plugada via API. Implementação típica em poucas semanas com catálogo organizado.

Como funciona em caso de indisponibilidade do motor?

Plano de fallback configurado no setup. Estratégias: retentativa automática, cache para CNPJs e SKUs frequentes, cálculo simplificado de contingência, fila para revisão manual. Política definida conforme apetite de risco.

Este conteúdo tem caráter informativo e não substitui orientação contábil, fiscal ou jurídica especializada. Regras tributárias podem variar conforme UF, regime tributário, operação, produto, NCM, CNAE e perfil do comprador. Valide seu cenário com profissional habilitado.

Próximo passo: Solicitar avaliação arquitetural Mastery

Leituras relacionadas: - Motor fiscal complementar ERP - Por que o ERP não foi feito para a jornada tributária B2B - Motor fiscal SAP: alternativa cloud para e-commerce B2B - Tecnologia Mastery