Opis funkcji programu > Program > Komunikaty nieruchomości

Komunikaty importuje się w aplikacji pracującej w roli gminy. Na liście Komunikaty nieruchomości należy rozwinąć przycisk Import komunikatów, a następnie wybrać format Excel, CSV albo JSON.

Każdy import jest wykonywany jako jedna operacja. Jeżeli w pliku wystąpi błąd, program nie zapisuje żadnego z jego rekordów i wyświetla opis błędu wraz z numerem wiersza lub elementu JSON.

Pola importu

Pole	Wymagane	Format	Opis
ESTATE_EXTERNAL_KEY	Tak	tekst	Klucz zewnętrzny nieruchomości. Można użyć także nazwy EXTERNAL_KEY.
ESTATE_PART_IDENT	Nie	tekst	Wyróżnik lokalu. Pusta wartość oznacza komunikat dla całej nieruchomości.
NOTICE_TEXT	Tak	tekst, do 2048 znaków	Treść wyświetlana operatorowi.
NOTICE_KIND	Tak	INFO lub WARNING	Rodzaj komunikatu. Dopuszczalne są również wartości INFORMACJA i OSTRZEŻENIE.
VALID_FROM	Nie	yyyy-MM-dd lub yyyy-MM-ddTHH:mm:ss	Początek obowiązywania. Pusta wartość przy nowym komunikacie oznacza czas importu; przy aktualizacji zachowuje wcześniejszą datę.
VALID_TO	Tak	yyyy-MM-dd lub yyyy-MM-ddTHH:mm:ss	Koniec obowiązywania. Data bez godziny oznacza koniec wskazanego dnia.
NOTICE_EXTERNAL_ID	Tak	tekst, do 100 znaków	Stały identyfikator komunikatu w systemie źródłowym. Służy do aktualizacji wpisu przy kolejnym imporcie.
COMMUNE_ID	Nie	UUID albo kod TERYT	Gmina właściciela komunikatu. Puste pole oznacza bieżącą gminę, dlatego w typowym pliku nie trzeba go podawać.

Formaty plików

•Excel (.xls i .xlsx) - należy wskazać plik, arkusz oraz w razie potrzeby poprawić mapowanie kolumn. Program proponuje mapowanie po nazwach nagłówków.

•CSV - plik UTF-8 z wierszem nagłówka, separatorem średnik. Pola zawierające średnik należy ująć w cudzysłów.

•JSON - głównym elementem może być tablica rekordów albo obiekt zawierający tablicę w polu notices, items lub data. Nazwy pól nie rozróżniają wielkości liter.

Przykład CSV

ESTATE_EXTERNAL_KEY;ESTATE_PART_IDENT;NOTICE_TEXT;NOTICE_KIND;VALID_FROM;VALID_TO;NOTICE_EXTERNAL_ID

1000;;Prosimy okazać dokument potwierdzający zamieszkanie.;WARNING;2026-09-01;2026-09-30;KOM-2026-001

Aktualizacja i kontrola błędów

Ponowny import z tym samym identyfikatorem NOTICE_EXTERNAL_ID aktualizuje istniejący komunikat. Jeżeli dane są identyczne, rekord jest pomijany bez zmiany daty modyfikacji.

Ten sam NOTICE_EXTERNAL_ID nie może wystąpić dwukrotnie w jednym pliku. Program sprawdza także wymagane pola, okres obowiązywania, gminę, nieruchomość i jednoznaczność lokalu.