Генератор и валидатор на CBU за Аржентина | Банкови кодове на BCRA

Какво е аржентинско CBU и защо да го валидираме?

Работата с банковата система на Аржентина означава да се справяте с CBU (Clave Bancaria Uniforme) - 22-цифров код, който уникално идентифицира всяка банкова сметка в страната. Ако някога сте се нуждаели от тестване на интеграция на плащане, проверка на банкови детайли преди превод или разбиране защо дадена транзакция е неуспешна, знаете колко критично е да работите с правилно форматирани CBU.

Този инструмент помага да генерирате структурно валидни CBU за тестови среди и да валидирате съществуващи кодове спрямо официалния формат, определен от Централната банка на Аржентина (BCRA). Когато изграждате финансови приложения или обработвате плащания, улавянето на форматни грешки в ранен етап спестява часове дебъгване и предотвратява неуспешни транзакции.

Разбиране на CBU формата

CBU (Clave Bancaria Uniforme) е отговорът на Аржентина към международните банкови идентификатори като IBAN или американски транзитни номера. Можете да го разглеждате като всеобхватен пакет, който обединява информацията за банката, клона и сметката в единен 22-цифрен код. Централната банка на Аржентина (BCRA) въведе тази система през ноември 2000 година, за да стандартизира електронните преводи в цялата финансова мрежа на страната.

Структура и формат на CBU

Всеки валиден CBU се състои точно от 22 цифри, разделени на два основни блока:

1. Първи блок (8 цифри): Идентифицира финансовата институция и клон

   • Първите 3 цифри: Банков код, присвоен от BCRA
   • Следващите 4 цифри: Код на клона в банката
   • Последната цифра: Контролна цифра за първия блок

2. Втори блок (14 цифри): Идентифицира конкретната сметка

   • Първите 13 цифри: Номер на сметката (може да включва тип сметка и други идентификатори)
   • Последната цифра: Контролна цифра за втория блок

Контролните цифри използват претеглен модуло-10 алгоритъм, който улавя често срещани правописни грешки — като разменени цифри или еднократни цифрови грешки — преди да се извърши какъвто и да е паричен превод. Тази предпазна мярка се е доказала като изключително ефективна: повечето грешки при въвеждане на CBU се улавят по време на валидирането, вместо да водят до неуспешни преводи.

Как да генерираме тестов CBU

Генераторът създава случайни, но структурно валидни CBU, които преминават всички формални проверки. Ето какво се случва зад кулисите:

1. Случайни цифри попълват секциите за банков код, код на клон и номер на сметка
2. Инструментът изчислява и двата контролни цифри, като използва официалния алгоритъм на BCRA
3. Получавате правилно форматиран 22-цифрен CBU, готов за тестване

Кога ще намерите това полезно:

• Тестване на плащания: Нуждаете се от десетки валидни CBU за вашия тестов комплект? Генерирайте ги мигновено без ръчно изчисление.
• QA и тестови среди: Попълвайте тестови бази данни с реалистични банкови данни, които случайно няма да съвпаднат с реални сметки.
• Изучаване на формата: Вижте как са структурирани различните CBU и разберете логиката на проверка.
• Документация и демонстрации: Създавайте примерни данни, които изглеждат автентични, без да разкривате реална банкова информация.

Стъпка по стъпка: Генериране на CBU

1. Отидете в раздел "Генератор" на инструмента
2. Натиснете бутона "Генериране на CBU"
3. Валиден, случаен 22-цифрен CBU ще се появи в областта за показване
4. Използвайте бутона "Копиране", за да копирате CBU в буферната памет за употреба в приложенията си

Как да валидираме argentine CBU

Валидаторът извършва същите проверки, които банковите системи на Аржентина използват за проверка на CBU целостта. Какво се проверява:

1. Проверка на дължината: Потвърждава точно 22 цифри (честа грешка е копирането с интервали или тирета)
2. Съдържание само с цифри: Гарантира, че няма букви или специални знаци
3. Контролна сума на първия блок: Валидира 8-та цифра спрямо първите 7 цифри
4. Контролна сума на втория блок: Валидира 22-та цифра спрямо цифрите от 9 до 21

Когато валидацията не премине, ще видите коя конкретна проверка не е преминала. Това е особено полезно при отстраняване на грешки защо банков API е отхвърлил CBU - често това е нещо просто като допълнителен интервал или разменени цифри.

Стъпка по стъпка: Валидиране на CBU

1. Отидете в раздел "Валидатор" на инструмента
2. Въведете 22-цифрения CBU, който искате да валидирате
3. Кликнете бутона "Валидирай CBU"
4. Прегледайте резултата от валидацията:
   • Зелен индикатор за валидни CBU
   • Червен индикатор с конкретни съобщения за грешки при невалидни CBU

Обяснение на алгоритъма за проверка на CBU

BCRA използва алгоритъм за контролна сума с тегловен модул-10 за изчисляване на контролни цифри. Ако внедрявате CBU валидация в приложението си, ето точната логика:

Проверка на първи блок

За първия блок (първите 8 цифри), контролната цифра се изчислява, както следва:

1. Вземете първите 7 цифри на CBU
2. Умножете всяка цифра по нейното съответстващо тегло: [7, 1, 3, 9, 7, 1, 3]
3. Съберете получените произведения
4. Изчислете: 10 - (сума % 10)
5. Ако резултатът е 10, контролната цифра е 0; в противен случай, тя е изчислената стойност

Проверка на втори блок

За втория блок (последните 14 цифри), контролната цифра се изчислява, както следва:

1. Вземете първите 13 цифри на втория блок
2. Умножете всяка цифра по нейното съответстващо тегло: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
3. Съберете получените произведения
4. Изчислете: 10 - (сума % 10)
5. Ако резултатът е 10, контролната цифра е 0; в противен случай, тя е изчислената стойност

Валидация на 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}
28

1# 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    }
30

1// 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}
41

1// 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
14

1' 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 за тестовата среда. Типичен сценарий: вашата тестова среда изисква 50 тестови акаунта с валидни CBU за натоварване. Ръчното изчисляване на контролни цифри за всеки би отнело часове. Генераторът извършва това за секунди, като ви предоставя правилно форматирани тестови данни, които се държат като производствени CBU, без риск от случайно използване на реални номера на сметки.

Професионален съвет: Съхранявайте набор от генерирани CBU във вашите тестови fixtures. Това гарантира последователни тестови данни в екипа и улеснява отстраняването на грешки, когато тестовете се провалят.

Предотвратяване на транзакционни грешки

Ето какво обикновено се случва: клиент предоставя CBU за паричен превод, но случайно е включил интервали или разменил две цифри. Ако обработите превода без валидация, банката го отхвърля - но едва след забавяне, и вие вече сте записали намерението за транзакция в системата си. Сега се занимавате с главоболия по съгласуването.

Валидирането на CBU формата преди изпращане улавя тези грешки незабавно. Валидаторът няма да ви каже дали сметката съществува или принадлежи на правилния човек (това изисква достъп до банкова API), но ще потвърди, че структурата е правилна според стандартите на BCRA.

Разбиране на изискванията за банкова интеграция

За разработчици, които са нови в аржентинската финансова система, този инструмент осигурява практическо обучение. Можете да видите точно как работят контролните цифри, да разберете защо някои номера са невалидни и да експериментирате с гранични случаи преди писане на производствен код.

Честа грешка: Предположението, че валидацията на CBU е същата като валидацията на IBAN. Докато и двете използват контролни цифри, алгоритмите са напълно различни. Тестването с този инструмент помага да разберете специфичните изисквания на аржентинските банкови кодове.

Валидация на форми в банкови потребителски интерфейси

При проектирането на входни форми, които приемат CBU, трябва да тествате как системата се справя с различни състояния на грешка. Какво се случва, когато потребителят постави CBU с интервали? Какво съобщение за грешка се появява, когато контролната цифра е грешна? Този инструмент помага да тествате тези сценарии и да проектирате по-добра обратна връзка за потребителя.

Свързани инструменти за банкова валидация

В зависимост от вашите изисквания, може да ви потрябват и тези допълнителни инструменти:

• Валидатор на CUIT/CUIL: Валидира argentine данъчни идентификационни номера - essential когато се нуждаете от проверка на банкова и данъчна идентификация
• CVU Валидатор: Подобен на CBU, но за дигитални портфейли (Mercado Pago, Ualá и др.), използващи същия 22-цифрен формат
• IBAN Валидатор: За трансгранични плащания, включващи европейски или други международни сметки
• Банкови API услуги: За производствени системи, които се нуждаят от проверка на собственост на сметка и баланс, а не само от валидиране на формат

Важно ограничение: Този инструмент валидира само формата и контролните цифри. Не може да потвърди дали CBU съответства на активна банкова сметка или да провери самоличността на титуляря на сметката. За тези проверки ще са ви необходими интеграция с argentine банкови API или платежни процесори.

Как банковата система на Аржентина възприе CBU

Преди ноември 2000 г. изпращането на пари между аржентински банки беше изненадващо усложнено. Всяка финансова институция използваше собствена система за номериране на сметки - някои с 10 цифри, други с 15, и без стандартизиран начин за идентифициране на това коя банка или клон държи сметката. Междубанковите преводи изискваха ръчна проверка и често отнемаха дни за обработка.

BCRA въведе CBU, за да реши тази фрагментация. Като задължи единен 22-цифрен формат във всички финансови институции, Аржентина се съобрази с международни стандарти като европейската система IBAN. Вградените контролни цифри бяха особено находчиви: те автоматично улавят повечето грешки при въвеждане на данни, като намаляват неуспешните преводи и свързаните с тях разходи за разследване и анулиране на транзакции.

Интересното е: Форматът на CBU почти не се е променял повече от 20 години. Докато банковите технологии са еволюирали драстично - мобилни приложения, мигновени преводи, дигитални портфейли - основната структура на CBU остава същата. Тази стабилност говори за това колко добре първоначалният дизайн е предвидил бъдещите нужди.

Днес аржентинците използват CBU практически за всяка електронна финансова транзакция: депозити за заплати, плащания на сметки, данъчни декларации, държавни помощи и електронна търговия. Форматът се е доказал толкова ефективен, че когато се появиха дигитални портфейли (като Mercado Pago), регулаторите възприеха същата структура за CVU (Clave Virtual Uniforme), вместо да измислят нещо ново.

Често задавани въпроси

Каква е разликата между CBU и CVU?

CBU идентифицира традиционни банкови сметки, докато CVU (Clave Virtual Uniforme) идентифицира дигитални портфейлни сметки от финтех доставчици като Mercado Pago, Ualá или Brubank. Форматът е идентичен - 22 цифри със същия алгоритъм за валидация - което има смисъл, защото са оперативно съвместими. Можете да превеждате пари от CBU към CVU и обратно, точно като всеки друг банков превод. Първите три цифри разкриват дали гледате традиционна банка или доставчик на дигитален портфейл.

Мога ли да разбера името на банката от CBU?

Да. Първите три цифри са идентификаторът на банката, определен от BCRA. Например, кодове, започващи с "011", принадлежат на Banco Nación, докато "017" показва BBVA Argentina. BCRA публикува официален регистър на тези кодове, който банковите приложения обикновено използват, за да показват името на банката автоматично, когато въведете CBU.

Същото ли е CBU като номер на сметка?

Не съвсем. Номерът на вашата сметка е вграден в CBU, но CBU го комплектова с допълнителна маршрутизационна информация. Помислете за това като разликата между адрес на улица и GPS координати - и двете идентифицират местоположение, но едното включва повече контекст. CBU обединява вашия банков код, код на клон, номер на сметка и две проверочни цифри в един прехвърляем низ.

Колко сигурно е да споделям моя CBU?

CBU е проектиран да бъде споделян - точно това е целта. Получателите се нуждаят от него, за да депозират пари по вашата сметка. За разлика от пароли или PIN кодове, CBU позволява само входящи преводи, не и тегления. Въпреки това, третирайте го като всяка друга финансова информация: споделяйте го с хора или компании, на които имате доверие, и бъдете предпазливи при публикуването му онлайн. Някои хора предпочитат да дават CBU селективно, вместо да го публикуват открито.

Може ли CBU да изтече или да се промени?

Вашият CBU остава с вас, докато сметката е отворена. Променя се само ако затворите тази сметка и отворите нова, или в редки случаи, когато банките се сливат или преструктурират своите номерационни системи. Дори тогава банките обикновено поддържат стария CBU за преходен период, за да избегнат прекъсване на периодичните плащания.

Как да намеря моя собствен CBU?

Проверете мобилното приложение на вашата банка - обикновено е в секцията с детайли на сметката. Повечето аржентински банки го показват prominently в онлайн банкирането, отпечатват го на месечните извлечения и някои дори го включват на гърба на дебитните карти. Ако не можете да го намерите, всеки банков представител може да ви го предостави незабавно; той не се счита за чувствителна информация като PIN.

Могат ли чужденци да имат CBU в Аржентина?

Да. Отварянето на банкова сметка в Аржентина като чужденец ви дава CBU като всеки друг титуляр на сметка. Изискванията варират в зависимост от институцията - някои банки изискват само паспорт, докато други искат доказателство за пребиваване или CDI (данъчен идентификационен номер). Дигиталните портфейли (CVU) са често по-лесни за чужденци за достъп от традиционните банкови сметки.

Какво се случва, ако направя превод към невалиден CBU?

Съвременните банкови системи извършват валидация на формата преди подаване на превода. Ако контролните цифри не съвпадат или дължината е грешна, ще получите незабавна грешка - преводът никога не напуска вашата сметка. Ето защо предварителната валидация е толкова ценна; тя улавя правописните грешки, преди да причинят проблеми.

По-сложната ситуация е, когато CBU премине валидация на формата, но не съответства на активна сметка. Преводът се подава към междубанковата мрежа и после се връща след часове или дни. Вече сте го записали като "изпратен" във вашето счетоводство и сега трябва да reconciliate връщането. Ето защо някои приложения също проверяват CBU срещу банкови бази данни, преди да позволят преводи, макар че това изисква платен API достъп.

Мога ли да имам множество CBU?

Абсолютно. Всяка сметка генерира свой собствен CBU. Ако имате разплащателна и спестовна сметка в една и съща банка, ще имате два различни CBU. Различни сметки в различни банки? Повече CBU. Всеки един уникално идентифицира конкретна сметка в конкретен клон на конкретна институция.

Използва ли се CBU системата извън Аржентина?

Не, CBU са специфични за Аржентина. Всяка страна има своя собствена система: Европа използва IBAN, САЩ използват рутиращи номера плюс номера на сметки, Австралия използва BSB кодове и т.н. При изпращане на пари в чужбина, обикновено ще ви трябва SWIFT кодът на получателя плюс неговия локален идентификатор на сметка - който в случая на Аржентина би бил CBU.

Препратки и официална документация

За авторитетна информация относно банковите стандарти на Аржентина:

1. Централна банка на Аржентина (BCRA) - Регламенти на финансовата система - Официална BCRA документация за стандарти на платежната система и банкови разпоредби

2. Закон № 25,345 - „Предотвратяване на данъчни измами и модернизация на плащанията" (Ноември 2000) - Законодателството, което установи рамката за електронни платежни системи в Аржентина

3. BCRA Комуникация „A" Серия - Технически циркуляри, определящи изискванията за прилагане на CBU за финансови институции

4. Интербанкинг С.А. - Организацията, която управлява междубанковата електронна платежна мрежа на Аржентина и поддържа CBU маршрутни таблици

Тези източници предоставят техническите спецификации, използвани за прилагане на този валидатор, и се актуализират редовно от аржентинските финансови власти.

Готови да валидирате или генерирате CBU?

Независимо дали изграждате платежна интеграция, тествате финтех приложение или научавате повече за банковата система на Аржентина, разбирането на валидирането на CBU е от съществено значение. Този инструмент прилага точно същите алгоритми за контролна сума, които използват аржентинските банки, така че можете да хванете форматни грешки преди те да предизвикат неуспех на транзакцията.

Запомнете: форматната валидация е само първата стъпка. Правилно форматираният CBU не гарантира, че сметката съществува или че имате правилния получател. За производствени системи, работещи с реални пари, комбинирайте форматната валидация с допълнителна проверка чрез банкови API или платежни процесори.

Инструментът не изисква регистрация или инсталиране - просто го отворете и започнете да валидирате или генерирате CBU според официалните стандарти на BCRA.