CBU Генератор и Валидатор за Аргентину | BCRA Банковни Кодови
Генеришите и валидирајте argentine CBU (Clave Bancaria Uniforme) банковне кодове. Бесплатан алат који користи званичне BCRA алгоритме за програмере, тестере и финансијске апликације.
Argentine CBU генератор и валидатор
Генеришите случајан, али важећи CBU за тестирање ваших апликација и интеграција.
Кликните дугме изнад да генеришете важећи CBU
О CBU-у
CBU (Clave Bancaria Uniforme) је 22-цифрени код који се користи у Аргентини за идентификацију банковних рачуна за електронске трансфере и плаћања.
Сваки CBU садржи информације о банци, филијали и броју рачуна, заједно са верификационим цифрама које обезбеђују његову валидност.
CBU структура
Dokumentacija
Šta je argentinski CBU i zašto ga validirati?
Rad sa argentinskim bankarskim sistemom znači baviti se CBU-om (Clave Bancaria Uniforme) - 22-cifrenim kodom koji jedinstveno identifikuje svaki bankovni račun u zemlji. Ako ste ikada morali da testirate integraciju plaćanja, proverite bankarske detalje pre transfera ili razumete zašto je transakcija failed, znate koliko je kritično raditi sa pravilno formatiranim CBU-ovima.
Ovaj alat vam pomaže da generišete strukturno validne CBU-ove za testne okruženja i proverite postojeće kodove u odnosu na zvanični format koji je propisala Centralna banka Argentine (BCRA). Kada gradite finansijske aplikacije ili obrađujete plaćanja, otkrivanje grešaka u formatu na vreme uštedi sate debugovanja i sprečava neuspele transakcije.
Razumevanje CBU formata
CBU (Clave Bancaria Uniforme) je argentinski odgovor međunarodnim bankarskim identifikatorima poput IBAN-a ili US routing brojeva. Zamislite ga kao sveobuhvatni paket koji spaja informacije o banci, filijali i računu u jedinstven 22-cifreni kod. Centralna banka Argentine (BCRA) je uvela ovaj sistem u novembru 2000. godine kako bi standardizovala elektronske transfere kroz finansijsku mrežu zemlje.
CBU struktura i format
Svaki validan CBU se sastoji tačno od 22 cifre podeljene u dva glavna bloka:
-
Prvi blok (8 cifara): Identifikuje finansijsku instituciju i filijalu
- Prve 3 cifre: Bankarski kod dodeljen od strane BCRA
- Sledeće 4 cifre: Kod filijale unutar banke
- Poslednja cifra: Kontrolna cifra za prvi blok
-
Drugi blok (14 cifara): Identifikuje specifičan račun
- Prvih 13 cifara: Broj računa (može uključivati tip računa i druge identifikatore)
- Poslednja cifra: Kontrolna cifra za drugi blok
Kontrolne cifre koriste ponderisani modulo-10 algoritam koji otkriva uobičajene greške—poput zamenjenih cifara ili grešaka sa jednom cifrom—pre bilo kakvog kretanja novca. Ova zaštita se pokazala izuzetno efikasnom: većina grešaka pri unosu CBU-a biva otkrivena u fazi validacije, umesto da rezultira neuspelim transferima.
Kako generisati test CBU
Generator stvara nasumične, ali strukturno validne CBU-ove koji prolaze sve provere formata. Evo šta se dešava iza scene:
- Nasumični brojevi popunjavaju sekcije bankovnog koda, koda filijale i broja računa
- Alat izračunava oba kontrolna broja koristeći zvanični BCRA algoritam
- Dobijate pravilno formatiran 22-cifreni CBU spreman za testiranje
Kada ćete ovo pronaći korisnim:
- Testiranje platnih integracija: Potrebno vam je nekoliko desetina validnih CBU-ova za vaš test skup? Generišite ih trenutno bez ručnog izračunavanja.
- QA i staging okruženja: Popunite test baze podataka realističnim bankarskim podacima koji slučajno neće odgovarati pravim računima.
- Učenje formata: Vidite kako su različiti CBU-ovi strukturirani i razumejte logiku provere.
- Dokumentacija i demonstracije: Kreirajte ogledne podatke koji izgledaju autentično bez otkrivanja pravih bankarskih informacija.
Korak po korak: Generisanje CBU-a
- Idite na karticu "Generator" alata
- Kliknite dugme "Generiši CBU"
- Validan, nasumičan 22-cifreni CBU pojaviće se u prostoru za prikaz
- Koristite dugme "Kopiraj" da kopirate CBU u clipboard za upotrebu u vašim aplikacijama
Kako validirati argentinski CBU
Validator vrši iste provere koje argentinski bankarski sistemi koriste za proveru integritet CBU-a. Šta se proverava:
- Provera dužine: Potvrđuje tačno 22 cifre (uobičajena greška je kopiranje sa razmacima ili crtama)
- Sadržaj samo brojeva: Osigurava da nema slova ili specijalnih karaktera
- Provera prvog bloka: Validira 8. cifru u odnosu na prvih 7 cifara
- Provera drugog bloka: Validira 22. cifru u odnosu na cifre 9-21
Kada validacija ne uspe, videćete koji specifični test nije prošao. Ovo je posebno korisno kada se otklanja greška zašto je bankarski API odbacio CBU - često je reč o jednostavnoj stvari poput dodatnog razmaka ili zamenjene cifre.
Korak po korak: Validacija CBU-a
- Idite na karticu "Validator" alata
- Unesite 22-cifreni CBU koji želite da validirate
- Kliknite dugme "Validate CBU"
- Pregledajte rezultat validacije:
- Zeleni indikator za validne CBU-ove
- Crveni indikator sa specifičnim porukama o greškama za nevažeće CBU-ove
Objašnjenje algoritma za proveru CBU-a
BCRA koristi algoritam za proveru sa ponderisanim modulo-10 kontrolnim zbirom za izračunavanje verifikacionih cifara. Ako implementirate validaciju CBU-a u svojoj aplikaciji, evo tačne logike:
Provera prvog bloka
Za prvi blok (prvih 8 cifara), verifikaciona cifra se izračunava na sledeći način:
- Uzmite prvih 7 cifara CBU-a
- Pomnožite svaku cifru njenoj odgovarajućom težinom: [7, 1, 3, 9, 7, 1, 3]
- Saberite dobijene proizvode
- Izračunajte: 10 - (suma % 10)
- Ako je rezultat 10, verifikaciona cifra je 0; u suprotnom, to je izračunata vrednost
Provera drugog bloka
Za drugi blok (poslednjih 14 cifara), verifikaciona cifra se izračunava na sledeći način:
- Uzmite prvih 13 cifara drugog bloka
- Pomnožite svaku cifru njenoj odgovarajućoj težini: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
- Saberite dobijene proizvode
- Izračunajte: 10 - (suma % 10)
- Ako je rezultat 10, verifikaciona cifra je 0; u suprotnom, to je izračunata vrednost
Примери валидације CBU кода
Ево како да имплементирате валидацију CBU у вашој апликацији. Ови примери прате званичну BCRA спецификацију и радиће са производним банкарским подацима:
1// JavaScript: Израчунавање контролне цифре CBU
2function calculateCheckDigit(number, weights) {
3 if (number.length !== weights.length) {
4 throw new Error('Дужина броја мора да одговара дужини тежинских коефицијената');
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// Валидација прве групе 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: Валидација комплетног CBU
2import re
3
4def validate_cbu(cbu):
5 # Провера основног формата
6 if not cbu or not re.match(r'^\d{22}$', cbu):
7 return {
8 'isValid': False,
9 'errors': ['CBU мора да садржи 22 цифре']
10 }
11
12 # Подела на групе
13 first_block = cbu[:8]
14 second_block = cbu[8:]
15
16 # Валидација група
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('Прва група (банкарски/филијални код) је неважећа')
23 if not second_block_valid:
24 errors.append('Друга група (број рачуна) је неважећа')
25
26 return {
27 'isValid': first_block_valid and second_block_valid,
28 'errors': errors
29 }
301// Java: Генерисање случајног важећег CBU
2import java.util.Random;
3
4public class CBUGenerator {
5 private static final Random random = new Random();
6
7 public static String generateCBU() {
8 // Генерисање првих 7 цифара (банкарски и филијални код)
9 StringBuilder firstBlockBase = new StringBuilder();
10 for (int i = 0; i < 7; i++) {
11 firstBlockBase.append(random.nextInt(10));
12 }
13
14 // Израчунавање контролне цифре за прву групу
15 int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16 int firstBlockCheckDigit = calculateCheckDigit(
17 firstBlockBase.toString(),
18 firstBlockWeights
19 );
20
21 // Генерисање првих 13 цифара друге групе
22 StringBuilder secondBlockBase = new StringBuilder();
23 for (int i = 0; i < 13; i++) {
24 secondBlockBase.append(random.nextInt(10));
25 }
26
27 // Израчунавање контролне цифре за другу групу
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 // Комбиновање свих делова
35 return firstBlockBase.toString() + firstBlockCheckDigit +
36 secondBlockBase.toString() + secondBlockCheckDigit;
37 }
38
39 // Имплементација calculateCheckDigit методе...
40}
411// PHP: Форматирање CBU за приказ
2function formatCBU($cbu) {
3 if (!$cbu || strlen($cbu) !== 22) {
4 return $cbu;
5 }
6
7 // Формат: XXXXXXXX XXXXXXXXXXXXXX
8 return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Пример употребе
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Излаз: 01234567 89012345678901
141' Excel VBA: Валидација CBU
2Function ValidateCBU(cbu As String) As Boolean
3 ' Провера дужине
4 If Len(cbu) <> 22 Then
5 ValidateCBU = False
6 Exit Function
7 End If
8
9 ' Провера да ли су сви карактери цифре
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 ' Издвајање група
19 Dim firstBlock As String
20 Dim secondBlock As String
21 firstBlock = Left(cbu, 8)
22 secondBlock = Right(cbu, 14)
23
24 ' Валидација обе групе
25 ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27Стварносни случајеви употребе за CBU валидацију
Тестирање платних интеграција
Приликом изградње финтех апликација или е-трговинских платформи које обрађују argentine плаћања, потребни су вам важећи CBU-ови за тестно окружење. Чест сценарио: ваше staging окружење захтева 50 тест налога са важећим CBU-овима за оптерећујуће тестирање. Ручно израчунавање контролних цифара за сваки би трајало сате. Генератор ово обавља за секунде, пружајући вам правилно форматиране тест податке који се понашају попут производних CBU-ова без ризика да случајно користите праве бројеве рачуна.
Про савет: Чувајте скуп генерисаних CBU-ова у вашим тест fixtures. Ово обезбеђује конзистентне тест податке у вашем тиму и олакшава отклањање грешака када тестови падну.
Спречавање грешака у трансакцијама
Ево шта се типично дешава: клијент пружа свој CBU за пренос новца, али је случајно укључио размаке или заменио две цифре. Ако обрадите пренос без валидације, банка га одбија - али тек након кашњења, и већ сте евидентирали намеру трансакције у свом систему. Сада се бавите проблемима усаглашавања.
Валидација CBU формата пре подношења одмах хвата ове грешке. Валидатор неће рећи да ли рачун постоји или припада правој особи (то захтева приступ банкарском API-ју), али потврдиће да је структура тачна према BCRA стандардима.
Разумевање захтева за банкарску интеграцију
За програмере нове у argentine финансијском систему, овај алат пружа практично учење. Можете тачно видети како контролне цифре раде, разумети зашто су одређени бројеви неважећи и експериментисати са граничним случајевима пре писања производног кода.
Уобичајена грешка: Претпоставка да је CBU валидација иста као IBAN валидација. Иако обе користе контролне цифре, algoritmi se potpuno razlikuju. Тестирање помоћу овог алата помаже вам да разумете специфичне захтеве argentine банкарских кодова.
Валидација форме у банкарским корисничким интерфејсима
Приликом пројектовања улазних образаца који прихватају CBU-ове, морате тестирати како систем рукује различитим стањима грешака. Шта се дешава када корисник налепи CBU са размацима? Која порука о грешки се појављује када је контролна цифра погрешна? Овај алат вам помаже да тестирате ове сценарије и дизајнирате боље корисничке повратне информације.
Сродни алати за валидацију банкарских података
У зависности од ваших захтева, можда ћете требати и ове допунске алате:
- CUIT/CUIL валидатор: Валидира argentine пореске идентификационе бројеве—суштински када вам требају и банкарска и пореска ID провера
- CVU валидатор: Сличан CBU-у, али за дигиталне новчанике (Mercado Pago, Ualá, итд.) који користе исти 22-цифрени формат
- IBAN валидатор: За прекограничнa плаћања која укључују европске или друге међународне рачуне
- Банкарске API услуге: За продукционе системе који требају да провере власништво рачуна и стање, а не само формат
Важно ограничење: Овај алат само валидира формат и контролне цифре. Не може да потврди да ли CBU одговара активном банковном рачуну или да провери идентитет власника рачуна. За те провере, требаћете интеграцију са argentine банкарским API-јима или процесорима плаћања.
Kako je bankarski sistem Argentine usvojio CBU
Pre novembra 2000. godine, slanje novca između argentinskih banaka bilo je iznenađujuće komplikovano. Svaka finansijska institucija koristila je sopstveni sistem numerisanja računa - neki sa 10 cifara, drugi sa 15, bez standardizovanog načina identifikacije banke ili filijale koja drži račun. Međubankarski transferi zahtevali su ručnu proveru i često su trajali nekoliko dana za obradu.
BCRA je uveo CBU kako bi rešio ovu fragmentaciju. Propisivanjem jedinstvenog formata od 22 cifre za sve finansijske institucije, Argentina se uskladila sa međunarodnim standardima poput evropskog IBAN sistema. Ugrađene kontrolne cifre bile su posebno pametan potez: automatski otkrivaju većinu grešaka pri unosu podataka, smanjujući broj neuspelih transfera i povezane troškove istrage i poništavanja transakcija.
Zanimljivo je: Format CBU-a se gotovo nije menjao više od 20 godina. Dok se bankarska tehnologija dramatično razvijala - mobilne aplikacije, trenutni transferi, digitalni novčanici - osnovna CBU struktura ostala je ista. Ova stabilnost govori koliko je originalni dizajn dobro predvideo buduće potrebe.
Danas Argentinci koriste CBU za gotovo svaku elektronsku finansijsku transakciju: depozite plate, plaćanje računa, poreske prijave, državne beneficije i elektronsku trgovinu. Format se pokazao toliko efikasnim da su, kada su se pojavili digitalni novčanici (poput Mercado Paga), regulatori usvojili isti struktura za CVU (Clave Virtual Uniforme) umesto da izmisle nešto novo.
Често постављана питања
Која је разлика између CBU и CVU?
CBU идентификује традиционалне банковне рачуне, док CVU (Clave Virtual Uniforme) идентификује дигиталне новчанике финтех пружалаца попут Mercado Pago, Ualá или Brubank. Формат је идентичан — 22 цифре са истим алгоритмом валидације — што има смисла јер су интероперабилни. Можете пребацити новац са CBU на CVU и обрнуто као и код било ког другог банковног трансфера. Прве три цифре откривају да ли се ради о традиционалној банци или пружаоцу дигиталних новчаника.
Могу ли сазнати назив банке из CBU?
Да. Прве три цифре су идентификатор банке додељен од стране BCRA. На пример, кодови који почињу са „011" припадају Banco Nación, док „017" указује на BBVA Аргентину. BCRA објављује званичан регистар ових кодова, који банковне апликације типично користе да аутоматски прикажу назив банке приликом уноса CBU.
Да ли је CBU исто што и број рачуна?
Не сасвим. Број вашег рачуна је садржан унутар CBU, али CBU га пакује са додатним информацијама за усмеравање. Размислите о томе као о разлици између адресе улице и GPS координата — обоје идентификују локацију, али један укључује више контекста. CBU обједињује код банке, код филијале, број рачуна и две верификационе цифре у једном преносивом низу.
Колико је безбедно делити мој CBU?
CBU је дизајниран да буде дељен — у томе и јесте поента. Примаоци су вам потребни да би уплатили новац на ваш рачун. За разлику од лозинки или PIN-ова, CBU дозвољава само долазне трансфере, не и повлачења. Међутим, третирајте га као било коју финансијску информацију: делите га са особама или компанијама којима верујете и будите опрезни приликом јавног објављивања. Неки људи радије селективно деле CBU него што га јавно објављују.
Да ли CBU може истећи или се променити?
Ваш CBU остаје са вама док је рачун отворен. Мења се само уколико затворите тај рачун и отворите нови, или у ретким случајевима када банке спајају или реструктурирају свој систем нумерисања. Чак и тада, банке типично одржавају стари CBU током периода транзиције да би избегле ометање понављајућих плаћања.
Како да пронађем свој CBU?
Проверите мобилну апликацију банке — обично се налази у секцији детаља рачуна. Већина argentine банака га такође јасно приказује у онлајн банкарству, штампа на месечним изводима, а неке га чак укључују и на полеђини дебитних картица. Уколико га не можете пронаћи, било који банкарски представник вам га може одмах пружити; не сматра се осетљивом информацијом попут PIN-а.
Да ли странци могу имати CBU у Аргентини?
Да. Отварање банковног рачуна у Аргентини за странце вам даје CBU као и осталим власницима рачуна. Услови варирају по институцији — неке банке захтевају само пасош, док друге траже доказ боравишта или CDI (порески идентификациони број). Дигитални новчаници (CVU) су често лакши за странце за приступ него традиционални банковни рачуни.
Шта се дешава ако извршим трансфер на неважећи CBU?
Модерни банковни системи врше валидацију формата пре слања трансфера. Уколико контролне цифре не одговарају или дужина није исправна, добићете тренутну грешку — трансфер никада не напушта ваш рачун. Управо је то разлог зашто је валидација на предњој страни тако вредна; хвата куцање пре него што проузрокује проблеме.
Компликованија ситуација је када CBU прође валидацију формата, али не одговара активном рачуну. Трансфер се шаље у међубанковску мрежу, а затим се враћа после неколико сати или дана. Већ сте га евидентирали као „послат" у вашем рачуноводству и сада треба да усkladite повраћај. Управо је то разлог зашто неке апликације такође проверавају CBU у банковним базама пре дозволе трансфера, иако то захтева плаћени API приступ.
Могу ли имати више CBU-ова?
Апсолутно. Сваки рачун генерише свој CBU. Ако имате текући и штедни рачун у истој банци, имаћете два различита CBU-а. Различити рачуни у различитим банкама? Још CBU-ова. Сваки јединствено идентификује специфичан рачун у специфичној филијали специфичне институције.
Да ли се CBU систем користи ван Аргентине?
Не, CBU је специфичан за Аргентину. Свака земља има свој систем: Европа користи IBAN, САД користе рутинг бројеве плус бројеве рачуна, Аустралија користи BSB кодове, и тако даље. Приликом слања новца internationally, типично ћете требати SWIFT код примаоца плус њихов локални идентификатор рачуна — који би у случају Аргентине био CBU.
Референце и службена документација
За меродавне информације о банкарским стандардима Аргентине:
-
Централна банка Аргентине (BCRA) - Прописи финансијског система - Службена BCRA документација о стандардима платног система и банкарским прописима
-
Закон бр. 25,345 - "Спречавање пореске утаје и модернизација плаћања" (новембар 2000) - Законодавство које је успоставило оквир електронских платних система Аргентине
-
BCRA Комуникација "А" серије - Техничке циркуларе које дефинишу захтеве за имплементацију CBU за финансијске институције
-
Интербанкинг С.А. - Организација која управља међубанкарском електронском платном мрежом Аргентине и одржава CBU табеле за рутирање
Ови извори пружају техничке спецификације коришћене за имплементацију овог валидатора и редовно их ажурирају argentine финансијске власти.
Спремни да Валидирате или Генеришете CBU?
Без обзира да ли градите платну интеграцију, тестирате финтех апликацију или учите о банкарском систему Аргентине, разумевање валидације CBU-а је суштинско. Овај алат примењује потпуно исте алгоритме за провeru збира који argentine банке користе, тако да можете открити грешке у формату пре него што проузрокују неуспех трансакције.
Запамтите: валидација формата је само први корак. Правилно форматиран CBU не гарантује да рачун постоји или да имате правог примаоца. За производне системе који рукују стварним новцем, комбинујте валидацију формата са додатном верификацијом путем банкарских API-ја или процесора плаћања.
Алат не захтева регистрацију или инсталацију - само га отворите и почните да валидирате или генеришете CBU-ове у складу са званичним BCRA стандардима.