Generator i Walidator CUIT/CUIL | Narzędzie do identyfikacji podatkowej w Argentynie

Generator i Walidator Argentyńskiego CUIT/CUIL

Wprowadzenie

W argentyńskich systemach podatkowych i pracowniczych stale napotyka się dwa kluczowe identyfikatory: CUIT (Clave Única de Identificación Tributaria) i CUIL (Clave Única de Identificación Laboral). Można pomyśleć o CUIT jako numerze identyfikacyjnym podatkowym dla firm i osób płacących podatki, podczas gdy CUIL identyfikuje pracowników w systemie zabezpieczenia społecznego. Oba używają tego samego 11-cyfrowego formatu i algorytmu weryfikacyjnego, co czyni testowanie aplikacji obsługujących te numery szczególnie ważnym zadaniem.

Podczas tworzenia oprogramowania dla argentyńskiego rynku potrzebujesz ważnych danych testowych. Właśnie w tym pomaga to narzędzie. Możesz generować matematycznie poprawne numery CUIT/CUIL do testowania bez używania prawdziwych danych osobowych lub weryfikować istniejące numery, aby upewnić się, że są zgodne z oficjalnym algorytmem AFIP. Szczególnie przydatne jest to, że narzędzie obsługuje zarówno stronę generowania (tworzenie ważnych numerów na żądanie), jak i walidacji (wychwytywanie błędów formatu, nieprawidłowych kodów typów i nieprawidłowych cyfr weryfikacyjnych przed wywołaniem problemów w produkcji).

Struktura i Obliczanie CUIT/CUIL

Zrozumienie Formatu

Prawidłowy numer CUIT/CUIL składa się z 11 cyfr, zazwyczaj wyświetlanych w formacie XX-XXXXXXXX-X. Oto jak to wygląda:

1. Kod Typu (pierwsze 2 cyfry): Identyfikuje rodzaj podmiotu

   • 20, 23, 24: Osoby płci męskiej (CUIL)
   • 27: Osoby płci żeńskiej (CUIL)
   • 30, 33, 34: Firmy i organizacje (CUIT)

2. Numer DNI (środkowe 8 cyfr): Dla osób fizycznych jest to ich narodowy numer dokumentu tożsamości (DNI). Częstym błędem jest to, że jeśli rzeczywisty numer DNI ma mniej niż 8 cyfr, należy go uzupełnić wiodącymi zerami. Na przykład DNI 1234567 staje się 01234567 w CUIT/CUIL. Firmy otrzymują zamiast tego unikalny przypisany numer.

3. Cyfra Weryfikacyjna (ostatnia cyfra): Ta cyfra kontrolna sprawdza poprawność całego numeru za pomocą algorytmu ważonego. Jeśli ta cyfra nie zgadza się z obliczeniem, cały CUIT/CUIL jest nieprawidłowy — coś, co często zaskakuje programistów podczas ręcznego konstruowania danych testowych.

Obliczanie Cyfry Weryfikacyjnej

Cyfra weryfikacyjna używa algorytmu ważonego modulo-11. Oto jak to działa:

1. Weź pierwsze 10 cyfr CUIT/CUIL (kod typu + DNI)
2. Pomnóż każdą cyfrę przez jej odpowiednią wagę: 5, 4, 3, 2, 7, 6, 5, 4, 3, 2
3. Zsumuj wszystkie ilorazy
4. Oblicz: 11 minus (suma modulo 11)
5. Obsłuż przypadki graniczne: jeśli wynik to 11, użyj 0; jeśli to 10, użyj 9

Najbardziej mylące są przypadki graniczne w kroku 5. Podczas testowania czasami otrzymasz wynik 10 lub 11, a zapomnienie o mapowaniu tych wartości na 9 i 0 powoduje błędy walidacji, które mogą być trudne do debugowania, jeśli nie jest się świadomym tej reguły.

Matematycznie można to wyrazić jako:

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

Gdzie:

• $VD$ jest cyfrą weryfikacyjną
• $d_i$ jest $i$-tą cyfrą pierwszych 10 cyfr
• $w_i$ jest odpowiednią wagą z sekwencji [5, 4, 3, 2, 7, 6, 5, 4, 3, 2]
• Przypadki specjalne: jeśli $VD = 11$ to $VD = 0$, jeśli $VD = 10$ to $VD = 9$

Przewodnik krok po kroku

Korzystanie z Generatora

1. Wybierz zakładkę "Generator" w górnej części interfejsu narzędzia.

2. Wybierz Kod Typu z menu rozwijanego:

   • 20: Mężczyzna (CUIL)
   • 23: Firma (CUIT)
   • 24: Tymczasowa Firma (CUIT)
   • 27: Kobieta (CUIL)
   • 30: Korporacja (CUIT)
   • 33: Stowarzyszenie Cywilne (CUIT)
   • 34: Fundacja (CUIT)

3. Wprowadź numer DNI (opcjonalnie):

   • Wprowadź 8-cyfrowy numer DNI w podanym polu
   • Jeśli pozostawione puste, narzędzie użyje losowo wygenerowanego DNI
   • Jeśli wprowadzisz mniej niż 8 cyfr, system uzupełni wiodącymi zerami

4. Generowanie losowego DNI (opcjonalnie):

   • Kliknij przycisk "Losowy", aby wygenerować losowy 8-cyfrowy numer DNI

5. Wyświetl wygenerowany CUIT/CUIL:

   • Narzędzie automatycznie wyświetla ważny CUIT/CUIL na podstawie Twoich danych wejściowych
   • Format będzie XX-XXXXXXXX-X z poprawną cyfrą weryfikacyjną

6. Skopiuj wynik:

   • Kliknij ikonę kopiowania, aby skopiować wygenerowany CUIT/CUIL do schowka
   • Pojawi się komunikat potwierdzający pomyślne skopiowanie

Korzystanie z Walidatora

1. Wybierz zakładkę "Walidator" w górnej części interfejsu narzędzia.

2. Wprowadź CUIT/CUIL do walidacji:

   • Wprowadź CUIT/CUIL w formacie XX-XXXXXXXX-X
   • Narzędzie automatycznie sformatuje Twoje dane wejściowe z myślnikami podczas wpisywania
   • Możesz również wprowadzić numer bez myślników (XXXXXXXXXXX)

3. Kliknij przycisk "Waliduj":

   • Narzędzie sprawdzi format, kod typu i cyfrę weryfikacyjną

4. Wyświetl wynik walidacji:

   • Dla ważnych numerów CUIT/CUIL pojawi się zielony komunikat sukcesu
   • Dla nieprawidłowych numerów pojawi się czerwony komunikat błędu wyjaśniający problem:
     • Nieprawidłowy format (musi być XX-XXXXXXXX-X)
     • Nieprawidłowy kod typu (musi być jednym z: 20, 23, 24, 27, 30, 33, 34)
     • Nieprawidłowa cyfra weryfikacyjna

5. Dodatkowe informacje:

   • Dla ważnych numerów narzędzie wyświetla rozbicie składników:
     • Kod typu i jego znaczenie
     • Numer DNI
     • Cyfra weryfikacyjna

Typowe Błędy i Najlepsze Praktyki

Podczas pracy z walidacją CUIT/CUIL w swoich aplikacjach, uważaj na te częste pułapki:

Problemy z Zerowaniem: Najczęstszym błędem, jaki napotkałem, są numery DNI z wiodącymi zerami. Gdy ktoś wprowadzi DNI "1234567", Twój kod musi go traktować jako "01234567" podczas konstruowania CUIT/CUIL. Wiele implementacji konwertuje do liczb całkowitych podczas przetwarzania, co usuwa wiodące zera. Zamiast tego używaj operacji na ciągach znaków z odpowiednim uzupełnianiem.

Pomyłki z Kodem Typu: Nie wszystkie dwucyfrowe numery są prawidłowymi kodami typu. Działają tylko 20, 23, 24, 27, 30, 33, 34. Widziałem systemy, które akceptują dowolny dwucyfrowy prefiks, prowadzące do "wyglądających na ważne" numerów jak 21-12345678-X, które nie przechodzą walidacji AFIP. Zawsze sprawdzaj kod typu przed obliczeniem cyfry weryfikacyjnej.

Założenia Dotyczące Płci: Kody typu 20 (mężczyzna) i 27 (kobieta) nie są zamienne. Jeśli automatycznie generujesz CUIL w oparciu o dane demograficzne, upewnij się, że Twój kod typu odpowiada faktycznej płci zarejestrowanej w RENAPER (krajowy rejestr Argentyny). Niezgodności powodują odrzucenie podczas próby użycia tych numerów w usługach rządowych.

Obsługa Łączników: Niektóre implementacje wymagają łączników, podczas gdy inne je odrzucają. Najlepsza praktyka: akceptuj oba formaty w polach wprowadzania (z łącznikami lub bez), usuń łączniki przed walidacją, przechowuj wersję bez łączników w bazach danych i dodawaj łączniki tylko do celów wyświetlania.

Brak Weryfikacji: Algorytm walidacji wykrywa błędy formatu, ale nie potwierdza, czy CUIT/CUIL jest zarejestrowany. W środowisku produkcyjnym najpierw zweryfikuj format (szybko), a następnie sprawdź w bazie danych AFIP (wolniej, ale autorytatywnie). To dwuetapowe podejście natychmiast wyłapuje literówki, jednocześnie zapewniając, że numer jest prawdziwy.

Testowanie Przypadków Skrajnych: Zawsze testuj z cyframi weryfikacyjnymi 0 i 9 — wynikają one ze specjalnych przypadków w algorytmie. Przetestuj również DNI zaczynające się od zer, aby upewnić się, że logika uzupełniania działa poprawnie.

Przypadki użycia i praktyczne zastosowania

Rozwój i testowanie

Tworzenie oprogramowania: Podczas budowy aplikacji dla rynku argentyńskiego, będziesz potrzebować danych testowych, które przechodzą walidację bez użycia prawdziwych informacji użytkownika. Oto, kiedy staje się to krytyczne:

• Platformy e-commerce: Procesory płatności i systemy fakturowania wymagają ważnych numerów CUIT/CUIL. Podczas testów obciążeniowych możesz potrzebować tysięcy ważnych numerów do symulacji realistycznych rejestracji użytkowników.
• Oprogramowanie księgowe: Moduły raportowania podatkowego weryfikują format CUIT/CUIL przed wysłaniem do AFIP. Testowanie tych reguł walidacji wymaga numerów, które przechodzą algorytm cyfry kontrolnej.
• Systemy zarządzania zasobami ludzkimi: Przetwarzanie listy płac i składek na ubezpieczenie społeczne zależy od ważnych numerów CUIL. Typowy scenariusz: testujesz przepływy onboardingu pracowników i musisz sprawdzić, czy nieprawidłowe CUIL-e wywołują odpowiednie komunikaty o błędach.
• Aplikacje bankowe: Procesy KYC (Poznaj Swojego Klienta) weryfikują CUIT/CUIL jako część otwierania konta. W moim doświadczeniu przypadki graniczne, takie jak niezgodności kodu typu, często ujawniają się podczas testów integracyjnych.

Populacja bazy danych: Podczas zasiewania testowych baz danych, używanie algorytmicznie ważnych numerów CUIT/CUIL zapewnia, że ograniczenia i wyzwalacze bazy danych działają zgodnie z oczekiwaniami. Ma to szczególne znaczenie podczas testowania skryptów migracji danych lub procesów ETL, które weryfikują numery identyfikacyjne.

Testowanie walidacji formularzy: Testuj zarówno ścieżkę szczęśliwą, jak i warunki błędów. Generuj ważne numery, aby potwierdzić pomyślne złożenie, a następnie zmodyfikuj cyfrę weryfikacyjną, aby upewnić się, że Twoja walidacja frontend i backend przechwytuje błąd przed dotarciem do bazy danych.

Testowanie API: Testy integracyjne powinny używać ważnych numerów CUIT/CUIL w ładunkach żądań. Zapobiega to fałszywym negatywom, gdzie testy zawodzą z powodu nieprawidłowych danych testowych, a nie rzeczywistych błędów w logice API.

Automatyzacja QA: Sparametryzowane testy korzystają z dynamicznego generowania CUIT/CUIL. Zamiast twardego kodowania wartości testowych, które mogą powodować konflikty między uruchomieniami testów, generuj świeże ważne numery dla każdego wykonania testu.

Cele edukacyjne

Nauka algorytmów walidacji: Algorytm weryfikacji CUIT/CUIL demonstruje praktyczne zastosowanie arytmetyki modulo i ważonych cyfr kontrolnych. Ten sam wzorzec pojawia się w innych systemach identyfikacji na świecie — numery kart kredytowych (algorytm Luhna), kody ISBN i europejskie numery VAT używają podobnych podejść z ważonymi sumami kontrolnymi. Zrozumienie, jak działa walidacja CUIT/CUIL, daje wgląd w to, dlaczego te algorytmy istnieją: wyłapują błędy przepisywania, takie jak przestawione cyfry lub błędy pojedynczej cyfry.

Nauczanie walidacji danych: Podczas szkolenia młodszych programistów w zakresie walidacji danych wejściowych, system CUIT/CUIL oferuje przykład z prawdziwego świata, który jest bardziej złożony niż walidacja adresu e-mail, ale prostszy niż weryfikacja kryptograficzna. Demonstruje zasadę głębi obrony: walidacja formatu (11 cyfr), walidacja reguł biznesowych (ważne kody typów) i walidacja algorytmiczna (cyfra kontrolna).

Rozwój biznesu międzynarodowego: Jeśli budujesz systemy dla rynków latynoamerykańskich, zrozumienie CUIT/CUIL pomaga zrozumieć podobne systemy w sąsiednich krajach. Brazylia ma CPF/CNPJ, Chile ma RUT, a Urugwaj ma RUT — wszystkie używają algorytmów cyfr kontrolnych. Wzorce, które tu poznasz, przenoszą się na te systemy.

Alternatywy i uwagi produkcyjne

Podczas gdy to narzędzie sprawdza się dobrze w rozwoju i testowaniu, środowiska produkcyjne mają inne wymagania:

Oficjalna walidacja rządowa: W przypadku aplikacji na żywo sama walidacja algorytmiczna nie wystarczy — musisz sprawdzić, czy CUIT/CUIL jest faktycznie zarejestrowany w AFIP (Administración Federal de Ingresos Públicos). AFIP udostępnia usługi sieciowe do walidacji w czasie rzeczywistym, choć będziesz musiał się zarejestrować i uwierzytelnić, aby uzyskać do nich dostęp. Haczyk: numer może być matematycznie poprawny, ale nie został oficjalnie przypisany, więc zawsze implementuj obie warstwy walidacji w produkcji.

Biblioteki i pakiety: Jeśli integrujesz walidację CUIT/CUIL z bazą kodu, rozważ te sprawdzone biblioteki zamiast pisać własne:

• JavaScript: validar-cuit na npm obsługuje walidację i formatowanie
• PHP: biblioteka afip-php zapewnia zarówno walidację, jak i integrację z usługą sieciową AFIP
• Python: py-cuit na PyPI implementuje pełny algorytm

Używanie utrzymywanych bibliotek zmniejsza ryzyko błędów implementacji i często obejmuje przypadki brzegowe, które możesz przegapić we własnym kodzie.

Ręczne obliczenie: W celach edukacyjnych lub debugowania, ręczne przejście przez algorytm pomaga utrwalić zrozumienie. Weź kalkulator i przykładowy CUIT/CUIL, a następnie postępuj krok po kroku zgodnie z procesem ważonego mnożenia.

Usługi walidacji dla przedsiębiorstw: Aplikacje na dużą skalę mogą skorzystać z interfejsów API walidacji stron trzecich, które nie tylko sprawdzają format, ale także krzyżowo odnoszą się do komercyjnych baz danych. Te usługi mogą oznaczać nieaktywne firmy, identyfikować podmioty objęte sankcjami lub dostarczać dodatkowych metadanych o posiadaczu CUIT/CUIL.

Historia systemu CUIT/CUIL

System identyfikacji CUIT/CUIL w Argentynie rozwijał się znacząco od momentu jego powstania:

Źródła i wdrożenie

CUIT (Clave Única de Identificación Tributaria) został po raz pierwszy wprowadzony w Argentynie w latach 70. jako część wysiłków mających na celu modernizację systemu poboru podatków. Federalna Administracja Dochodów Publicznych (AFIP) wdrożyła ten unikalny identyfikator, aby skuteczniej śledzić podatników i ograniczyć uchylanie się od opodatkowania.

CUIL (Clave Única de Identificación Laboral) został później wprowadzony, aby konkretnie identyfikować pracowników w systemie zabezpieczenia społecznego, tworząc rozróżnienie między identyfikacją podatkową a identyfikacją pracowniczą przy zachowaniu spójnego formatu.

Ewolucja i cyfryzacja

W latach 90., gdy Argentyna przechodziła znaczące reformy gospodarcze, system CUIT/CUIL stał się coraz ważniejszy dla śledzenia aktywności ekonomicznej. System został dalej usystematyzowany, a wdrożono systemy weryfikacji online.

Początek lat 2000 przyniósł integrację systemu CUIT/CUIL z różnymi cyfrowymi usługami rządowymi, czyniąc go istotnym elementem argentyńskich inicjatyw e-rządu. W tym okresie nastąpiła również standaryzacja algorytmu weryfikacji i formatu, które są używane do dziś.

Najnowsze osiągnięcia

W ostatnich latach AFIP zwiększyła bezpieczeństwo i procesy weryfikacji numerów CUIT/CUIL, wdrażając bardziej zaawansowane systemy walidacji i integrując je z innymi bazami danych rządowych. System odgrywa obecnie kluczową rolę w wysiłkach Argentyny zmierzających do zwalczania uchylania się od opodatkowania i formalizacji gospodarki.

Dzisiaj CUIT/CUIL jest używany nie tylko do celów podatkowych i zatrudnienia, ale także w szerokim zakresie działań, w tym w bankowości, transakcjach nieruchomościami, usługach komunalnych i zakupach online, stając się niezbędnym identyfikatorem zarówno dla osób fizycznych, jak i firm działających w Argentynie.

Zagadnienia Implementacyjne

Podczas implementacji walidacji CUIT/CUIL w swoich systemach rozważ następujące aspekty techniczne:

Stabilność Algorytmu: Aktualny algorytm weryfikacji CUIT/CUIL pozostaje niezmieniony od czasu standaryzacji w latach 90. Zgodnie z dokumentacją techniczną AFIP, podejście do cyfry kontrolnej opartej na module-11 jest usystematyzowane w Resolución General 2854/2010 i kolejnych regulacjach. Ta stabilność oznacza, że implementacje rzadko wymagają aktualizacji, ale powinieneś monitorować komunikaty AFIP pod kątem ewentualnych zmian regulacyjnych.

Optymalizacja Wydajności: Algorytm weryfikacji jest obliczeniowo niedrogi — zaledwie 10 mnożeń, jedno dodawanie i jedna operacja modulo. W systemach o wysokiej przepustowości przetwarzających tysiące weryfikacji na sekundę wąskim gardłem jest zazwyczaj opóźnienie sieciowe podczas weryfikacji w bazie danych AFIP, a nie sam algorytm. Rozważ buforowanie wyników weryfikacji AFIP z odpowiednimi czasami wygaśnięcia (zazwyczaj 24 godziny), aby zachować równowagę między aktualnością a wydajnością.

Kodowanie Znaków: Podczas przetwarzania danych CUIT/CUIL z zewnętrznych źródeł (PDF, dokumenty skanowane, web scraping) zwróć uwagę na problemy z kodowaniem znaków. Myślnik może pojawić się jako pauza długa (U+2014), pauza krótka (U+2013) lub znak minus (U+2212) zamiast standardowego myślnika (U+002D). Znormalizuj je przed walidacją, aby zapobiec fałszywym wynikom negatywnym.

Internacjonalizacja: Jeśli Twoja aplikacja obsługuje wiele rynków latynoamerykańskich, zauważ, że argentyński CUIT/CUIL używa modulo-11 z określonymi wagami, podczas gdy chilijskie RUT używa modulo-11 z innymi wagami, a brazylijski CPF/CNPJ używa modulo-11 z jeszcze innym wzorem. Nie zakładaj, że algorytmy są identyczne — każdy krajowy system ma odrębne zasady. Aby lepiej zrozumieć algorytmy cyfr kontrolnych, zapoznaj się z normą ISO/IEC 7064, która formalizuje różne schematy weryfikacji opartej na modulo.

Przechowywanie w Bazie Danych: Przechowuj numery CUIT/CUIL bez myślników jako stałej długości CHAR(11) lub jako BIGINT, jeśli Twoja baza danych obsługuje 11-cyfrowe liczby całkowite bez utraty precyzji. Dodaj ograniczenie sprawdzające, które weryfikuje cyfrę kontrolną na poziomie bazy danych jako dodatkowe zabezpieczenie przed uszkodzonymi danymi. Utwórz indeksy na tym polu dla wydajnych wyszukiwań, gdy użytkownicy szukają po CUIT/CUIL.

Przykłady kodu

Python

JavaScript

Java

PHP

<?php

function calculateVerificationDigit($typeCode, $dni) {
    // Konwersja na ciąg znaków i zapewnienie, że DNI ma 8 cyfr z wiodącymi zerami
    $typeCodeStr = (string)$typeCode;
    $dniStr = str_pad((string)$dni, 8, '0', STR_PAD_LEFT);
    
    // Połączenie kodu typu i DNI
    $digits = $typeCodeStr . $dniStr;
    
    // Wagi dla każdej pozycji
    $weights = [5, 4, 3, 2, 7, 6, 5, 4, 3, 2];
    
    // Obliczenie sumy iloczynów
    $sumProducts = 0;
    for ($i = 0; $i < 10; $i++) {
        $sumProducts += (int)$digits[$i] * $weights[$i];
    }
    
    // Obliczenie cyfry weryfikacyjnej
    $verificationDigit = 11 - ($sumProducts % 11);
    
    // Przypadki specjalne
    if ($verificationDigit == 11) {
        $verificationDigit = 0;
    } else if ($verificationDigit == 10) {
        $verificationDigit = 9;
    }
    
    return $verificationDigit;
}

function generateCuitCuil($typeCode, $dni = null) {
    // Prawidłowe kody typów
    $validTypeCodes = [20, 23, 24, 27, 30, 33, 34];
    
    if (!in_array($typeCode, $validTypeCodes)) {
        throw new Exception("Nieprawidłowy kod typu. Musi być jednym z: " . implode(', ', $validTypeCodes));
    }
    
    // Generowanie losowego DNI, jeśli nie podano
    if ($dni === null) {
        $dni = rand(10000000, 99999999);
    }
    
    // Obliczenie cyfry weryfikacyjnej
    $verificationDigit = calculateVerificationDigit($typeCode, $dni);
    
    // Formatowanie CUIT/CUIL
    return sprintf("%d-%08d-%d", $typeCode, $dni, $verificationDigit);
}

function validateCuitCuil($cuitCuil) {
    // Usunięcie myślników, jeśli są obecne
    $cuitCuilClean = str_replace('-', '', $cuitCuil);
    
    // Sprawdzenie podstawowego formatu
    if (!preg_match('/^\d{11}$/', $cuitCuilClean)) {
        return ['isValid' => false, 'errorMessage' => 'Nieprawidłowy format'];
    }
    
    // Wyodrębnienie części
    $typeCode = (int)substr($cuitCuilClean, 0, 2);
    $dni = (int)substr($cuitCuilClean, 2, 8);
    $verificationDigit = (int)substr($cuitCuilClean, 10, 1);
    
    // Walidacja kodu typu
    $validTypeCodes = [20, 23, 24, 27, 30, 33, 34];
    if (!in_array($typeCode, $validTyp

## Często zadawane pytania

### Jaka jest różnica między CUIT a CUIL?

Oto praktyczne rozróżnienie: **CUIT** (Clave Única de Identificación Tributaria) identyfikuje podatników — zarówno osoby fizyczne, jak i firmy składające zeznania podatkowe w AFIP. **CUIL** (Clave Única de Identificación Laboral) identyfikuje pracowników w systemie ubezpieczeń społecznych dla celów zatrudnienia i emerytury.

W praktyce wielu osób posiada zarówno CUIL (z pierwszej pracy), a później może uzyskać CUIT (jeśli zostanie samozatrudniony lub założy firmę). Numery używają identycznego formatowania i zasad obliczania, więc pod względem walidacji obsługuje się je tak samo. Rozróżnienie ma znaczenie dla celów administracyjnych: systemy płacowe zazwyczaj pracują z CUIL, podczas gdy systemy fakturowania i podatkowe używają CUIT.

### Jakie kody typów są używane dla osób fizycznych, a jakie dla firm?

Dla osób fizycznych:
- 20, 23, 24: Mężczyźni (CUIL)
- 27: Kobiety (CUIL)

Dla firm i organizacji:
- 30: Korporacje (CUIT)
- 33: Stowarzyszenia cywilne (CUIT)
- 34: Fundacje (CUIT)

### Jak oblicza się cyfrę weryfikacyjną?

Algorytm używa mnożenia ważonego: weź każdą z pierwszych 10 cyfr, pomnóż przez wagi **5, 4, 3, 2, 7, 6, 5, 4, 3, 2**, zsumuj iloczyny, a następnie oblicz 11 minus (suma modulo 11).

Dwa szczególne przypadki mogą wprowadzać w błąd: gdy obliczenie daje 11, użyj 0 jako cyfry weryfikacyjnej; gdy daje 10, użyj 9. Te specjalne przypadki istnieją, ponieważ cyfra weryfikacyjna musi być jednocyfrowa (0-9). Jest to algorytm sprawdzania cyfry modulo-11, podobny do używanego w kodach ISBN-10 i innych systemach identyfikacyjnych na świecie.

### Czy mogę użyć tego narzędzia do generowania prawdziwych, oficjalnych numerów CUIT/CUIL?

Nie — to narzędzie generuje matematycznie poprawne dane testowe, ale numery nie są oficjalnie zarejestrowane w AFIP. Pomyśl o tym jak o generowaniu prawidłowego numeru karty kredytowej przy użyciu algorytmu Luhna: przechodzi walidację formatu, ale nie jest podłączony do prawdziwego konta.

Do oficjalnej rejestracji CUIT/CUIL osoby fizyczne muszą odwiedzić AFIP z dowodem osobistym, podczas gdy firmy muszą ukończyć procedury rejestracji korporacyjnej. Narzędzie jest przeznaczone wyłącznie do rozwoju, testowania i celów edukacyjnych, gdzie potrzebne są wiarygodne dane, które nie będą kolidować z prawdziwymi numerami identyfikacyjnymi.

### Dlaczego moja walidacja CUIT/CUIL nie powiodła się, mimo że format wygląda poprawnie?

Gdy walidacja zawodzi mimo poprawnie wyglądającego formatowania, sprawdź te typowe przyczyny:

1. **Nieprawidłowy kod typu**: Tylko 20, 23, 24, 27, 30, 33, 34 są prawidłowe. Użycie 21, 25 lub innych liczb spowoduje niepowodzenie.
2. **Nieprawidłowa cyfra weryfikacyjna**: Ostatnia cyfra musi zgadzać się z obliczeniami algorytmu. Nawet zmiana jednej cyfry w części DNI wymaga przeliczenia cyfry kontrolnej.
3. **Problemy z formatem**: Musi być dokładnie 11 cyfr (XX-XXXXXXXX-X). Uważaj na dodatkowe spacje lub brakujące wiodące zera.
4. **Ukryte znaki**: Kopiowanie i wklejanie z plików PDF lub stron internetowych czasami wprowadza niewidoczne znaki Unicode, które psują walidację.

Szybka wskazówka debugowania: usuń ostatnią cyfrę i przelicz ją ręcznie. Jeśli nie zgadza się, to jest twój problem.

### Czy łączniki są wymagane w numerach CUIT/CUIL?

Łączniki są tylko do formatowania wyświetlania — nie są częścią numeru do celów obliczeniowych. Gdy widzisz **20-12345678-9**, algorytm dba tylko o 11 cyfr: **20123456789**.

Większość implementacji walidacji usuwa łączniki przed przetworzeniem, dlatego nasze narzędzie akceptuje zarówno **20-12345678-9**, jak i **20123456789**. W interfejsach API i bazach danych zazwyczaj przechowuje się wersję bez łączników i dodaje się je tylko podczas wyświetlania użytkownikom. To podejście zapobiega niepowodzeniom walidacji spowodowanym niespójnościami formatowania.

### Czy numer CUIT/CUIL może mieć mniej niż 8 cyfr w części DNI?

Część DNI musi zawsze mieć dokładnie 8 cyfr — bez wyjątków. Jeśli czyjś rzeczywisty DNI ma mniej cyfr (co zdarza się w przypadku starszych, niższych numerów), należy uzupełnić go wiodącymi zerami.

Na przykład DNI **1234567** staje się **01234567** w strukturze CUIT/CUIL. To częste źródło błędów podczas konwersji między formatami DNI a CUIT/CUIL. Widziałem systemy, które nie przechodzą walidacji, ponieważ zapomniały uzupełnić, traktując **1234567** jako 7-cyfrową liczbę zamiast **01234567**. Zawsze używaj funkcji uzupełniania zerami zamiast prostego łączenia ciągów znaków.

### Jak mogę sprawdzić, czy CUIT/CUIL jest oficjalnie zarejestrowany w Argentynie?

Nasze narzędzie sprawdza matematyczną poprawność — format, kod typu i cyfrę kontrolną. Ale nie może stwierdzić, czy numer jest faktycznie zarejestrowany w AFIP lub należy do prawdziwej osoby lub firmy.

Do oficjalnej weryfikacji użyj [usług internetowych AFIP](https://www.afip.gob.ar/) lub ich narzędzia do wyszukiwania "Constancia de Inscripción". AFIP oferuje interfejsy API do automatycznej weryfikacji, choć musisz zarejestrować się jako deweloper i uwierzytelnić. W środowiskach produkcyjnych zaimplementuj obie warstwy: najpierw przeprowadź walidację algorytmiczną (szybką, wyłapującą literówki i błędy formatu), a następnie zweryfikuj w bazie danych AFIP (wolniejszą, ale potwierdzającą, że numer jest prawdziwy i aktywny).

### Czy mogę użyć tego narzędzia w mojej aplikacji komercyjnej?

Tak — algorytm walidacji CUIT/CUIL jest publicznym standardem zdefiniowanym przez AFIP, więc możesz swobodnie zaimplementować go w oprogramowaniu komercyjnym. Zamieszczone tutaj przykłady kodu są przeznaczone jako implementacje referencyjne.

W użyciu produkcyjnym rozważ następujące najlepsze praktyki: zaimplementuj odpowiednią obsługę błędów dla przypadków skrajnych, dodaj rejestrowanie do debugowania niepowodzeń walidacji, sprawdzaj poprawność w oficjalnej bazie danych AFIP (nie tylko walidację algorytmiczną) i utrzymuj implementację na bieżąco, jeśli AFIP zmieni zasady (choć obecny algorytm jest stabilny od dziesięcioleci).

### Czy narzędzie przechowuje wygenerowane lub zwalidowane numery CUIT/CUIL?

Nie — całe przetwarzanie odbywa się w przeglądarce (po stronie klienta). Podczas generowania lub walidacji CUIT/CUIL obliczenia są wykonywane lokalnie przy użyciu JavaScript. Nic nie jest wysyłane na nasze serwery, a my nie rejestrujemy, nie przechowujemy ani nie śledzimy żadnych wprowadzonych lub wygenerowanych numerów.

To podejście po stronie klienta zapewnia prywatność i oznacza również, że narzędzie działa offline po załadowaniu strony. Możesz to sprawdzić, otwierając narzędzia dla programistów w przeglądarce i obserwując zakładkę sieciową — nie zobaczysz żadnych żądań podczas generowania lub walidacji numerów.

## Referencje

1. AFIP (Administracja Federalna Dochodów Publicznych). "CUIT/CUIL/CDI." Oficjalna strona internetowa. [https://www.afip.gob.ar/](https://www.afip.gob.ar/)

2. Ministerstwo Pracy, Zatrudnienia i Zabezpieczenia Społecznego. "CUIL - Unikalny Klucz Identyfikacji Pracowniczej." [https://www.argentina.gob.ar/trabajo](https://www.argentina.gob.ar/trabajo)

3. ANSES (Krajowa Administracja Zabezpieczenia Społecznego). "Uzyskaj mój CUIL." [https://www.anses.gob.ar/](https://www.anses.gob.ar/)

4. Dziennik Urzędowy Republiki Argentyny. "Rozporządzenie Generalne AFIP 2854/2010: Procedura. Unikalny Klucz Identyfikacji Podatkowej (C.U.I.T.)."

5. Kodeks Podatkowy Republiki Argentyny. "Identyfikacja i Rejestracja Podatników."

---

Bez względu na to, czy budujesz system fakturowania, testujesz przepływy onboardingu pracowników lub uczysz się o algorytmach walidacji, to narzędzie zapewnia generowanie i walidację CUIT/CUIL, których potrzebujesz. Generuj dane testowe, które przechodzą walidację algorytmiczną, weryfikuj numery przed wprowadzeniem ich do bazy danych lub poznaj, jak w praktyce działa algorytm cyfry kontrolnej.