Generátor a validátor CBU pro Argentinu | Bankovní kódy BCRA

Co je argentinské CBU a proč ho ověřovat?

Práce s argentinským bankovním systémem znamená práci s CBU (Clave Bancaria Uniforme) - 22-místným kódem, který jednoznačně identifikuje každý bankovní účet v zemi. Pokud jste někdy potřebovali otestovat platební integraci, ověřit bankovní údaje před převodem nebo pochopit, proč transakce selhala, víte, jak kritické je pracovat s řádně formátovanými CBU.

Tento nástroj vám pomáhá generovat strukturálně platná CBU pro testovací prostředí a ověřovat existující kódy podle oficiálního formátu stanoveného argentinskou Centrální bankou (BCRA). Při budování finančních aplikací nebo zpracování plateb může včasné zachycení formátových chyb ušetřit hodiny ladění a předejít selháním transakcí.

Porozumění formátu CBU

CBU (Clave Bancaria Uniforme) je argentinská odpověď na mezinárodní bankovní identifikátory jako IBAN nebo americká routovací čísla. Můžete si to představit jako komplexní balíček, který sdružuje informace o bance, pobočce a účtu do jediného 22-místného kódu. Centrální banka Argentiny (BCRA) zavedla tento systém v listopadu 2000, aby standardizovala elektronické převody v rámci země.

Struktura a formát CBU

Každé platné CBU sestává přesně z 22 číslic rozdělených do dvou hlavních bloků:

1. První blok (8 číslic): Identifikuje finanční instituci a pobočku

   • První 3 číslice: Kód banky přidělený BCRA
   • Další 4 číslice: Kód pobočky v bance
   • Poslední číslice: Ověřovací číslice prvního bloku

2. Druhý blok (14 číslic): Identifikuje konkrétní účet

   • Prvních 13 číslic: Číslo účtu (může zahrnovat typ účtu a další identifikátory)
   • Poslední číslice: Ověřovací číslice druhého bloku

Ověřovací číslice používají vážený algoritmus modulo-10, který zachytává běžné překlepy – jako jsou prohozené číslice nebo chyby v jednotlivých číslicích – ještě předtím, než dojde k jakémukoli pohybu peněz. Tato ochrana se ukázala jako mimořádně účinná: většina chyb při zadávání CBU je zachycena již ve validačním stadiu, místo aby vedly k neúspěšným převodům.

Jak vygenerovat testovací CBU

Generátor vytváří náhodné, ale strukturálně platné CBU, které projdou všemi formátovými kontrolami. Zde je, co se děje v zákulisí:

1. Náhodné číslice vyplní sekce bankovního kódu, kódu pobočky a čísla účtu
2. Nástroj vypočítá obě ověřovací číslice pomocí oficiálního algoritmu BCRA
3. Obdržíte správně naformátované 22-místné CBU připravené pro testování

Kdy bude toto užitečné:

• Testování platebních integrací: Potřebujete desítky platných CBU pro váš testovací balíček? Vygenerujte je okamžitě bez manuálního výpočtu.
• QA a stagingová prostředí: Naplňte testovací databáze realistickými bankovními daty, která náhodou neodpovídají skutečným účtům.
• Učení formátu: Podívejte se, jak jsou různá CBU strukturována a pochopte ověřovací logiku.
• Dokumentace a ukázky: Vytvořte vzorová data, která vypadají autenticky, aniž byste odhalili skutečné bankovní informace.

Krok za krokem: Generování CBU

1. Přejděte na kartu "Generátor" nástroje
2. Klikněte na tlačítko "Generovat CBU"
3. V zobrazovací oblasti se objeví platné, náhodné 22-místné CBU
4. Použijte tlačítko "Kopírovat" pro zkopírování CBU do schránky pro použití ve vašich aplikacích

Jak ověřit argentinské CBU

Validátor provádí stejné kontroly, které argentinské bankovní systémy používají k ověření integrity CBU. Co se kontroluje:

1. Ověření délky: Potvrzuje přesně 22 číslic (běžnou chybou je kopírování s mezerami nebo pomlčkami)
2. Obsah pouze čísel: Zajišťuje, že nebyly vloženy žádné písmena nebo speciální znaky
3. Kontrolní součet prvního bloku: Ověřuje 8. číslici podle prvních 7 číslic
4. Kontrolní součet druhého bloku: Ověřuje 22. číslici podle číslic 9-21

Pokud ověření selže, uvidíte, která konkrétní kontrola nepřešla. To je obzvláště užitečné při ladění důvodu, proč bankovní API zamítlo CBU - často je to něco jednoduchého, jako je nadbytečná mezera nebo přeházená číslice.

Krok za krokem: Ověření CBU

1. Přejděte na kartu "Validátor" nástroje
2. Zadejte 22-místné CBU, které chcete ověřit
3. Klikněte na tlačítko "Ověřit CBU"
4. Prohlédněte si výsledek ověření:
   • Zelený indikátor pro platná CBU
   • Červený indikátor s konkrétními chybovými zprávami pro neplatná CBU

Vysvětlení algoritmu ověřování CBU

BCRA používá vážený modulo-10 algoritmus kontrolního součtu pro výpočet ověřovacích číslic. Pokud implementujete ověřování CBU ve vaší aplikaci, zde je přesná logika:

Ověření prvního bloku

Pro první blok (prvních 8 číslic) se ověřovací číslice počítá následovně:

1. Vezměte prvních 7 číslic CBU
2. Vynásobte každou číslici jejím odpovídajícím váhovým koeficientem: [7, 1, 3, 9, 7, 1, 3]
3. Sečtěte výsledné součiny
4. Vypočítejte: 10 - (součet % 10)
5. Pokud je výsledek 10, ověřovací číslice je 0; jinak je to vypočítaná hodnota

Ověření druhého bloku

Pro druhý blok (posledních 14 číslic) se ověřovací číslice počítá následovně:

1. Vezměte prvních 13 číslic druhého bloku
2. Vynásobte každou číslici jejím odpovídajícím váhovým koeficientem: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
3. Sečtěte výsledné součiny
4. Vypočítejte: 10 - (součet % 10)
5. Pokud je výsledek 10, ověřovací číslice je 0; jinak je to vypočítaná hodnota

Validace kódu CBU - příklady

Zde je postup implementace validace CBU ve vaší aplikaci. Tyto příklady odpovídají oficiální specifikaci BCRA a budou fungovat s produkčními bankovními daty:

1// JavaScript: Výpočet kontrolní číslice CBU
2function calculateCheckDigit(number, weights) {
3  if (number.length !== weights.length) {
4    throw new Error('Délka čísla musí odpovídat délce vah');
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// Validace první části 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}
28

1# Python: Validace 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í obsahovat 22 číslic']
10        }
11    
12    # Rozdělení na části
13    first_block = cbu[:8]
14    second_block = cbu[8:]
15    
16    # Validace každé části
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('První část (kód banky/pobočky) je neplatná')
23    if not second_block_valid:
24        errors.append('Druhá část (číslo účtu) je neplatná')
25    
26    return {
27        'isValid': first_block_valid and second_block_valid,
28        'errors': errors
29    }
30

1// Java: Generování 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        // Generování první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 kontrolní číslice první části
15        int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16        int firstBlockCheckDigit = calculateCheckDigit(
17            firstBlockBase.toString(), 
18            firstBlockWeights
19        );
20        
21        // Generování prvních 13 číslic druhé části
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 kontrolní číslice druhé části
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        // Kombinace všech částí
35        return firstBlockBase.toString() + firstBlockCheckDigit + 
36               secondBlockBase.toString() + secondBlockCheckDigit;
37    }
38    
39    // Implementace metody calculateCheckDigit...
40}
41

1// PHP: Formátování CBU pro zobrazení
2function formatCBU($cbu) {
3    if (!$cbu || strlen($cbu) !== 22) {
4        return $cbu;
5    }
6    
7    // Formátování jako: XXXXXXXX XXXXXXXXXXXXXX
8    return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Příklad použití
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Výstup: 01234567 89012345678901
14

1' Excel VBA: Validace CBU
2Function ValidateCBU(cbu As String) As Boolean
3    ' Kontrola délky
4    If Len(cbu) <> 22 Then
5        ValidateCBU = False
6        Exit Function
7    End If
8    
9    ' Kontrola, zda jsou všechny 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    ' Extrakce částí
19    Dim firstBlock As String
20    Dim secondBlock As String
21    firstBlock = Left(cbu, 8)
22    secondBlock = Right(cbu, 14)
23    
24    ' Validace obou částí
25    ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27

Reálné případy použití validace CBU

Testování platebních integrací

Při budování fintech aplikací nebo e-commerce platforem, které zpracovávají argentinské platby, potřebujete platné CBU pro testovací prostředí. Běžný scénář: vaše stagingové prostředí vyžaduje 50 testovacích účtů s platnými CBU pro zátěžové testování. Ruční výpočet kontrolních číslic pro každý by trval hodiny. Generátor toto zvládne během sekund a poskytuje správně formátovaná testovací data, která se chovají jako produkční CBU bez rizika náhodného použití skutečných čísел účtů.

Tip pro profesionály: Uchovávejte sadu vygenerovaných CBU ve svých testovacích fixtures. To zajistí konzistentní testovací data v rámci vašeho týmu a usnadní ladění, když testy selžou.

Prevence chyb v transakcích

Typicky se stává: klient poskytne své CBU pro bankovní převod, ale náhodou zahrne mezery nebo zamění dvě číslice. Pokud převod zpracujete bez ověření, banka jej zamítne - ale až po prodlevě, a vy už jste zaznamenali záměr transakce ve vašem systému. Nyní řešíte problémy s odsouhlasením.

Ověření formátu CBU před odesláním zachytí tyto chyby okamžitě. Validátor vám neřekne, zda účet existuje nebo patří správné osobě (to vyžaduje přístup k bankovnímu API), ale potvrdí, že struktura odpovídá standardům BCRA.

Pochopení požadavků bankovní integrace

Pro vývojáře nové v argentinském finančním systému tento nástroj poskytuje praktickou výuku. Můžete přesně vidět, jak kontrolní číslice fungují, pochopit, proč jsou některá čísla neplatná, a experimentovat s hraničními případy před psaním produkčního kódu.

Běžná chyba: Předpokládat, že validace CBU je stejná jako validace IBAN. Přestože obě používají kontrolní číslice, algoritmy se zcela liší. Testování pomocí tohoto nástroje vám pomůže pochopit specifické požadavky argentinských bankovních kódů.

Validace formulářů v bankovních uživatelských rozhraních

Při navrhování vstupních formulářů, které přijímají CBU, potřebujete otestovat, jak systém zpracovává různé stavy chyb. Co se stane, když uživatel vloží CBU s mezerami? Jaká chybová zpráva se zobrazí, když je kontrolní číslice špatně? Tento nástroj vám pomůže otestovat tyto scénáře a navrhnout lepší zpětnou vazbu pro uživatele.

Související nástroje pro ověřování bankovních údajů

V závislosti na vašich požadavcích můžete potřebovat i tyto doplňkové nástroje:

• Validátor CUIT/CUIL: Ověřuje argentinská daňová identifikační čísla — nezbytné, když potřebujete ověření bankovních a daňových identifikátorů
• Validátor CVU: Podobný CBU, ale pro digitální peněženky (Mercado Pago, Ualá atd.) používající stejný 22-místný formát
• Validátor IBAN: Pro mezinárodní platby zahrnující evropské nebo jiné mezinárodní účty
• Bankovní API služby: Pro produkční systémy, které potřebují ověřit vlastnictví účtu a kontrolu zůstatku, nejen formátovou validaci

Důležité omezení: Tento nástroj ověřuje pouze formát a kontrolní číslice. Nemůže potvrdit, zda CBU odpovídá aktivnímu bankovnímu účtu nebo ověřit totožnost majitele účtu. Pro tyto kontroly budete potřebovat integraci s argentinskými bankovními API nebo platebními procesory.

Jak argentinský bankovní systém přijal CBU

Před listopadem 2000 bylo posílání peněz mezi argentinskými bankami překvapivě komplikované. Každá finanční instituce používala vlastní systém číslování účtů - některé s 10 číslicemi, jiné s 15, a bez standardizovaného způsobu identifikace banky nebo pobočky, kde je účet veden. Mezibankovní převody vyžadovaly ruční ověření a často trvaly několik dní.

BCRA zavedla CBU, aby vyřešila tuto fragmentaci. Nařízením jednotného 22-místného formátu ve všech finančních institucích Argentina sladila své standardy s mezinárodními systémy, jako je evropský systém IBAN. Vestavěné kontrolní číslice byly obzvláště chytré: automaticky zachytí většinu chyb při zadávání dat, čímž se sníží počet neúspěšných převodů a s tím spojené náklady na vyšetřování a stornování transakcí.

Co je zajímavé: Formát CBU se za posledních 20 let téměř nezměnil. Přestože bankovní technologie se dramaticky vyvinuly - mobilní aplikace, okamžité převody, digitální peněženky - základní struktura CBU zůstává stejná. Tato stabilita vypovídá o tom, jak dobře původní návrh předvídal budoucí potřeby.

Dnes Argentinci používají CBU prakticky pro každou elektronickou finanční transakci: výplaty mezd, platby účtů, daňová přiznání, státní dávky a elektronický obchod. Formát se ukázal jako natolik účinný, že když se objevily digitální peněženky (jako Mercado Pago), regulátoři přijali stejnou strukturu pro CVU (Clave Virtual Uniforme), místo aby vymýšleli něco nového.

Často kladené dotazy

Jaký je rozdíl mezi CBU a CVU?

CBU identifikuje tradiční bankovní účty, zatímco CVU (Clave Virtual Uniforme) identifikuje digitální peněženky fintech poskytovatelů jako Mercado Pago, Ualá nebo Brubank. Formát je identický — 22 číslic se stejným validačním algoritmem — což dává smysl, protože jsou vzájemně propojitelné. Můžete převádět peníze z CBU do CVU a naopak stejně jako jakýkoli jiný bankovní převod. První tři číslice prozrazují, zda se díváte na tradiční banku nebo poskytovatele digitální peněženky.

Mohu zjistit název banky z CBU?

Ano. První tři číslice jsou identifikátor banky přidělený BCRA. Například kódy začínající „011" patří Banco Nación, zatímco „017" označuje BBVA Argentina. BCRA zveřejňuje oficiální registr těchto kódů, který bankovní aplikace typicky využívají k automatickému zobrazení názvu banky při zadání CBU.

Je CBU totéž co číslo účtu?

Ne zcela. Číslo vašeho účtu je ukryto uvnitř CBU, ale CBU jej zabaluje s dalšími směrovacími informacemi. Představte si to jako rozdíl mezi adresou a GPS souřadnicemi — obojí identifikuje polohu, ale jeden zahrnuje více kontextu. CBU sdružuje váš bankovní kód, kód pobočky, číslo účtu a dva ověřovací digits do jediného převoditelného řetězce.

Jak bezpečné je sdílet moje CBU?

CBU je navrženo k sdílení — to je celý smysl. Příjemci jej potřebují k vložení peněz na váš účet. Na rozdíl od hesel nebo PIN kódů CBU umožňuje pouze příchozí převody, nikoli výběry. Přesto s ním zacházejte jako s jakýmikoli finančními informacemi: sdílejte jej s lidmi nebo společnostmi, kterým důvěřujete, a buďte opatrní při zveřejňování online. Někteří lidé upřednostňují selektivní sdílení CBU před jeho veřejným zveřejněním.

Může CBU vypršet nebo se změnit?

Vaše CBU zůstává s vámi, dokud je účet otevřen. Změní se pouze tehdy, pokud tento účet uzavřete a otevřete nový, nebo ve vzácných případech, kdy banky sloučí nebo restrukturalizují své číslování. I tehdy banky typicky udržují staré CBU po přechodné období, aby se zabránilo narušení opakujících se plateb.

Jak najdu své vlastní CBU?

Podívejte se do mobilní aplikace vaší banky — obvykle je v sekci údajů o účtu. Většina argentinských bank jej také zobrazuje výrazně v online bankovnictví, tiskne na měsíčních výpisech a některé jej dokonce uvádějí na zadní straně debetních karet. Pokud jej nemůžete najít, jakýkoli bankovní zástupce vám jej okamžitě poskytne; není považováno za citlivou informaci jako PIN.

Mohou cizinci mít CBU v Argentině?

Ano. Otevření bankovního účtu v Argentině jako cizinec vám poskytne CBU stejně jako jakémukoli jinému držiteli účtu. Požadavky se liší podle instituce — některé banky vyžadují pouze pas, zatímco jiné žádají doklad o pobytu nebo CDI (daňové identifikační číslo). Digitální peněženky (CVU) jsou pro cizince často snáze dostupné než tradiční bankovní účty.

Co se stane, když provedu převod na neplatné CBU?

Moderní bankovní systémy provádějí validaci formátu před odesláním převodu. Pokud kontrolní číslice nesouhlasí nebo délka je špatná, dostanete okamžitou chybu — převod nikdy neopustí váš účet. Proto je přední validace tak cenná; zachytí překlepy ještě předtím, než způsobí problémy.

Komplikovanější situace nastává, když CBU projde formální validací, ale neshoduje se s aktivním účtem. Převod je odeslán do mezibankovní sítě a poté se vrátí zpět po hodinách nebo dnech. Již jste jej zaznamenali jako „odeslaný" v účetnictví a nyní potřebujete vyřešit jeho vrácení. Proto některé aplikace také kontrolují CBU proti bankovním databázím před povolením převodů, i když to vyžaduje placený API přístup.

Mohu mít více CBU?

Rozhodně. Každý účet generuje své vlastní CBU. Pokud máte běžný a spořicí účet ve stejné bance, budete mít dvě odlišná CBU. Různé účty v různých bankách? Více CBU. Každé jedinečně identifikuje specifický účet ve specifické pobočce specifické instituce.

Je systém CBU používán mimo Argentinu?

Ne, CBU je specifické pro Argentinu. Každá země má svůj vlastní systém: Evropa používá IBAN, USA používají směrovací čísla plus čísla účtů, Austrálie používá BSB kódy atd. Při mezinárodním posílání peněz budete typicky potřebovat SWIFT kód příjemce plus jeho místní identifikátor účtu — který v případě Argentiny bude CBU.

Reference a Oficiální dokumentace

Pro autoritativní informace o argentinských bankovních standardech:

1. Centrální banka Argentiny (BCRA) - Předpisy finančního systému - Oficiální dokumentace BCRA o standardech platebního systému a bankovních předpisech

2. Zákon č. 25,345 - „Prevence daňových úniků a modernizace plateb" (listopad 2000) - Legislativa, která stanovila rámec elektronických platebních systémů v Argentině

3. Komunikace BCRA série „A" - Technické oběžníky definující požadavky na implementaci CBU pro finanční instituce

4. Interbanking S.A. - Organizace, která provozuje argentinskou mezibankovní elektronickou platební síť a spravuje směrovací tabulky CBU

Tyto zdroje poskytují technické specifikace použité pro implementaci tohoto validátoru a jsou pravidelně aktualizovány argentinskými finančními úřady.

Připraveni ověřit nebo generovat CBU?

Ať už budujete platební integraci, testujete fintech aplikaci nebo se učíte o argentinském bankovním systému, pochopení ověřování CBU je zásadní. Tento nástroj implementuje přesně stejné algoritmy kontrolního součtu, které používají argentinské banky, takže můžete zachytit chyby formátu ještě před tím, než způsobí selhání transakce.

Pamatujte: ověřování formátu je jen první krok. Správně naformátované CBU nezaručuje, že účet existuje nebo že máte správného příjemce. Pro produkční systémy pracující s reálnými penězi kombinujte ověřování formátu s dalšími ověřeními prostřednictvím bankovních API nebo platebních procesorů.

Nástroj nevyžaduje žádnou registraci nebo instalaci - stačí jej otevřít a začít ověřovat nebo generovat CBU podle oficiálních standardů BCRA.