CUIT/CUIL ģenerators un validators | Argentīnas nodokļu ID rīks

Argentīnas CUIT/CUIL ģenerators un validātors

Ievads

Argentīnas nodokļu un darba sistēmās jūs pastāvīgi saskarsieties ar diviem kritiskiem identifikatoriem: CUIT (Clave Única de Identificación Tributaria) un CUIL (Clave Única de Identificación Laboral). Uztveriet CUIT kā nodokļu ID uzņēmumiem un personām, kas maksā nodokļus, savukārt CUIL identificē darbiniekus sociālās drošības sistēmā. Abiem ir vienāds 11 ciparu formāts un pārbaudes algoritms, kas padara īpaši svarīgu testu lietojumprogrammu izstrādi, kas apstrādā šos numurus.

Izstrādājot programmatūru Argentīnas tirgum, jums ir nepieciešami derīgi testa dati. Tieši šeit noderēs šis rīks. Jūs varat ģenerēt matemātiski pareizus CUIT/CUIL numurus testēšanai, neizmantojot īstas personas informāciju, vai pārbaudīt esošos numurus, lai nodrošinātu to atbilstību AFIP oficiālajam algoritmam. Īpaši noderīgi ir tas, ka rīks nodarbojas gan ar ģenerēšanas pusi (pēc pieprasījuma izveidojot derīgus numurus), gan ar pārbaudes pusi (konstatot formāta kļūdas, nederīgus tips kodus un nepareizus pārbaudes ciparus pirms to izraisītajām problēmām ražošanā).

CUIT/CUIL struktūra un aprēķins

Formāta izpratne

Derīgs CUIT/CUIL numurs sastāv no 11 cipariem, kas parasti tiek attēlots formātā XX-XXXXXXXX-X. Tā tas sadalās:

1. Tipa kods (pirmie 2 cipari): Identificē subjekta tipu

   • 20, 23, 24: Vīriešu personas (CUIL)
   • 27: Sieviešu personas (CUIL)
   • 30, 33, 34: Uzņēmumi un organizācijas (CUIT)

2. DNI numurs (vidējie 8 cipari): Personām tas ir viņu valsts identifikācijas dokumenta numurs (DNI). Izplatīta kļūda: ja faktiskais DNI ir ar mazāk nekā 8 cipariem, tas jāaizpilda ar nullēm priekšā. Piemēram, DNI 1234567 kļūst par 01234567 CUIT/CUIL. Uzņēmumi saņem īpašu piešķirtu numuru.

3. Pārbaudes cipars (pēdējais cipars): Šis pārbaudes cipars validē visu numuru, izmantojot svērto algoritmu. Ja šis cipars nesaskan ar aprēķinu, viss CUIT/CUIL ir nederīgs - kas bieži pārsteidz izstrādātājus, kad viņi manuāli veido testa datus.

Pārbaudes cipara aprēķins

Pārbaudes cipars izmanto modulo-11 svērto algoritmu. Tā tas darbojas:

1. Ņemiet pirmos 10 CUIT/CUIL ciparus (tipa kods + DNI)
2. Reiziniet katru ciparu ar tā atbilstošo svaru: 5, 4, 3, 2, 7, 6, 5, 4, 3, 2
3. Summējiet visus reizinājumus
4. Aprēķiniet: 11 mīnus (summa modulo 11)
5. Apstrādājiet īpašos gadījumus: ja rezultāts ir 11, izmantojiet 0; ja tas ir 10, izmantojiet 9

Visbiežāk cilvēkus apjūk 5. soļa īpašie gadījumi. Testējot, jūs reizēm iegūsiet rezultātu 10 vai 11, un aizmirstot kartēt šos uz 9 un 0 attiecīgi, izraisa validācijas kļūmes, kas var būt grūti atrodamas, ja neesat informēts par šo noteikumu.

Matemātiski tas var tikt izteikts kā:

$VD = 11 - ((\sum_{i=1}^{10} d_i \times w_i) \bmod 11)$

Kur:

• $VD$ ir pārbaudes cipars
• $d_i$ ir $i$-tais cipars no pirmajiem 10 cipariem
• $w_i$ ir atbilstošais svars no virknes [5, 4, 3, 2, 7, 6, 5, 4, 3, 2]
• Īpašie gadījumi: ja $VD = 11$ tad $VD = 0$, ja $VD = 10$ tad $VD = 9$

Pakāpenisks Ceļvedis

Ģeneratora Izmantošana

1. Atlasiet "Ģeneratora" cilni rīka saskarnē augšpusē.

2. Izvēlieties Tipa Kodu no nolaižamās izvēlnes:

   • 20: Vīrietis (CUIL)
   • 23: Uzņēmums (CUIT)
   • 24: Pagaidu Uzņēmums (CUIT)
   • 27: Sieviete (CUIL)
   • 30: Korporācija (CUIT)
   • 33: Pilsoniska Asociācija (CUIT)
   • 34: Fonds (CUIT)

3. Ievadiet DNI Numuru (nav obligāti):

   • Ievadiet 8 ciparu DNI numuru norādītajā laukā
   • Ja atstāts tukšs, rīks izmantos nejauši ģenerētu DNI
   • Ja ievadāt mazāk par 8 cipariem, sistēma papildinās ar vadošajiem nulles cipariem

4. Ģenerēt Nejaušu DNI (nav obligāti):

   • Noklikšķiniet uz pogas "Nejaušs", lai ģenerētu nejaušu 8 ciparu DNI numuru

5. Skatīt Ģenerēto CUIT/CUIL:

   • Rīks automātiski parāda derīgu CUIT/CUIL, pamatojoties uz jūsu ievadi
   • Formāts būs XX-XXXXXXXX-X ar pareizo pārbaudes ciparu

6. Kopēt Rezultātu:

   • Noklikšķiniet uz kopēšanas ikonas, lai kopētu ģenerēto CUIT/CUIL starpliktuvē
   • Parādīsies apstiprinājuma ziņojums pēc veiksmīgas kopēšanas

Validatora Izmantošana

1. Atlasiet "Validatora" cilni rīka saskarnē augšpusē.

2. Ievadiet Validējamo CUIT/CUIL:

   • Ievadiet CUIT/CUIL formātā XX-XXXXXXXX-X
   • Rīks automātiski formatēs jūsu ievadi ar defisēm, rakstot
   • Varat arī ievadīt numuru bez defisēm (XXXXXXXXXXX)

3. Noklikšķiniet uz pogas "Validēt":

   • Rīks pārbaudīs formātu, tipa kodu un pārbaudes ciparu

4. Skatīt Validācijas Rezultātu:

   • Derīgiem CUIT/CUIL numuriem parādīsies zaļš veiksmes ziņojums
   • Nederīgiem numuriem parādīsies sarkans kļūdas ziņojums ar skaidrojumu:
     • Nederīgs formāts (jābūt XX-XXXXXXXX-X)
     • Nederīgs tipa kods (jābūt vienam no: 20, 23, 24, 27, 30, 33, 34)
     • Nederīgs pārbaudes cipars

5. Papildu Informācija:

   • Derīgiem numuriem rīks parāda komponentu sadalījumu:
     • Tipa kods un tā nozīme
     • DNI numurs
     • Pārbaudes cipars

Izplatītākās kļūdas un labākās prakses

Strādājot ar CUIT/CUIL validāciju savās lietojumprogrammās, uzmanieties no šīm bieži sastopamajām lamatām:

Nulles pildīšanas problēmas: Visizplatītākā kļūda, ko esmu sastapis, ir DNI numuri ar vadošajām nullēm. Kad kāds ievada DNI "1234567", jūsu kodam tas jāapstrādā kā "01234567" CUIT/CUIL konstruēšanai. Daudzas realizācijas konvertē uz veseliem skaitļiem apstrādei, kas noņem vadošās nulles. Tā vietā izmantojiet virkņu operācijas ar pareizu pildīšanu.

Tipa koda sajaukšana: Ne visi divciparu skaitļi ir derīgi tipa kodi. Darbojas tikai 20, 23, 24, 27, 30, 33, 34. Esmu redzējis sistēmas, kas pieņem jebkuru divciparu prefiksu, izraisot "derīgi izskatāmus" numurus kā 21-12345678-X, kas neizdodas AFIP validācijā. Vienmēr validējiet tipa kodu pirms verificēšanas cipara aprēķināšanas.

Dzimuma pieņēmumi: Tipa kodi 20 (vīrietis) un 27 (sieviete) nav savstarpēji aizstājami. Ja automātiski ģenerējat CUIL, pamatojoties uz demogrāfiskajiem datiem, nodrošiniet, ka jūsu tipa kods atbilst faktiskajai dzimumei, kas reģistrēta RENAPER (Argentīnas valsts reģistrā). Neatbilstības izraisa noraidīšanu, kad indivīdi mēģina izmantot šos numurus valdības pakalpojumos.

Defišu apstrāde: Dažas realizācijas prasa defises, kamēr citas tās noraida. Labākā prakse: pieņemiet abas formāta versijas ievades laukos (ar vai bez defisēm), noņemiet defises pirms validācijas, saglabājiet bez defisēm datubāzēs un pievienojiet defises tikai attēlošanas nolūkos.

Trūkstošā verifikācija: Algoritma validācija uztver formāta kļūdas, bet neapstiprina, ka CUIT/CUIL ir reģistrēts. Ražošanā vispirms validējiet formātu (ātri), tad pārbaudiet pret AFIP datubāzi (lēnāk, bet autoritatīvi). Šis divu posmu pieeja uzreiz noķer drukas kļūdas, vienlaikus nodrošinot, ka numurs ir īsts.

Robežgadījumu testēšana: Vienmēr testējiet ar verificēšanas cipariem 0 un 9 - tie rodas no īpašajiem gadījumiem algoritmā. Testējiet arī DNI, kas sākas ar nullēm, lai nodrošinātu, ka jūsu pildīšanas loģika darbojas pareizi.

Lietojuma gadījumi un praktiskie pielietojumi

Izstrāde un testēšana

Programmatūras izstrāde: Veidojot lietojumprogrammas Argentīnas tirgum, jums būs nepieciešami testa dati, kas iztur validāciju bez reālu lietotāju informācijas izmantošanas. Šeit ir kritiskas situācijas:

• E-komercijas platformas: Maksājumu apstrādātāji un rēķinu sistēmas prasa derīgus CUIT/CUIL numurus. Slodzes testēšanas laikā jums var būt nepieciešami tūkstošiem derīgu numuru, lai simulētu reālistiskas lietotāju reģistrācijas.
• Grāmatvedības programmatūra: Nodokļu pārskatu moduļi pārbauda CUIT/CUIL formātu pirms iesniegšanas AFIP. Šo validācijas noteikumu testēšanai ir nepieciešami numuri, kas iztur kontrolskaitļa algoritmu.
• Cilvēkresursu pārvaldības sistēmas: Algu aprēķins un sociālās apdrošināšanas iemaksas ir atkarīgas no derīgiem CUIL numuriem. Tipiska situācija: jūs testējat darbinieku reģistrācijas plūsmu un nepieciešams pārbaudīt, vai nederīgi CUIL numuri izraisa atbilstošus kļūdu paziņojumus.
• Banku lietojumprogrammas: KYC (Klienta pazīšanas) procesi validē CUIT/CUIL kā daļu no konta atvēršanas. Manā pieredzē, malas gadījumi, piemēram, tipa koda neatbilstības, bieži parādās integrācijas testēšanas laikā.

Datu bāzes piepildīšana: Aizpildot testa datu bāzes, izmantojot algoritmiski derīgus CUIT/CUIL numurus, tiek nodrošināts, ka jūsu datu bāzes ierobežojumi un trigeri darbojas kā paredzēts. Tas ir īpaši svarīgi, testējot datu migrācijas skriptus vai ETL procesus, kas validē identifikācijas numurus.

Formu validācijas testēšana: Testējiet gan veiksmīgo scenāriju, gan kļūdu nosacījumus. Ģenerējiet derīgus numurus, lai apstiprinātu veiksmīgu iesniegšanu, pēc tam modificējiet verificēšanas ciparu, lai nodrošinātu, ka jūsu priekšpuses un aizmugures validācija uztver kļūdu pirms tā sasniedz jūsu datu bāzi.

API testēšana: Integrācijas testiem jāizmanto derīgi CUIT/CUIL numuri pieprasījumu datos. Tas novērš nepatiesus negatīvus rezultātus, kur testi neizdodas nevis API loģikas kļūdu dēļ, bet gan nederīgu testa datu dēļ.

QA automatizācija: Parametrizētie testi gūst labumu no dinamiskās CUIT/CUIL ģenerēšanas. Tā vietā, lai cieti kodētu testa vērtības, kas var konfliktēt starp testa palaišanām, katrā testa izpildē ģenerējiet jaunus derīgus numurus.

Izglītojošie mērķi

Validācijas algoritmu apgūšana: CUIT/CUIL verificēšanas algoritms demonstrē praktisko modulo aritmētikas un svērto kontrolskaitļu pielietojumu. Šis pats modelis parādās citos identifikācijas sistēmās visā pasaulē — kredītkaršu numuri (Luhn algoritms), ISBN kodi un Eiropas PVN numuri visi izmanto līdzīgus svērtos kontrolsummas paņēmienus. Izprotot, kā darbojas CUIT/CUIL validācija, sniedz ieskatu, kāpēc šie algoritmi pastāv: tie uztver pārrakstīšanas kļūdas, piemēram, samainītus ciparus vai viencipara kļūdas.

Datu validācijas mācīšana: Apmācot jaunos izstrādātājus par ievades validāciju, CUIT/CUIL sistēma piedāvā reālu piemēru, kas ir sarežģītāks par e-pasta validāciju, bet vienkāršāks par kriptografisko verificēšanu. Tas demonstrē dziļās aizsardzības principu: formāta validācija (11 cipari), biznesa noteikumu validācija (derīgi tipa kodi) un algoritmiska validācija (kontrolskaitlis).

Starptautiskā biznesa attīstība: Ja veidojat sistēmas Latīņamerikas tirgiem, CUIT/CUIL izpratne palīdz saprast līdzīgas sistēmas kaimiņvalstīs. Brazīlijai ir CPF/CNPJ, Čīlei — RUT, Urugvajai — RUT — visi izmanto kontrolskaitļa algoritmus. Šeit apgūtās likumsakarības ir pārvietojamas uz šīm sistēmām.

Alternatīvas un ražošanas apsvērumi

Lai gan šis rīks labi darbojas izstrādes un testēšanas laikā, ražošanas vidēm ir atšķirīgas prasības:

Oficiāla valdības validācija: Dzīvās lietojumprogrammās algoritmiskā validācija vien nav pietiekama — jums jāpārbauda, vai CUIT/CUIL ir reāli reģistrēts AFIP (Administración Federal de Ingresos Públicos). AFIP nodrošina tīmekļa pakalpojumus reāllaika validācijai, lai gan jums būs jāreģistrējas un jāautentificējas, lai piekļūtu tiem. Īpatnība: numurs var būt matemātiski derīgs, bet nav oficiāli piešķirts, tāpēc ražošanā vienmēr īstenojiet abas validācijas pakāpes.

Bibliotēkas un pakotnes: Ja integrējat CUIT/CUIL validāciju savā kodā, apsveriet šīs izveidotās bibliotēkas, nevis veidojiet savu:

• JavaScript: validar-cuit npm validē un formatē
• PHP: afip-php bibliotēka nodrošina gan validāciju, gan AFIP tīmekļa pakalpojumu integrāciju
• Python: py-cuit PyPI realizē pilnu algoritmu

Izmantojot uzturētas bibliotēkas, tiek samazināts ieviešanas kļūdu risks un bieži ietvertas malas situācijas, kuras varētu palaist garām pielāgotā kodā.

Manuāla aprēķināšana: Mācīšanās nolūkos vai atkļūdošanai, algoritma izstrāde ar roku palīdz nostiprināt izpratni. Paņemiet kalkulatoru un paraugu CUIT/CUIL, tad soli pa solim sekojiet svērtās reizināšanas procesam.

Uzņēmumu validācijas pakalpojumi: Lielizmēra lietojumprogrammām var būt noderīgi trešās puses validācijas API, kas ne tikai pārbauda formātu, bet arī šķērso atsauces ar komerciālām datubāzēm. Šie pakalpojumi var atzīmēt neaktīvus uzņēmumus, identificēt sankcionētās vienības vai sniegt papildu metadatus par CUIT/CUIL īpašnieku.

CUIT/CUIL sistēmas vēsture

CUIT/CUIL identifikācijas sistēma Argentīnā ir būtiski attīstījusies kopš tās izveides:

Izcelsme un ieviešana

CUIT (Clave Única de Identificación Tributaria) pirmo reizi tika ieviests Argentīnā 1970-tajos gados kā daļa no centieniem modernizēt nodokļu iekasēšanas sistēmu. Valsts ieņēmumu dienests (AFIP) ieviesa šo unikālo identifikatoru, lai efektīvāk izsekotu nodokļu maksātājiem un samazinātu nodokļu apiešanu.

CUIL (Clave Única de Identificación Laboral) vēlāk tika ieviests, lai īpaši identificētu darbiniekus sociālās drošības sistēmā, radot atšķirību starp nodokļu identifikāciju un darba identifikāciju, vienlaikus saglabājot konsekventu formātu.

Attīstība un digitalizācija

1990-tajos gados, kad Argentīna piedzīvoja nozīmīgas ekonomiskās reformas, CUIT/CUIL sistēma kļuva arvien svarīgāka ekonomiskās aktivitātes izsekošanā. Sistēma tika vairāk digitalizēta, un tika ieviesti tiešsaistes pārbaudes mehānismi.

Agrīnie 2000-tie gadi raksturojās ar CUIT/CUIL sistēmas integrāciju dažādos digitālajos valdības pakalpojumos, padarot to par būtisku Argentīnas e-pārvaldes iniciatīvu sastāvdaļu. Šajā periodā arī tika standartizēts pārbaudes algoritms un formāts, kas tiek izmantots vēl šodien.

Jaunākās attīstības tendences

Pēdējos gados AFIP ir uzlabojusi CUIT/CUIL numuru drošības un pārbaudes procesus, ieviešot vairāk izstrādātās validācijas sistēmas un integrējot tās ar citām valdības datu bāzēm. Sistēmai tagad ir izšķiroša nozīme Argentīnas centienos apkarot nodokļu apiešanu un formalizēt ekonomiku.

Šodien CUIT/CUIL tiek izmantots ne tikai nodokļu un nodarbinātības mērķiem, bet arī plašā darbību spektrā, tostarp banku pakalpojumos, īpašumu darījumos, komunālajos pakalpojumos un tiešsaistes pirkumos, padarot to par būtisku identifikatoru gan fiziskām, gan juridiskām personām, kas darbojas Argentīnā.

Ieviešanas apsvērumi

Ieviešot CUIT/CUIL validāciju savās sistēmās, ņemiet vērā šos tehniskos aspektus:

Algoritma stabilitāte: Pašreizējais CUIT/CUIL verificēšanas algoritms kopš tā standartizācijas 1990. gados nav mainījies. Saskaņā ar AFIP tehnisko dokumentāciju, modulo-11 svērtā kontrolcipara pieeja ir kodificēta Rezolūcijā General 2854/2010 un turpmākos noteikumos. Šī stabilitāte nozīmē, ka ieviešanām reti vajadzīgi atjauninājumi, tomēr jums vajadzētu sekot līdzi AFIP paziņojumiem par jebkādām regulatīvām izmaiņām.

Veiktspējas optimizācija: Verificēšanas algoritms ir skaitļošanas ziņā lēts — tikai 10 reizinājumi, viena saskaitīšana un viena modulo operācija. Augstas caurlaidspējas sistēmās, kas apstrādā tūkstošiem validāciju sekundē, šaurā vieta parasti ir tīkla latentums, veicot pārbaudi pret AFIP datubāzi, nevis pats algoritms. Apsveriet AFIP verificēšanas rezultātu kešošanu ar atbilstošiem TTL (parasti 24 stundas), lai līdzsvarotu svaigumu ar veiktspēju.

Rakstzīmju kodējums: Apstrādājot CUIT/CUIL datus no ārējiem avotiem (PDF, skenētiem dokumentiem, tīmekļa skrāpēšanas), uzmaniet rakstzīmju kodējuma problēmas. Defise var parādīties kā em dash (U+2014), en dash (U+2013) vai mīnus zīme (U+2212) nevis standarta defise-mīnus (U+002D). Normalizējiet šos pirms validācijas, lai novērstu nepamatotus noraidījumus.

Internacionalizācija: Ja jūsu lietojumprogramma apkalpo vairākus Latīņamerikas tirgus, ņemiet vērā, ka Argentīnas CUIT/CUIL izmanto modulo-11 ar specifiskiem svariem, kamēr Čīles RUT izmanto modulo-11 ar citādiem svariem, un Brazīlijas CPF/CNPJ izmanto modulo-11 ar vēl citu modeli. Nepieņemiet, ka algoritmi ir identiski — katras valsts sistēmai ir atšķirīgi noteikumi. Plašākai izpratnei par kontrolciparu algoritmiem skatiet ISO/IEC 7064 standartu, kas formalizē dažādas modulo-bāzētas verificēšanas shēmas.

Datubāzes glabāšana: Glabājiet CUIT/CUIL numurus bez defisēm kā fiksēta garuma CHAR(11) vai kā BIGINT, ja jūsu datubāze atbalsta 11 ciparu veselus skaitļus bez precizitātes zuduma. Pievienojiet pārbaudes ierobežojumu, kas validē verificēšanas ciparu datubāzes līmenī kā drošības tīklu pret bojātiem datiem. Izveidojiet indeksus šajā laukā efektīvai meklēšanai, kad lietotāji meklē pēc CUIT/CUIL.

Kodu piemēri

Python

JavaScript

Java

PHP

<?php

function calculateVerificationDigit($typeCode, $dni) {
    // Pārvērst par virkni un nodrošināt, ka DNI ir 8 cipari ar vadošām nullēm
    $typeCodeStr = (string)$typeCode;
    $dniStr = str_pad((string)$dni, 8, '0', STR_PAD_LEFT);
    
    // Apvienot tips kodu un DNI
    $digits = $typeCodeStr . $dniStr;
    
    // Svari katrai pozīcijai
    $weights = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2];
    
    // Aprēķināt produktu summu
    $sumProducts = 0;
    for ($i = 0; $i < 10; $i++) {
        $sumProducts += (int)$digits[$i] * $weights[$i];
    }
    
    // Aprēķināt pārbaudes ciparu
    $verificationDigit = 11 - ($sumProducts % 11);
    
    // Īpašie gadījumi
    if ($verificationDigit == 11) {
        $verificationDigit = 0;
    } else if ($verificationDigit == 10) {
        $verificationDigit = 9;
    }
    
    return $verificationDigit;
}

function generateCuitCuil($typeCode, $dni = null) {
    // Derīgie tips kodi
    $validTypeCodes = [20, 23, 24, 27, 30, 33, 34];
    
    if (!in_array($typeCode, $validTypeCodes)) {
        throw new Exception("Nederīgs tips kods. Jābūt vienam no: " . implode(', ', $validTypeCodes));
    }
    
    // Ģenerēt nejaušu DNI, ja nav norādīts
    if ($dni === null) {
        $dni = rand(10000000, 99999999);
    }
    
    // Aprēķināt pārbaudes ciparu
    $verificationDigit = calculateVerificationDigit($typeCode, $dni);
    
    // Formatēt CUIT/CUIL
    return sprintf("%d-%08d-%d", $typeCode, $dni, $verificationDigit);
}

function validateCuitCuil($cuitCuil) {
    // Noņemt defises, ja ir
    $cuitCuilClean = str_replace('-', '', $cuitCuil);
    
    // Pārbaudīt pamatformātu
    if (!preg_match('/^\d{11}$/', $cuitCuilClean)) {
        return ['isValid' => false, 'errorMessage' => 'Nederīgs formāts'];
    }
    
    // Izvilkt daļas
    $typeCode = (int)substr($cuitCuilClean, 0, 2);
    $dni = (int)substr($cuitCuilClean,

## Bieži uzdotie jautājumi

### Kāda ir atšķirība starp CUIT un CUIL?

Šeit ir praktiskā atšķirība: **CUIT** (Clave Única de Identificación Tributaria) identificē nodokļu maksātājus — gan fiziskas personas, gan uzņēmumus, kas iesniedz nodokļus AFIP. **CUIL** (Clave Única de Identificación Laboral) identificē darbiniekus sociālās drošības sistēmā nodarbinātības un pensionēšanās nolūkos.

Praksē daudzām personām ir gan CUIL (no viņu pirmās darbavietas), un vēlāk viņas var iegūt CUIT (ja kļūst par pašnodarbinātām vai sāk uzņēmumu). Numuri izmanto identiskus formatēšanas un aprēķinu noteikumus, tāpēc no validācijas viedokļa tos apstrādā vienādi. Atšķirība ir svarīga administratīvos nolūkos: algu sistēmas parasti strādā ar CUIL, savukārt rēķinu un nodokļu sistēmas izmanto CUIT.

### Kādus veida kodus izmanto fiziskām personām un kādus uzņēmumiem?

Fiziskām personām:
- 20, 23, 24: Vīriešu personas (CUIL)
- 27: Sieviešu personas (CUIL)

Uzņēmumiem un organizācijām:
- 30: Korporācijas (CUIT)
- 33: Pilsoniskās asociācijas (CUIT)
- 34: Fondi (CUIT)

### Kā tiek aprēķināts pārbaudes cipars?

Algoritms izmanto svērto reizināšanu: ņem katru no pirmajiem 10 cipariem, reizina ar svariem **5, 4, 3, 2, 7, 6, 5, 4, 3, 2**, summē reizinājumus, tad aprēķina 11 mīnus (summa modulo 11).

Divas īpašās situācijas var mulsināt: ja aprēķins dod 11, izmanto 0 kā pārbaudes ciparu; ja tas dod 10, izmanto 9. Šīs īpašās situācijas pastāv tāpēc, ka pārbaudes ciparam jābūt viencipara skaitlim (0-9). Šis ir modulo-11 pārbaudes cipara algoritms, līdzīgs tam, ko izmanto ISBN-10 kodos un citās identifikācijas sistēmās pasaulē.

### Vai varu izmantot šo rīku, lai ģenerētu īstus, oficālus CUIT/CUIL numurus?

Nē — šis rīks ģenerē matemātiski derīgus testēšanas datus, bet numuri nav oficiāli reģistrēti AFIP. Domājiet par to kā par derīga kredītkartes numura ģenerēšanu, izmantojot Luhn algoritmu: tas iztur formāta validāciju, bet nav saistīts ar īstu kontu.

Oficiālai CUIT/CUIL reģistrācijai fiziskām personām jāapmeklē AFIP ar savu DNI, savukārt uzņēmumiem jāveic korporatīvās reģistrācijas procedūras. Rīks ir paredzēts tikai izstrādei, testēšanai un izglītojošiem nolūkiem, kur nepieciešami derīgi izskatāmies dati, kas nekonfliktēs ar īstiem identifikācijas numuriem.

### Kāpēc mana CUIT/CUIL validācija neizdodas, lai gan formāts izskatās pareizs?

Kad validācija neizdodas, neskatoties uz pareizi izskatošos formatējumu, pārbaudiet šos izplatītos iemeslus:

1. **Nederīgs veida kods**: Derīgi ir tikai 20, 23, 24, 27, 30, 33, 34. Izmantojot 21, 25 vai citus skaitļus, validācija neizdosies.
2. **Nepareizs pārbaudes cipars**: Pēdējam ciparam jāatbilst algoritma aprēķinam. Pat mainot vienu ciparu DNI daļā, jāpārrēķina pārbaudes cipars.
3. **Formāta problēmas**: Jābūt tieši 11 cipariem (XX-XXXXXXXX-X). Uzmanieties pēc liekām atstarpēm vai trūkstošiem vadošiem nulles cipariem.
4. **Slēpti rakstzīmes**: Kopējot no PDF vai tīmekļa vietnēm, dažreiz tiek ieviestas neredzamas Unicode rakstzīmes, kas bojā validāciju.

Ātra atkļūdošanas padoms: noņemiet pēdējo ciparu un manuāli pārrēķiniet to. Ja tas neatbilst, tad tas ir jūsu problēmas cēlonis.

### Vai defises ir obligātas CUIT/CUIL numuros?

Defises ir tikai displeja formatēšanai — tās nav daļa no faktiskā numura aprēķina. Kad redzat **20-12345678-9**, algoritms rūpējas tikai par 11 cipariem: **20123456789**.

Lielākā daļa validācijas ieviešanu noņem defises pirms apstrādes, tāpēc mūsu rīks pieņem gan **20-12345678-9**, gan **20123456789**. API un datubāzēs jūs parasti saglabāsiet nedefizēto versiju un pievienosiet defises tikai, kad rādāt lietotājiem. Šī pieeja novērš formatēšanas nekonsekvences, kas varētu izraisīt validācijas kļūmes.

### Vai CUIT/CUIL numurā var būt mazāk par 8 cipariem DNI daļā?

DNI daļai vienmēr jābūt tieši 8 cipariem — bez izņēmumiem. Ja kāda personas faktiskais DNI satur mazāk ciparu (kas notiek ar vecākiem, zemāk numurētiem DNI), jāaizpilda ar vadošām nullēm.

Piemēram, DNI **1234567** kļūst par **01234567** CUIT/CUIL struktūrā. Šis ir bieža kļūdu avots, konvertējot starp DNI un CUIT/CUIL formātiem. Esmu redzējis sistēmas, kas neiztur validāciju, jo aizmirsa pievienot nulles, apstrādājot **1234567** kā 7 ciparu skaitli, nevis **01234567**. Vienmēr izmantojiet nulles pievienošanas funkcijas savā kodā, nevis vienkāršu virkņu konkatenāciju.

### Kā es varu pārbaudīt, vai CUIT/CUIL ir oficiāli reģistrēts Argentīnā?

Mūsu rīks validē matemātisko pareizību — formātu, veida kodu un pārbaudes ciparu. Bet tas nevar pateikt, vai numurs ir faktiski reģistrēts AFIP vai pieder īstai personai vai uzņēmumam.

Oficiālai pārbaudei izmantojiet [AFIP tīmekļa pakalpojumus](https://www.afip.gob.ar/) vai viņu "Constancia de Inscripción" meklēšanas rīku. AFIP piedāvā API automatizētai pārbaudei, lai gan jums būs jāreģistrējas kā izstrādātājam un jāautentificējas. Ražošanas vidēs īstenojiet abas pakāpes: vispirms veiciet algoritmisko validāciju (ātri, uztver drukas kļūdas un formāta kļūdas), tad pārbaudiet pret AFIP datubāzi (lēnāk, bet apstiprina, ka numurs ir īsts un aktīvs).

### Vai varu izmantot šo rīku savā komerciālajā lietojumprogrammā?

Jā — CUIT/CUIL validācijas algoritms ir publisks standarts, ko definējis AFIP, tāpēc jūs varat brīvi to īstenot komerciālā programmnodrošinājumā. Šeit sniegtie koda piemēri ir paredzēti kā atsauces īstenošanas.

Ražošanas lietojumam ņemiet vērā šos labākos praktiskos paņēmienus: īstenojiet pareizu kļūdu apstrādi īpašām situācijām, pievienojiet žurnalizāciju validācijas kļūmju atkļūdošanai, validējiet pret AFIP oficiālo datubāzi (ne tikai algoritmiski), un saglabājiet savu īstenošanu atjauninātu, ja AFIP maina noteikumus (lai gan pašreizējais algoritms ir bijis stabils gadu desmitiem).

### Vai rīks saglabā kādu no ģenerētajiem vai validētajiem CUIT/CUIL numuriem?

Nē — visa apstrāde notiek jūsu pārlūkprogrammā (klienta pusē). Kad ģenerējat vai validējat CUIT/CUIL, aprēķins notiek lokāli, izmantojot JavaScript. Nekas netiek nosūtīts uz mūsu serveriem, un mēs nereģistrējam, nesaglabājam un nekontrolējam nevienu skaitli, ko jūs ievadāt vai ģenerējat.

Šī klienta puses pieeja nodrošina privātumu un arī nozīmē, ka rīks darbojas bezsaistē pēc lapas ielādes. Jūs varat to pārbaudīt, atverot savas pārlūkprogrammas izstrādātāju rīkus un novērojot tīkla cilni — jūs neredzēsiet nevienu pieprasījumu, ģenerējot vai validējot skaitļus.

## Atsauces

1. AFIP (Federālā publisko ieņēmumu administrācija). "CUIT/CUIL/CDI." Oficiālā vietne. [https://www.afip.gob.ar/](https://www.afip.gob.ar/)

2. Darba, nodarbinātības un sociālās drošības ministrija. "CUIL - Unikālā darba identifikācijas atslēga." [https://www.argentina.gob.ar/trabajo](https://www.argentina.gob.ar/trabajo)

3. ANSES (Valsts sociālās drošības administrācija). "Iegūt manu CUIL." [https://www.anses.gob.ar/](https://www.anses.gob.ar/)

4. Argentīnas Republikas Oficiālais biļetens. "AFIP Vispārīgā rezolūcija 2854/2010: Procedūra. Unikālā nodokļu identifikācijas atslēga (C.U.I.T.)."

5. Argentīnas Republikas Fiskālais kodekss. "Nodokļu maksātāju identifikācija un reģistrācija."

---

Neatkarīgi no tā, vai jūs veidojat rēķinu sistēmu, pārbaudāt darbinieku reģistrācijas plūsmas vai mācāties par validācijas algoritmiem, šis rīks nodrošina CUIT/CUIL ģenerēšanu un validāciju, kāda jums nepieciešama. Ģenerējiet pārbaudes datus, kas iztur algoritmisko validāciju, pārbaudiet numurus pirms to ievietošanas datubāzē vai izpētiet, kā kontrolcipara algoritms darbojas praksē.