Validador de Clave de Acceso NFS-e Nacional
Valide la autenticidad estructural, municipio emisor, identificación fiscal y dígito verificador de claves NFS-e de 50 dígitos.
Acerca de la Validación de la Clave NFS-e Nacional
La validación analiza la cadena de 50 dígitos (o 53 con prefijo 'NFS'), el código municipal IBGE, la integridad del CPF o CNPJ y la exactitud del dígito verificador Módulo 11.
Inconsistencias en la clave impiden la integración con los sistemas de gestión tributaria municipal (Sefin) y la contabilidad fiscal.
Anatomía & Estructura de la Clave NFS-e Nacional (50 Dígitos)
Estructura oficial estandarizada por el Manual del Contribuyente (MOC) de la NFS-e Nacional:
| Posición | Campo | Longitud | Significado & Regra | Ejemplo |
|---|---|---|---|---|
| 01 a 07 | cMun | 7 dígitos | Código IBGE del municipio de incidencia del ISS | 3550308 (SP) |
| 08 | tpAmb | 1 dígito | Entorno generador (1=Municipal, 2=Nacional) | 2 |
| 09 | tpInsc | 1 dígito | Tipo de registro (1=CPF, 2=CNPJ) | 2 |
| 10 a 23 | Insc | 14 caracteres | Registro fiscal (CPF con 3 ceros iniciales o CNPJ) | 00000000000191 |
| 24 a 36 | nNFSe | 13 dígitos | Número correlativo de la NFS-e en el Entorno Nacional | 0000000000001 |
| 37 a 40 | AAMM | 4 dígitos | Año y mes de emisión del documento fiscal | 2609 |
| 41 a 49 | cNFSe | 9 dígitos | Código numérico aleatorio de seguridad | 123456789 |
| 50 | cDV | 1 dígito | Dígito verificador calculado mediante Módulo 11 | 0 |
Algoritmo de Cálculo del Dígito Verificador (Módulo 11)
Cálculo oficial realizado por las autoridades tributarias sobre las 49 primeras posiciones:
S = Σ(d_i * weight_i) | DV = rem < 2 ? 0 : 11 - rem
- 1. Recorrer los caracteres de la posición 49 a la 1 (de derecha a izquierda).
- 2. Convertir los caracteres a valor numérico (ASCII - 48).
- 3. Multiplicar cada valor por los pesos cíclicos [2, 3, 4, 5, 6, 7, 8, 9, 2, 3...].
- 4. Sumar todos los productos y calcular el resto de la división entera por 11.
- 5. Si el resto es 0 o 1, el DV es 0; en caso contrario, el DV es 11 menos el resto.