State registration (IE)

Validate

• JavaScript library
• Python library
• Go library
• Ruby library
• Rust library83 cases fail
• .NET library83 cases fail
• Erlang library

Validates an inscrição estadual (state registration) for a given state. It uses the format and check-digit rule that the state publishes (SINTEGRA).

• params.value is the registration, a string. Any other type, or a missing value, returns false. params.stateCode is the two-letter state code, case-insensitive, and surrounding whitespace is ignored (until 2.4.0 whitespace made the state unknown and the result false). An unknown or missing state returns false.
• Punctuation and spaces in the registration are ignored. Letters are dropped before the check for every state but SP, where only P is accepted.
• JavaScript also keeps the 2.3.0 form isValidIe(stateCode, ie), deprecated. It answers like the object form. Other languages take only the parameters object.
• Several states have special cases: GO, PA, MS, MT, SP, TO, DF, PE, AL, AM, RR, MG and RO. These are extra prefixes or formats, or readings where the SINTEGRA page is silent or disagrees with the state's own acts. When official sources disagree, the library keeps its behavior and documents what it rests on.
• AL: the third digit is the tipo de empresa and must be 0, 3, 5, 7 or 8, the five the SINTEGRA page lists. 2.4.0 accepted any third digit.
• DF: 13 digits with prefix 07 or 08. DF moved to 08 when the 07 numbers ran out. No SEFAZ-DF act announces it; the prefix rests on the CF/DF validator of the Receita DF portal and on software notes. 2.4.0 accepted only 07.
• GO: 9 digits with prefix 10, 11, 15 or 20 to 29. IN 946/09-GSF (as worded by IN 1.535/22-GSE) gives 10 and 20 for companies and 11 for individuals, and the Secretaria da Economia has issued 20 to new companies since 13/01/2023. The SINTEGRA page (2022) gives 20 to 29, and only the 2012 roteiro de crítica gives 15. The check digit follows the 2012 roteiro, including its special range 10103105 to 10119997 and the dual-digit registration 11094402, so 101031050 is rejected. 2.4.0 rejected the prefixes 20 to 29. No norm names 15 or 21 to 29, so the official sources disagree and all of the prefixes are accepted. The check digit rule of the SINTEGRA page (2022) always reads a remainder of 0 or 1 as 0; this library follows the roteiro, as 2.4.0 did.
• MT: 9 digits, the form Portaria SEFAZ-MT 59/2025 art. 8º § 1º prescribes, or the 11 digits the SINTEGRA page prints. The 9-digit form is checked as the 11-digit one padded with two zeros. 2.4.0 accepted only 11 digits.
• PA: 9 digits with prefix 15 or 75 to 79, the six the SINTEGRA page lists. SEFA-PA announced only 75 (08/10/2024); 76 to 79 rest on the page. This is the 2.4.0 behavior.
• PE: the 9-digit eFisco number or the old 14-digit CACEPE number (13 digits and 1 check digit, weights 5, 4, 3, 2, 1, 9 down to 2, a difference above 9 minus 10). Portaria SF 087/2007 converted the old numbers but set no date after which they are void. 2.4.0 accepted only 9 digits.
• SP: a produtor rural registration is P then 0MMMSSSSD000, so the character after P must be 0 (P0 + 11 digits). The P may be lower case. Letters other than P are rejected. 2.4.0 accepted any digit after the P.
• MS: prefixes 28 and 50, the two the SINTEGRA page (2024) gives. A SEFAZ-MS communiqué says new companies start with 50, while the only norm, Resolução/SEF 1.344/1999, gives 28 alone. The check digit rule is the same for both.
• RR: the prefix 24 is required. The SINTEGRA page never writes it: it is read from the page's ten valid examples, which all start with 24.
• TO: the 9-digit form in force (Portaria SEFAZ-TO 676/2002, art. 3º; RICMS-TO, art. 90), with no prefix check, or the old 11-digit form the SINTEGRA page documents, whose tipo digits (3rd and 4th, left out of the check digit sum) must be 01, 02, 03 or 99.
• AM: the SINTEGRA page gives a rule with two branches and leaves "Resto" undefined. The library reads it as the sum modulo 11 and gives 0 to a sum of 0 or 1, which is the shared modulus 11 rule (weights 9 down to 2, a remainder of 0 or 1 giving 0).
• RO: the 14-digit form (13 digits and the check digit) the SINTEGRA page gives for registrations since 01/08/2000. The 9-digit form it still prints for the earlier formula (101.62521-3) is rejected: those numbers were converted to 0000000062521-3.
• MG: a first check digit of 10, from a sum that is already a multiple of ten, is read as 0.
• An all-zero registration is accepted wherever the published formula gives a check digit of 0 for it: AM, CE, ES, MG, PB, PE (9 digits), PI, PR, RJ, RS, SC, SE and SP, plus BA with 8 or 9 digits, MT with 9 or 11 digits and TO with 9 digits. Unlike cpf.isValid and cnpj.isValid, the IE does not reject repeated digits.

import { isValidIe } from '@brazilian-utils/brazilian-utils';

isValidIe({ value: '110042490114', stateCode: 'SP' }); // true
isValidIe({ value: 'P011004243002', stateCode: 'SP' }); // true (produtor rural)
isValidIe({ value: '0187634580933', stateCode: 'AC' }); // false
isValidIe({ value: '109161793', stateCode: 'go' }); // true (case-insensitive)
isValidIe({ value: '109161793', stateCode: ' GO ' }); // true (surrounding whitespace ignored)
isValidIe({ value: '200000004', stateCode: 'GO' }); // true (prefix 20)
isValidIe({ value: '130000019', stateCode: 'MT' }); // true (9 digits)