Integracja AMODIT z bazą adresową GUS TERYT

1. Czym jest GUS TERYT?

TERYT (Krajowy Rejestr Urzędowy Podziału Terytorialnego Kraju) to oficjalna baza Głównego Urzędu Statystycznego zawierająca pełne, aktualne dane adresowe Polski – od województw aż po nazwy ulic. Dzięki niej:

każdy adres posiada jednoznaczny identyfikator,
dane są regularnie aktualizowane przez GUS,
możliwe jest precyzyjne raportowanie i statystyka geograficzna.

2. Dlaczego warto w AMODIT?

Wyzwanie bez integracji	Korzyść po wdrożeniu GUS TERYT
Ręczne wpisywanie ulic powoduje literówki i rozbieżności (“Al. Jana Pawła II” vs “al Jana Pawla 2”)	Automatyczne podpowiedzi prosto z oficjalnej bazy – pełna spójność danych.
Brak jednego formatu adresu utrudnia analizy i korespondencję seryjną	Jednolity format {Ulica}, {Miejscowość}, {Gmina}…, gotowy do eksportu i raportów.
Czasochłonne wyszukiwanie danych administracyjnych (powiat, gmina)	Pola formularza wypełniają się natychmiast po wyborze ulicy.
Ryzyko wysyłki na nieistniejące adresy	Walidacja w czasie rzeczywistym na etapie wprowadzania danych.

Efekt? Mniej błędów, szybsza praca i zgodność z wymogami audytowymi.

3. Jak to działa? (wysoki poziom)

Użytkownik zaczyna wpisywać ulicę w polu formularza AMODIT.
System wysyła zapytanie do usługi GUS TERYT (chmura lub lokalny indeks Lucene).
W ułamku sekundy wyświetla się lista dopasowanych adresów – nawet przy 350 tys. ulic! Algorytm punktuje dokładność, dlatego najbardziej trafne wyniki są zawsze na górze.
Po wybraniu pozycji AMODIT zapisuje identyfikator TERYT oraz wyświetla sformatowaną nazwę ulicy.
W regułach i raportach można korzystać z pełnego JSON‑a (województwo, powiat, gmina…).

4. Kluczowe korzyści biznesowe

Poprawność danych – adresy pochodzą z urzędowego rejestru, a nie z pamięci pracownika.
Oszczędność czasu – brak ręcznego dopisywania powiatu, gminy czy województwa.
Lepsza analityka – każde zgłoszenie, faktura czy korespondencja ma poprawne kody terytorialne – gotowe do BI.
Mniejszy koszt reklamacji – wysyłki wychodzą na prawidłowe adresy, spada liczba zwrotów.

5. Typowe scenariusze użycia

Rejestracja kontrahentów – handlowiec wpisuje kilka liter ulicy, reszta wypełnia się sama.
Moduł HR – szybkie uzupełnienie adresu pracownika podczas onboardingu.
Zgłoszenia serwisowe – technik wybiera adres klienta, a system zwraca dokładny powiat i gminę do raportów SLA.
Generowanie umów i pism – zawsze poprawna, jednolita stopka adresowa.

6. Jak wdrożyć? (checklista biznes‑IT)

Włącz źródło danych: w ustawieniach systemowych AMODIT upewnij się, że parametr GUSTerytSource wskazuje services (chmura) lub local (indeks on‑prem). – Dla services wpisz adres w GUSTerytServicesUrl (domyślnie services.amodit.com). – Dla local wskaż ścieżkę GUSTerytIndexDirectory.
Dodaj pole typu Odnośnik do źródła zewnętrznego i wybierz źródło GUS Teryt.
Wybierz, co przechowujesz: – idval (identyfikator + pełny JSON) zapisywany w bazie, – name (sformatowany adres) wyświetlany użytkownikowi.
Przetestuj – wpisz kilka liter ulicy, sprawdź podpowiedzi i zapisywaną wartość.
(Opcjonalnie) wykorzystaj funkcję ParseJson w regułach, aby rozbić dane na osobne pola (województwo, powiat itp.).

Czas konfiguracji: ok. 15 minut.

7. Najczęstsze pytania

Pytanie	Odpowiedź
Czy potrzebuję licencji GUS?	Nie, dane TERYT są publiczne; AMODIT udostępnia gotowy indeks.
Czy usługa pokrywa wszystkie miejscowości i ulice?	Tak, obejmuje pełną bazę TERYT, aktualizowaną kilka razy w roku.
Co z adresami zagranicznymi?	Pole można połączyć z innym źródłem lub pozostawić wolny tekst dla krajów spoza Polski.
Czy wyszukiwanie obciąża serwer?	Indeks Lucene działa w pamięci, zapytania są lekkie (<30 ms).
Jak dodać kolumny z JSON‑a do raportu?	Skorzystaj z ParseJson w regułach lub SQL View, aby wyciągnąć woj/pow/gm.

Podsumowanie: Integracja AMODIT z GUS TERYT to szybki sposób na wyeliminowanie błędów adresowych i przyspieszenie wprowadzania danych. Użytkownik zyskuje wygodne podpowiedzi, a firma – spójne dane i lepszą analitykę geograficzną. Implementacja to kwestia kilku parametrów i jednego pola formularza.