Generátor a validátor CBU pre Argentínu | Bankové kódy BCRA
Generujte a validujte argentínske CBU (Clave Bancaria Uniforme) bankové kódy. Bezplatný nástroj využívajúci oficiálne algoritmy BCRA pre vývojárov, testerov a finančné aplikácie.
Argentínsky generátor a validátor CBU
Vygenerujte náhodné, ale platné CBU pre testovanie vašich aplikácií a integrácií.
Kliknite na tlačidlo vyššie pre vygenerovanie platného CBU
O CBU
CBU (Clave Bancaria Uniforme) je 22-miestny kód používaný v Argentíne na identifikáciu bankových účtov pre elektronické prevody a platby.
Každé CBU obsahuje informácie o banke, pobočke a čísle účtu spolu s overovacími číslicami, ktoré zaručujú jeho platnosť.
Štruktúra CBU
Dokumentácia
Čo je argentínsky CBU a prečo ho overovať?
Práca s argentínskym bankovým systémom znamená prácu s CBU (Clave Bancaria Uniforme) - 22-miestnym kódom, ktorý jednoznačne identifikuje každý bankový účet v krajine. Ak ste niekedy potrebovali otestovať integráciu platieb, overiť bankové údaje pred prevodom alebo pochopiť dôvod zlyhania transakcie, viete, aké dôležité je pracovať so správne formátovanými CBU.
Tento nástroj vám pomáha generovať štrukturálne platné CBU pre testovacie prostredia a overovať existujúce kódy podľa oficiálneho formátu stanoveného argentínskou Centrálnou bankou (BCRA). Pri budovaní finančných aplikácií alebo spracovávaní platieb môže včasné zachytenie chýb formátu ušetriť hodiny ladenia a zabrániť zlyhaniu transakcií.
Pochopenie formátu CBU
CBU (Clave Bancaria Uniforme) je argentínska odpoveď na medzinárodné identifikátory bánk ako IBAN alebo smerové čísla v USA. Môžete si ho predstaviť ako komplexný balík, ktorý spája informácie o banke, pobočke a účte do jediného 22-miestneho kódu. Centrálna banka Argentíny (BCRA) zaviedla tento systém v novembri 2000 s cieľom štandardizovať elektronické prevody v krajinskom finančnom systéme.
Štruktúra a formát CBU
Každé platné CBU pozostáva presne z 22 číslic rozdelených do dvoch hlavných blokov:
-
Prvý blok (8 číslic): Identifikuje finančnú inštitúciu a pobočku
- Prvé 3 číslice: Kód banky priradený BCRA
- Ďalšie 4 číslice: Kód pobočky v rámci banky
- Posledná číslica: Overovacia číslica pre prvý blok
-
Druhý blok (14 číslic): Identifikuje konkrétny účet
- Prvých 13 číslic: Číslo účtu (môže zahŕňať typ účtu a ďalšie identifikátory)
- Posledná číslica: Overovacia číslica pre druhý blok
Overovacie číslice využívajú vážený algoritmus modulo-10, ktorý zachytáva bežné preklepy - ako sú priesthodené číslice alebo chyby v jednotlivých čísliciach - pred akýmkoľvek pohybom peňazí. Toto zabezpečenie sa ukázalo mimoriadne účinné: väčšina chýb pri zadávaní CBU je zachytená už vo validačnom štádiu, a nie až pri zlyhaní prevodu.
Ako vygenerovať testovací CBU
Generátor vytvára náhodné, ale štrukturálne platné CBU, ktoré prechádzajú všetkými formátovými kontrolami. Tu je to, čo sa deje v pozadí:
- Náhodné číslice vyplnia sekcie kódu banky, kódu pobočky a čísla účtu
- Nástroj vypočíta oba overovacie digits pomocou oficiálneho algoritmu BCRA
- Dostanete správne naformátovaný 22-miestny CBU pripravený na testovanie
Kedy bude toto užitočné:
- Testovanie platobných integrácií: Potrebujete desiatky platných CBU pre váš testovací súbor? Vygenerujte ich okamžite bez manuálneho výpočtu.
- QA a stagingové prostredia: Naplňte testovacie databázy realistickými bankovými údajmi, ktoré náhodou nezodpovedajú skutočným účtom.
- Učenie sa formátu: Pozrite sa, ako sú rôzne CBU štruktúrované a pochopte overovaciu logiku.
- Dokumentácia a ukážky: Vytvorte vzorové dáta, ktoré vyzerajú autenticky bez odhalenia skutočných bankových informácií.
Krok za krokom: Generovanie CBU
- Prejdite na kartu "Generátor" nástroja
- Kliknite na tlačidlo "Generovať CBU"
- V zobrazovacej oblasti sa objaví platný, náhodný 22-miestny CBU
- Použite tlačidlo "Kopírovať" na skopírovanie CBU do schránky pre použitie vo vašich aplikáciách
Ako overiť argentínsky CBU
Validátor vykonáva rovnaké kontroly, ktoré argentínske bankové systémy používajú na overenie integrity CBU. Čo sa kontroluje:
- Overenie dĺžky: Potvrdzuje presne 22 číslic (bežnou chybou je kopírovanie s medzerami alebo pomlčkami)
- Obsah len s číslicami: Zabezpečuje, že sa nedostali žiadne písmená alebo špeciálne znaky
- Kontrolný súčet prvého bloku: Overuje 8. číslicu voči prvým 7 čísliciam
- Kontrolný súčet druhého bloku: Overuje 22. číslicu voči čísliciam 9-21
Keď overenie zlyhá, uvidíte, ktorá konkrétna kontrola neprešla. To je obzvlášť užitočné pri ladení dôvodu zamietnutia CBU bankovým rozhraním API - často ide o niečo jednoduché ako nadbytočná medzera alebo zamenené číslice.
Krok za krokom: Overenie CBU
- Prejdite na kartu "Validátor" nástroja
- Zadajte 22-miestne CBU, ktoré chcete overiť
- Kliknite na tlačidlo "Overiť CBU"
- Prezrite si výsledok overenia:
- Zelený indikátor pre platné CBU
- Červený indikátor so špecifickými chybovými správami pre neplatné CBU
Vysvetlenie algoritmu overenia CBU
BCRA používa váhový modulo-10 kontrolný súčet na výpočet overovacích číslic. Ak implementujete overenie CBU vo vašej aplikácii, tu je presná logika:
Overenie prvého bloku
Pre prvý blok (prvých 8 číslic) sa overovacia číslica počíta nasledovne:
- Vezmite prvých 7 číslic CBU
- Vynásobte každú číslicu jej zodpovedajúcou váhou: [7, 1, 3, 9, 7, 1, 3]
- Sčítajte výsledné súčiny
- Vypočítajte: 10 - (súčet % 10)
- Ak je výsledok 10, overovacia číslica je 0; inak je to vypočítaná hodnota
Overenie druhého bloku
Pre druhý blok (posledných 14 číslic) sa overovacia číslica počíta nasledovne:
- Vezmite prvých 13 číslic druhého bloku
- Vynásobte každú číslicu jej zodpovedajúcou váhou: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
- Sčítajte výsledné súčiny
- Vypočítajte: 10 - (súčet % 10)
- Ak je výsledok 10, overovacia číslica je 0; inak je to vypočítaná hodnota
Validácia kódu CBU - Príklady
Tu je postup implementácie validácie CBU vo vašej aplikácii. Tieto príklady sú v súlade s oficálnou špecifikáciou BCRA a budú fungovať s produkčnými bankovými údajmi:
1// JavaScript: Výpočet kontrolnej číslice CBU
2function calculateCheckDigit(number, weights) {
3 if (number.length !== weights.length) {
4 throw new Error('Dĺžka čísla sa musí zhodovať s dĺžkou váh');
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// Validácia prvého bloku 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: Validácia kompletného CBU
2import re
3
4def validate_cbu(cbu):
5 # Kontrola základného formátu
6 if not cbu or not re.match(r'^\d{22}$', cbu):
7 return {
8 'isValid': False,
9 'errors': ['CBU musí obsahovať 22 číslic']
10 }
11
12 # Rozdelenie na bloky
13 first_block = cbu[:8]
14 second_block = cbu[8:]
15
16 # Validácia každého bloku
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('Prvý blok (kód banky/pobočky) je neplatný')
23 if not second_block_valid:
24 errors.append('Druhý blok (číslo účtu) je neplatný')
25
26 return {
27 'isValid': first_block_valid and second_block_valid,
28 'errors': errors
29 }
301// Java: Generovanie náhodného platného CBU
2import java.util.Random;
3
4public class CBUGenerator {
5 private static final Random random = new Random();
6
7 public static String generateCBU() {
8 // Generovanie prvých 7 číslic (kód banky a pobočky)
9 StringBuilder firstBlockBase = new StringBuilder();
10 for (int i = 0; i < 7; i++) {
11 firstBlockBase.append(random.nextInt(10));
12 }
13
14 // Výpočet kontrolnej číslice pre prvý blok
15 int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16 int firstBlockCheckDigit = calculateCheckDigit(
17 firstBlockBase.toString(),
18 firstBlockWeights
19 );
20
21 // Generovanie prvých 13 číslic druhého bloku
22 StringBuilder secondBlockBase = new StringBuilder();
23 for (int i = 0; i < 13; i++) {
24 secondBlockBase.append(random.nextInt(10));
25 }
26
27 // Výpočet kontrolnej číslice pre druhý blok
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 // Kombinovanie všetkých častí
35 return firstBlockBase.toString() + firstBlockCheckDigit +
36 secondBlockBase.toString() + secondBlockCheckDigit;
37 }
38
39 // Implementácia metódy calculateCheckDigit...
40}
411// PHP: Formátovanie CBU pre zobrazenie
2function formatCBU($cbu) {
3 if (!$cbu || strlen($cbu) !== 22) {
4 return $cbu;
5 }
6
7 // Formátovanie ako: XXXXXXXX XXXXXXXXXXXXXX
8 return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Príklad použitia
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Výstup: 01234567 89012345678901
141' Excel VBA: Validácia CBU
2Function ValidateCBU(cbu As String) As Boolean
3 ' Kontrola dĺžky
4 If Len(cbu) <> 22 Then
5 ValidateCBU = False
6 Exit Function
7 End If
8
9 ' Kontrola, či sú všetky znaky číslice
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 ' Extrakcia blokov
19 Dim firstBlock As String
20 Dim secondBlock As String
21 firstBlock = Left(cbu, 8)
22 secondBlock = Right(cbu, 14)
23
24 ' Validácia oboch blokov
25 ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27Reálne prípady použitia validácie CBU
Testovanie platobných integrácií
Pri budovaní fintech aplikácií alebo e-commerce platforiem, ktoré spracúvajú argentínske platby, potrebujete platné CBU pre vaše testovacie prostredie. Bežný scenár: vaše stagingové prostredie vyžaduje 50 testovacích účtov s platnými CBU pre záťažové testovanie. Manuálne výpočty kontrolných číslic pre každý by trvali hodiny. Generátor toto zvládne za sekundy a poskytuje správne formátované testovacie dáta, ktoré sa správajú ako produkčné CBU bez rizika náhodného použitia skutočných čísiel účtov.
Pro tip: Uchovávajte sadu vygenerovaných CBU vo vašich testovacích podkladoch. Zabezpečí to konzistentné testovacie dáta v rámci vášho tímu a uľahčí ladenie v prípade zlyhaných testov.
Predchádzanie chybám transakcií
Tu je typický scenár: klient poskytne svoje CBU pre bankový prevod, ale náhodou pridá medzery alebo zamení dve číslice. Ak spracujete prevod bez validácie, banka ho zamietne - ale až po určitom oneskorení a vy ste už zaznamenali zámer transakcie vo vašom systéme. Teraz riešite problémy s odsúhlasovaním.
Validácia formátu CBU pred odoslaním zachytí tieto chyby okamžite. Validátor vám nepovie, či účet existuje alebo patrí správnej osobe (to vyžaduje prístup k bankovému API), ale potvrdí, že štruktúra je správna podľa štandardov BCRA.
Pochopenie požiadaviek bankovej integrácie
Pre vývojárov nových v argentínskom finančnom systéme tento nástroj poskytuje praktickú skúsenosť. Môžete presne vidieť, ako fungujú kontrolné číslice, pochopiť, prečo sú niektoré čísla neplatné, a experimentovať s hraničnými prípadmi pred písaním produkčného kódu.
Bežná chyba: Predpokladať, že validácia CBU je rovnaká ako validácia IBAN. Hoci obe používajú kontrolné číslice, algoritmy sú úplne odlišné. Testovanie pomocou tohto nástroja vám pomôže pochopiť špecifické požiadavky argentínskych bankových kódov.
Validácia formulárov v bankových rozhraniach
Pri navrhovaní vstupných formulárov, ktoré prijímajú CBU, potrebujete otestovať, ako systém zvláda rôzne chybové stavy. Čo sa stane, keď používateľ vloží CBU s medzerami? Aká chybová správa sa zobrazí, keď je kontrolná číslica nesprávna? Tento nástroj vám pomôže otestovať tieto scenáre a navrhnúť lepšiu spätnú väzbu pre používateľa.
Súvisiace nástroje na overenie bankových údajov
V závislosti od vašich požiadaviek môžete potrebovať aj tieto doplnkové nástroje:
- Overovač CUIT/CUIL: Overuje argentínske daňové identifikačné čísla — nevyhnutné, keď potrebujete overenie bankových a daňových identifikátorov
- Overovač CVU: Podobný ako CBU, ale pre digitálne peňaženky (Mercado Pago, Ualá atď.) používajúce rovnaký 22-miestny formát
- Overovač IBAN: Pre cezhraničné platby zahŕňajúce európske alebo iné medzinárodné účty
- Bankové API služby: Pre produkčné systémy, ktoré potrebujú overiť vlastníctvo účtu a kontrolu zostatku, nielen overenie formátu
Dôležité obmedzenie: Tento nástroj overuje iba formát a kontrolné číslice. Nemôže potvrdiť, či CBU zodpovedá aktívnemu bankovému účtu alebo overiť identitu majiteľa účtu. Pre tieto kontroly budete potrebovať integráciu s bankovými API alebo platobnými procesormi Argentíny.
Ako argentínsky bankový systém prijal CBU
Pred novembrom 2000 bolo posielanie peňazí medzi argentínskymi bankami prekvapivo komplikované. Každá finančná inštitúcia používala vlastný systém číslovania účtov - niektoré s 10 číslicami, iné s 15, a bez štandardizovaného spôsobu identifikácie banky alebo pobočky, ktorá účet spravuje. Medzibankové prevody vyžadovali manuálnu kontrolu a často trvali niekoľko dní na spracovanie.
BCRA zaviedla CBU na vyriešenie tejto fragmentácie. Mandátom jednotného 22-miestneho formátu pre všetky finančné inštitúcie sa Argentina priblížila medzinárodným štandardom, ako je systém IBAN v Európe. Zabudované kontrolné číslice boli mimoriadne dômyselné: automaticky zachytávajú väčšinu chýb pri zadávaní údajov, čím znižujú počet neúspešných prevodov a súvisiace náklady na vyšetrovanie a stornovanie transakcií.
Zaujímavé je: Formát CBU sa za posledných 20 rokov takmer nezmenil. Hoci sa bankovníctvo technologicky dramaticky vyvinulo - mobilné aplikácie, okamžité prevody, digitálne peňaženky - základná štruktúra CBU zostáva rovnaká. Táto stabilita svedčí o tom, ako dobre pôvodný návrh anticipoval budúce potreby.
V súčasnosti Argentínčania používajú CBU prakticky pri každej elektronickej finančnej transakcii: výplatných prevodoch, platbách faktúr, daňových priznaniach, štátnych dávkach a elektronickom obchode. Formát sa ukázal ako natoľko efektívny, že keď sa objavili digitálne peňaženky (ako Mercado Pago), regulátori prevzali rovnakú štruktúru pre CVU (Clave Virtual Uniforme) namiesto vytvárania niečoho nového.
Často kladené otázky
Aký je rozdiel medzi CBU a CVU?
CBU identifikuje tradičné bankové účty, zatiaľ čo CVU (Clave Virtual Uniforme) identifikuje digitálne peňaženky od fintech poskytovateľov ako Mercado Pago, Ualá alebo Brubank. Formát je identický - 22 číslic s rovnakým validačným algoritmom - čo dáva zmysel, pretože sú vzájomne prepojiteľné. Môžete previesť peniaze z CBU do CVU a naopak rovnako ako pri akomkoľvek inom bankovom prevode. Prvé tri číslice prezrádzajú, či sa pozeráte na tradičnú banku alebo poskytovateľa digitálnej peňaženky.
Môžem zistiť názov banky z CBU?
Áno. Prvé tri číslice sú identifikátor banky priradený BCRA. Napríklad kódy začínajúce "011" patria Banco Nación, zatiaľ čo "017" označuje BBVA Argentina. BCRA zverejňuje oficiálny register týchto kódov, ktorý bankové aplikácie typicky využívajú na automatické zobrazenie názvu banky pri zadaní CBU.
Je CBU to isté čo číslo účtu?
Nie celkom. Vaše číslo účtu je ukryté vnútri CBU, ale CBU ho zabaľuje s dodatočnými smerovacími informáciami. Predstavte si to ako rozdiel medzi adresou a GPS súradnicami - obe identifikujú polohu, ale jedna obsahuje viac kontextu. CBU spája váš bankový kód, kód pobočky, číslo účtu a dva overovací digits do jedného prevoditeľného reťazca.
Ako bezpečné je zdieľať moje CBU?
CBU je navrhnuté na zdieľanie - to je celý zmysel. Príjemcovia ho potrebujú na vloženie peňazí na váš účet. Na rozdiel od hesiel alebo PIN-ov, CBU umožňuje len prichádzajúce prevody, nie výbery. Napriek tomu s ním zaobchádzajte ako s akoukoľvek finančnou informáciou: zdieľajte ho s ľuďmi alebo spoločnosťami, ktorým dôverujete, a buďte opatrní pri zverejňovaní online. Niektorí ľudia uprednostňujú selektívne zdieľanie CBU namiesto jeho verejného zverejnenia.
Môže CBU vypršať alebo sa zmeniť?
Vaše CBU zostáva s vami, kým je účet otvorený. Zmení sa len vtedy, ak tento účet zatvoríte a otvoríte nový, alebo v zriedkavých prípadoch zlúčenia bánk alebo reštrukturalizácie ich číslovania. Aj vtedy banky typicky zachovávajú staré CBU počas prechodného obdobia, aby sa predišlo narušeniu opakovaných platieb.
Ako nájdem svoje vlastné CBU?
Skontrolujte mobilnú aplikáciu vašej banky - zvyčajne je v sekcii detailov účtu. Väčšina argentínskych bánk ho tiež zobrazuje výrazne v internetovom bankovníctve, tlačí na mesačných výpisoch a niektoré ho dokonca uvádzajú na zadnej strane debetnej karty. Ak ho nemôžete nájsť, ktorýkoľvek bankový zástupca vám ho okamžite poskytne; nie je považované za citlivú informáciu ako PIN.
Môžu cudzinci mať CBU v Argentíne?
Áno. Otvorenie bankového účtu v Argentíne pre cudzinca vám poskytne CBU rovnako ako ktorémukoľvek inému majiteľovi účtu. Požiadavky sa líšia podľa inštitúcie - niektoré banky vyžadujú len pas, zatiaľ čo iné žiadajú doklad o pobyte alebo CDI (daňové identifikačné číslo). Digitálne peňaženky (CVU) sú pre cudzincov často ľahšie dostupné ako tradičné bankové účty.
Čo sa stane, ak prevediem peniaze na neplatné CBU?
Moderné bankové systémy vykonávajú validáciu formátu pred odoslaním prevodu. Ak kontrolné číslice nezodpovedajú alebo dĺžka nie je správna, dostanete okamžitú chybu - prevod nikdy neopustí váš účet. Preto je validácia na vstupe tak cenná; zachytáva preklepy skôr, než spôsobia problémy.
Zložitejšia situácia nastáva, keď CBU prejde validáciou formátu, ale nezodpovedá aktívnemu účtu. Prevod sa odovzdá medzibankové sieti a následne sa vráti späť po hodinách alebo dňoch. Už ste ho zaznamenali ako "odoslaný" vo vašom účtovníctve a teraz potrebujete vyriešiť jeho vrátenie. Preto niektoré aplikácie tiež kontrolujú CBU oproti bankovým databázam pred povolením prevodov, hoci to vyžaduje platený prístup API.
Môžem mať viacero CBU?
Absolútne. Každý účet generuje vlastné CBU. Ak máte bežný a sporiaci účet v tej istej banke, budete mať dva odlišné CBU. Rôzne účty v rôznych bankách? Ešte viac CBU. Každé jedinečne identifikuje špecifický účet v špecifickej pobočke špecifickej inštitúcie.
Je systém CBU používaný mimo Argentíny?
Nie, CBU je špecifické pre Argentínu. Každá krajina má svoj vlastný systém: Európa používa IBAN, USA používajú smerové čísla plus čísla účtov, Austrália používa BSB kódy a podobne. Pri medzinárodných prevodoch budete typicky potrebovať SWIFT kód príjemcu plus jeho lokálny identifikátor účtu - ktorým je v prípade Argentíny CBU.
Referencie a oficiálna dokumentácia
Pre autoritatívne informácie o bankových štandardoch Argentíny:
-
Centrálna banka Argentíny (BCRA) - Finančné systémové predpisy - Oficiálna BCRA dokumentácia o štandardoch platobného systému a bankových predpisoch
-
Zákon č. 25,345 - "Prevencia daňových únikov a modernizácia platieb" (november 2000) - Legislatíva, ktorá stanovila rámec elektronických platobných systémov Argentíny
-
BCRA Komunikácia "A" série - Technické obežníky definujúce požiadavky na implementáciu CBU pre finančné inštitúcie
-
Interbanking S.A. - Organizácia, ktorá prevádzkuje argentínsku medzibankovú elektronickú platobnú sieť a udržiava smerovné tabuľky CBU
Tieto zdroje poskytujú technické špecifikácie použité na implementáciu tohto validátora a sú pravidelne aktualizované argentínskymi finančnými orgánmi.
Pripravení na validáciu alebo generovanie CBU?
Či už budujete platobnú integráciu, testujete fintech aplikáciu, alebo sa učíte o argentínskom bankovom systéme, pochopenie validácie CBU je nevyhnutné. Tento nástroj implementuje presne rovnaké algoritmy kontrolného súčtu, ktoré používajú argentínske banky, takže môžete zachytiť chyby vo formáte skôr, než spôsobia zlyhanie transakcie.
Pamätajte: validácia formátu je len prvým krokom. Správne naformátované CBU nezaručuje, že účet existuje alebo že máte správneho príjemcu. Pre produkčné systémy spracúvajúce skutočné peniaze kombinujte validáciu formátu s ďalšou overením prostredníctvom bankových API alebo platobných procesorov.
Nástroj nevyžaduje žiadnu registráciu ani inštaláciu - stačí ho otvoriť a začať validovať alebo generovať CBU podľa oficiálnych štandardov BCRA.