Strona główna » Księgowość » Podatki » PIT » Rozliczenia PIT-ów » Uniwersalna Bramka Dokumentów (UBD)

Uniwersalna Bramka Dokumentów (UBD)

26 stycznia 2015, 13:36

Uniwersalna Bramka Dokumentów (UBD) to nowy kanał komunikacji elektronicznej dla płatników uruchomiony przez Ministerstwo Finansów od 1 stycznia 2015 r., który ma ułatwić i usprawnić składanie deklaracji drogą elektroniczną. Narzędzie to umożliwia złożenie w ramach jednego dokumentu i jednej transmisji danych do 20 000 PIT-11, PIT-8C, PIT-R, PIT-40 oraz pobranie jednego Urzędowego Poświadczenia Odbioru (UPO) dla całej wysyłki.

W praktyce oznacza to, iż wprowadzony został dokument wielopozycyjny, umożliwiający płatnikom podatku dochodowego od osób fizycznych oraz podmiotom niepełniącym funkcji płatnika w tym podatku, wysyłanie urzędowi skarbowemu zbiorczej informacji o dochodach osób fizycznych, opatrzonej jednym podpisem elektronicznym.

Rozlicz szybko PITY 2015 z płytą CD

W celu przesyłania dokumentów za pośrednictwem bramki UBD wprowadzone zostały nowe schematy informacji zbiorczych PIT-11, PIT-8C, PIT-R oraz deklaracji zbiorczej PIT-40 oznaczone odpowiednio: PIT-11Z, PIT-8CZ, PIT-RZ oraz PIT-40Z.

Schematy dokumentów zbiorczych nie przewidują składania korekt. Korekty powinny być składane jako pojedyncze dokumenty (PIT-11, PIT-8C, PIT-R, PIT-40) za pośrednictwem dotychczasowej bramki e-Deklaracje.

Od 1 stycznia 2015 r. płatnicy zaliczek na podatek dochodowy będący osobami fizycznymi mają możliwość podpisania wysyłanych dokumentów zbiorczych (PIT-11Z, PIT-8CZ, PIT-40Z) i pojedynczych (PIT-11, PIT-8C, PIT-40) danymi autoryzującymi.

Produkcyjnie bramka UBD (Uniwersalna Bramka Dokumentów) została uruchomiona w dniu 1 stycznia 2015 r. i dostępna jest pod adresem: https://ubd.mf.gov.pl/uslugi/dokumenty .

Szczegółowe informacje techniczne dotyczące działania UBD zostały zawarte w „Specyfikacji Wejścia-Wyjścia dla środowiska produkcyjnego UBD – wersja 0.1.0" dostępnej w zakładce e-Deklaracje/Do pobrania.

W zakładce e-Deklaracje/Struktury dokumentów XML opublikowane zostały wzory dokumentów zbiorczych PIT-11Z, PIT-8CZ, PIT-RZ i PIT-40Z.

Ministerstwo Finansów zaprasza do wysyłania informacji i deklaracji zbiorczych za pośrednictwem UBD (Uniwersalnej Bramki Dokumentów).

Pod adresem https://test-ubd.mf.gov.pl/uslugi/dokumenty znajduje się testowa wersja Uniwersalnej Bramki Dokumentów, która pozwoli na dostosowanie systemów teleinformatycznych podatników do nowego rozwiązania i przygotowanie się korzystania z tego kanału komunikacji.

Szczegółowe informacje techniczne zawarte są w „Specyfikacji Wejścia-Wyjścia dla środowiska testowego UBD – wersja 0.1.0" dostępnej w zakładce e-Deklaracje/Do pobrania.

Limity ulg i odliczeń w PIT 2014 / 2015

Najważniejsze zagadnienia, pytania i odpowiedzi ekspertów Ministerstwa Finansów dotyczące testowej Uniwersalnej Bramki Dokumentów (UBD):

1. Błąd w dokumencie zbiorczym

Przedłożony dokument zbiorczy w formacie XML stanowi integralną całość i jeżeli błędna jest jedna z jego sekcji (np. dane dot. jednego z podatników), to cały dokument zbiorczy zostanie odrzucony (status „401 – Weryfikacja negatywna - dokument niezgodny ze schematem xsd").

2. Status przesłanego do UBD dokumentu

Zwracany status przetwarzania dla dokumentu odrzuconego po weryfikacji zawiera kod błędu i słowny opis przyczyny błędu. Dla weryfikacji zgodności danych XML ze wzorem XSD opis może zawierać również krótkie informacje techniczne pochodzące bezpośrednio z aplikacji weryfikującej (parser). Dla dokumentu zbiorczego zwracany opis błędu może zawierać jedynie informację o pierwszym wystąpieniu błędu w danych XML.

Istnieją bezpłatne narzędzia pozwalające na samodzielną walidację przygotowanych danych XML ze wzorem XSD dokumentu elektronicznego.

3. Czy można zaimportować do formularza PDF dane XML zawierające kilkadziesiąt PIT-11 celem wysyłki do UBD?

Nie. Na portalu nie ma interaktywnych formularzy PDF które dotyczyłyby wzorów deklaracji wielopozycyjnych tj. PIT-11Z, PIT-8CZ, PIT-40Z i PIT-RZ. Do dokumentów interaktywnych PDF (w tym PIT-11) można importować z pliku XML dane wyłącznie dla pojedynczych dokumentów.

Formularze PIT 2014/2015

4. Gdzie są dostępne opisy mechanizmów umożliwiających transfer danych i przesłanie do UBD, przykłady użycia kodu, ewentualnie biblioteki do zaimplementowania we własnym oprogramowaniu.

Opis WSDL usługi Web Services został stworzony z zachowaniem standardów w sposób jednoznacznie opisujący udostępnioną usługę. Jest on poprawnie interpretowany przez edytory WSDL i pozwala, wykorzystując dostępne narzędzia programistyczne, na przygotowanie poprawnej implementacji klienta usługi Web Services.

Szczegółowe informacje techniczne dotyczące działania UBD zostały zawarte w „Specyfikacji Wejścia-Wyjścia dla środowiska produkcyjnego UBD – wersja 0.1.0" oraz w „Specyfikacji Wejścia-Wyjścia dla środowiska testowego UBD – wersja 0.1.0" (dostępna na stronie internetowej www.portalpodatkowy.mf.gov.pl w zakładce „e-Deklaracje", sekcja „Do pobrania"), które pozwalają na przygotowanie przez firmy IT własnych rozwiązań, pozwalających na wysłanie dokumentu XML i odebranie zwrotnego komunikatu (status, UPO).

Ministerstwo Finansów nie wskazuje metod, zastosowań, narzędzi i rozwiązań programistycznych, stąd też nie publikuje przykładów implementacji rozwiązania dla Web Services.

5. Podpis dokumentów wysyłanych do UBD

Dla dokumentów elektronicznych składanych do UBD wymagane jest ich podpisanie za pomocą:

podpis kwalifikowany (certyfikaty wydane przez jedno z 5 polskich centrów certyfikacji elektronicznej)
dane autoryzujące (płatnik będący osobą fizyczną).

6. Wysyłanie dokumentów do UBD

Podpisany dokument elektroniczny PIT-11Z, PIT-8CZ, PIT-40Z, PIT-RZ może być wysłany do systemu e-Deklaracje jedynie przez bramkę UBD (usługa Web Services).

Adres usługi WS UBD to: https://ubd.mf.gov.pl/uslugi/dokumenty?wsdl

Udostępnione zostało również środowisko testowe UBD dostępne pod adresem: https://test-ubd.mf.gov.pl/uslugi/dokumenty?wsdl pozwalające na sprawdzenie własnych rozwiązań i testową wysyłkę deklaracji wielopozycyjnych.

7. Dostęp do bramek usługi Web Services systemu e-Deklaracje

Ministerstwo Finansów udostępnia bramki Web Services systemu e-Deklaracje, umożliwiające składanie dokumentów drogą elektroniczną, pod następującymi adresami:

testowa UBD:
https://test-ubd.mf.gov.pl/uslugi/dokumenty
produkcyjna UBD
https://ubd.mf.gov.pl/uslugi/dokumenty
testowa e-Deklaracje:
https://test-bramka.edeklaracje.gov.pl/uslugi/dokumenty
produkcyjna e-Deklaracje:
https://bramka.e-deklaracje.mf.gov.pl/uslugi/dokumenty

8. Wymagania techniczne – dostęp do UBD

Szczegółowe informacje na temat wymagań zostały przedstawione w opublikowanych na stronie www.portalpodatkowy.mf.gov.pl zakładka „e-Deklaracje", sekcja "Do pobrania" w „Specyfikacji Wejścia-Wyjścia dla środowiska testowego UBD – wersja 0.1.0" oraz „Specyfikacji Wejścia-Wyjścia dla środowiska produkcyjnego UBD – wersja 0.1.0".

9. Korzystanie ze środowiska testowego UBD

Aby skorzystać ze środowiska testowego UBD nie są konieczne żadne dodatkowe działania ze strony użytkownika (użyty certyfikat SSL/TLS jest automatycznie rozpoznawany w systemach Windows).

10. Poprawność wysyłanych do UBD dokumentów – zgodność ze wzorem

Opublikowane w Repozytorium CRD na platformie ePUAP (crd.gov.pl) wzory pozwalają na samodzielne przygotowanie na ich podstawie danych w formacie XML.

11. Dedykowany program dla płatników

Ministerstwo Finansów nie planuje udostępniania specjalnej aplikacji dla płatników chcących skorzystać z wysyłki dokumentów zbiorczych (wielopozycyjnych PIT-11Z, PIT-8CZ, PIT-40Z, PIT-RZ).

Opublikowane materiały (specyfikacja wejścia-wyjścia, wzory zbiorczych dokumentów elektronicznych XSD dla płatników w repozytorium CRD ePUAP –oraz na stronie www.portalpodatkowy.mf.gov.pl) oraz udostępnione środowisko testowe nowej bramki UBD pozwalają na przygotowanie zbiorczego dokumentu (PIT-11Z, PIT-8CZ, PIT-RZ, PIT-40Z) i wysłanie go do bramki testowej lub produkcyjnej usługi Web Services.

Ponadto funkcjonujące dotychczas rozwiązanie dla składania pojedynczych dokumentów – również przez płatników – stanowi uzupełnienie i alternatywę dla nowej bramki UBD.

12. Przykładowe pliki do wysyłania na UBD

Ministerstwo Finansów nie publikuje przykładowych plików XML dla wzorów XSD dokumentów elektronicznych. Przykłady dokumentów zamieszczone są w opublikowanych specyfikacjach wejścia-wyjścia (www.portalpodatkowy.mf.gov.pl zakładka „e-Deklaracje", sekcja „Do pobrania").

13. Działanie UBD - aplikacja www czy aplikacja instalowana na komputerze?

UBD działa jako udostępnione usługi Web Services (bramki testowe i produkcyjne). Dokumenty przesyłane do systemu przez aplikacje własne podatników (wywołanie odpowiednich operacji usług WS) muszą być w formacie XML, z kodowaniem znaków UTF-8 i opatrzone podpisem elektronicznym (kwalifikowanym lub danymi autoryzującymi).

14. Nowa bramka UBD a dotychczasowa bramka e-Deklaracje

Obie bramki (usługi Web Services) stanowią składniki jednego systemu e-Deklaracje i przesłane dokumenty elektroniczne podatnika po zakończonej pozytywnie weryfikacji zawsze trafiają do, wskazanej w złożonym dokumencie elektronicznym, jednostki administracji podatkowej (urząd skarbowy).

15. Bramka UBD - dokumenty podpisanie podpisem elektronicznym - analogicznie jak bramka e-Deklaracje?

Tak. Dokumenty elektroniczne składane do systemu e-Deklaracje muszą być podpisane, co jest jednym z warunków na ich poprawną weryfikację. Szczegóły zostały zamieszczone w specyfikacjach wejścia-wyjścia (stronawww.portalpodatkowy.mf.gov.pl zakładka „e-Deklaracje", sekcja „Do pobrania").

Więcej pytań i odpowiedzi na temat Bramki UBD

Źródło: Ministerstwo Finansów