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.

Architektura logiczna ePłatności

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