Integracja AMODIT z bazą adresową GUS TERYT

Aktualizacja3 lipca 2025

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)

  1. Użytkownik zaczyna wpisywać ulicę w polu formularza AMODIT.
  2. System wysyła zapytanie do usługi GUS TERYT (chmura lub lokalny indeks Lucene).
  3. 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.
  4. Po wybraniu pozycji AMODIT zapisuje identyfikator TERYT oraz wyświetla sformatowaną nazwę ulicy.
  5. 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)

  1. 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.
  2. Dodaj pole typu Odnośnik do źródła zewnętrznego i wybierz źródło GUS Teryt.
  3. Wybierz, co przechowujesz: – idval (identyfikator + pełny JSON) zapisywany w bazie, – name (sformatowany adres) wyświetlany użytkownikowi.
  4. Przetestuj – wpisz kilka liter ulicy, sprawdź podpowiedzi i zapisywaną wartość.
  5. (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.