Trabalho Por Equipe DevBras

Capa do artigo: PDV em vários estados: o SAT de São Paulo não se copia para o caixa de outro estado

PDV em vários estados: o SAT de São Paulo não se copia para o caixa de outro estado

Documento fiscal do varejo, equipamento e contingência mudam de estado para estado. Veja como mapear cada unidade antes de levar o mesmo PDV para outra loja.

A rede abriu a primeira loja fora de São Paulo, em Fortaleza. O time de TI copiou a instalação do PDV que funciona há anos nas lojas paulistas, ligou o caixa e, no primeiro dia, nenhum cupom foi aceito. O código tinha orgulho de ser único; a obrigação fiscal não é. O documento fiscal do varejo é definido pelo estado de cada loja, não pelo seu sistema. A resposta curta: antes de abrir uma unidade em outro estado, confirme com o contador e no portal da Sefaz daquele estado qual documento a operação exige, que equipamento é necessário e como funciona a contingência.

Este guia trata do lado de planejamento de quem leva um PDV para vários estados. A diferença técnica entre os documentos está em SAT fiscal não é a nota eletrônica com outro nome e em SAT fiscal no PDV.

Por que o mesmo PDV não serve em todo lugar

O ICMS é um imposto estadual, e cada estado regula como a venda ao consumidor é documentada no seu território. Por isso o documento do caixa não é igual no país inteiro.

Em linhas gerais, o mapa é este. São Paulo criou o SAT CF-e, um equipamento ligado ao caixa que gera e assina o cupom fiscal eletrônico e o transmite à Sefaz. O Ceará adotou um modelo próprio, o MFE (Módulo Fiscal Eletrônico), que também gera o CF-e, mas com equipamento e software de integração próprios. A maior parte dos outros estados usa a NFC-e, a nota fiscal de consumidor eletrônica, emitida por software e enviada à Sefaz pela internet, sem equipamento fiscal dedicado. E São Paulo tem um cronograma de migração do SAT para a NFC-e, então o quadro dentro do próprio estado muda com o tempo.

Cada modelo tem consequências práticas diferentes:

  • Hardware. SAT e MFE exigem um equipamento homologado por caixa ou por loja. NFC-e não exige equipamento fiscal, mas exige certificado digital e internet estável.
  • Leiaute. O XML do CF-e não é o XML da NFC-e. Campos, validações e retornos são diferentes.
  • Contingência. Cada modelo tem sua regra para quando a internet cai ou o equipamento falha. Na NFC-e, há uma emissão em contingência offline com prazo para transmitir depois. No SAT, o equipamento guarda os cupons e transmite quando a comunicação volta.
  • Cadastros. Ativação do equipamento, código de segurança do contribuinte, credenciamento: cada estado tem o seu procedimento.

Os detalhes exatos mudam com normas estaduais. Por isso a fonte de verdade é sempre o portal da Sefaz do estado e o contador da empresa, não um post, nem este.

Como planejar a abertura de uma loja em outro estado

O exemplo é a rede fictícia Mercado Bom Preço, com doze lojas em São Paulo usando SAT, abrindo uma em Fortaleza e outra em Recife.

  1. Monte a ficha fiscal de cada unidade. Para cada loja: estado, CNPJ da filial, inscrição estadual, documento exigido no caixa, equipamento necessário, regra de contingência e onde conferir. Preencha com o contador, não de memória.
  2. Confirme no portal da Sefaz do estado. Leia a página oficial sobre o documento de varejo daquele estado. Anote a data da consulta, porque a regra pode mudar.
  3. Verifique se o seu PDV já suporta aquele modelo. Suportar NF-e não significa suportar NFC-e; suportar SAT não significa suportar MFE. Pergunte ao fornecedor do componente fiscal por escrito.
  4. Faça a escolha do modelo depender do cadastro da loja, não de um if escondido. O sistema deve saber, pela configuração da unidade, qual fluxo usar, e recusar a venda se a unidade não estiver configurada.
  5. Teste em homologação do estado de destino. Com o certificado e os dados da filial nova, até ter o documento autorizado. Teste também a contingência daquele modelo.
  6. Treine o operador no fluxo local. Mensagens de erro, contingência e cancelamento são diferentes. "É quase a mesma coisa" vira fila no balcão.

A configuração por unidade, no código

O ponto central é que o fluxo fiscal sai da configuração da loja, e uma loja sem configuração não vende. Um exemplo em JavaScript:

const MODELOS_SUPORTADOS = new Set(['SAT_CFE', 'MFE_CFE', 'NFCE']);

function modeloFiscalDaUnidade(unidade) {
  const modelo = unidade.config && unidade.config.modeloFiscal;
  if (!modelo) {
    throw new Error(
      'Unidade ' + unidade.codigo + ' sem modelo fiscal configurado. ' +
      'Confirme com o contador antes de liberar o caixa.'
    );
  }
  if (!MODELOS_SUPORTADOS.has(modelo)) {
    throw new Error('Modelo fiscal ' + modelo + ' não suportado por este PDV.');
  }
  return modelo;
}

async function emitirDocumentoDaVenda(venda, unidade, emissores) {
  const modelo = modeloFiscalDaUnidade(unidade);
  const emissor = emissores[modelo];
  if (!emissor) {
    throw new Error('Emissor para ' + modelo + ' não foi carregado.');
  }
  return emissor.emitir(venda, unidade);
}

Repare no que o código não faz: ele não tenta adivinhar o modelo pela UF. A tentação é escrever if (uf === 'SP') usarSat(), mas a regra dentro de São Paulo está mudando, e uma filial pode estar numa situação diferente da outra. A decisão fica no cadastro, preenchido por quem confirmou a regra, e a falta dela trava a venda em vez de emitir o documento errado.

A ficha fiscal da unidade

Unidade: BP-13 Fortaleza
UF: CE
Documento no caixa: CF-e via MFE (confirmar com contador)
Equipamento: MFE homologado, um por caixa? (confirmar)
Contingência: conforme regra do MFE (link da Sefaz-CE anotado)
Fonte consultada: portal da Sefaz-CE, consultado em 12/10/2026
Responsável pela confirmação: contador da filial
Homologação: documento autorizado em ____ (pendente)

Os campos com "confirmar" são intencionais. Uma ficha honesta mostra o que ainda é suposição, e a abertura da loja só sai quando não sobra nenhum.

Erros comuns

  • Copiar a instalação de uma loja para outra em outro estado. O documento pode ser outro, e o caixa abre sem conseguir emitir nada no primeiro dia.
  • Decidir o modelo por UF no código. Quando a regra do estado muda, o if continua lá, e o sistema emite o documento antigo sem ninguém perceber.
  • Esconder a diferença num ajuste de última hora sem teste. O fluxo de contingência daquele modelo nunca foi exercitado e falha na primeira queda de internet.
  • Comprar equipamento antes de confirmar a regra. Um lote de equipamentos que o estado não usa vira estoque parado.
  • Treinar o operador com o roteiro da outra loja. As mensagens e os passos de contingência são diferentes, e a fila cresce enquanto alguém liga para o suporte.
  • Confiar em post antigo sobre regra fiscal. Normas estaduais mudam. O que valia há cinco anos pode estar fora de vigor.

Checklist

  • Cada unidade tem uma ficha com UF, documento exigido, equipamento e contingência.
  • A regra foi conferida no portal da Sefaz do estado, com data de consulta anotada.
  • O contador da empresa confirmou a ficha de cada unidade nova.
  • O fornecedor do componente confirmou por escrito o suporte ao modelo daquele estado.
  • O PDV recusa vender quando a unidade não tem modelo fiscal configurado.
  • Houve documento autorizado em homologação com os dados da filial nova.
  • A contingência daquele modelo foi testada desligando a internet.
  • Os operadores da nova loja foram treinados no fluxo local.

Este texto não substitui a orientação do contador nem a consulta à legislação do seu estado. Agora, olhe a loja onde o seu PDV vai rodar a seguir: ela usa o mesmo documento fiscal da unidade onde você testou?

Avalie este artigo

Referência: http://www.tecnospeed.com.br/tudo-sobre-sat/