Chiffres de contrôle NIB portugais
Pour le corps 0002 0123 12345678901, les chiffres de contrôle sont 54 et le NIB complet devient 0002.0123.12345678901.54. Saisissez les dix-neuf chiffres pour obtenir la clé, ou collez un NIB entier pour le vérifier avant un virement ou un fichier de paie. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Nib
- 0002012312345678901
- Mode de calcul
- Compute
- Entrée
- 0002012312345678901
- Banque
- 0002
- Branche
- 0123
- Compte
- 12345678901
Le NIB portugais (Número de Identificação Bancária) est l'identifiant national de compte bancaire à vingt et un chiffres utilisé pour les virements, les fichiers de salaires, les prélèvements et de nombreux formulaires de paiement au Portugal. Il se compose d'un code banque à quatre chiffres, d'un code guichet à quatre, d'un numéro de compte à onze et de deux chiffres de contrôle finaux. Ces deux chiffres ne sont pas du texte libre : ils sont entièrement déterminés par l'algorithme ISO 7064 MOD 97-10 appliqué au corps de dix-neuf chiffres, de sorte qu'une seule faute de frappe échoue presque toujours au contrôle modulaire. Cette capacité calcule les deux chiffres de contrôle corrects à partir de la banque, du guichet et du compte (ou d'un corps combiné de dix-neuf chiffres), ou valide un NIB complet de vingt et un chiffres qui les inclut déjà, et signale les entrées incorrectes au lieu d'inventer un résultat.
Qu'est-ce qu'un NIB portugais et comment s'applique l'ISO 7064 MOD 97-10
Un NIB portugais identifie un compte bancaire domestique sur les rails de paiement nationaux et dans de nombreux systèmes d'entreprise qui stockent encore la forme à vingt et un chiffres à côté de l'IBAN ou à sa place. Les relevés et formulaires imprimés regroupent souvent les chiffres en quatre, quatre, onze et deux avec des points ou des espaces, mais la valeur sous-jacente est toujours de vingt et un chiffres décimaux.
Les quatre premiers sont le code banque du système bancaire portugais ; les quatre suivants identifient le guichet ou balcão ; les onze suivants sont le numéro de compte tel que tenu par la banque ; et les deux derniers sont des chiffres de contrôle calculés à partir des dix-neuf précédents.
La règle officielle est ISO 7064 MOD 97-10 : traitez le corps de dix-neuf chiffres comme un entier, ajoutez deux zéros, prenez cette valeur modulo quatre-vingt-dix-sept et soustrayez le reste de quatre-vingt-dix-huit pour obtenir un contrôle à deux chiffres allant de zéro-un à quatre-vingt-dix-sept, complété par des zéros à gauche si besoin. De façon équivalente, un NIB bien formé satisfait la propriété que le nombre complet de vingt et un chiffres modulo quatre-vingt-dix-sept est égal à un.
Cette identité modulaire appartient à la même famille de contrôle que la construction de l'IBAN, c'est pourquoi les IBAN portugais intègrent le NIB après le code pays et les chiffres de contrôle de l'IBAN. Par rapport à Luhn modulo dix sur les cartes ou aux schémas à un chiffre comme le NIP polonais, le NIB utilise un résidu à deux chiffres MOD 97-10 sur tout le corps : vous ne devez donc pas réutiliser un validateur Luhn sur les champs de compte portugais.
Par rapport à un outil générique ISO 7064 en système pur qui ne couvre que MOD 11-2 ou MOD 37-2, cette capacité fixe la disposition du NIB portugais et le système hybride MOD 97-10 des comptes bancaires. Savoir quel schéma vous devez utiliser évite une fausse confiance lorsqu'un utilitaire générique de chiffres de contrôle accepte une chaîne qui n'est pas un NIB bien formé. Cet outil implémente l'arithmétique modulaire sur des chiffres purs après suppression optionnelle des espaces, points et tirets.
Il ne consulte pas d'annuaires bancaires, ne prouve pas qu'un compte est ouvert et ne convertit pas seul en IBAN — seulement que la chaîne de chiffres est cohérente avec l'algorithme de contrôle NIB publié.
Où les chiffres de contrôle du NIB portugais s'insèrent dans paiements, paie et onboarding
Les virements domestiques portugais, les schémas SEPA qui collectent encore un NIB et de nombreux registres maîtres de salaires et fournisseurs stockent l'identifiant à vingt et un chiffres ; un seul chiffre de contrôle mal saisi à l'onboarding peut envoyer de l'argent sur le mauvais compte ou faire échouer la validation bancaire plus tard. Les applications fintech qui construisent des IBAN portugais à partir d'un NIB peuvent appeler le mode compute sur le corps et vérifier que les chiffres de contrôle intégrés correspondent au NIB placé après le contrôle IBAN.
Les équipes produit qui exposent déjà des outils Luhn ou ISO 7064 en système pur doivent tout de même utiliser cette capacité spécifique au NIB pour les champs de compte portugais afin que longueurs, MOD 97-10 et format d'affichage correspondent au domaine. Les pages éducatives et SEO qui se positionnent sur des expressions comme chiffres de contrôle nib portugal ou calculatrice nib portugal ont besoin d'un outil gratuit en direct dont le chemin navigateur correspond à l'automatisation pour que les captures de tutoriels restent exactes.
Ne traitez pas un contrôle NIB réussi comme preuve que le compte est ouvert, appartient au client nommé ou est autorisé pour un virement — cela prouve seulement que la chaîne de chiffres est cohérente avec ISO 7064 MOD 97-10 pour la disposition du NIB portugais.
Cas d’usage
Auditer les colonnes NIB dans la paie et les fichiers partenaires
Validez par lots chaque NIB d'un import CSV et mettez en quarantaine les lignes dont les chiffres de contrôle ne correspondent plus à la paire attendue recalculée selon ISO 7064 MOD 97-10.
Questions fréquentes
Comment calcule-t-on les chiffres de contrôle du NIB portugais ?
Prenez le corps de 19 chiffres (banque 4 + guichet 4 + compte 11), ajoutez 00, calculez ce nombre modulo 97 et fixez les deux chiffres de contrôle à 98 moins le reste, complétés sur deux chiffres (ISO 7064 MOD 97-10). Un NIB complet de 21 chiffres est valide lorsque le nombre modulo 97 est égal à 1.
Quelle est la différence entre les modes compute et validate ?
Validate prend 21 chiffres incluant la paire de contrôle et indique s'ils correspondent aux chiffres recalculés.
Les espaces, points et tirets sont-ils autorisés ?
Oui. Les séparateurs courants sont supprimés avant l'analyse.
Un NIB valide prouve-t-il que le compte existe ?
Non. Un résultat valide signifie seulement que les chiffres respectent le calcul officiel. L'outil ne consulte aucun annuaire bancaire, ne confirme pas que le compte est ouvert et n'indique pas son titulaire.
Quel est le lien entre le NIB et l'IBAN portugais ?
L'IBAN portugais contient le NIB complet juste après le code pays et ses deux chiffres de contrôle. Les deux reposent sur la même famille de contrôle modulo 97, mais cet outil traite le NIB seul et ne construit pas l'IBAN.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
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"}'const res = await fetch("https://api.kit.forhosting.com/enc/nib-portugal", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"nib": "0002012312345678901",
"number": "valor-ejemplo"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/enc/nib-portugal",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"nib": "0002012312345678901",
"number": "valor-ejemplo"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/nib-portugal", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"nib":"0002012312345678901","number":"valor-ejemplo"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"nib":"0002012312345678901","number":"valor-ejemplo"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/nib-portugal", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"nib": "0002012312345678901",
"number": "valor-ejemplo"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.nib_portugal",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Utilisez-la gratuitement dans le navigateur ou appelez l'API KIT au prix publié ; les deux chemins exécutent la même arithmétique déterministe sans requête réseau ni annuaire bancaire.
Comment calculer les deux chiffres de contrôle ou valider un NIB complet
Les chiffres de zéro à neuf sont requis ; les espaces, points, underscores ou tirets optionnels sont supprimés avant l'analyse. Le mode validate attend un NIB complet de vingt et un chiffres incluant la paire de contrôle finale (par exemple 000201231234567890154 ou 0002.0123.12345678901.54). Les chaînes vides, champs manquants, valeurs de mode invalides et mauvaises longueurs échouent avant l'arithmétique modulaire et ne sont pas facturés. Préférez compute lorsque vous assemblez un NIB à partir de banque, guichet et compte connus ; préférez validate lorsqu'un utilisateur, un fichier partenaire ou un relevé numérisé fournit un numéro complet et que vous avez besoin d'un filtre booléen avant un virement ou l'écriture de données maîtres. Envoyez un champ nib combiné ou les champs structurés bank, branch et account. Les lettres et autre ponctuation sont rejetées comme entrée mal formée avec invalid_input afin que vous n'acceptiez jamais une valeur nettoyée en silence. Le mode compute est le défaut : fournissez exactement dix-neuf chiffres du corps sans les chiffres de contrôle (par exemple 0002012312345678901 ou bank 0002, branch 0123, account 12345678901) et le moteur renvoie check_digits comme chaîne de deux caractères, with_check comme le NIB complet de vingt et un chiffres et formatted sous la forme courante XXXX.XXXX.XXXXXXXXXXX.XX, avec bank, branch, account, algorithm iso7064_mod97_10 et mod97_remainder égal à un sur le nombre complété. La réponse indique valid true lorsque les chiffres de contrôle recalculés correspondent aux deux derniers et que le nombre complet est congruent à un modulo quatre-vingt-dix-sept ; elle inclut toujours expected_check_digits, payload sans la paire de contrôle et formatted pour un affichage cohérent. Comme le chemin est pure parse sans horloge, source aléatoire ni réseau, la même entrée produit toujours le même JSON sur l'outil gratuit du navigateur et sur l'API. À $0.002 par requête réussie, vous pouvez filtrer les imports massifs de paiements, paies et onboarding sans négocier un palier sur mesure.
Où les chiffres de contrôle du NIB portugais s'insèrent dans paiements, paie et onboarding
Le mode validate à l'entrée bloque l'enregistrement lorsque valid est false et peut afficher expected_check_digits pour que le préposé corrige le formulaire avant l'écriture du dossier. Les imports de paie et d'ERP reçoivent des NIB partenaires depuis des tableurs où une mauvaise paire finale rejetterait un lot entier ; un oracle déterministe qui renvoie valid et with_check permet de signaler les lignes avant la production.
Cas d'intégration
Filtrer les champs NIB sur les formulaires de paiement et fournisseurs
Lorsqu'un utilisateur soumet un NIB portugais complet, appelez le mode validate et bloquez l'enregistrement si valid est false, en affichant expected_check_digits pour corriger une faute de frappe avant l'écriture du maître de paiement.
Calculer les deux chiffres de contrôle lors de l'assemblage des comptes
À partir de banque, guichet et compte (ou d'un corps de 19 chiffres), appelez le mode compute et stockez with_check ou formatted pour que chaque nouveau NIB porte la paire finale correcte avant impression, export ou génération de virement.
Questions techniques
Que se passe-t-il si les chiffres de contrôle sont incorrects ?
En mode validate la réponse inclut toujours expected_check_digits et valid est false. Une entrée complètement mal formée ou de mauvaise longueur échoue avec invalid_input.
Combien coûte le calculateur de chiffres de contrôle du NIB portugais ?
L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; l'entrée invalide n'est pas facturée.