Usługa ePłatności w mObywatelu
Wytyczne integracji z usługą ePłatności w aplikacji mObywatel dla jednostek samorządu terytorialnego.
Czym jest usługa ePłatności w mObywatelu?
Usługa ePłatności pozwala szybko i bez prowizji opłacić zobowiązania finansowe wystawione przez urząd, na przykład podatek od nieruchomości. Usługa jest dostępna w aplikacji mobilnej mObywatel i na stronie internetowej mObywatel.gov.pl.
Co zyskasz dzięki ePłatnościom? *Oszczędność czasu – płatność wykonasz bez wychodzenia z domu. *Bezpieczeństwo – ePłatności są współtworzone z Polskim Standardem Płatności. *Brak dodatkowych opłat – płatność zrealizujesz szybko i bez prowizji za pomocą BLIKA lub kart płatniczych. *Poprawność danych – część z nich system wypełni za Ciebie automatycznie. *Kontrolę nad wydatkami – sprawdzisz historię i statusy płatności. *Potwierdzenie płatności – uzyskasz je zaraz po przetworzeniu transakcji w BLIKU.
Pilotaż
Obecnie usługa ePłatności jest uruchamiana w ramach testów pilotażowych rozwiązania. Pilotaż realizowany jest w ramach trójstronnego porozumienia zawartego przez:
- Skarb Państwa - Ministra Cyfryzacji działającego w jego imieniu Centralnego Ośrodka Informatyki (podmiot wiodący, twórca i administrator portalu mobywatel.gov.pl i aplikacji mObywatel),
- Bank Gospodarstwa Krajowego (operator ePłatności),
- Organ Podatkowy, czyli urząd przystępujący do pilotażu.
Obsługa zobowiązań finansowych z perspektywy urzędu
Broker komunikacyjny mObywatel to rozwiązanie odpowiadające za komunikację (przesyłanie i pobieranie danych) z usługą ePłatności w aplikacji mObywatel.
Numer PESEL Obywatela, a tym samym płatnika, jest wymagany w celu poprawnego przypisania przekazywanych do usługi danych do właściwej osoby. Stąd istotne jest, aby w bazie osobowej systemów dziedzinowych były uzupełnione numery PESEL.
Udostępnienie zobowiązań
W ramach integracji z usługą ePłatności aplikacji mObywatel, „Broker komunikacyjny mObywatel” przekazuje dane o zobowiązaniach finansowych mieszkańców gminy, pochodzące z systemów dziedzinowych urzędu. Inicjalizacja usługi obejmuje całą bazę danych urzędu — przekazywane są zobowiązania wszystkich mieszkańców znajdujących się w systemach dziedzinowych.
Nie ma możliwości selektywnego wskazania np. tylko pracowników urzędu jako pierwszych użytkowników usługi w celu testów funkcjonalnych. Takie testy mogą być przeprowadzane wyłącznie na środowisku integracyjnym (INT), jednak należy mieć świadomość, że nie istnieje publiczna wersja aplikacji mObywatel połączona z tym środowiskiem, w związku z czym użytkownicy końcowi nie mają możliwości samodzielnego podglądu przekazanych tam danych.
Inicjalne udostępnienie danych o zobowiązaniach będzie zawierać także dane historyczne, jeśli obywatel w ramach typu zobowiązania posiada zaległości.
Jest to pierwsze zasilenie usługi ePłatności danymi o płatnościach. Realizowane tylko na etapie wdrożenia usługi.
Aktualizacja danych
Działanie brokera komunikacyjnego mObywatel będzie niewidoczne dla użytkownika, ale na podstawie działań wykonywanych w systemach dziedzinowych na bieżąco do usługi ePłatności będą przekazywane aktualne informacje dotyczące:
- Weryfikacji statusu zobowiązania - urząd będzie miał możliwość odpytania w dowolnym momencie o status wybranego zobowiązania, bądź listy zobowiązań,
- Edycji zobowiązań - możliwość edycji wystawionych zobowiązań, jeśli zajdzie taka potrzeba,
- Odrzucenia zobowiązań - w sytuacji, kiedy urząd będzie chciał wycofać udostępnione uprzednio w usłudze ePłatności zobowiązanie,
- Potwierdzenia płatności - w sytuacji, gdy obywatel ureguluje zobowiązanie poza usługą ePłatności, np. korzystając z platformy podatkowej ePodatki, bankowości elektronicznej bądź w kasie urzędu, urząd będzie mógł zmienić status płatności w usłudze ePłatności,
- Przekazywanie umorzeń - w przypadku umorzenia zobowiązania wystawionego uprzednio w usłudze ePłatności.
Pobieranie plików rozliczeniowych
Płatności zrealizowane przez usługę ePłatności w aplikacji mObywatel będą przekazywane na rachunki bankowe urzędu w formie zbiorczej płatności na dany dzień, dla każdego typu zobowiązania osobno. Numery rachunków bankowych przekazywane są do Banku Gospodarstwa Krajowego na etapie konfiguracji środowiska produkcyjnego.
W celu umożliwienia urzędowi identyfikacji i poprawnego rozksięgowania wpłaty otrzymanej z Banku Gospodarstwa Krajowego usługa ePłatności udostępnia pliki rozliczeniowe w formacie CSV, które będą zapisywane w bazach danych urzędu, a następnie księgowanie z wykorzystaniem aplikacji Uniwersalny Program Księgujący (UPK).
Plik rozliczeniowy w formacie CSV jest niezbędny do poprawnego rozksięgowania zbiorczych płatności. Nazwa pliku zawiera unikalny identyfikator UUID, który widnieje również w tytule przelewu z BGK oraz w nagłówku pliku — co pozwala jednoznacznie powiązać płatność z danymi księgowymi.
Wymagania techniczne
Broker komunikacyjny mObywatel do działania wymaga serwera Internet Information Services (IIS) dostępnego na systemach rodziny Microsoft Windows.
Minimalne wymagania dla sewera:
- Procesor: czterordzeniowy 2.4 GHz
- Pamięć RAM: 16 GB
- Dysk twardy: 500 GB (zalecane dyski o szybkim dostępie: 7200 obr/min lub wyższym, np. SSD)
- System operacyjny: Windows 2019 Server lub wyższy / Windows 10/11 Pro
Wymagania dotyczące baz danych:
- Minimalna wersja serwera: Firebird 3
Najczęściej zadawane pytania (FAQ)
Czy można jednocześnie korzystać z portalu ePodatki i usługi ePłatności w mObywatelu?
Portal podatkowy ePodatki może działać równolegle z usługą ePłatności w mObywatelu. ePodatki udostępniają więcej danych o podstawie opodatkowania, dają możliwość pobrania decyzji, pobierania faktur, podawania odczytów wodomierzy, itd.
Wirtualne Rachunki Bankowe a ePłatności
Rachunki wirtualne do identyfikacji masowych płatności nie mają zastosowania w przypadku korzystania z usługi ePłatności w aplikacji mObywatel. Konfiguracja środowiska produkcyjnego wymaga przekazania przez urząd do BGK numerów rachunków bankowego dla każdego typu zobowiązania.
Właściwe rozksięgowanie płatności zrealizowanych przez usługę ePłatności w aplikacji mObywatel będzie możliwe z wykorzystaniem aplikacji Uniwersalny Program Księgujący (UPK) w oparciu o pobrany z usługi ePłatności plik rozliczeniowy w formacie CSV.
Wirtualne Rachunki Banowe nadal mogą być wykorzystywane, np. na decyzjach podatkowych.
Oddzielna baza danych z opłatami za gospodarowanie odpadami komunalnymi
Przed uruchomieniem produkcyjnym ePłatności należy ustalić czy wszystkie uruchamiane zobowiązania są prowadzone w ramach jednej i tej samej bazy danych. W przypadku gdy np. opłaty za gospodarowanie odpadami komunalnymi prowadzone są w osobnej bazie danych należy podjąć kroki ku scaleniu baz danych oraz uporządkowaniu bazy osobowej.
Jak przystąpić do pilotażu usługi ePłatności?
Więcej informacji: Pilotaż ePłatności