Cifre di controllo NIB portoghese
Per il corpo 0002 0123 12345678901 le cifre di controllo sono 54 e il NIB completo diventa 0002.0123.12345678901.54. Inserisca le diciannove cifre per ottenere la coppia di controllo, oppure incolli un NIB intero per verificarlo prima di un bonifico o di un file stipendi. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Nib
- 0002012312345678901
- Modalità di calcolo
- Compute
- Input
- 0002012312345678901
- Banca
- 0002
- Branch
- 0123
- Conto
- 12345678901
Il NIB portoghese (Número de Identificação Bancária) è l'identificativo nazionale del conto bancario a ventuno cifre usato nei bonifici, nei file stipendio, negli addebiti diretti e in molti moduli di pagamento in Portogallo. È composto da un codice banca a quattro cifre, un codice filiale a quattro, un numero di conto a undici e due cifre di controllo finali. Quelle due cifre non sono testo libero: sono interamente determinate dall'algoritmo ISO 7064 MOD 97-10 applicato al corpo di diciannove cifre, così un solo errore di digitazione fallisce quasi sempre il controllo modulare. Questa capacità calcola le due cifre di controllo corrette da banca, filiale e conto (o da un corpo combinato di diciannove cifre), oppure convalida un NIB completo di ventuno cifre che le include già, e segnala l'input non valido invece di inventare un risultato.
Cos'è un NIB portoghese e come si applica ISO 7064 MOD 97-10
Un NIB portoghese identifica un conto bancario nazionale sui circuiti di pagamento del Paese e in molti sistemi aziendali che ancora conservano la forma a ventuno cifre accanto all'IBAN o al suo posto. Estratti e moduli stampati spesso raggruppano le cifre in quattro, quattro, undici e due con punti o spazi, ma il valore sottostante è sempre di ventuno cifre decimali.
Le prime quattro cifre sono il codice banca del sistema bancario portoghese; le quattro successive identificano la filiale o balcão; le undici successive sono il numero di conto come tenuto dalla banca; e le ultime due sono cifre di controllo calcolate dalle diciannove precedenti.
La regola ufficiale è ISO 7064 MOD 97-10: tratti il corpo di diciannove cifre come un intero, aggiunga due zeri, prenda quel valore modulo novantasette e sottragga il resto da novantotto per ottenere un controllo a due cifre nell'intervallo da zero-uno a novantasette, con zeri a sinistra se necessario. In modo equivalente, un NIB ben formato soddisfa la proprietà che il numero completo di ventuno cifre modulo novantasette è uguale a uno.
Quell'identità modulare è della stessa famiglia di controllo usata nella costruzione dell'IBAN, ecco perché gli IBAN portoghesi incorporano il NIB dopo il codice paese e le cifre di controllo IBAN. Rispetto a Luhn modulo dieci sulle carte o a schemi a una cifra come il NIP polacco, il NIB usa un residuo a due cifre MOD 97-10 sull'intero corpo, quindi non deve riutilizzare un validatore Luhn sui campi conto portoghesi.
Rispetto a uno strumento generico ISO 7064 a sistema puro che copre solo MOD 11-2 o MOD 37-2, questa capacità fissa il layout del NIB portoghese e il sistema ibrido MOD 97-10 dei conti bancari. Non interroga elenchi bancari, non dimostra che un conto sia aperto e non converte da solo in IBAN — solo che la stringa di cifre è coerente con l'algoritmo di controllo NIB pubblicato.
Dove le cifre di controllo del NIB portoghese entrano in pagamenti, paghe e onboarding
I bonifici domestici portoghesi, gli schemi SEPA che ancora raccolgono un NIB e molti archivi master di stipendi e fornitori memorizzano l'identificativo a ventuno cifre; una sola cifra di controllo digitata male in onboarding può inviare denaro al conto sbagliato o far fallire la validazione bancaria in seguito. Le app fintech che costruiscono IBAN portoghesi da un NIB possono chiamare la modalità compute sul corpo e verificare che le cifre di controllo incorporate coincidano con il NIB posto dopo il controllo IBAN.
I team di prodotto che già espongono strumenti Luhn o ISO 7064 a sistema puro devono comunque usare questa capacità specifica del NIB per i campi conto portoghesi così che lunghezze, MOD 97-10 e formattazione di visualizzazione corrispondano al dominio. Le landing educative e SEO che si posizionano su frasi come cifre di controllo nib portogallo o calcolatore nib portogallo necessitano di uno strumento gratuito dal vivo il cui percorso browser coincida con l'automazione affinché le schermate dei tutorial restino accurate.
Non consideri un controllo NIB superato come prova che il conto sia aperto, appartenga al cliente indicato o sia autorizzato a un bonifico — dimostra solo che la stringa di cifre è coerente con ISO 7064 MOD 97-10 per il layout del NIB portoghese.
Casi d'uso
Controllare le colonne NIB in paghe e file partner
Convalidi in batch ogni NIB di un import CSV e metta in quarantena le righe le cui cifre di controllo non coincidono più con la coppia attesa ricalcolata secondo ISO 7064 MOD 97-10.
Domande frequenti
Come si calcolano le cifre di controllo del NIB portoghese?
Prenda il corpo di 19 cifre (banca 4 + filiale 4 + conto 11), aggiunga 00, calcoli quel numero modulo 97 e imposti le due cifre di controllo a 98 meno il resto, con zeri a sinistra fino a due cifre (ISO 7064 MOD 97-10). Un NIB completo di 21 cifre è valido quando il numero modulo 97 è uguale a 1.
Qual è la differenza tra le modalità compute e validate?
Validate prende 21 cifre inclusa la coppia di controllo e restituisce se coincidono con le cifre ricalcolate.
Sono ammessi spazi, punti e trattini?
Sì. I separatori comuni vengono rimossi prima dell'analisi.
Un NIB valido dimostra che il conto esiste?
No. Un risultato valido indica soltanto che le cifre sono coerenti con il calcolo ufficiale. Lo strumento non consulta elenchi bancari, non conferma che il conto sia aperto e non dice chi ne è il titolare.
Che rapporto c'è tra il NIB e l'IBAN portoghese?
L'IBAN portoghese contiene il NIB completo subito dopo il codice del paese e le sue due cifre di controllo. Entrambi usano la stessa famiglia di verifica modulo 97, ma questo strumento lavora sul NIB e non costruisce l'IBAN.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"nib": "0002012312345678901",
"number": "valor-ejemplo"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "enc.nib_portugal",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
La usi gratis nel browser o chiami l'API KIT al prezzo pubblicato; entrambi i percorsi eseguono la stessa aritmetica deterministica senza rete e senza elenco bancario.
Cos'è un NIB portoghese e come si applica ISO 7064 MOD 97-10
Sapere quale schema le serve evita una falsa fiducia quando un'utilità generica di cifre di controllo accetta una stringa che non è un NIB ben formato. Questo strumento implementa l'aritmetica modulare su cifre pure dopo la rimozione opzionale di spazi, punti e trattini.
Come calcolare le due cifre di controllo o convalidare un NIB completo
Sono richieste le cifre da zero a nove; spazi, punti, underscore o trattini opzionali vengono rimossi prima dell'analisi. La modalità validate attende un NIB completo a ventuno cifre inclusa la coppia di controllo finale (ad esempio 000201231234567890154 o 0002.0123.12345678901.54). Stringhe vuote, campi mancanti, valori di mode non validi e lunghezze errate falliscono prima dell'aritmetica modulare e non vengono fatturati. Preferisca compute quando assembla un NIB da banca, filiale e conto noti; preferisca validate quando un utente, un file partner o un estratto scansionato fornisce un numero completo e le serve un filtro booleano prima di un bonifico o della scrittura di dati anagrafici. Invii un campo nib combinato oppure i campi strutturati bank, branch e account. Lettere e altra punteggiatura sono rifiutate come input malformato con invalid_input, così non accetta mai un valore ripulito in silenzio. La modalità compute è quella predefinita: fornisca esattamente diciannove cifre del corpo senza le cifre di controllo (ad esempio 0002012312345678901 oppure bank 0002, branch 0123, account 12345678901) e il motore restituisce check_digits come stringa di due caratteri, with_check come NIB completo a ventuno cifre e formatted nella forma comune XXXX.XXXX.XXXXXXXXXXX.XX, insieme a bank, branch, account, algorithm iso7064_mod97_10 e mod97_remainder pari a uno sul numero completato. La risposta indica valid true quando le cifre di controllo ricalcolate coincidono con le ultime due e il numero completo è congruente a uno modulo novantasette; include sempre expected_check_digits, payload senza la coppia di controllo e formatted per una visualizzazione coerente. Poiché il percorso è pure parse senza orologio, casualità né rete, lo stesso input produce sempre lo stesso JSON sullo strumento gratuito del browser e sull'API. A $0.002 per richiesta riuscita può filtrare import massivi di pagamenti, paghe e onboarding senza negoziare un piano su misura.
Dove le cifre di controllo del NIB portoghese entrano in pagamenti, paghe e onboarding
La modalità validate in ingresso blocca il salvataggio quando valid è false e può mostrare expected_check_digits affinché l'operatore corregga il modulo prima della scrittura del record. Gli import di paghe ed ERP ricevono NIB partner da fogli di calcolo in cui una coppia finale errata rifiuterebbe un intero lotto; un oracolo deterministico che restituisce valid e with_check consente di segnalare le righe prima della produzione.
Casi di integrazione
Filtrare i campi NIB nei moduli di pagamento e fornitori
Quando un utente invia un NIB portoghese completo, chiami la modalità validate e blocchi il salvataggio se valid è false, mostrando expected_check_digits per correggere un errore di digitazione prima della scrittura del master pagamenti.
Calcolare le due cifre di controllo quando si assemblano i conti
Da banca, filiale e conto (o un corpo di 19 cifre), chiami la modalità compute e memorizzi with_check o formatted così ogni nuovo NIB porta la coppia finale corretta prima di stampa, export o generazione di bonifici.
Domande tecniche
Cosa succede se le cifre di controllo sono errate?
In modalità validate la risposta include ancora expected_check_digits e valid è false. Input completamente malformato o lunghezze errate falliscono con invalid_input.
Quanto costa il calcolatore delle cifre di controllo del NIB portoghese?
Lo strumento nel browser è gratuito. Le richieste API usano il saldo prepagato KIT a $0.002 per chiamata riuscita; l'input non valido non viene fatturato.