ForHosting KIT · Utilidades de desarrollo

Dígitos de control NIB portugués

Para el cuerpo 0002 0123 12345678901 los dígitos de control son 54, y el NIB completo queda 0002.0123.12345678901.54. Escriba los diecinueve dígitos para obtener el par de control, o pegue un NIB entero para comprobarlo antes de una transferencia o una nómina. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Nib
0002012312345678901
Modo de cálculo
Compute
Obtiene
Entrada
0002012312345678901
Banco
0002
Rama
0123
Cuenta
12345678901

El NIB portugués (Número de Identificação Bancária) es el identificador nacional de cuenta bancaria de veintiún dígitos usado en transferencias, nóminas, adeudos y muchos formularios de pago en Portugal. Se compone de un código de banco de cuatro dígitos, un código de sucursal de cuatro, un número de cuenta de once y dos dígitos de control finales. Esos dos dígitos no son texto libre: los determina por completo el algoritmo ISO 7064 MOD 97-10 aplicado al cuerpo de diecinueve dígitos, de modo que un solo error de tecleo casi siempre falla la comprobación modular. Esta capacidad calcula los dos dígitos de control correctos a partir del banco, la sucursal y la cuenta (o de un cuerpo combinado de diecinueve dígitos), o valida un NIB completo de veintiún dígitos que ya los incluye, e informa de entradas incorrectas en lugar de inventar un resultado.

Qué es un NIB portugués y cómo se aplica ISO 7064 MOD 97-10

Un NIB portugués identifica una cuenta bancaria nacional en los sistemas de pago del país y en muchos sistemas empresariales que aún guardan la forma de veintiún dígitos junto al IBAN o en su lugar. Los extractos y formularios suelen agrupar los dígitos como cuatro, cuatro, once y dos con puntos o espacios, pero el valor subyacente son siempre veintiún dígitos decimales.

Los cuatro primeros son el código de banco del sistema bancario portugués; los cuatro siguientes identifican la sucursal o balcão; los once siguientes son el número de cuenta según el banco; y los dos finales son dígitos de control calculados a partir de los diecinueve precedentes.

La regla oficial es ISO 7064 MOD 97-10: trate el cuerpo de diecinueve dígitos como un entero, añada dos ceros, tome ese valor módulo noventa y siete y reste el resto de noventa y ocho para obtener un control de dos dígitos en el rango de cero-uno a noventa y siete, rellenado con ceros a la izquierda si hace falta. De forma equivalente, un NIB bien formado cumple que el número completo de veintiún dígitos módulo noventa y siete es igual a uno.

Esa identidad modular es de la misma familia de comprobación que se usa al construir el IBAN, por eso los IBAN portugueses incorporan el NIB tras el código de país y los dígitos de control del IBAN. Frente a Luhn módulo diez en tarjetas o esquemas de un solo dígito como el NIP polaco, el NIB usa un residuo de dos dígitos MOD 97-10 sobre todo el cuerpo, así que no debe reutilizar un validador Luhn en campos de cuenta portugueses.

Frente a una herramienta genérica ISO 7064 de sistema puro que solo cubre MOD 11-2 o MOD 37-2, esta capacidad fija el diseño del NIB portugués y el sistema híbrido MOD 97-10 de las cuentas bancarias. Saber qué esquema necesita evita una falsa confianza cuando un utilitario genérico de dígitos de control acepta una cadena que no es un NIB bien formado. Esta herramienta implementa la aritmética modular sobre dígitos puros tras eliminar opcionalmente espacios, puntos y guiones.

No consulta directorios bancarios, no demuestra que una cuenta esté abierta ni convierte por sí sola a IBAN: solo comprueba que la cadena de dígitos es coherente con el algoritmo de control del NIB publicado.

Dónde encajan los dígitos de control del NIB portugués en pagos, nómina y altas

Las transferencias nacionales portuguesas, los esquemas SEPA que aún recogen un NIB y muchos maestros de nómina y proveedores guardan el identificador de veintiún dígitos; un solo dígito de control mal tecleado en el alta puede enviar dinero a la cuenta equivocada o fallar la validación bancaria más adelante. Las aplicaciones fintech que construyen IBAN portugueses a partir de un NIB pueden llamar al modo compute sobre el cuerpo y comprobar que los dígitos de control embebidos coinciden con el NIB que colocarán tras el control del IBAN.

Los equipos de producto que ya exponen herramientas Luhn o ISO 7064 de sistema puro deben usar igualmente esta capacidad específica de NIB en campos de cuenta portugueses para que longitudes, MOD 97-10 y formato de visualización coincidan con el dominio. Las páginas educativas y SEO que posicionan frases como dígitos de control NIB portugal o calculadora NIB portugal necesitan una herramienta gratuita en vivo cuya ruta del navegador coincida con la automatización para que las capturas de tutoriales sigan siendo exactas.

No trate un NIB que pasa el control como prueba de que la cuenta está abierta, pertenece al cliente indicado o está autorizada para una transferencia: solo demuestra que la cadena de dígitos es coherente con ISO 7064 MOD 97-10 para el diseño del NIB portugués.

Auditar columnas NIB en nóminas y ficheros de socios

Valide por lotes cada NIB de una importación CSV y ponga en cuarentena las filas cuyos dígitos de control ya no coincidan con el par esperado recalculado según ISO 7064 MOD 97-10.

¿Cómo se calculan los dígitos de control del NIB portugués?

Tome el cuerpo de 19 dígitos (banco 4 + sucursal 4 + cuenta 11), añada 00, calcule ese número módulo 97 y fije los dos dígitos de control como 98 menos el resto, rellenados a dos dígitos (ISO 7064 MOD 97-10). Un NIB completo de 21 dígitos es válido cuando el número módulo 97 es igual a 1.

¿Cuál es la diferencia entre los modos compute y validate?

Validate toma 21 dígitos con el par de control y devuelve si coinciden con los dígitos recalculados.

¿Se permiten espacios, puntos y guiones?

Sí. Los separadores habituales se eliminan antes del análisis.

¿Un NIB válido demuestra que la cuenta existe?

No. Un resultado válido solo indica que los dígitos cuadran con el cálculo oficial. La herramienta no consulta directorios bancarios, no confirma que la cuenta esté abierta ni dice quién es su titular.

¿Qué relación hay entre el NIB y el IBAN portugués?

El IBAN portugués lleva el NIB completo justo después del código de país y de sus dos dígitos de control. Ambos usan la misma familia de comprobación módulo 97, pero esta herramienta trabaja sobre el NIB y no construye el IBAN.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/enc/nib-portugal

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/enc/nib-portugal \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"nib":"0002012312345678901","number":"valor-ejemplo"}'
{
  "nib": "0002012312345678901",
  "number": "valor-ejemplo"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.nib_portugal",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Úselo gratis en el navegador o llame a la API de KIT al precio publicado; ambos caminos ejecutan la misma aritmética determinista sin consulta de red ni directorio bancario.

Cómo calcular los dos dígitos de control o validar un NIB completo

Se exigen dígitos del cero al nueve; los espacios, puntos, guiones bajos o guiones opcionales se eliminan antes del análisis. El modo validate espera un NIB completo de veintiún dígitos con el par de control final (por ejemplo 000201231234567890154 o 0002.0123.12345678901.54). Cadenas vacías, campos ausentes, valores de mode no válidos y longitudes incorrectas fallan antes de la aritmética modular y no se facturan. Prefiera compute cuando ensamble un NIB a partir de banco, sucursal y cuenta conocidos; prefiera validate cuando un usuario, un fichero de socio o un extracto escaneado aporte un número completo y necesite un filtro booleano antes de una transferencia o de escribir datos maestros. Envíe un campo nib combinado o los campos estructurados bank, branch y account. Las letras y otra puntuación se rechazan como entrada malformada con invalid_input, de modo que nunca acepte un valor limpiado en silencio. El modo compute es el predeterminado: proporcione exactamente diecinueve dígitos del cuerpo sin los de control (por ejemplo 0002012312345678901 o bank 0002, branch 0123, account 12345678901) y el motor devuelve check_digits como cadena de dos caracteres, with_check como el NIB completo de veintiún dígitos y formatted en la forma habitual XXXX.XXXX.XXXXXXXXXXX.XX, junto con bank, branch, account, algorithm iso7064_mod97_10 y mod97_remainder de uno sobre el número completado. La respuesta indica valid true cuando los dígitos de control recalculados coinciden con los dos últimos y el número completo es congruente con uno módulo noventa y siete; siempre incluye expected_check_digits, payload sin el par de control y formatted para una visualización coherente. Como la ruta es pure parse sin reloj, aleatoriedad ni red, la misma entrada produce siempre el mismo JSON en la herramienta gratuita del navegador y en la API. A $0.002 por solicitud correcta puede filtrar importaciones masivas de pagos, nóminas y altas sin negociar un tramo a medida.

Dónde encajan los dígitos de control del NIB portugués en pagos, nómina y altas

El modo validate en la entrada bloquea el guardado cuando valid es false y puede mostrar expected_check_digits para que el operador corrija el formulario antes de escribir el registro. Las importaciones de nómina y ERP reciben NIB de socios desde hojas de cálculo donde un par final incorrecto rechazaría un lote entero; un oráculo determinista que devuelve valid y with_check permite marcar filas antes de producción.

Filtrar campos NIB en formularios de pago y proveedores

Cuando un usuario envíe un NIB portugués completo, llame al modo validate y bloquee el guardado si valid es false, mostrando expected_check_digits para corregir un error de tecleo antes de escribir el maestro de pagos.

Calcular los dos dígitos de control al montar cuentas

A partir del banco, la sucursal y la cuenta (o un cuerpo de 19 dígitos), llame al modo compute y guarde with_check o formatted para que cada NIB nuevo lleve el par final correcto antes de imprimir, exportar o generar transferencias.

¿Qué ocurre si los dígitos de control son incorrectos?

En el modo validate la respuesta sigue incluyendo expected_check_digits y valid es false. La entrada completamente malformada o con longitudes incorrectas falla con invalid_input.

¿Cuánto cuesta la calculadora de dígitos de control del NIB portugués?

La herramienta del navegador es gratuita. Las solicitudes a la API usan saldo prepago de KIT a $0.002 por llamada correcta; la entrada no válida no se factura.

Ver la documentación completa del KIT →