CBU Generator & Validator for Argentina | BCRA Bankkoder

Hva er en argentinsk CBU og hvorfor validere den?

Å arbeide med Argentinas banksystem betyr å forholde seg til CBU (Clave Bancaria Uniforme)—en 22-sifret kode som unikt identifiserer hver bankkonto i landet. Hvis du noen gang har måttet teste en betalingsintegrasjon, verifisere bankdetaljer før en overføring, eller forstå hvorfor en transaksjon mislyktes, vet du hvor kritisk det er å arbeide med riktig formaterte CBUer.

Dette verktøyet hjelper deg med å generere strukturelt gyldige CBUer for testmiljøer og validere eksisterende koder mot det offisielle formatet spesifisert av Argentinas sentralbank (BCRA). Når du bygger finansielle applikasjoner eller behandler betalinger, kan det å oppdage formatfeil tidlig spare timer med feilsøking og forhindre mislykkede transaksjoner.

Forstå CBU-formatet

CBU (Clave Bancaria Uniforme) er Argentinas svar på internasjonale bankidentifikatorer som IBAN eller amerikanske rutingnumre. Se på det som en omfattende pakke som samler bank-, filial- og kontoinformasjon i en enkelt 22-sifret kode. Sentralbanken i Argentina (BCRA) lanserte dette systemet i november 2000 for å standardisere elektroniske overføringer på tvers av landets finansielle nettverk.

CBU-struktur og format

Hver gyldig CBU består av nøyaktig 22 sifre delt inn i to hovedblokker:

Første blokk (8 sifre): Identifiserer finansinstitusjonen og filialen
- Første 3 sifre: Bankkode tildelt av BCRA
- Neste 4 sifre: Filialkode innenfor banken
- Siste siffer: Kontrollsiffer for første blokk
Andre blokk (14 sifre): Identifiserer den spesifikke kontoen
- Første 13 sifre: Kontonummer (kan inkludere kontotype og andre identifikatorer)
- Siste siffer: Kontrollsiffer for andre blokk

Kontrollsifre bruker en vektet modulo-10-algoritme som fanger opp vanlige skrivefeil—som byttet om sifre eller enkeltsiffer—før noen penger flyttes. Denne sikkerhetsmekanismen har vist seg bemerkelsesverdig effektiv: de fleste CBU-inntastingsfeil blir oppdaget på valideringsstadiet i stedet for å resultere i mislykkede overføringer.

Hvordan generere en test-CBU

Generatoren oppretter tilfeldige, men strukturelt gyldige CBUer som passerer alle formatsjekker. Her er hva som skjer bak kulissene:

Tilfeldige sifre fyller bank-koden, filial-koden og kontonummer-seksjonen
Verktøyet beregner begge kontrollsifre ved hjelp av den offisielle BCRA-algoritmen
Du får en riktig formatert 22-sifret CBU klar for testing

Når du vil finne dette nyttig:

Testing av betalingsintegrasjoner: Trenger dusinvis av gyldige CBUer for testsettet ditt? Generer dem umiddelbart uten manuell beregning.
QA og staging-miljøer: Fyll testdatabaser med realistiske bankdata som ikke utilsiktet matcher virkelige kontoer.
Læring av formatet: Se hvordan forskjellige CBUer er strukturert og forstå verifiseringslogikken.
Dokumentasjon og demonstrasjoner: Opprett eksempeldata som ser autentisk ut uten å eksponere virkelig bankinformasjon.

Trinn for trinn: Generere en CBU

Naviger til "Generator"-fanen i verktøyet
Klikk på "Generer CBU"-knappen
En gyldig, tilfeldig 22-sifret CBU vil vises i displayområdet
Bruk "Kopier"-knappen for å kopiere CBUen til utklippstavlen for bruk i dine applikasjoner

Hvordan validere en argentinsk CBU

Validatoren kjører de samme kontrollene som Argentinas banksystemer bruker for å verifisere CBU-integritet. Hva som blir sjekket:

Lengdeverifisering: Bekrefter nøyaktig 22 sifre (en vanlig feil er å kopiere med mellomrom eller bindestreker)
Kun numerisk innhold: Sikrer at ingen bokstaver eller spesialtegn har sneket seg inn
Første blokks sjekksum: Validerer det 8. sifferet mot de første 7 sifrene
Andre blokks sjekksum: Validerer det 22. sifferet mot sifrene 9-21

Når validering mislykkes, vil du se hvilken spesifikk kontroll som ikke bestod. Dette er spesielt nyttig når du feilsøker hvorfor en bank-API avviste en CBU—ofte er det noe enkelt som et ekstra mellomrom eller byttet siffer.

Trinn for trinn: Validere en CBU

Naviger til "Validator"-fanen i verktøyet
Skriv inn den 22-sifrede CBU-en du vil validere
Klikk på "Valider CBU"-knappen
Gjennomgå valideringsresultatet:
- Grønn indikator for gyldige CBU-er
- Rød indikator med spesifikke feilmeldinger for ugyldige CBU-er

CBU-verifiseringsalgoritmen forklart

BCRA bruker en vektet modulo-10 sjekksum-algoritme for å beregne verifiseringssiffer. Hvis du implementerer CBU-validering i applikasjonen din, her er den nøyaktige logikken:

Første blokks verifisering

For den første blokken (første 8 siffer), beregnes verifiseringsssifferet som følger:

Ta de første 7 sifrene i CBU
Multipliser hvert siffer med sin tilsvarende vekt: [7, 1, 3, 9, 7, 1, 3]
Summer de resulterende produktene
Beregn: 10 - (sum % 10)
Hvis resultatet er 10, er verifiseringsssifferet 0; ellers er det den beregnede verdien

Andre blokks verifisering

For den andre blokken (siste 14 siffer), beregnes verifiseringsssifferet som følger:

Ta de første 13 sifrene i den andre blokken
Multipliser hvert siffer med sin tilsvarende vekt: [3, 9, 7, 1, 3, 9, 7, 1, 3, 9, 7, 1, 3]
Summer de resulterende produktene
Beregn: 10 - (sum % 10)
Hvis resultatet er 10, er verifiseringsssifferet 0; ellers er det den beregnede verdien

CBU Validerings Kodeeksempler

Her er hvordan du implementerer CBU-validering i din applikasjon. Disse eksemplene følger den offisielle BCRA-spesifikasjonen og vil fungere med produksjons bankdata:

1// JavaScript: Beregn CBU kontrollsifre
2function calculateCheckDigit(number, weights) {
3  if (number.length !== weights.length) {
4    throw new Error('Nummerlengde må samsvare med vektlengde');
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// Valider første blokk av 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: Valider en komplett CBU
2import re
3
4def validate_cbu(cbu):
5    # Sjekk grunnleggende format
6    if not cbu or not re.match(r'^\d{22}$', cbu):
7        return {
8            'isValid': False,
9            'errors': ['CBU må være 22 sifre']
10        }
11    
12    # Del opp i blokker
13    first_block = cbu[:8]
14    second_block = cbu[8:]
15    
16    # Valider hver blokk
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('Første blokk (bank/filial kode) er ugyldig')
23    if not second_block_valid:
24        errors.append('Andre blokk (kontonummer) er ugyldig')
25    
26    return {
27        'isValid': first_block_valid and second_block_valid,
28        'errors': errors
29    }
30

1// Java: Generer en tilfeldig gyldig CBU
2import java.util.Random;
3
4public class CBUGenerator {
5    private static final Random random = new Random();
6    
7    public static String generateCBU() {
8        // Generer første 7 sifre (bank og filial kode)
9        StringBuilder firstBlockBase = new StringBuilder();
10        for (int i = 0; i < 7; i++) {
11            firstBlockBase.append(random.nextInt(10));
12        }
13        
14        // Beregn kontrollsifre for første blokk
15        int[] firstBlockWeights = {7, 1, 3, 9, 7, 1, 3};
16        int firstBlockCheckDigit = calculateCheckDigit(
17            firstBlockBase.toString(), 
18            firstBlockWeights
19        );
20        
21        // Generer første 13 sifre av andre blokk
22        StringBuilder secondBlockBase = new StringBuilder();
23        for (int i = 0; i < 13; i++) {
24            secondBlockBase.append(random.nextInt(10));
25        }
26        
27        // Beregn kontrollsifre for andre blokk
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        // Kombiner alle deler
35        return firstBlockBase.toString() + firstBlockCheckDigit + 
36               secondBlockBase.toString() + secondBlockCheckDigit;
37    }
38    
39    // Implementasjon av calculateCheckDigit metode...
40}
41

1// PHP: Formater en CBU for visning
2function formatCBU($cbu) {
3    if (!$cbu || strlen($cbu) !== 22) {
4        return $cbu;
5    }
6    
7    // Formater som: XXXXXXXX XXXXXXXXXXXXXX
8    return substr($cbu, 0, 8) . ' ' . substr($cbu, 8);
9}
10
11// Brukseksempel
12$cbu = '0123456789012345678901';
13echo formatCBU($cbu); // Viser: 01234567 89012345678901
14

1' Excel VBA: Valider en CBU
2Function ValidateCBU(cbu As String) As Boolean
3    ' Sjekk lengde
4    If Len(cbu) <> 22 Then
5        ValidateCBU = False
6        Exit Function
7    End If
8    
9    ' Sjekk om alle tegn er sifre
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    ' Trekk ut blokker
19    Dim firstBlock As String
20    Dim secondBlock As String
21    firstBlock = Left(cbu, 8)
22    secondBlock = Right(cbu, 14)
23    
24    ' Valider begge blokker
25    ValidateCBU = ValidateFirstBlock(firstBlock) And ValidateSecondBlock(secondBlock)
26End Function
27

Reelle brukstilfeller for CBU-validering

Testing av betalingsintegrasjoner

Når du bygger fintech-applikasjoner eller e-handelplattformer som behandler argentinske betalinger, trenger du gyldige CBUer for testmiljøet ditt. Et vanlig scenario: ditt staging-miljø krever 50 testkontoer med gyldige CBUer for belastningstesting. Manuell beregning av kontrollsifre for hver ville ta timer. Generatoren håndterer dette på sekunder, og gir deg riktig formaterte testdata som oppfører seg som produksjons-CBUer uten risikoen for utilsiktet bruk av virkelige kontonumre.

Pro-tips: Behold et sett med genererte CBUer i testfixturene dine. Dette sikrer konsistente testdata på tvers av teamet og gjør feilsøking enklere når tester feiler.

Forhindre transaksjonfeil

Her er hva som typisk skjer: en klient oppgir sin CBU for en bankoverføring, men har utilsiktet inkludert mellomrom eller byttet om to sifre. Hvis du behandler overføringen uten validering, avviser banken den - men først etter en forsinkelse, og du har allerede registrert transaksjonsintensjon i systemet ditt. Nå må du håndtere avstemmingsproblemer.

Validering av CBU-formatet før innsending fanger disse feilene umiddelbart. Validatoren vil ikke fortelle deg om kontoen eksisterer eller tilhører riktig person (det krever tilgang til bank-API), men den vil bekrefte at strukturen er korrekt i henhold til BCRA-standarder.

Forstå krav til bankintegrasjon

For utviklere som er nye i det argentinske finanssystemet, gir dette verktøyet praktisk læring. Du kan se nøyaktig hvordan kontrollsifre fungerer, forstå hvorfor visse nummer er ugyldige, og eksperimentere med grensetilfeller før du skriver produksjonskode.

Vanlig feil: Anta at CBU-validering er det samme som IBAN-validering. Selv om begge bruker kontrollsifre, er algoritmene helt forskjellige. Testing med dette verktøyet hjelper deg med å forstå de spesifikke kravene til argentinske bankkoder.

Skjemavalidering i bank-brukergrensesnitt

Når du designer inndataskjemaer som aksepterer CBUer, må du teste hvordan systemet håndterer ulike feilstilstander. Hva skjer når en bruker limer inn en CBU med mellomrom? Hvilken feilmelding vises når kontrollsifferet er feil? Dette verktøyet hjelper deg med å teste disse scenarioene og designe bedre brukertilbakemelding.

Relaterte bankvalideringsverktøy

Avhengig av dine behov, kan du også trenge disse komplementære verktøyene:

CUIT/CUIL-validator: Validerer argentinske skatteidentifikasjonsnumre—essensielt når du trenger både bank- og skatte-ID-verifisering
CVU-validator: Lik CBU, men for digitale lommebøker (Mercado Pago, Ualá, etc.) som bruker samme 22-sifrede format
IBAN-validator: For grenseoverskridende betalinger som involverer europeiske eller andre internasjonale kontoer
Bank-API-tjenester: For produksjonssystemer som trenger å verifisere kontoinnehav og saldosjekk, ikke bare formatvalidering

Viktig begrensning: Dette verktøyet validerer kun format og kontrollsifre. Det kan ikke bekrefte hvorvidt en CBU tilsvarer en aktiv bankkonto eller verifisere kontoinnehaverens identitet. For slike sjekker trenger du integrasjon med Argentinas bank-APIer eller betalingsformidlere.

Hvordan Argentinas Banksystem Tok i Bruk CBU

Før november 2000 var det overraskende komplisert å sende penger mellom argentinske banker. Hver finansinstitusjon brukte sitt eget kontonummersystem—noen med 10 sifre, andre med 15, og ingen standardisert måte å identifisere hvilken bank eller filial som hadde kontoen. Interbankoverføringer krevde manuell verifisering og tok ofte dagevis å behandle.

BCRA introduserte CBU for å løse denne fragmenteringen. Ved å påby et enkelt 22-sifret format på tvers av alle finansinstitusjoner, tilpasset Argentina seg internasjonale standarder som Europas IBAN-system. De innebygde kontrollsifrene var særlig smarte: de fanger de fleste dataregistreringsfeil automatisk, noe som reduserer mislykkede overføringer og de tilhørende kostnadene ved å undersøke og reversere transaksjoner.

Det interessante er: CBU-formatet har knapt endret seg på over 20 år. Mens banknteknologien har utviklet seg dramatisk—mobilapper, øyeblikkelige overføringer, digitale lommebøker—har den underliggende CBU-strukturen forbli den samme. Denne stabiliteten forteller hvor godt den opprinnelige designen forutså fremtidige behov.

I dag bruker argentinere CBUer for praktisk talt alle elektroniske finansielle transaksjoner: lønnsinnskudd, regningsbetalinger, skattemeldinger, statlige ytelser og e-handel. Formatet har vist seg så effektivt at da digitale lommebøker dukket opp (som Mercado Pago), tok regulatorene i bruk samme struktur for CVUer (Clave Virtual Uniforme) i stedet for å finne opp noe nytt.

Ofte stilte spørsmål

Hva er forskjellen mellom en CBU og en CVU?

CBUer identifiserer tradisjonelle bankkontoer, mens CVUer (Clave Virtual Uniforme) identifiserer digitale lommebokkontoer fra fintech-leverandører som Mercado Pago, Ualá eller Brubank. Formatet er identisk—22 sifre med samme valideringsalgoritme—noe som gir mening fordi de er interoperable. Du kan overføre penger fra en CBU til en CVU og omvendt akkurat som enhver annen bankoverføring. De første tre sifrene avslører om du ser på en tradisjonell bank eller en digital lommebokaktør.

Kan jeg finne ut banknavnet fra en CBU?

Ja. De første tre sifrene er bankidentifikatoren tildelt av BCRA. For eksempel starter koder med "011" hos Banco Nación, mens "017" indikerer BBVA Argentina. BCRA publiserer et offisielt register over disse kodene, som bankapplikasjoner vanligvis refererer til for automatisk å vise banknavnet når du legger inn en CBU.

Er en CBU det samme som et kontonummer?

Ikke helt. Ditt kontonummer er gjemt inne i CBUen, men CBUen pakker det med ytterligere rutingsinformasjon. Tenk på det som forskjellen mellom en gateadresse og GPS-koordinater—begge identifiserer en lokasjon, men én inkluderer mer kontekst. CBUen samler din bankkode, filialkode, kontonummer og to kontrollsifre i en enkelt overførbar streng.

Hvor trygt er det å dele min CBU?

Din CBU er designet for å deles—det er hele poenget. Mottakere trenger den for å sette inn penger på kontoen din. I motsetning til passord eller PIN-koder tillater en CBU kun innkommende overføringer, ikke uttak. Behandle den likevel som enhver finansiell informasjon: del den med folk eller selskaper du stoler på, og vær forsiktig med å legge den ut offentlig på nettet. Noen foretrekker å gi ut sin CBU selektivt fremfor å publisere den åpent.

Kan en CBU utløpe eller endre seg?

Din CBU blir med deg så lenge kontoen er åpen. Den eneste gangen den endres er hvis du stenger den kontoen og åpner en ny, eller i sjeldne tilfeller når banker slår seg sammen eller omstrukturerer sine nummeringssystemer. Selv da opprettholder banker vanligvis den gamle CBUen i en overgangsperiode for å unngå å forstyrre gjentakende betalinger.

Hvordan finner jeg min egen CBU?

Sjekk bankens mobilapp—den er vanligvis i kontodetalj-seksjonen. De fleste argentinske banker viser den også tydelig i nettbank, skriver den ut på månedlige kontoutskrifter, og noen inkluderer den til og med på baksiden av bankkort. Hvis du ikke kan finne den, kan enhver bankrepresentant umiddelbart oppgi den; den regnes ikke som sensitiv informasjon som en PIN-kode.

Kan utenlandske statsborgere ha en CBU i Argentina?

Ja. Det å åpne en bankkonto i Argentina som utenlandsk statsborger gir deg en CBU akkurat som enhver annen kontohaver. Kravene varierer etter institusjon—noen banker krever kun pass, mens andre ber om bostedsbevis eller en CDI (skatte-identifikasjonsnummer). Digitale lommebøker (CVU) er ofte enklere for utenlandske statsborgere å få tilgang til enn tradisjonelle bankkontoer.

Hva skjer hvis jeg foretar en overføring til en ugyldig CBU?

Moderne banksystemer utfører formatvalidering før overføringen sendes. Hvis kontrollsifrene ikke matcher eller lengden er feil, får du en umiddelbar feil—overføringen forlater aldri kontoen din. Dette er hvorfor frontvalidering er så verdifull; den fanger opp skrivefeil før de forårsaker problemer.

Den vanskeligere situasjonen er når en CBU passerer formatvalidering, men ikke matcher en aktiv konto. Overføringen sendes til interbanknettet og returneres timer eller dager senere. Du har allerede registrert den som "sendt" i regnskapet ditt, og nå må du avstemme returneringen. Dette er hvorfor noen applikasjoner også sjekker CBUer mot bankdatabaser før de tillater overføringer, selv om det krever betalt API-tilgang.

Kan jeg ha flere CBUer?

Absolutt. Hver konto genererer sin egen CBU. Hvis du har en brukskonto og en sparekonto i samme bank, vil du ha to distinkte CBUer. Forskjellige kontoer i forskjellige banker? Flere CBUer. Hver enkelt unikt identifiserer en spesifikk konto på en spesifikk filial ved en spesifikk institusjon.

Brukes CBU-systemet utenfor Argentina?

Nei, CBUer er spesifikke for Argentina. Hvert land har sitt eget system: Europa bruker IBAN, USA bruker rutingnumre pluss kontonumre, Australia bruker BSB-koder, og så videre. Ved internasjonale pengeoverføringer trenger du vanligvis mottakerens SWIFT-kode pluss deres lokale kontoidentifikator—som i Argentinas tilfelle ville være CBUen.

Referanser og offisiell dokumentasjon

For autoritative informasjon om Argentinas bankstandarder:

Argentinas Sentralbank (BCRA) - Finansielle systemforskrifter - Offisiell BCRA-dokumentasjon om betalingssystemstandarder og bankforskrifter
Lov nr. 25,345 - "Forebygging av skatteunndragelse og modernisering av betalinger" (november 2000) - Lovgivningen som etablerte Argentinas elektroniske betalingssystemrammeverk
BCRA Kommunikasjon "A" Serie - Tekniske rundskriv som definerer CBU-implementeringskrav for finansinstitusjoner
Interbanking S.A. - Organisasjonen som driver Argentinas interbankelektroniske betalingsnettverk og vedlikeholder CBU-rutingtabeller

Disse kildene gir de tekniske spesifikasjonene som brukes til å implementere denne validatoren og oppdateres jevnlig av argentinske finansmyndigheter.

Klar til å validere eller generere CBUer?

Enten du bygger en betalingsintegrasjon, tester en fintech-applikasjon eller lærer om det argentinske banksystemet, er det avgjørende å forstå CBU-validering. Dette verktøyet implementerer de nøyaktig samme kontrollsummalgoritmene som argentinske banker bruker, slik at du kan oppdage formatfeil før de forårsaker transaksjonssvikt.

Husk: formatvalidering er bare det første trinnet. En riktig formatert CBU garanterer ikke at kontoen eksisterer eller at du har rett mottaker. For produksjonssystemer som håndterer ekte penger, kombiner formatvalidering med ytterligere verifisering gjennom bank-APIer eller betalingsformidlere.

Verktøyet krever ingen registrering eller installasjon—bare åpne det og begynn å validere eller generere CBUer i henhold til offisielle BCRA-standarder.