Calculadora y validador del dígito de control NIF de Portugal

Introduzca los ocho primeros dígitos para calcular el noveno, o envíe los nueve para comprobar si el dígito proporcionado coincide con el cálculo. El resultado es determinista e inmediato, por lo que resulta apropiado para formularios, importaciones, procesos contables y validaciones mediante API. Las longitudes incorrectas, los caracteres que no son dígitos y los modos no admitidos se notifican con claridad, sin corregirlos ni interpretarlos de forma silenciosa.

Elija entre calcular y validar

Use el modo de cálculo cuando ya disponga de la base de ocho dígitos de un NIF portugués y necesite obtener su dígito de control final. La respuesta incluye tanto el dígito calculado como el valor completo de nueve dígitos, de modo que puede incorporarlo directamente a una validación posterior o a sus pruebas. Use el modo de validación cuando el origen ya contenga los nueve dígitos. La validación separa los ocho primeros del noveno proporcionado, calcula el valor esperado e indica si ambos coinciden. También devuelve los dígitos proporcionado y esperado, lo que facilita diagnosticar un fallo. Conserve la entrada como cadena y no como número. Una cadena preserva exactamente todos los caracteres, incluido un cero inicial, y evita que el formato numérico de una hoja de cálculo o de un lenguaje de programación altere el identificador antes de evaluar la suma de comprobación. El modo predeterminado es validar, pero conviene indicarlo expresamente si un proceso admite ambas formas.

Cómo funciona el cálculo de módulo once

El algoritmo procesa los ocho primeros dígitos de izquierda a derecha con pesos descendentes desde nueve hasta dos. Multiplica el primer dígito por nueve, el segundo por ocho y continúa hasta multiplicar el octavo por dos. Después suma esos ocho productos y reduce el total mediante módulo once. Si el resto es cero o uno, el dígito de control es cero. Para cualquier otro resto, el dígito equivale a once menos dicho resto. La validación efectúa exactamente el mismo cálculo sobre las ocho primeras posiciones y compara el resultado con la novena. Esta capacidad no elimina espacios, puntos, guiones, prefijos de país ni etiquetas. Esta exigencia es deliberada: una limpieza automática podría presentar datos mal formados como fiables y ocultar errores en la asignación de campos anterior. Envíe únicamente dígitos ASCII del cero al nueve. El cálculo no usa red, valores aleatorios, reloj, base de datos ni conversiones dependientes de la configuración regional, por lo que una misma entrada y modo siempre generan la misma salida JSON.

Interprete el resultado y sus límites

Un resultado de validación verdadero significa que el noveno dígito concuerda con la suma de comprobación de módulo once obtenida a partir de los ocho anteriores. Es una comprobación estructural útil para detectar errores de escritura, importaciones dañadas y columnas mal asignadas, pero no demuestra que el número haya sido emitido, siga activo o pertenezca a una persona u organización determinada. Para responder a esas cuestiones necesita un registro autorizado o un proceso empresarial de verificación adecuado. Asimismo, esta calculadora evalúa deliberadamente la suma de comprobación sin imponer supuestos sobre categorías codificadas en el primer dígito. Así mantiene un alcance preciso y evita rechazar un número cuya suma es válida solo porque cambie una regla externa de asignación. En una canalización de datos, distinga un error de entrada de un resultado de validez falso: el error indica tipo, longitud, caracteres o modo incorrectos; falso indica que se comprobó un valor bien formado y el dígito no coincidió. Cada solicitud de API cuesta $0.002, y el mismo núcleo determinista puede ejecutarse en el navegador.