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)

  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.

Aktualizacja