Inscrição estadual para testes: por que cada estado difere e como usar
Inscrição estadual para testes precisa seguir o formato e o dígito verificador do estado escolhido, porque cada unidade da federação tem regra própria e o validador confere uma a uma.
O sistema de emissão de notas está em homologação, o cadastro do cliente pede a inscrição estadual, e o testador digita uma sequência qualquer. O validador recusa. Digita a IE de um cliente real. O validador aceita, e a base de teste acaba de ganhar um dado de empresa de verdade que não deveria estar ali. Entre os dois extremos existe o caminho certo: a inscrição estadual para testes, um número que segue o formato e o cálculo do dígito verificador do estado escolhido, passa em qualquer validação de formato e não pertence a nenhuma empresa cadastrada.
Este texto explica para que serve a IE e por que cada estado tem tamanho, máscara e algoritmo próprios. Mostra como gerar um número válido para o estado que o teste pede, onde ele entra na homologação, a diferença entre válido e existente, o que a lei diz sobre dado real em ambiente de teste e os erros de validação de quem trata a IE como igual em todo lugar. Traz um comparativo entre estados, um roteiro e as dúvidas mais comuns.
Inscrição estadual para testes: o que é a IE
A IE é o registro da empresa na secretaria de fazenda do estado, obrigatório para quem vende mercadoria e recolhe ICMS. Ela aparece na nota fiscal, no cadastro de fornecedor e em toda integração que envolve imposto estadual, e é conferida por validador na maioria dos sistemas antes de gravar. "Válido", no sentido técnico, quer dizer que o número tem o tamanho certo para o estado e que o dígito verificador fecha com o cálculo daquele estado; não quer dizer que a empresa existe no Sintegra ou no cadastro da fazenda.
Empresa isenta de ICMS, como a maioria dos prestadores de serviço, não tem IE, e o campo aceita "ISENTO", o que também precisa ser testado, porque é o caso mais comum em cadastro de cliente.
Uma empresa pode ter uma inscrição por estado em que opera, e o cadastro precisa aceitar várias por CNPJ.
Por que cada estado é diferente
Ao contrário do CPF e do CNPJ, que têm um formato para o país inteiro, a IE foi criada por cada estado, na época em que cada um tinha o próprio sistema. O resultado são 27 regras. São Paulo usa doze dígitos com dois verificadores em posições diferentes; Minas Gerais usa treze, com um zero inserido no meio antes da conta; o Rio de Janeiro usa oito; Goiás usa nove com faixas de numeração; e alguns estados aceitam letras. Um gerador de inscrição estadual conhece as 27 regras, recebe o estado escolhido e devolve um número no formato e com o verificador daquele estado, com ou sem máscara, o que poupa a leitura de 27 manuais para montar o conjunto de teste.
O gerador não consulta a fazenda nem cria cadastro: ele faz a conta do estado e devolve o resultado, que serve para teste e para nada mais, como o CPF e o CNPJ gerados.
Quem testa sistema que opera em vários estados precisa de pelo menos um número gerado por estado atendido, porque o validador tem um ramo de código para cada um.
Comparativo entre alguns estados
| Estado | Tamanho | Particularidade |
|---|---|---|
| São Paulo | 12 dígitos | Dois verificadores, nas posições 9 e 12 |
| Minas Gerais | 13 dígitos | Insere zero no cálculo do primeiro verificador |
| Rio de Janeiro | 8 dígitos | Um verificador, pesos de 2 a 7 |
| Goiás | 9 dígitos | Começa em 10, 11 ou 15, com exceções na faixa |
| Bahia | 8 ou 9 dígitos | Módulo 10 ou 11 conforme o primeiro dígito |
Como montar o conjunto de teste, em ordem
- Listar os estados em que o sistema opera ou será homologado.
- Gerar de cinco a dez inscrições válidas por estado, com e sem máscara, e guardar no projeto de teste.
- Acrescentar inválidas de propósito, com verificador trocado, e o valor "ISENTO".
- Incluir o caso de duas ou três IEs para o mesmo CNPJ, em estados diferentes.
- Usar sempre o mesmo conjunto nos testes automatizados, e nunca copiá-lo para produção.
O passo três pega o validador que trata "ISENTO" como erro e barra o prestador de serviço no cadastro, que é um dos chamados de suporte mais comuns em sistema fiscal.
Onde a IE gerada entra no trabalho
Homologação da NF-e, em que a secretaria de fazenda oferece ambiente próprio e o emitente e o destinatário fictícios precisam de IE que passe na validação. Cadastro de cliente e de fornecedor em sistema de gestão. Integração com transportadora e com marketplace, que conferem a IE do vendedor. Importação em lote de planilha de cadastro. Aula de programação, onde o validador de IE é o exercício avançado depois do CPF e do CNPJ, por causa dos 27 casos. E demonstração de sistema, em que a tela precisa de dados que pareçam reais.
Em todos, o que sai do gerador passa na validação local e falha na consulta ao Sintegra, o que é exatamente o comportamento esperado de dado de teste.
Válido, existente e a lei
Válido é o que fecha a conta; existente é o que está no registro oficial; e os dois se confundem só na cabeça de quem nunca testou. Dado de empresa real em homologação, com IE, CNPJ, razão social e contatos, é cópia de produção sem finalidade, e a lei de proteção de dados trata isso como tratamento indevido quando envolve pessoa física por trás da empresa. A prática recomendada é o ambiente fictício de ponta a ponta: IE e CNPJ gerados, razão social inventada, endereço de teste. E o que sai do gerador não serve para emitir nota real, abrir conta ou se apresentar como empresa: isso é crime, e não tem relação com teste de software.
Há ainda o caso do produtor rural, que em vários estados tem inscrição com formato próprio, e o do contribuinte substituto, com IE em estado onde não tem sede. Sistema que atende agronegócio ou distribuição precisa desses dois casos no conjunto de teste, e eles são os que mais escapam.
Os erros de validação mais comuns
Aplicar a regra de um estado a todos, o que aceita IE errada de um lado e recusa IE certa do outro. Não aceitar "ISENTO". Exigir tamanho fixo quando o estado aceita dois tamanhos, como a Bahia. Rejeitar o número sem máscara, que o usuário cola do cartão. Validar só no navegador. Não permitir várias IEs por CNPJ. E o mais caro: consultar o Sintegra a cada tecla digitada, quando a conta local resolve o formato e a consulta fica para o momento certo do fluxo.
Perguntas frequentes sobre a IE de teste
Inscrição estadual para testes é de alguma empresa?
Não. O número fecha o cálculo do estado, mas não consta no registro oficial. Existe só para o teste.
Por que preciso escolher o estado?
Porque cada estado tem tamanho e cálculo próprios. Uma IE válida em São Paulo é inválida em Minas, e o validador confere pelo estado do cadastro.
O gerador cobre os 27 estados?
Sim. Ele conhece a regra de cada um e devolve o número no formato e com o verificador daquele estado, com ou sem máscara.
E a empresa isenta?
Usa "ISENTO" no campo. O validador precisa aceitar, e o conjunto de teste precisa ter esse caso, que é o mais frequente em serviço.
Posso usar o número gerado numa nota real?
Não. É irregular, e a fazenda recusa. Serve para o ambiente de homologação, que a própria secretaria oferece.
Preciso validar no servidor?
Sim. Validação só no navegador é contornada por chamada direta à API, e a IE errada vai para o banco e depois para a nota.
Resumo
Inscrição estadual para testes é um número que segue o tamanho, a máscara e o dígito verificador do estado escolhido, entre as 27 regras que existem, sem pertencer a nenhuma empresa. Ela entra na homologação da nota, no cadastro, na integração e na aula, passa na validação local e falha na consulta oficial, como deve ser. O conjunto de teste tem uma IE por estado atendido, os inválidos de propósito, o "ISENTO" e o caso de várias inscrições por CNPJ, e nunca vai para produção. Validar no servidor e aplicar a regra do estado certo evitam os erros mais comuns.
