Generatore e Validatore CBU per l'Argentina | Codici Bancari BCRA
Genera e convalida i codici bancari CBU (Clave Bancaria Uniforme) argentini. Strumento gratuito che utilizza gli algoritmi ufficiali BCRA per sviluppatori, tester e applicazioni finanziarie.
Generatore e Validatore CBU Argentino
Genera un CBU casuale ma valido per testare le tue applicazioni e integrazioni.
Fai clic sul pulsante sopra per generare un CBU valido
Informazioni sul CBU
Il CBU (Clave Bancaria Uniforme) è un codice di 22 cifre utilizzato in Argentina per identificare i conti bancari per trasferimenti elettronici e pagamenti.
Ogni CBU contiene informazioni sulla banca, sulla filiale e sul numero di conto, insieme a cifre di verifica che ne garantiscono la validità.
Struttura del CBU
Documentazione
Cos'è un CBU argentino e perché validarlo?
Lavorare con il sistema bancario argentino significa confrontarsi con il CBU (Clave Bancaria Uniforme), un codice di 22 cifre che identifica in modo univoco ogni conto bancario del paese. Se hai mai avuto bisogno di testare un'integrazione di pagamento, verificare i dettagli bancari prima di un trasferimento o capire perché una transazione è fallita, sai quanto sia importante lavorare con CBU formattati correttamente.
Questo strumento ti aiuta a generare CBU strutturalmente validi per ambienti di test e a convalidare i codici esistenti rispetto al formato ufficiale specificato dalla Banca Centrale Argentina (BCRA). Quando si sviluppano applicazioni finanziarie o si elaborano pagamenti, individuare gli errori di formato fin da subito fa risparmiare ore di debug e previene transazioni fallite.
Comprendere il Formato CBU
Il CBU (Clave Bancaria Uniforme) è la risposta dell'Argentina agli identificatori bancari internazionali come IBAN o numeri di routing statunitensi. Pensalo come un pacchetto completo che raggruppa le informazioni della banca, della filiale e del conto in un unico codice di 22 cifre. La Banca Centrale dell'Argentina (BCRA) ha introdotto questo sistema nel novembre 2000 per standardizzare i trasferimenti elettronici attraverso la rete finanziaria del paese.
Struttura e Formato del CBU
Ogni CBU valido è composto esattamente da 22 cifre divise in due blocchi principali:
-
Primo Blocco (8 cifre): Identifica l'istituto finanziario e la filiale
- Prime 3 cifre: Codice banca assegnato dalla BCRA
- Successive 4 cifre: Codice filiale all'interno della banca
- Ultima cifra: Cifra di verifica per il primo blocco
-
Secondo Blocco (14 cifre): Identifica il conto specifico
- Prime 13 cifre: Numero di conto (può includere il tipo di conto e altri identificatori)
- Ultima cifra: Cifra di verifica per il secondo blocco
Le cifre di verifica utilizzano un algoritmo di modulo-10 ponderato che individua gli errori di battitura comuni, come cifre invertite o errori su singole cifre, prima che avvenga qualsiasi movimento di denaro. Questa salvaguardia si è dimostrata straordinariamente efficace: la maggior parte degli errori di inserimento del CBU viene intercettata durante la fase di convalida, piuttosto che causare trasferimenti falliti.
Come Generare un CBU di Test
Il generatore crea CBU casuali ma strutturalmente validi che superano tutti i controlli di formato. Ecco cosa accade dietro le quinte:
- Cifre casuali riempiono le sezioni del codice banca, codice filiale e numero di conto
- Lo strumento calcola entrambe le cifre di verifica utilizzando l'algoritmo ufficiale BCRA
- Ottieni un CBU completamente formattato da 22 cifre pronto per i test
Quando questo sarà utile:
- Test di integrazione dei pagamenti: Hai bisogno di dozzine di CBU validi per la tua suite di test? Generali istantaneamente senza calcoli manuali.
- Ambienti QA e staging: Popola database di test con dati bancari realistici che non corrispondano accidentalmente a conti reali.
- Apprendimento del formato: Vedi come sono strutturati i diversi CBU e comprendi la logica di verifica.
- Documentazione e demo: Crea dati di esempio che sembrano autentici senza esporre informazioni bancarie reali.
Procedura Passo-Passo: Generazione di un CBU
- Vai alla scheda "Generatore" dello strumento
- Fai clic sul pulsante "Genera CBU"
- Un CBU casuale valido da 22 cifre apparirà nell'area di visualizzazione
- Usa il pulsante "Copia" per copiare il CBU negli appunti per utilizzarlo nelle tue applicazioni
Come Convalidare un CBU Argentino
Il validatore esegue gli stessi controlli che i sistemi bancari argentini utilizzano per verificare l'integrità del CBU. Cosa viene controllato:
- Verifica della lunghezza: Conferma esattamente 22 cifre (un errore comune è copiare con spazi o trattini)
- Contenuto solo numerico: Assicura che non siano presenti lettere o caratteri speciali
- Checksum del primo blocco: Convalida l'8° cifra rispetto alle prime 7 cifre
- Checksum del secondo blocco: Convalida la 22° cifra rispetto alle cifre 9-21
Quando la convalida fallisce, vedrai quale controllo specifico non è passato. Questo è particolarmente utile quando si esegue il debug del motivo per cui un'API bancaria ha rifiutato un CBU—spesso è qualcosa di semplice come uno spazio extra o una cifra trasposta.
Procedura Passo-Passo: Convalidare un CBU
- Vai alla scheda "Validatore" dello strumento
- Inserisci il CBU di 22 cifre che vuoi convalidare
- Fai clic sul pulsante "Convalida CBU"
- Rivedi il risultato della convalida:
- Indicatore verde per CBU validi
- Indicatore rosso con messaggi di errore specifici per CBU non validi
Spiegazione dell'Algoritmo di Verifica CBU
La BCRA utilizza un algoritmo di checksum ponderato modulo-10 per calcolare le cifre di verifica. Se stai implementando la convalida CBU nella tua applicazione, ecco l'esatta logica:
Verifica del Primo Blocco
Per il primo blocco (primi 8 cifre), la cifra di verifica viene calcolata come segue:
- Prendi i primi 7 cifre del CBU
- Moltiplica ogni cifra per il suo peso corrispondente: [7, 1, 3, 9, 7, 1, 3]
- Somma i prodotti risultanti
- Calcola: 10 - (somma % 10)
- Se il risultato è 10, la cifra di verifica è 0; altrimenti, è il valore calcolato
Verifica del Secondo Blocco
Per il secondo blocco (ultimi 14 cifre), la cifra di verifica viene calcolata come segue:
- Prendi i primi 13 cifre del secondo blocco
- Moltiplica ogni cifra per il suo peso corrispondente: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
- Somma i prodotti risultanti
- Calcola: 10 - (somma % 10)
- Se il risultato è 10, la cifra di verifica è 0; altrimenti, è il valore calcolato
Esempi di Convalida del Codice CBU
Ecco come implementare la convalida CBU nella tua applicazione. Questi esempi seguono la specifica ufficiale della BCRA e funzioneranno con dati bancari di produzione:
1// JavaScript: Calcolare la cifra di controllo CBU
2function calculateCheckDigit(number, weights) {
3 if (number.length !== weights.length) {
4 throw new Error('La lunghezza del numero deve corrispondere alla lunghezza dei pesi');
5 }
6
7 let sum = 0;
8 for (let i = 0; i < number.length; i++) {
9 sum += parseInt(number[i]) * weights[i];
10 }
11
12 const remainder = sum % 10;
13 return remainder === 0 ? 0 : 10 - remainder;
14}
15
16// Convalidare il primo blocco del CBU
17function validateFirstBlock(block) {
18 if (block.length !== 8 || !/^\d{8}$/.test(block)) {
19 return false;
20 }
21
22 const number = block.substring(0, 7);
23 const checkDigit = parseInt(block[7]);
24 const weights = [7, 1, 3, 9, 7, 1, 3];
25
26 return checkDigit === calculateCheckDigit(number, weights);
27}
281# Python: Convalidare un CBU completo
2import re
3
4def validate_cbu(cbu):
5 # Controllare il formato di base
6 if not cbu or not re.match(r'^\d{22}$', cbu):
7 return {
8 'isValid': False,
9 'errors': ['Il CBU deve essere di 22 cifre']
10 }
11
12 # Dividere in blocchi
13 first_block = cbu[:8]
14 second_block = cbu[8:]
15
16 # Convalidare ogni blocco
17 first_block_valid = validate_first_block(first_block)
18 second_block_valid = validate_second_block(second_block)
19
20 errors = []
21 if not first_block_valid:
22 errors.append('Il primo blocco (codice banca/filiale) non è valido')
23 if not second_block_valid:
24 errors.append('Il secondo blocco (numero di conto) non è valido')
25
26 return {
27 'isValid': first_block_valid and second_block_valid,
28 'errors': errors
29 }
301// Java: Generare un CBU valido casuale
2import java.util.Random;
3
4public class CBUGenerator {
5 private static final Random random = new Random();
6
7 public static String generateCBU() {
8 // Generare le prime 7 cifre (codice banca e filiale)
9 StringBuilder firstBlockBase = new StringBuilder();
10 for (int i = 0; i < 7; i++) {
11 firstBlockBase.append(random.nextInt(10));
12 }
13
14 // Calcolare la cifra di controllo per il primo blocco
15 int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16 int firstBlockCheckDigit = calculateCheckDigit(
17 firstBlockBase.toString(),
18 firstBlockWeights
19 );
20
21 // Generare le prime 13 cifre del secondo blocco
22 StringBuilder secondBlockBase = new StringBuilder();
23 for (int i = 0; i < 13; i++) {
24 secondBlockBase.append(random.nextInt(10));
25 }
26
27 // Calcolare la cifra di controllo per il secondo blocco
28 int[] secondBlockWeights = {3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3};
29 int secondBlockCheckDigit = calculateCheckDigit(
30 secondBlockBase.toString(),
31 secondBlockWeights
32 );
33
34 // Combinare tutte le parti
35 return firstBlockBase.toString() + firstBlockCheckDigit +
36 secondBlockBase.toString() + secondBlockCheckDigit;
37 }
38
39 // Implementazione del metodo calculateCheckDigit...
40}
411// PHP: Formattare un CBU per la visualizzazione
2function formatCBU($cbu) {
3 if (!$cbu || strlen($cbu) !== 22) {
4 return $cbu;
5 }
6
7 // Formattare come: XXXXXXXX XXXXXXXXXXXXXX
8 return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Esempio di utilizzo
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Restituisce: 01234567 89012345678901
141' Excel VBA: Convalidare un CBU
2Function ValidateCBU(cbu As String) As Boolean
3 ' Controllare la lunghezza
4 If Len(cbu) <> 22 Then
5 ValidateCBU = False
6 Exit Function
7 End If
8
9 ' Controllare se tutti i caratteri sono cifre
10 Dim i As Integer
11 For i = 1 To Len(cbu)
12 If Not IsNumeric(Mid(cbu, i, 1)) Then
13 ValidateCBU = False
14 Exit Function
15 End If
16 Next i
17
18 ' Estrarre i blocchi
19 Dim firstBlock As String
20 Dim secondBlock As String
21 firstBlock = Left(cbu, 8)
22 secondBlock = Right(cbu, 14)
23
24 ' Convalidare entrambi i blocchi
25 ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27Casi d'uso reali per la convalida CBU
Test delle integrazioni di pagamento
Quando si sviluppano applicazioni fintech o piattaforme di e-commerce che elaborano pagamenti argentini, sono necessari CBU validi per l'ambiente di test. Uno scenario comune: l'ambiente di staging richiede 50 account di test con CBU validi per il test di carico. Calcolare manualmente le cifre di controllo per ciascuno richiederebbe ore. Il generatore gestisce questo in pochi secondi, fornendo dati di test formattati correttamente che si comportano come CBU di produzione senza il rischio di utilizzare accidentalmente numeri di conto reali.
Suggerimento: Conserva una serie di CBU generati nei tuoi fixture di test. Questo garantisce dati di test coerenti all'interno del tuo team e rende il debug più semplice quando i test falliscono.
Prevenzione degli errori di transazione
Ecco cosa accade tipicamente: un cliente fornisce il proprio CBU per un bonifico, ma ha accidentalmente incluso spazi o scambiato due cifre. Se si elabora il trasferimento senza convalida, la banca lo rifiuta, ma solo dopo un ritardo, e si è già registrato l'intento di transazione nel sistema. Ora si devono gestire complicazioni di riconciliazione.
La convalida del formato CBU prima dell'invio intercetta immediatamente questi errori. Il validatore non dirà se l'account esiste o appartiene alla persona giusta (richiede l'accesso all'API bancaria), ma confermerà che la struttura è corretta secondo gli standard BCRA.
Comprendere i requisiti di integrazione bancaria
Per gli sviluppatori nuovi al sistema finanziario argentino, questo strumento offre un apprendimento pratico. È possibile vedere esattamente come funzionano le cifre di controllo, capire perché alcuni numeri non sono validi e sperimentare casi limite prima di scrivere codice di produzione.
Errore comune: Presumere che la convalida CBU sia identica alla convalida IBAN. Mentre entrambi utilizzano cifre di controllo, gli algoritmi differiscono completamente. Testare con questo strumento aiuta a comprendere i requisiti specifici dei codici bancari argentini.
Convalida dei moduli nelle interfacce bancarie
Quando si progettano moduli di input che accettano CBU, è necessario testare come il sistema gestisce vari stati di errore. Cosa succede quando un utente incolla un CBU con spazi? Quale messaggio di errore appare quando la cifra di controllo è errata? Questo strumento aiuta a testare questi scenari e a progettare un feedback utente migliore.
Strumenti di Convalida Bancaria Correlati
A seconda delle tue esigenze, potresti avere bisogno di questi strumenti complementari:
- Validatore CUIT/CUIL: Convalida i numeri di identificazione fiscale argentini—essenziale quando hai bisogno di verifica sia bancaria che fiscale
- Validatore CVU: Simile a CBU ma per portafogli digitali (Mercado Pago, Ualá, ecc.) utilizzando lo stesso formato a 22 cifre
- Validatore IBAN: Per pagamenti transfrontalieri che coinvolgono conti europei o internazionali
- Servizi API Bancari: Per sistemi di produzione che necessitano di verificare la proprietà del conto e controllare i saldi, non solo la validazione del formato
Limitazione importante: Questo strumento convalida solo il formato e le cifre di controllo. Non può confermare se un CBU corrisponde a un conto bancario attivo o verificare l'identità del titolare del conto. Per questi controlli, sarà necessaria l'integrazione con le API bancarie argentine o con i processori di pagamento.
Come il Sistema Bancario Argentino ha Adottato il CBU
Prima di novembre 2000, l'invio di denaro tra banche argentine era sorprendentemente complicato. Ogni istituto finanziario utilizzava un proprio sistema di numerazione dei conti—alcuni con 10 cifre, altri con 15, e nessun modo standardizzato per identificare quale banca o filiale detenesse un conto. I trasferimenti interbancari richiedevano una verifica manuale e spesso impiegavano giorni per essere elaborati.
La BCRA ha introdotto il CBU per risolvere questa frammentazione. Imponendo un unico formato di 22 cifre in tutte le istituzioni finanziarie, l'Argentina si è allineata agli standard internazionali come il sistema IBAN europeo. Le cifre di controllo incorporate erano particolarmente intelligenti: catturano automaticamente la maggior parte degli errori di immissione dei dati, riducendo i trasferimenti falliti e i relativi costi di indagine e storno delle transazioni.
Cosa è interessante: Il formato CBU è rimasto praticamente invariato in oltre 20 anni. Mentre la tecnologia bancaria si è evoluta dramatically—app mobili, trasferimenti istantanei, portafogli digitali—la struttura sottostante del CBU rimane la stessa. Questa stabilità dimostra quanto il design originale abbia anticipato le esigenze future.
Oggi, gli argentini utilizzano i CBU per praticamente ogni transazione finanziaria elettronica: depositi di stipendi, pagamenti di bollette, dichiarazioni fiscali, benefici governativi ed e-commerce. Il formato si è rivelato così efficace che quando sono emersi i portafogli digitali (come Mercado Pago), i regolatori hanno adottato la stessa struttura per i CVU (Clave Virtual Uniforme) piuttosto che inventare qualcosa di nuovo.
Domande Frequenti
Qual è la differenza tra un CBU e un CVU?
I CBU identificano conti bancari tradizionali, mentre i CVU (Clave Virtual Uniforme) identificano conti di portafogli digitali di provider fintech come Mercado Pago, Ualá o Brubank. Il formato è identico—22 cifre con lo stesso algoritmo di convalida—il che ha senso perché sono interoperabili. Puoi trasferire denaro da un CBU a un CVU e viceversa proprio come qualsiasi altro trasferimento bancario. Le prime tre cifre rivelano se stai guardando una banca tradizionale o un provider di portafogli digitali.
Posso scoprire il nome della banca da un CBU?
Sì. Le prime tre cifre sono l'identificatore bancario assegnato dalla BCRA. Ad esempio, i codici che iniziano con "011" appartengono a Banco Nación, mentre "017" indica BBVA Argentina. La BCRA pubblica un registro ufficiale di questi codici, che le applicazioni bancarie in genere utilizzano per visualizzare automaticamente il nome della banca quando si inserisce un CBU.
Un CBU è la stessa cosa di un numero di conto?
Non esattamente. Il tuo numero di conto è nascosto all'interno del CBU, ma il CBU lo abbina con informazioni di instradamento aggiuntive. Pensalo come la differenza tra un indirizzo stradale e le coordinate GPS—entrambi identificano una posizione, ma uno include più contesto. Il CBU raggruppa il tuo codice bancario, codice filiale, numero di conto e due cifre di verifica in un'unica stringa trasferibile.
Quanto è sicuro condividere il mio CBU?
Il CBU è progettato per essere condiviso—è proprio questo lo scopo. I destinatari ne hanno bisogno per depositare denaro sul tuo conto. A differenza di password o PIN, un CBU consente solo trasferimenti in entrata, non prelievi. Detto questo, trattalo come qualsiasi informazione finanziaria: condividilo con persone o aziende di cui ti fidi, e fai attenzione a pubblicarlo pubblicamente online. Alcune persone preferiscono dare il loro CBU in modo selettivo piuttosto che pubblicarlo apertamente.
Un CBU può scadere o cambiare?
Il tuo CBU rimane tale finché il conto rimane aperto. L'unico momento in cui cambia è se chiudi quel conto e ne apri uno nuovo, o in casi rari in cui le banche si fondono o riorganizzano i loro sistemi di numerazione. Anche in questi casi, le banche in genere mantengono il vecchio CBU per un periodo di transizione per evitare di interrompere i pagamenti ricorrenti.
Come faccio a trovare il mio CBU?
Controlla l'app mobile della tua banca—di solito si trova nella sezione dettagli del conto. La maggior parte delle banche argentine lo mostra anche in modo prominente nel banking online, lo stampano sugli estratti conto mensili, e alcuni lo includono persino sul retro delle carte di debito. Se non riesci a trovarlo, qualsiasi rappresentante bancario può fornirtelo immediatamente; non è considerato un'informazione sensibile come un PIN.
I cittadini stranieri possono avere un CBU in Argentina?
Sì. Aprire un conto bancario in Argentina come straniero ti dà un CBU proprio come qualsiasi altro titolare di conto. I requisiti variano a seconda dell'istituzione—alcune banche richiedono solo un passaporto, mentre altre chiedono la prova di residenza o un CDI (numero di identificazione fiscale). I portafogli digitali (CVU) sono spesso più facili da ottenere per gli stranieri rispetto ai conti bancari tradizionali.
Cosa succede se faccio un trasferimento a un CBU non valido?
I sistemi bancari moderni eseguono la convalida del formato prima di inviare il trasferimento. Se le cifre di controllo non corrispondono o la lunghezza è sbagliata, riceverai immediatamente un errore—il trasferimento non lascia mai il tuo conto. Ecco perché la convalida front-end è così preziosa; cattura gli errori di battitura prima che causino problemi.
La situazione più complicata è quando un CBU supera la convalida del formato ma non corrisponde a un conto attivo. Il trasferimento viene inviato alla rete interbancaria, poi rimbalza indietro dopo ore o giorni. Lo hai già registrato come "inviato" nella tua contabilità, e ora devi riconciliare il ritorno. Ecco perché alcune applicazioni controllano anche i CBU rispetto ai database bancari prima di consentire i trasferimenti, anche se ciò richiede l'accesso a API a pagamento.
Posso avere più CBU?
Assolutamente. Ogni conto genera il proprio CBU. Se hai un conto corrente e un conto di risparmio presso la stessa banca, avrai due CBU distinti. Conti diversi in banche diverse? Più CBU. Ognuno identifica univocamente un conto specifico in una specifica filiale di una specifica istituzione.
Il sistema CBU viene utilizzato al di fuori dell'Argentina?
No, i CBU sono specifici dell'Argentina. Ogni paese ha il proprio sistema: l'Europa usa IBAN, gli USA usano numeri di routing più numeri di conto, l'Australia usa codici BSB, e così via. Quando si invia denaro internazionalmente, in genere sarà necessario il codice SWIFT del destinatario più il suo identificatore di conto locale—che nel caso dell'Argentina sarebbe il CBU.
Riferimenti e Documentazione Ufficiale
Per informazioni autorevoli sugli standard bancari dell'Argentina:
-
Banca Centrale dell'Argentina (BCRA) - Regolamenti del Sistema Finanziario - Documentazione ufficiale BCRA sugli standard dei sistemi di pagamento e le normative bancarie
-
Legge n. 25.345 - "Prevenzione dell'Evasione Fiscale e Modernizzazione dei Pagamenti" (novembre 2000) - La legislazione che ha stabilito il quadro dei sistemi di pagamento elettronico in Argentina
-
Comunicazione BCRA Serie "A" - Circolari tecniche che definiscono i requisiti di implementazione del CBU per gli istituti finanziari
-
Interbanking S.A. - L'organizzazione che gestisce la rete di pagamento elettronico interbancario dell'Argentina e mantiene le tabelle di routing CBU
Queste fonti forniscono le specifiche tecniche utilizzate per implementare questo validatore e vengono regolarmente aggiornate dalle autorità finanziarie argentine.
Pronti a Validare o Generare CBU?
Che tu stia costruendo un'integrazione di pagamento, testando un'applicazione fintech o imparando a conoscere il sistema bancario argentino, comprendere la validazione CBU è essenziale. Questo strumento implementa gli stessi algoritmi di checksum utilizzati dalle banche argentine, in modo da poter intercettare errori di formato prima che causino guasti nelle transazioni.
Ricorda: la convalida del formato è solo il primo passo. Un CBU formattato correttamente non garantisce l'esistenza del conto o che tu abbia il destinatario giusto. Per sistemi di produzione che gestiscono denaro reale, combina la convalida del formato con ulteriori verifiche tramite API bancarie o processori di pagamento.
Lo strumento non richiede registrazione o installazione: basta aprirlo e iniziare a validare o generare CBU secondo gli standard ufficiali della BCRA.