Generador i Validador de CBU per a Argentina | Codis Bancaris del BCRA
Genereu i valideu codis bancaris CBU (Clave Bancaria Uniforme) argentins. Eina gratuïta que utilitza algoritmes oficials del BCRA per a desenvolupadors, proves i aplicacions financeres.
Generador i Validador de CBU Argentí
Genera un CBU aleatori però vàlid per provar les teves aplicacions i integracions.
Fes clic al botó de dalt per generar un CBU vàlid
Sobre el CBU
El CBU (Clave Bancaria Uniforme) és un codi de 22 dígits utilitzat a l'Argentina per identificar comptes bancaris per a transferències electròniques i pagaments.
Cada CBU conté informació sobre el banc, la sucursal i el número de compte, juntament amb dígits de verificació que garanteixen la seva validesa.
Estructura del CBU
Documentació
Què és un CBU argentí i per què validar-lo?
Treballar amb el sistema bancari argentí significa tractar amb el CBU (Clave Bancaria Uniforme), un codi de 22 dígits que identifica de manera única cada compte bancari del país. Si alguna vegada has necessitat provar una integració de pagament, verificar detalls bancaris abans d'una transferència o entendre per què una transacció ha fallat, saps com és de crític treballar amb CBUs ben formats.
Aquesta eina t'ajuda a generar CBUs estructuralment vàlids per a entorns de proves i validar codis existents davant el format oficial especificat pel Banc Central de l'Argentina (BCRA). Quan estàs construint aplicacions financeres o processant pagaments, detectar errors de format des del principi estalvia hores de depuració i prevé transaccions fallides.
Entenent el Format CBU
El CBU (Clau Bancària Uniforme) és la resposta de l'Argentina als identificadors bancaris internacionals com IBAN o números de ruta dels EUA. Penseu-ho com un paquet complet que agrupa la informació del banc, la sucursal i el compte en un únic codi de 22 dígits. El Banc Central de l'Argentina (BCRA) va implementar aquest sistema al novembre del 2000 per estandarditzar les transferències electròniques a través de la xarxa financera del país.
Estructura i Format del CBU
Cada CBU vàlid consta exactament de 22 dígits dividits en dos blocs principals:
-
Primer Bloc (8 dígits): Identifica la institució financera i la sucursal
- Primers 3 dígits: Codi de banc assignat per la BCRA
- Següents 4 dígits: Codi de sucursal dins del banc
- Últim dígit: Dígit de verificació per al primer bloc
-
Segon Bloc (14 dígits): Identifica el compte específic
- Primers 13 dígits: Número de compte (pot incloure el tipus de compte i altres identificadors)
- Últim dígit: Dígit de verificació per al segon bloc
Els dígits de verificació utilitzen un algoritme de mòdul-10 ponderat que detecta errors comuns, com ara dígits intercanviats o errors d'un sol dígit, abans que es mogui qualsevol diners. Aquesta salvaguarda ha demostrat ser extraordinàriament efectiva: la majoria dels errors d'entrada de CBU es detecten en l'etapa de validació, en lloc de resultar en transferències fallides.
Com Generar un CBU de Prova
El generador crea CBUs aleatoris però estructuralment vàlids que passen tots els controls de format. Aquí és el que passa darrere de l'escenari:
- Dígits aleatoris omplen les seccions de codi de banc, codi de sucursal i número de compte
- L'eina calcula els dos dígits de verificació mitjançant l'algoritme oficial del BCRA
- Obtindràs un CBU de 22 dígits correctament format, preparat per a proves
Quan trobaràs això útil:
- Proves d'integracions de pagament: Necessites desenes de CBUs vàlids per al teu conjunt de proves? Genera'ls instantàniament sense càlcul manual.
- Entorns de QA i staging: Omple bases de dades de proves amb dades bancàries realistes que no coincideixin accidentalment amb comptes reals.
- Aprendre el format: Veure com estan estructurats els diferents CBUs i comprendre la lògica de verificació.
- Documentació i demostracions: Crea dades de mostra que semblin autèntiques sense exposar informació bancària real.
Pas a Pas: Generació d'un CBU
- Navega a la pestanya "Generador" de l'eina
- Fes clic al botó "Generar CBU"
- Apareixerà un CBU aleatori vàlid de 22 dígits a l'àrea de visualització
- Utilitza el botó "Copiar" per copiar el CBU al teu portapapers per usar-lo a les teves aplicacions
Com validar un CBU argentí
El validador executa les mateixes comprovacions que els sistemes bancaris argentins utilitzen per verificar la integritat del CBU. Què es comprova:
- Verificació de longitud: Confirma exactament 22 dígits (un error comú és copiar amb espais o guions)
- Contingut numèric: Garanteix que no hi hagi lletres o caràcters especials
- Suma de verificació del primer bloc: Valida el 8è dígit amb els primers 7 dígits
- Suma de verificació del segon bloc: Valida el 22è dígit amb els dígits 9-21
Quan la validació falla, veureu quina comprovació específica no ha passat. Això és especialment útil quan es depura per què una API bancària ha rebutjat un CBU, sovint és algo simple com un espai addicional o un dígit intercanviat.
Pas a pas: Validació d'un CBU
- Navegueu a la pestanya "Validador" de l'eina
- Introduïu el CBU de 22 dígits que voleu validar
- Feu clic al botó "Validar CBU"
- Reviseu el resultat de la validació:
- Indicador verd per a CBU vàlids
- Indicador vermell amb missatges d'error específics per a CBU invàlids
L'Algoritme de Verificació de CBU Explicat
El BCRA utilitza un algorisme de suma de verificació ponderat modulo-10 per calcular dígits de verificació. Si esteu implementant la validació de CBU a la vostra aplicació, aquí teniu la lògica exacta:
Verificació del Primer Bloc
Per al primer bloc (primers 8 dígits), el dígit de verificació es calcula de la manera següent:
- Agafeu els primers 7 dígits del CBU
- Multipliqueu cada dígit pel seu pes corresponent: [7, 1, 3, 9, 7, 1, 3]
- Sumeu els productes resultants
- Calculeu: 10 - (suma % 10)
- Si el resultat és 10, el dígit de verificació és 0; altrament, és el valor calculat
Verificació del Segon Bloc
Per al segon bloc (últims 14 dígits), el dígit de verificació es calcula de la manera següent:
- Agafeu els primers 13 dígits del segon bloc
- Multipliqueu cada dígit pel seu pes corresponent: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
- Sumeu els productes resultants
- Calculeu: 10 - (suma % 10)
- Si el resultat és 10, el dígit de verificació és 0; altrament, és el valor calculat
Exemples de Validació de Codi CBU
Aquí us mostrem com implementar la validació de CBU a la vostra aplicació. Aquests exemples segueixen l'especificació oficial del BCRA i funcionaran amb dades bancàries de producció:
1// JavaScript: Calcular el dígit de control de CBU
2function calculateCheckDigit(number, weights) {
3 if (number.length !== weights.length) {
4 throw new Error('La longitud del número ha de coincidir amb la longitud dels pesos');
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// Validar el primer bloc de 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: Validar un CBU complet
2import re
3
4def validate_cbu(cbu):
5 # Comprovar format bàsic
6 if not cbu or not re.match(r'^\d{22}$', cbu):
7 return {
8 'isValid': False,
9 'errors': ['El CBU ha de tenir 22 dígits']
10 }
11
12 # Dividir en blocs
13 first_block = cbu[:8]
14 second_block = cbu[8:]
15
16 # Validar cada bloc
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('El primer bloc (codi de banc/sucursal) no és vàlid')
23 if not second_block_valid:
24 errors.append('El segon bloc (número de compte) no és vàlid')
25
26 return {
27 'isValid': first_block_valid and second_block_valid,
28 'errors': errors
29 }
301// Java: Generar un CBU vàlid aleatori
2import java.util.Random;
3
4public class CBUGenerator {
5 private static final Random random = new Random();
6
7 public static String generateCBU() {
8 // Generar els primers 7 dígits (codi de banc i sucursal)
9 StringBuilder firstBlockBase = new StringBuilder();
10 for (int i = 0; i < 7; i++) {
11 firstBlockBase.append(random.nextInt(10));
12 }
13
14 // Calcular el dígit de control per al primer bloc
15 int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16 int firstBlockCheckDigit = calculateCheckDigit(
17 firstBlockBase.toString(),
18 firstBlockWeights
19 );
20
21 // Generar els primers 13 dígits del segon bloc
22 StringBuilder secondBlockBase = new StringBuilder();
23 for (int i = 0; i < 13; i++) {
24 secondBlockBase.append(random.nextInt(10));
25 }
26
27 // Calcular el dígit de control per al segon bloc
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 // Combinar totes les parts
35 return firstBlockBase.toString() + firstBlockCheckDigit +
36 secondBlockBase.toString() + secondBlockCheckDigit;
37 }
38
39 // Implementació del mètode calculateCheckDigit...
40}
411// PHP: Formatar un CBU per mostrar
2function formatCBU($cbu) {
3 if (!$cbu || strlen($cbu) !== 22) {
4 return $cbu;
5 }
6
7 // Formatar com: XXXXXXXX XXXXXXXXXXXXXX
8 return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Exemple d'ús
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Mostra: 01234567 89012345678901
141' Excel VBA: Validar un CBU
2Function ValidateCBU(cbu As String) As Boolean
3 ' Comprovar longitud
4 If Len(cbu) <> 22 Then
5 ValidateCBU = False
6 Exit Function
7 End If
8
9 ' Comprovar si tots els caràcters són dígits
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 ' Extreure blocs
19 Dim firstBlock As String
20 Dim secondBlock As String
21 firstBlock = Left(cbu, 8)
22 secondBlock = Right(cbu, 14)
23
24 ' Validar ambdós blocs
25 ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27Casos d'Ús Reals per a la Validació de CBU
Proves d'Integracions de Pagament
Quan es construeixen aplicacions fintech o plataformes de comerç electrònic que processen pagaments argentins, cal tenir CBUs vàlids per a l'entorn de proves. Un escenari comú: el vostre entorn de preparació requereix 50 comptes de proves amb CBUs vàlids per a proves de càrrega. Calcular manualment els dígits de control per a cadascun prendria hores. El generador ho gestiona en segons, proporcionant dades de proves correctament formatades que es comporten com a CBUs de producció sense el risc d'usar accidentalment números de compte reals.
Consell professional: Mantingueu un conjunt de CBUs generats als vostres fitxers de proves. Això garanteix dades de proves coherents a tot l'equip i facilita la depuració quan fallen les proves.
Prevenció d'Errors de Transacció
Això és el que passa normalment: un client proporciona el seu CBU per a una transferència bancària, però ha inclòs accidentalment espais o ha intercanviat dos dígits. Si processeu la transferència sense validació, el banc la rebutja, però només després d'un retard, i ja heu registrat la intenció de transacció al vostre sistema. Ara us enfronteu a problemes de conciliació.
Validar el format del CBU abans de l'enviament detecta aquests errors immediatament. El validador no us dirà si el compte existeix o pertany a la persona correcta (cal accés a l'API bancària), però confirmarà que l'estructura és correcta d'acord amb els estàndards del BCRA.
Comprensió dels Requisits d'Integració Bancària
Per a desenvolupadors nous al sistema financer argentí, aquesta eina ofereix un aprenentatge pràctic. Podeu veure exactament com funcionen els dígits de control, entendre per què alguns números no són vàlids i experimentar amb casos límit abans d'escriure codi de producció.
Error comú: Assumir que la validació de CBU és igual a la validació d'IBAN. Mentre que tots dos utilitzen dígits de control, els algoritmes difereixen completament. Provar amb aquesta eina us ajuda a entendre els requisits específics dels codis bancaris argentins.
Validació de Formularis en Interfícies Bancàries
En dissenyar formularis d'entrada que acceptin CBUs, cal provar com el sistema gestiona diversos estats d'error. Què passa quan un usuari enganxa un CBU amb espais? Quin missatge d'error apareix quan el dígit de control és incorrecte? Aquesta eina us ajuda a provar aquests escenaris i dissenyar una millor retroalimentació d'usuari.
Eines de Validació Bancària Relacionades
Depenent dels seus requisits, també pot necessitar aquestes eines complementàries:
- Validador de CUIT/CUIL: Valida números d'identificació fiscal argentins—essencial quan es necessita verificació tant bancària com fiscal
- Validador de CVU: Similar a CBU però per a carteres digitals (Mercado Pago, Ualá, etc.) que utilitzen el mateix format de 22 dígits
- Validador d'IBAN: Per a pagaments transfronterers que involucren comptes europeus o internacionals
- Serveis d'API Bancàries: Per a sistemes de producció que necessiten verificar la propietat del compte i comprovar saldos, no només validar el format
Limitació important: Aquesta eina només valida el format i els dígits de control. No pot confirmar si un CBU correspon a un compte bancari actiu o verificar la identitat del titular del compte. Per a aquestes comprovacions, caldrà integrar-se amb les API bancàries o processadors de pagaments de l'Argentina.
Com el Sistema Bancari Argentí va Adoptar el CBU
Abans de novembre del 2000, enviar diners entre bancs argentins era sorprenentment complicat. Cada institució financera feia servir el seu propi sistema de numeració de comptes: alguns amb 10 dígits, altres amb 15, i sense una manera estandarditzada d'identificar quin banc o sucursal tenia un compte. Les transferències interbancàries requerien verificació manual i sovint trigaven dies a processar-se.
El BCRA va introduir el CBU per resoldre aquesta fragmentació. En exigir un únic format de 22 dígits a totes les institucions financeres, Argentina es va alinear amb estàndards internacionals com el sistema IBAN europeu. Els dígits de verificació integrats eren especialment intel·ligents: detecten automàticament la majoria dels errors d'entrada de dades, reduint les transferències fallides i els costos associats d'investigar i revertir transaccions.
El que és interessant: El format CBU gairebé no ha canviat en més de 20 anys. Mentre la tecnologia bancària ha evolucionat dramàticament —aplicacions mòbils, transferències instantànies, carteres digitals— l'estructura subjacent del CBU roman igual. Aquesta estabilitat demostra com el disseny original va anticipar perfectament les necessitats futures.
Avui, els argentins fan servir CBUs per gairebé totes les transaccions financeres electròniques: dipòsits de nòmina, pagaments de factures, declaracions fiscals, beneficis governamentals i comerç electrònic. El format ha demostrat ser tan efectiu que quan van sorgir les carteres digitals (com Mercado Pago), els reguladors van adoptar la mateixa estructura per als CVUs (Clau Virtual Uniforme) en lloc d'inventar-ne una de nova.
Preguntes Freqüents
Quina és la diferència entre un CBU i un CVU?
Els CBU identifiquen comptes bancaris tradicionals, mentre que els CVU (Clau Virtual Uniforme) identifiquen comptes de carteres digitals de proveïdors de fintech com Mercado Pago, Ualá o Brubank. El format és idèntic: 22 dígits amb el mateix algoritme de validació, la qual cosa té sentit perquè són interoperables. Podeu transferir diners d'un CBU a un CVU i viceversa, igual que qualsevol altra transferència bancària. Els primers tres dígits revelen si esteu mirant un banc tradicional o un proveïdor de cartera digital.
Puc saber el nom del banc a partir d'un CBU?
Sí. Els primers tres dígits són l'identificador del banc assignat pel BCRA. Per exemple, els codis que comencen per "011" pertanyen al Banco Nación, mentre que "017" indica BBVA Argentina. El BCRA publica un registre oficial d'aquests codis, que les aplicacions bancàries normalment fan servir per mostrar automàticament el nom del banc quan s'introdueix un CBU.
Un CBU és el mateix que un número de compte?
No exactament. El número de compte està amagat dins del CBU, però el CBU l'empaqueta amb informació addicional de routing. Penseu-ho com la diferència entre una adreça de carrer i les coordenades GPS: tots dos identifiquen una ubicació, però un inclou més context. El CBU agrupa el codi del banc, el codi de la sucursal, el número de compte i dos dígits de verificació en una sola cadena transferible.
Quant de segur és compartir el meu CBU?
El CBU està dissenyat per ser compartit: aquest és tot el punt. Els destinataris el necessiten per dipositar diners al teu compte. A diferència de contrasenyes o PINs, un CBU només permet transferències entrants, no extraccions. Dit això, tracteu-lo com qualsevol informació financera: compartiu-lo amb persones o empreses en qui confieu i sigueu cautelosos en publicar-lo públicament en línia. Algunes persones prefereixen donar el seu CBU de manera selectiva en lloc de publicar-lo obertament.
Pot caducar o canviar un CBU?
El teu CBU es manté mentre el compte estigui obert. L'únic moment en què canvia és si tanques aquest compte i obres un de nou, o en casos rars quan els bancs es fusionen o reestructuren els seus sistemes de numeració. Fins i tot llavors, els bancs normalment mantenen el CBU antic durant un període de transició per evitar interrupcions en els pagaments recurrents.
Com puc trobar el meu propi CBU?
Reviseu l'aplicació mòbil del vostre banc: normalment es troba a la secció de detalls del compte. La majoria dels bancs argentins també el mostren de manera destacada a la banca en línia, l'imprimeixen als extractes mensuals i alguns fins i tot l'inclouen al darrere de les targetes de dèbit. Si no el trobeu, qualsevol representant bancari pot proporcionar-lo immediatament; no es considera informació sensible com un PIN.
Els estrangers poden tenir un CBU a l'Argentina?
Sí. Obrir un compte bancari a l'Argentina com a estranger us dona un CBU igual que a qualsevol altre titular de compte. Els requisits varien segons la institució: alguns bancs només requereixen un passaport, mentre que altres demanen proves de residència o un CDI (número d'identificació fiscal). Les carteres digitals (CVU) sovint són més fàcils d'accedir per als estrangers que els comptes bancaris tradicionals.
Què passa si faig una transferència a un CBU invàlid?
Els sistemes bancaris moderns realitzen una validació de format abans de trametre la transferència. Si els dígits de verificació no coincideixen o la longitud és incorrecta, rebreu un error immediat: la transferència mai no surt del vostre compte. Per això la validació frontal és tan valuosa: detecta errors tipogràfics abans que causin problemes.
La situació més complicada és quan un CBU passa la validació de format però no coincideix amb un compte actiu. La transferència s'envia a la xarxa interbancària i després rebota després d'unes hores o dies. Ja l'heu registrat com a "enviada" a la vostra comptabilitat i ara heu de conciliar la devolució. Per això algunes aplicacions també comproven els CBU contra bases de dades bancàries abans de permetre transferències, tot i que això requereix accés API de pagament.
Puc tenir múltiples CBU?
Absolutament. Cada compte genera el seu propi CBU. Si teniu un compte corrent i un compte d'estalvis al mateix banc, tindreu dos CBU diferenciats. Comptes diferents a bancs diferents? Més CBU. Cadascun identifica únicament un compte específic en una sucursal específica d'una institució específica.
El sistema CBU s'utilitza fora de l'Argentina?
No, els CBU són específics de l'Argentina. Cada país té el seu propi sistema: Europa utilitza IBAN, els EUA fan servir números de routing més números de compte, Austràlia utilitza codis BSB, etc. En enviar diners internacionalment, normalment necessitareu el codi SWIFT del destinatari més el seu identificador de compte local, que en el cas de l'Argentina seria el CBU.
Referències i Documentació Oficial
Per obtenir informació autoritativa sobre els estàndards bancaris de l'Argentina:
-
Banc Central de l'Argentina (BCRA) - Reglaments del Sistema Financer - Documentació oficial del BCRA sobre estàndards de sistemes de pagament i regulacions bancàries
-
Llei núm. 25.345 - "Prevenció de l'Evasió Fiscal i Modernització dels Pagaments" (novembre de 2000) - La legislació que va establir el marc dels sistemes de pagament electrònic de l'Argentina
-
Comunicació "A" del BCRA - Circulars tècniques que defineixen els requisits d'implementació de CBU per a institucions financeres
-
Interbanking S.A. - L'organització que opera la xarxa de pagaments electrònics interbancaris de l'Argentina i manté les taules de routing de CBU
Aquestes fonts proporcionen les especificacions tècniques utilitzades per implementar aquest validador i s'actualitzen regularment per les autoritats financeres argentines.
Preparat per Validar o Generar CBUs?
Tant si estàs construint una integració de pagament, provant una aplicació fintech, o aprenent sobre el sistema bancari argentí, entendre la validació de CBU és essencial. Aquesta eina implementa els mateixos algorismes de checksum que fan servir els bancs argentins, perquè puguis detectar errors de format abans que causin fallades de transacció.
Recorda: la validació de format és només el primer pas. Un CBU amb format correcte no garanteix que l'compte existeixi o que tinguis el destinatari correcte. Per a sistemes de producció que gestionen diners reals, combina la validació de format amb verificació addicional mitjançant API bancàries o processadors de pagament.
L'eina no requereix registre ni instal·lació: simplement obre-la i comença a validar o generar CBUs d'acord amb els estàndards oficials del BCRA.