Generator TERYT
Generuj polskie adresy z pełną hierarchią administracyjną: województwo, powiat, gmina, typ jednostki i 7-cyfrowy kod TERC z rejestru TERYT prowadzonego przez GUS. Niezbędne przy testowaniu systemów administracji publicznej, ochrony zdrowia, sprawozdawczości i każdej integracji wymagającej kodów terytorialnych.
Kliknij „Generuj nowy", aby otrzymać kolejny adres z kodem TERC, albo wklej dowolny 7-cyfrowy kod poniżej — walidator rozpozna województwo i typ jednostki.
Czym jest TERYT i kod TERC
TERYT to Krajowy Rejestr Urzędowy Podziału Terytorialnego Kraju prowadzony przez GUS — kanoniczne źródło identyfikatorów jednostek administracyjnych, na którym opierają się systemy publiczne: od sprawozdawczości statystycznej, przez rejestry medyczne, po ewidencje gruntów. Jego rdzeniem jest kod TERC: 7 cyfr w układzie WW PP GG T — dwie cyfry województwa, dwie powiatu, dwie gminy i cyfra typu jednostki.
Jak czytać kod TERC
Dwie pierwsze cyfry to województwo — i tu ciekawostka, która bywa przypadkiem testowym: kody województw są wyłącznie parzyste, od 02 (dolnośląskie) do 32 (zachodniopomorskie). Nieparzyste wartości zostały zarezerwowane przy reformie z 1999 roku na wypadek przyszłych zmian podziału. Ostatnia cyfra koduje typ jednostki: gmina miejska (1), wiejska (2), miejsko-wiejska (3), a miasta na prawach powiatu mają własne oznaczenia. Walidator kuQA rozbija każdy kod na te składniki i nazywa je po ludzku — zamiast „1465011" zobaczysz, że to jednostka w Warszawie.
Dlaczego to unikat wśród generatorów danych testowych
Kody TERC pojawiają się w specyfikacjach systemów zdrowia, oświaty i administracji — wszędzie tam, gdzie dane raportuje się „w podziale terytorialnym" — a jednocześnie praktycznie żaden generator danych testowych ich nie obsługuje. Testerzy kopiują wtedy kody ręcznie z arkuszy GUS, co jest wolne i podatne na literówki. Generator kuQA tworzy od razu spójny komplet: jednostka z realnej hierarchii, jej prawidłowy kod TERC i przybliżony kod pocztowy — gotowy rekord do formularzy i seedów.
Źródło prawdy
Generator służy testom — oficjalnym i jedynym wiążącym źródłem kodów jest rejestr TERYT udostępniany przez GUS (eTERYT), aktualizowany przy każdej zmianie podziału administracyjnego. Jeśli system produkcyjny waliduje kody przeciwko słownikowi, słownik powinien pochodzić właśnie stamtąd.
Najczęstsze pytania
Czym jest kod TERC?
To 7-cyfrowy identyfikator jednostki administracyjnej z rejestru TERYT: dwie cyfry województwa, dwie powiatu, dwie gminy i cyfra typu jednostki (miejska, wiejska, miejsko-wiejska).
Dlaczego kody województw są parzyste?
Przy reformie administracyjnej z 1999 roku nadano województwom kody parzyste od 02 do 32, rezerwując nieparzyste na ewentualne przyszłe zmiany podziału. Nieparzysty kod województwa to zawsze błąd.
Gdzie sprawdzić oficjalne kody TERYT?
W rejestrze eTERYT prowadzonym przez GUS — to jedyne wiążące źródło, aktualizowane przy każdej zmianie podziału administracyjnego kraju.
W jakich systemach używa się kodów TERC?
W administracji publicznej, sprawozdawczości statystycznej, systemach ochrony zdrowia, oświaty i ewidencjach — wszędzie tam, gdzie dane raportuje się w podziale terytorialnym.
Co rozpoznaje walidator?
Format 7 cyfr, poprawność kodu województwa (parzyste 02–32) oraz typ jednostki — rozbijając kod na nazwane składniki zamiast samego „poprawny/niepoprawny".
Czy mogę wygenerować wiele rekordów naraz?
Tak — tryb bulk wygeneruje do 500 adresów z kodami TERC i eksportem do CSV, JSON, SQL lub TXT.
To tylko jeden ze 175 generatorów. Pełny katalog kuQA zawiera m.in. payloady security, artefakty QA, edge cases i tryb bulk z eksportem CSV/JSON/SQL.
