Ministerstwo Finansów Departament Informatyki Uniwersalna Bramka Dokumentów Specyfikacja Wejścia-Wyjścia Środowisko testowe Wersja 0.0.5 Warszawa, 01.07.2014 r. Copyright (c) 2014 Ministerstwo Finansów MINISTERSTWO FINANSÓW, DEPARTAMENT INFORMATYKI ul. Świętokrzyska 12, 00-916 Warszawa www.mf.gov.pl www.e-deklaracje.gov.pl e-mail: info.e-deklaracje@mofnet.gov.pl 1/56
Historia dokumentu Wersja Data wersji Opis Akcja (*) Rozdziały (**) Autorzy Zatwierdził (***) 0.0.1 2014-02-01 Utworzenie dokumentu N W 0.0.2 2014-04-01 Uzupełnienie Z W 0.0.3 2014-05-28 Uzupełnienie W, Z W 0.0.4 2014-06-20 Uzupełnienie W, Z W 0.0.5 2014-06-27 Uzupełnienie W, Z W (*) Akcje: W = Wstaw, Z = Zamień, We = Weryfikuj, N = Nowy (**) Rozdziały: W = Wszystkie (***) Zatwierdził (jeśli dotyczy) osoba zatwierdzająca podpisuje się w ostatnim wypełnionym wierszu, dla zatwierdzonej wersji papierowej, którą przekazuje się do archiwum. 2/56
Spis treści 1. WPROWADZENIE... 5 1.1 PRZEZNACZENIE... 5 1.2 ZAKRES... 5 1.3 DEFINICJE, AKRONIMY, SKRÓTY... 5 1.4 REFERENCJE... 6 2. PREZENTACJA STRUKTURY DOKUMENTU ELEKTRONICZNEGO... 10 2.1 OPIS STRUKTURY... 10 2.2 DEKLARACJE Z SEKCJĄ POWTARZALNĄ... 10 2.2.1 Graficzna prezentacja struktury przykładowej deklaracji z sekcją powtarzalną... 10 2.2.2 Graficzna prezentacja struktury przykładowego dokumentu element Naglowek... 10 2.2.3 Graficzna prezentacja struktury przykładowego dokumentu element Podmiot1 bez adresu... 10 2.2.4 Graficzna prezentacja struktury przykładowego dokumentu element Pozycja... 11 2.2.5 Graficzna prezentacja struktury przykładowego dokumentu element PozycjeSzczegolowe... 12 2.2.6 Graficzna prezentacja struktury przykładowego dokumentu element Zalaczniki... 13 2.3 DEKLARACJE POJEDYNCZE BEZ SEKCJI POWTARZALNEJ... 13 2.3.1 Graficzna prezentacja struktury przykładowej deklaracji bez sekcji powtarzalnej... 13 2.3.2 Graficzna prezentacja struktury przykładowego dokumentu element Naglowek... 13 2.3.3 Graficzna prezentacja struktury przykładowego dokumentu element Podmiot1 bez adresu... 13 2.3.4 Graficzna prezentacja struktury przykładowego dokumentu element Podmiot2 typ TOsobaFizyczna1... 13 2.3.5 Graficzna prezentacja struktury przykładowego dokumentu element PozycjeSzczegolowe... 14 2.3.6 Graficzna prezentacja struktury przykładowego dokumentu element Zalaczniki... 15 2.4 PISMO OGÓLNE... 15 2.4.1 Graficzna prezentacja struktury dokumentu... 15 2.4.2 Graficzna prezentacja poszczególnych sekcji dokumentu... 16 2.5 URZĘDOWE POŚWIADCZENIE ODBIORU (UPO)... 17 2.5.1 Graficzna prezentacja struktury dokumentu... 17 2.6 ELEMENTY STRUKTURY PRZYKŁADOWEGO DOKUMENTU DEKLARACJA... 18 2.6.1 Prolog XML wzoru dokumentu... 18 2.6.2 Nagłówek... 18 2.6.3 Deklaracja... 18 2.6.4 Pozycje szczegółowe... 19 2.7 ZAKRES INFORMACYJNY DOKUMENTU ELEKTRONICZNEGO... 24 2.8 KODOWANIE ZNAKÓW DOKUMENTU ELEKTRONICZNEGO... 24 2.9 POTWIERDZANIE AUTENTYCZNOŚCI PRZESYŁANYCH DOKUMENTÓW... 24 2.10 POSTAĆ KANONICZNA DOKUMENTU ELEKTRONICZNEGO... 24 2.11 PODPISANIE BEZPIECZNYM PODPISEM DOKUMENTU ELEKTRONICZNEGO... 25 2.11.1 Przykładowy dokument XML podpisany bezpiecznym podpisem weryfikowanym przy pomocy ważnego kwalifikowanego certyfikatu, gotowy do zakodowania base64 i umieszczenia w elemencie <Dokument> w komunikacie wywołującym operację wyslijpismoogolne... 26 2.12 POTWIERDZANIE AUTENTYCZNOŚCI PISM OGÓLNYCH... 27 2.12.1 Przykładowy podpisany dokument z Pismem Ogólnym, gotowy do zakodowania base64 i umieszczenia w elemencie <Dokument> w komunikacie wywołującym operację wyslijpismoogolne... 27 2.13 UWIERZYTELNIANIE DOKUMENTU DANYMI AUTORYZUJĄCYMI... 28 2.13.1 Definicja schematu XML PodpisDaneAutoryzujace... 29 2.13.2 Opis struktury PodpisDaneAutoryzujace... 31 2.13.3 Graficzna prezentacja struktury PodpisDaneAutoryzujace... 32 2.13.4 Przykładowy XML ze strukturą PodpisDaneAutoryzujace zawierających dokument PIT-8C... 32 3. PRZESYŁANIE DOKUMENTU ELEKTRONICZNEGO DO SYSTEMU... 33 3.1 USTANOWIENIE SESJI... 33 3.2 WYSYŁANIE DEKLARACJI ZBIORCZEJ Z PODPISEM... 33 3.3 WYSYŁANIE DEKLARACJI POJEDYNCZEJ Z PODPISEM... 33 3.4 WYSYŁANIE DEKLARACJI POJEDYNCZEJ Z DANYMI AUTORYZUJĄCYMI... 34 3.5 WYSYŁANIE PISMA OGÓLNEGO... 34 3.6 POBIERANIE DOKUMENTU (POTWIERDZENIA)... 34 3/56
3.7 INFORMACJE DODATKOWE ZAWARTE W POBIERANYM DOKUMENCIE (POTWIERDZENIU)... 35 3.8 STRUKTURA LOGICZNA URZĘDOWEGO POŚWIADCZENIA ODBIORU (UPO)... 36 4. SPECYFIKACJA USŁUGI WEB SERVICE... 39 OPERACJE USŁUGI WEB SERVICE... 39 4.1 OPERACJA WYSLIJDOKUMENTZBIORCZY... 39 4.1.1 Opis ogólny... 39 4.1.2 Opis szczegółowy... 39 4.1.3 Przykład wykorzystania... 40 4.2 OPERACJA WYSLIJDOKUMENT... 44 4.2.1 Opis ogólny... 44 4.2.2 Opis szczegółowy... 44 4.2.3 Przykład wykorzystania... 44 4.3 OPERACJA WYSLIJNIEPODPISANYDOKUMENT... 47 4.3.1 Opis ogólny... 47 4.3.2 Opis szczegółowy... 47 4.3.3 Przykład wykorzystania... 48 4.4 OPERACJA WYSLIJPISMOOGOLNE... 49 4.4.1 Opis ogólny... 49 4.4.2 Opis szczegółowy... 49 4.4.3 Przykład wykorzystania... 49 4.5 OPERACJA POBIERZUPO... 51 4.5.1 Opis ogólny... 51 4.5.2 Opis szczegółowy... 51 4.5.3 Przykład I wykorzystania... 52 4.6 PLIK WSDL DLA USŁUGI WEB SERVICE... 54 4.7 PLIK XSD DLA USŁUGI WEB SERVICE... 56 4/56
1. Wprowadzenie 1.1 Przeznaczenie Celem tego dokumentu jest przedstawienie zasad wymiany informacji pomiędzy systemem informatycznym Uniwersalna Bramka Dokumentów a oprogramowaniem interfejsowym przeznaczonym do przekazywania elektronicznych dokumentów do systemu e-deklaracje2. 1.2 Zakres Niniejsze opracowanie przeznaczone jest dla osób i firm z branży IT przygotowujących oprogramowanie interfejsowe do przekazywania elektronicznych dokumentów podatkowych do systemu e-deklaracje2. Różnice zakresu systemu testowego w odniesieniu do wersji produkcyjnej: System testowy nie przechowuje wysłanych danych testowych - cyklicznie dane te będą trwale usuwane, nie można pobrać UPO dla dokumentów starszych niż 2 miesiące System testowy nie weryfikuje rodzaju certyfikatu (kwalifikowany, komercyjny, inny) i wystawcy użytego certyfikatu, System testowy nie weryfikuje certyfikatu z listą CRL, System testowy nie weryfikuje upoważnień/pełnomocnictw do składania (ZAW- E1, ZAW-E2, UPL-1), System testowy nie weryfikuje poprawności danych autoryzujących opartych na zestawie cech informacyjnych podatnika składającego deklarację lub podanie, obejmującym: a) identyfikator podatkowy (NIP albo numer PESEL), b) imię (pierwsze), c) nazwisko, d) data urodzenia, e) kwota przychodu wskazana w zeznaniu lub rocznym obliczeniu podatku za rok podatkowy o dwa lata wcześniejszy niż rok, w którym są składane deklaracje lub a) numer identyfikacyjny VAP, b) kwota podstawy opodatkowania wykazana deklaracji, ostatnio złożonej za kwartał poprzedzający kwartał, za który jest składana deklaracja, c) kwota podatku podlegająca wpłacie do urzędu skarbowego Podmiotem przyjmującym dokumenty elektroniczne w systemie testowym jest e-deklaracje system testowy, UPO jest opatrzone podpisem elektronicznym w formacie XAdES enveloping (takim samym jak w środowisku produkcyjnym). Uwaga! Środowisko testowe systemu e-deklaracje nie jest przeznaczone do przetwarzania danych osobowych zgodnie z ustawą o ochronie danych osobowych (Dz. U. z 2002 r., Nr 101, poz. 926, t.j., z późn. zm.). W związku z powyższym do środowiska testowego należy przesyłać jedynie takie informacje, które nie są danymi osobowymi podlegającymi ochronie na podstawie ustawy o ochronie danych osobowych (w szczególności art. 6). Wszystkie przesłane do systemu informacje będą traktowane jako dane nieprawdziwe (fikcyjne). 1.3 Definicje, Akronimy, Skróty Kanoniczny XML (ang. Canonical XML, canonical form of an XML document) znormalizowna forma zapisu dokumentu XML. Standard opracowany przez W3C. SOAP - (ang. Simple Object Access Protocol) jest protokołem bazującym na standardzie XML. Protokół SOAP pozwala aplikacjom na komunikację przez 5/56
Internet. Standard SOAP jest opracowywany przez W3C (http://www.w3.org/tr/soap12-part0, http://www.w3.org/tr/soap12-part1, http://www.w3.org/tr/soap12-part2 ). Obecna wersja SOAP to 1.2. Protokół SOAP definiuje formaty komunikatów, sposoby wysyłania komunikatów i odbierania odpowiedzi, kodowania danych w języku XML oraz gramatykę XML służącą do: określania nazw metod, definiowania typów parametrów zwracanych wartości oraz opisu typów. Specyfikacja protokołu dopuszcza stosowanie różnych protokołów internetowych jako protokołów transportowych. Obecnie najczęściej wykorzystywanym protokołem jest HTTP. SSL - (ang. Secure Socket Layer) protokół aplikacyjny stosowany w celu zabezpieczenia poufności i integralności przesyłanych danych. Standard opisany został na stronie http://wp.netscape.com/eng/ssl3. Unicode standard definiujący zestaw znaków dla wszystkich alfabetów świata ( http://www.unicode.org ) UTF-8 (ang. Unicode Transformation Format) - sposób kodowania znaków Unicode (A transformation format of ISO 10646, http://www.ietf.org/rfc/rfc2279.txt ) W3C (ang. The World Wide Web Consortium - organizacja zajmująca się ustanawianiem standardów dla stron WWW. Publikowane przez W3C rekomendacje nie mają mocy prawnej, nakazującej ich użycie, lecz wskazują standardy dla rozwiązań technologicznych. WS, Web Service (ang. usługa sieciowa). Podstawowa technologia wykorzystywana w architekturze SOA. Jest to usługa systemu informatycznego, która może być używana przez inne komponenty programowe, również komponenty zewnętrzne projektowanego systemu. Web Service w paradygmacie SOA stanowi najistotniejszy interfejs (ang. API application programming interface) projektowanego systemu. Web Service jest również wykorzystywany wewnętrznie do komunikacji pomiędzy komponentami systemu. WSDL - (ang. Web Services Description Language). Plik WSDL to dokument XML, opisujący zbiór komunikatów SOAP. XML - (ang. Extensible Markup Language, - Rozszerzalny Język Znaczników) to uniwersalny język formalny przeznaczony do reprezentowania różnych danych w ustrukturalizowany sposób. XML jest niezależny od platformy, co umożliwia łatwą wymianę dokumentów pomiędzy różnymi systemami i rekomendowany oraz specyfikowany przez organizację W3C. XSD (ang. XML Schema Definition - Schemat XML, Schemat Rozszerzalnego Języka Znaczników) to opracowany przez W3C standard służący do definiowania struktury dokumentu XML. Dokumenty zawierające definicje XML Schema zapisuje się zwykle w plikach z rozszerzeniem.xsd (od XML Schema Definition). 1.4 Referencje [1] Ustawa z dnia 29 sierpnia 1997 r. Ordynacja podatkowa (tekst jedn. Dz.U. z 2005 r. Nr 8, poz. 60, z późn. zm.) [2] Rozporządzenie Ministra Finansów z dnia 19 grudnia 2007 r. w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz. U. z 2007 r. Nr 246, poz. 1817) [3] Rozporządzenie Ministra Finansów z dnia 24 grudnia 2007 r. w sprawie struktury logicznej deklaracji i podań, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz. U. z 2007 r. Nr 246, poz. 1820) [4] Rozporządzenie Ministra Finansów z dnia 19 grudnia 2007 r. zmieniające rozporządzenie w sprawie trybu składania oraz struktury logicznej zgłoszenia upoważnienia podatnika lub osoby upoważnionej przez podatnika do 6/56
składania deklaracji w formie elektronicznej i podpisywania deklaracji podpisem elektronicznym (Dz. U. z 2007 r. Nr 246, poz. 1818) [5] Rozporządzenie Ministra Finansów z dnia 19 grudnia 2007 r. zmieniające rozporządzenie w sprawie zaświadczeń wydawanych przez organy podatkowe (Dz. U. z 2007 r. Nr 246, poz. 1819) [6] Rozporządzenie Ministra Finansów z dnia 28 marca 2008 r. zmieniające rozporządzenie w sprawie struktury logicznej deklaracji i podań, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz. U. z 2008 r. Nr 55, poz. 336) [7] Ustawa z dnia 18 września 2001 r. o podpisie elektronicznym. (Dz. U. *zmieniony przez [38] z 2001 r. Nr 130, poz. 1450, z późn. zm.) [8] Rozporządzenie Rady Ministrów z dnia 7 sierpnia 2002 r. w sprawie określenia warunków technicznych i organizacyjnych dla kwalifikowanych podmiotów świadczących usługi certyfikacyjne, polityk certyfikacji dla kwalifikowanych certyfikatów wydawanych przez te podmioty oraz warunków technicznych dla bezpiecznych urządzeń służących do składania i weryfikacji podpisu elektronicznego. (Dz. U. z 2002 r. Nr 128, poz. 1094) [9] Rozporządzenie Prezesa Rady Ministrów z dnia 29 września 2005 r. w sprawie warunków organizacyjno-technicznych doręczania dokumentów elektronicznych podmiotom publicznym (Dz. U. z 2005 r. Nr 200, poz. 1651) * uchylone przez [24] [10] Ustawa z dnia 17 lutego 2005 r. o informatyzacji działalności podmiotów realizujących zadania publiczne (Dz. U. z 2005 r. Nr 64, poz. 565, z późn. zm.) [11] Rozporządzenie Rady Ministrów z dnia 11 października 2005 r. w sprawie minimalnych wymagań dla systemów teleinformatycznych (Dz. U. z 2005 r. * uchylone przez [24] Nr 212, poz. 1766) [12] Ustawa z dnia 21 czerwca 1996 r. o urzędach i izbach skarbowych (tekst jedn. Dz. U. z 2004 r. Nr 121, poz. 1267, z późn. zm.) [13] Ustawa z dnia 18 lipca 2002 r. o świadczeniu usług drogą elektroniczną (Dz. U. z 2002 r. Nr 144, poz. 1204, z późn. zm.) [14] Rozporządzenie Ministra Finansów z dnia 30 czerwca 2008 r. zmieniające rozporządzenie w sprawie struktury logicznej deklaracji i podań, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz. U. z 2008 r. Nr 114, poz. 727) [15] Rozporządzenie Ministra Finansów z dnia 29 grudnia 2008 r. zmieniające rozporządzenie w sprawie struktury logicznej deklaracji i podań, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz. U. z 2009 r. Nr 2, poz. 9) [16] Rozporządzenie Ministra Finansów z dnia 31 grudnia 2008 r. w sprawie struktury logicznej zgłoszeń, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz. U. z 2009 r. Nr 2, poz. 10) [17] Ustawa z dnia 5 marca 2009 r. o zmianie ustawy Ordynacja podatkowa oraz ustawy o opłacie skarbowej (Dz. U. z 2009 r. Nr 57, poz. 466) [18] Rozporządzenie Ministra Finansów z dnia 7 kwietnia 2009 r. zmieniające rozporządzenie w sprawie struktury logicznej deklaracji i podań, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz. U. z 2009 r. Nr 57, poz. 469) [19] Rozporządzenie Ministra Finansów z dnia 8 kwietnia 2009 r. w sprawie wzoru pełnomocnictwa do podpisywania deklaracji składanej za pomocą środków komunikacji elektronicznej oraz wzoru zawiadomienia o odwołaniu tego pełnomocnictwa (Dz. U. z 2009 r. Nr 57, poz. 470) 7/56
[20] Rozporządzenie Ministra Finansów z dnia 28 grudnia 2009 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej [21] Rozporządzenie Ministra Finansów z dnia 29 grudnia 2009 r. zmieniające rozporządzenie w sprawie struktury logicznej deklaracji i podań, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz. U. z 2009 r. Nr 225, poz. 1808) [22] Rozporządzenie Ministra Finansów z dnia 6 października 2010 r. zmieniające rozporządzenie w sprawie struktury logicznej deklaracji i podań, sposobu ich przesyłania oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz.U. z 2010 r. Nr 209 poz. 1378) [23] Rozporządzenie Ministra Finansów z dnia 30 grudnia 2010 r. w sprawie sposobu przesyłania deklaracji i podań oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz.U. z 2010 r. Nr 259 poz. 1769) [24] Ustawa z dnia 12 lutego 2010 r. o zmianie ustawy o informatyzacji działalności podmiotów realizujących zadania publiczne oraz niektórych innych ustaw (Dz.U. z 2010 r. Nr 40, poz. 230) [25] Rozporządzenie Ministra Finansów z dnia 19 stycznia 2011 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2011 r. Nr 19, poz. 97) [26] Rozporządzenie Ministra Finansów z dnia 31 marca 2011 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2011 r. Nr 76, poz. 412) [27] Rozporządzenie Ministra Finansów z dnia 27 września 2011 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2011 r. Nr 207, poz. 1231) [28] Rozporządzenie Ministra Finansów z dnia 19 grudnia 2011 r. w sprawie wzoru pełnomocnictwa do podpisywania deklaracji składanej za pomocą środków komunikacji elektronicznej oraz wzoru zawiadomienia o odwołaniu tego pełnomocnictwa (Dz.U. z 2011 r. Nr 286 poz. 1681) [29] Rozporządzenie Ministra Finansów z dnia 23 grudnia 2011 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2011 r. Nr 293, poz. 1733) [30] Rozporządzenie Ministra Finansów z dnia 3 stycznia 2012 r. zmieniające rozporządzenie w sprawie sposobu przesyłania deklaracji i podań oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz.U. z 2012 r. Nr 1 poz. 18) [31] Rozporządzenie Ministra Finansów z dnia 4 kwietnia 2012 r. zmieniające rozporządzenie w sprawie sposobu przesyłania deklaracji i podań oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz.U. z 2012 r. Nr 1 poz. 387) [32] Rozporządzenie Ministra Finansów z dnia 26 września 2012 r. zmieniające rozporządzenie w sprawie sposobu przesyłania deklaracji i podań oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz.U. z 2012 r. Nr 1 poz. 1083) [33] Rozporządzenie Rady Ministrów z dnia 12 kwietnia 2012 r. w sprawie Krajowych Ram Interoperacyjności, minimalnych wymagań dla rejestrów publicznych i wymiany informacji w postaci elektronicznej oraz minimalnych wymagań dla systemów teleinformatycznych (Dz.U. z 2012 r. poz. 526) 8/56
[34] Rozporządzenie Ministra Finansów z dnia 24 grudnia 2012 r. w sprawie sposobu przesyłania deklaracji i podań oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz.U. z 2012 r. poz. 1537) [35] Obwieszczenie Ministra Finansów z dnia 3 grudnia 2012 r. w sprawie ogłoszenia jednolitego tekstu rozporządzenia Ministra Finansów w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2013 r. poz. 85) [36] Rozporządzenie Ministra Finansów z dnia 11 stycznia 2013 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2013 r. poz. 98) [37] Rozporządzenie Ministra Finansów z dnia 31 stycznia 2013 r. w sprawie określenia rodzajów zgłoszeń, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2013 r. poz. 203) [38] Obwieszczenie Marszałka Sejmu Rzeczypospolitej Polskiej z dnia 8 lutego 2013 r. w sprawie ogłoszenia jednolitego tekstu ustawy o podpisie elektronicznym (Dz.U. z 2013 r. poz. 262) [39] Rozporządzenie Ministra Finansów z dnia 5 czerwca 2013 r. w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2013 r. poz. 669) [40] Rozporządzenie Ministra Finansów z dnia 25 czerwca 2013 r. w sprawie sposobu przesyłania zgłoszeń oraz rodzajów podpisu elektronicznego, którymi powinny być opatrzone (Dz.U. z 2013 r. poz. 753) [41] Rozporządzenie Ministra Finansów z dnia 9 grudnia 2013 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2013 r. poz. 1547) [42] Ustawa z dnia 10 stycznia 2014 r. o zmianie ustawy o informatyzacji działalności podmiotów realizujących zadania publiczne oraz niektórych innych ustaw (Dz.U. z 2014 r. poz. 183) [43] Rozporządzenie Ministra Finansów z dnia 26 marca 2014 r. zmieniające rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być składane za pomocą środków komunikacji elektronicznej (Dz.U. z 2014 r. poz. 405) 9/56
2. Prezentacja struktury dokumentu elektronicznego W rozdziale tym została przedstawiona struktura dokumentów elektronicznych, przesyłanych do systemu e-deklaracje2 jako skompresowane pliki formatu XML, opatrzone bezpiecznym podpisem weryfikowanym przy pomocy ważnego kwalifikowanego certyfikatu. 2.1 Opis struktury Do szczegółowego opisu struktury dokumentów używany jest standard XSD. 2.2 Deklaracje z sekcją powtarzalną 2.2.1 Graficzna prezentacja struktury przykładowej deklaracji z sekcją powtarzalną 2.2.2 Graficzna prezentacja struktury przykładowego dokumentu element Naglowek 2.2.3 Graficzna prezentacja struktury przykładowego dokumentu element Podmiot1 bez adresu 10/56
2.2.4 Graficzna prezentacja struktury przykładowego dokumentu element Pozycja 11/56
2.2.5 Graficzna prezentacja struktury przykładowego dokumentu element PozycjeSzczegolowe 12/56
2.2.6 Graficzna prezentacja struktury przykładowego dokumentu element Zalaczniki 2.3 Deklaracje pojedyncze bez sekcji powtarzalnej 2.3.1 Graficzna prezentacja struktury przykładowej deklaracji bez sekcji powtarzalnej 2.3.2 Graficzna prezentacja struktury przykładowego dokumentu element Naglowek 2.3.3 Graficzna prezentacja struktury przykładowego dokumentu element Podmiot1 bez adresu 2.3.4 Graficzna prezentacja struktury przykładowego dokumentu element Podmiot2 typ TOsobaFizyczna1 13/56
2.3.5 Graficzna prezentacja struktury przykładowego dokumentu element PozycjeSzczegolowe 14/56
2.3.6 Graficzna prezentacja struktury przykładowego dokumentu element Zalaczniki 2.4 Pismo Ogólne 2.4.1 Graficzna prezentacja struktury dokumentu 15/56
2.4.2 Graficzna prezentacja poszczególnych sekcji dokumentu 16/56
2.5 Urzędowe Poświadczenie Odbioru (UPO) 2.5.1 Graficzna prezentacja struktury dokumentu 17/56
2.6 Elementy struktury przykładowego dokumentu Deklaracja 2.6.1 Prolog XML wzoru dokumentu <?xml version="1.0" encoding="utf-8"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns="http://crd.gov.pl/wzor/2013/03/04/7250/" xmlns:etd="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/ed/definicjetypy/" xmlns:zr="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2013/09/18/ed/pitr/" targetnamespace="http://crd.gov.pl/wzor/2013/03/04/7250/" elementformdefault="qualified" attributeformdefault="unqualified" xml:lang="pl"> <xsd:import namespace="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/ed/definicjetypy/" schemalocation="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/ed/definicjetypy/strukturydanych_v3-0e.xsd"/> <xsd:import namespace="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2013/09/18/ed/pitr/" schemalocation="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2013/09/18/ed/pitr/pit-r(16)_z_v1-0e.xsd"/> 2.6.2 Nagłówek <xsd:complextype name="tnaglowek"> <xsd:documentation>nagłówek deklaracji</xsd:documentation> <xsd:sequence> <xsd:element name="kodformularza"> <xsd:complextype> <xsd:simplecontent> <xsd:extension base="tkodformularza"> <xsd:attribute name="kodsystemowy" type="xsd:string" use="required" fixed="pit-11 (20)"/> <xsd:attribute name="kodpodatku" type="xsd:string" use="required" fixed="pit"/> <xsd:attribute name="rodzajzobowiazania" type="xsd:token" use="required" fixed="z"/> <xsd:attribute name="wersjaschemy" type="xsd:string" use="required" fixed="2-0e"/> </xsd:extension> </xsd:simplecontent> </xsd:complextype> <xsd:element name="wariantformularza"> <xsd:restriction base="xsd:byte"> <xsd:enumeration value="20"/> <xsd:element name="celzlozenia"> <xsd:documentation>cel złożenia: 1 - złożenie informacji</xsd:documentation> <xsd:complextype> <xsd:simplecontent> <xsd:extension base="tcelzlozenia"> <xsd:attribute name="poz" type="xsd:string" use="required" fixed="p_6"/> </xsd:extension> </xsd:simplecontent> </xsd:complextype> <xsd:element name="rok"> <xsd:restriction base="etd:trok"> <xsd:mininclusive value="2013"/> <xsd:maxinclusive value="2020"/> <xsd:element name="kodurzedu"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="0000"/> </xsd:sequence> </xsd:complextype> 2.6.3 Deklaracja <xsd:element name="deklaracja"> <xsd:documentation>zbiorcza INFORMACJA O DOCHODACH ORAZ O POBRANYCH ZALICZKACH NA PODATEK DOCHODOWY</xsd:documentation> <xsd:complextype> <xsd:sequence> <xsd:element name="naglowek" type="tnaglowek"> <xsd:documentation>nagłówek deklaracji</xsd:documentation> <xsd:element name="podmiot1"> <xsd:complextype> <xsd:complexcontent> <xsd:extension base="etd:tpodmiotdowolnybezadresu2"> <xsd:attribute name="rola" type="xsd:string" use="required" fixed="płatnik"/> </xsd:extension> </xsd:complexcontent> </xsd:complextype> 18/56
<xsd:element name="pozycja" maxoccurs="5000"> <xsd:complextype> <xsd:sequence> <xsd:element name="kodurzedup" type="etd:tkodus"/> <xsd:element name="podmiot2"> <xsd:complextype> <xsd:complexcontent> <xsd:extension base="etd:tosobafizyczna1"> <xsd:attribute name="rola" type="xsd:string" use="required" fixed="podatnik"/> <xsd:attribute name="poz" type="xsd:string" use="required" fixed="p_10a"/> </xsd:extension> </xsd:complexcontent> </xsd:complextype> <xsd:element ref="pozycjeszczegolowe"> <xsd:documentation>informacja o kosztach uzyskania przychodu z tytułu stosunku służbowego, stosunku pracy, spółdzielczego stosunku pracy oraz pracy nakładczej, dochodach podatnika, pobranych zaliczkach oraz pobranych składkach, o przychodach zwolnionych od podatku oraz o załączniku.</xsd:documentation> <xsd:element name="zalaczniki" minoccurs="0"> <xsd:complextype> <xsd:sequence> <xsd:element ref="zr:zalacznik_pit-r" minoccurs="0"/> </xsd:sequence> </xsd:complextype> </xsd:sequence> <xsd:attribute name="typ" use="required" fixed="g"/> </xsd:complextype> <xsd:element name="pouczenie"> <xsd:restriction base="xsd:string"> <xsd:enumeration value="za uchybienie obowiązkom płatnika grozi odpowiedzialność przewidziana w Kodeksie karnym skarbowym."/> </xsd:sequence> </xsd:complextype> <xsd:unique name="klucz1osobafizyczna"> <xsd:selector xpath=".//etd:osobafizyczna"/> <xsd:field xpath="etd:nip"/> </xsd:unique> <xsd:unique name="klucz2osobafizyczna"> <xsd:selector xpath=".//etd:osobafizyczna"/> <xsd:field xpath="etd:pesel"/> </xsd:unique> <xsd:unique name="klucz3osobafizyczna"> <xsd:selector xpath=".//etd:osobafizyczna"/> <xsd:field xpath="etd:imiepierwsze"/> <xsd:field xpath="etd:nazwisko"/> <xsd:field xpath="etd:dataurodzenia"/> </xsd:unique> 2.6.4 Pozycje szczegółowe <xsd:element name="pozycjeszczegolowe"> <xsd:complextype> <xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>1. Należności ze stosunku: pracy, służbowego, spółdzielczego i z pracy nakładczej, a także zasiłki pieniężne z ubezpieczenia społecznego wypłacone przez zakład pracy, o którym mowa w art. 31 ustawy, oraz płatników, o których mowa w art. 42e ust. 1 ustawy</xsd:documentation> <xsd:element name="p_24" minoccurs="0"> <xsd:documentation>informacja o kosztach uzyskania przychodu. Koszty uzyskania przychodów, wykazane w poz. 26, zostały uwzględnione do wysokości przysługującej podatnikowi</xsd:documentation> <xsd:restriction base="xsd:byte"> <xsd:enumeration value="1"> <xsd:documentation>z jednego stosunku pracy (stosunków pokrewnych)</xsd:documentation> </xsd:enumeration> <xsd:enumeration value="2"> <xsd:documentation>z więcej niż jednego stosunku pracy (stosunków pokrewnych)</xsd:documentation> </xsd:enumeration> <xsd:enumeration value="3"> <xsd:documentation>z jednego stosunku pracy (stosunków pokrewnych), podwyższone w związku z zamieszkiwaniem podatnika poza miejscowością, w której znajduje się zakład pracy</xsd:documentation> </xsd:enumeration> <xsd:enumeration value="4"> <xsd:documentation>z więcej niż jednego stosunku pracy (stosunków pokrewnych), podwyższone w związku z zamieszkiwaniem podatnika poza miejscowością, w której znajduje się zakład pracy</xsd:documentation> 19/56
</xsd:enumeration> <xsd:element name="p_25" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_26" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>koszty uzyskania przychodów</xsd:documentation> <xsd:element name="p_27" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_28" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>dochód zwolniony od podatku</xsd:documentation> <xsd:element name="p_29" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> <xsd:sequence minoccurs="0"> <xsd:element name="p_30" type="etd:tkwota2nieujemna"> <xsd:documentation>przychody, do których zastosowano odliczenie kosztów uzyskania przychodów na podstawie art. 22 ust. 9 pkt 3 ustawy</xsd:documentation> <xsd:element name="p_31" type="etd:tkwota2nieujemna"> <xsd:documentation>koszty uzyskania przychodów na podstawie art. 22 ust. 9 pkt 3 ustawy</xsd:documentation> </xsd:sequence> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>2. Należności z tytułu członkostwa w rolniczej spółdzielni produkcyjnej lub innej spółdzielni zajmującej się produkcją rolną oraz zasiłki pieniężne z ubezpieczenia społecznego</xsd:documentation> <xsd:element name="p_32" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_33" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_34" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>3. Emerytury - renty zagraniczne</xsd:documentation> <xsd:element name="p_35" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_36" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_37" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>dochód zwolniony od podatku</xsd:documentation> <xsd:element name="p_38" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>4. Należności za pracę przypadające tymczasowo aresztowanym lub skazanym</xsd:documentation> <xsd:element name="p_39" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> 20/56
<xsd:element name="p_40" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_41" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>5. Świadczenia wypłacone z Funduszów: Pracy i Gwarantowanych Świadczeń Pracowniczych</xsd:documentation> <xsd:element name="p_42" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_43" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_44" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>6. Działalność wykonywana osobiście, o której mowa w art. 13 pkt 2, 4, 6 (z wyjątkiem czynności wymienionych w wierszu 7) i 7-9 ustawy, w tym umowy zlecenia i o dzieło</xsd:documentation> <xsd:element name="p_45" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_46" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>koszty uzyskania przychodów</xsd:documentation> <xsd:element name="p_47" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_48" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>7. Czynności związane z pełnieniem obowiązków społecznych lub obywatelskich (art. 13 pkt 5 i 6 ustawy)</xsd:documentation> <xsd:element name="p_49" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_50" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>koszty uzyskania przychodów</xsd:documentation> <xsd:element name="p_51" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_52" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>8. Prawa autorskie i inne prawa, o których mowa w art. 18 ustawy</xsd:documentation> <xsd:element name="p_53" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_54" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_55" type="etd:tkwotacnieujemna"> 21/56
<xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> <xsd:sequence minoccurs="0"> <xsd:element name="p_56" type="etd:tkwota2nieujemna"> <xsd:documentation>przychody, do których zastosowano koszty uzyskania przychodów na podstawie art. 22 ust. 9 pkt 1-3 ustawy</xsd:documentation> <xsd:element name="p_57" type="etd:tkwota2nieujemna"> <xsd:documentation>koszty uzyskania przychodów na podstawie art. 22 ust. 9 pkt 1-3 ustawy</xsd:documentation> </xsd:sequence> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>9. Należności wynikające z umowy aktywizacyjnej</xsd:documentation> <xsd:element name="p_58" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_59" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>koszty uzyskania przychodów</xsd:documentation> <xsd:element name="p_60" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_61" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:documentation>10. Inne źródła</xsd:documentation> <xsd:element name="p_62" type="etd:tkwota2nieujemna"> <xsd:documentation>przychód</xsd:documentation> <xsd:element name="p_63" type="etd:tkwota2nieujemna"> <xsd:documentation>dochód</xsd:documentation> <xsd:element name="p_64" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>dochód zwolniony od podatku</xsd:documentation> <xsd:element name="p_65" type="etd:tkwotacnieujemna"> <xsd:documentation>zaliczka pobrana przez płatnika</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:element name="p_66" type="etd:tkwota2nieujemna"> <xsd:documentation>składki na ubezpieczenia społeczne, o których mowa w przepisach ustawy, podlegające odliczeniu od dochodu</xsd:documentation> <xsd:element name="p_67" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>w tym zagraniczne, o których mowa w art. 26 ust. 1 pkt 2a ustawy</xsd:documentation> </xsd:sequence> <xsd:sequence minoccurs="0"> <xsd:element name="p_68" type="etd:tkwota2nieujemna"> <xsd:documentation>składki na ubezpieczenie zdrowotne, o których mowa w przepisach ustawy, podlegające odliczeniu od podatku</xsd:documentation> <xsd:element name="p_69" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>w tym zagraniczne, o których mowa w art. 27b ust. 1 pkt 2 ustawy</xsd:documentation> </xsd:sequence> <xsd:element name="p_70" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>przychody otrzymywane z zagranicy, o których mowa w art. 21 ust. 1 pkt 74 ustawy, między innymi renty inwalidzkie z tytułu inwalidztwa wojennego</xsd:documentation> 22/56
<xsd:element name="p_71" type="etd:tkwota2nieujemna" minoccurs="0"> <xsd:documentation>przychody pochodzące ze środków bezzwrotnej pomocy zagranicznej, o których mowa w art. 21 ust. 1 pkt 46 ustawy</xsd:documentation> <xsd:element name="p_72" type="etd:twybor1_2"> <xsd:documentation>do niniejszej informacji dołączono informację PIT-R: 1- tak, 2 - nie</xsd:documentation> </xsd:sequence> </xsd:complextype> 23/56
2.7 Zakres informacyjny dokumentu elektronicznego W rozdziale tym został opisany zakres informacyjny elementów wchodzących w skład dokumentu elektronicznego. W dokumencie elektronicznym nie należy umieszczać elementów, które nie zawierają treści (nie zostały wypełnione), a ich występowanie nie zostało narzucone przez schemat XSD. Oznacza to, że w przypadku elementów niewymaganych, które nie zostały wypełnione, nie należy ich umieszczać w dokumencie jako pustych znaczników w postaci <Nazwa></Nazwa> lub <Nazwa/>. Dotyczy to zarówno elementów prostych (np. nie wypełnionych treści pól formularza) jak i elementów złożonych. Umieszczanie pustych elementów nie jest niezgodne z ogólnymi regułami tworzenia dokumentów XML, jednak zalecane jest nieumieszczanie elementów zbędnych, nie przenoszących żadnej informacji. Zgodnie z definicją schematu XML, dokument elektroniczny musi zawierać jeden dokument (dokument główny lub zestaw składający się z dokumentu głównego i załączników). Każdy dokument musi być opatrzony bezpiecznym podpisem elektronicznym (weryfikowanym przy pomocy ważnego kwalifikowanego certyfikatu) lub musi być opatrzony danymi autoryzacyjnymi. 2.8 Kodowanie znaków dokumentu elektronicznego Uzyskanie poprawnych znaków w dokumencie XML wymaga zadeklarowania użytego zestawu i użycia znaków w tym zestawie. W dokumentach wysyłanych do systemu e-deklaracje2 musi być stosowane kodowanie UTF-8. Atrybut kodowania w dokumencie XML powinien wystąpić na początku dokumentu i mieć postać: <?xml version= 1.0 encoding= UTF-8?> 2.9 Potwierdzanie autentyczności przesyłanych dokumentów Autentyczność dokumentu można potwierdzić na dwa sposoby: Potwierdzając dokument bezpiecznym podpisem elektronicznym Dołączając do dokumentu dane autoryzujące Dla dokumentów podpisanych i niepodpisanych (potwierdzonych danymi autoryzującymi) istnieją osobne dedykowane operacje usługi UBD. Trzeba upewnić się czy dana metoda potwierdzania jest dostępna dla danego rodzaju dokumentu. 2.10 Postać kanoniczna dokumentu elektronicznego Przed podpisaniem dokumentu XML wymagana jest postać kanoniczna XML, w tym porządek leksykograficzny dla użytych deklaracji przestrzeni nazw i atrybutów elementów. Przykład dla lepszego zobrazowania porządku leksykograficznego fragment danych XML zaprezentowany w formacie pretty print Przykładowy przygotowany dokument elektroniczny w formacie XML zgodny ze wzorem opublikowanym w Repozytorium CRD epuap (crd.gov.pl) interesujący nas fragment XML przed uporządkowaniem leksykograficznym: <?xml version="1.0" encoding="utf-8" standalone="yes"?> <Deklaracja xmlns="http://crd.gov.pl/wzor/2013/12/04/1997/" xmlns:ns2="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/ed/definicjetypy/" xmlns:ns3="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2013/09/18/ed/pitr/"> <Naglowek> <KodFormularza rodzajzobowiazania="z" kodsystemowy="pit-11 (20)" kodpodatku="pit" wersjaschemy="2-0e">pit-11z</kodformularza> <WariantFormularza>20</WariantFormularza> 24/56
<CelZlozenia poz="p_6">1</celzlozenia> <Rok>2013</Rok> <KodUrzedu>0000</KodUrzedu> </Naglowek> <Podmiot1 rola="płatnik"> Przykładowy przygotowany dokument elektroniczny w formacie XML zgodny ze wzorem opublikowanym w Repozytorium CRD epuap (crd.gov.pl) fragment XML po uporządkowaniu leksykograficznym (atrybuty): <?xml version="1.0" encoding="utf-8" standalone="yes"?> <Deklaracja xmlns="http://crd.gov.pl/wzor/2013/12/04/1997/" xmlns:ns2="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/ed/definicjetypy/" xmlns:ns3="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2013/09/18/ed/pitr/"> <Naglowek> <KodFormularza kodsystemowy="pit-11 (20)" kodpodatku="pit" rodzajzobowiazania="z" wersjaschemy="2-0e">pit-11z</kodformularza> <WariantFormularza>20</WariantFormularza> <CelZlozenia poz="p_6">1</celzlozenia> <Rok>2013</Rok> <KodUrzedu>0000</KodUrzedu> </Naglowek> <Podmiot1 rola="płatnik"> 2.11 Podpisanie bezpiecznym podpisem dokumentu elektronicznego 1. Potwierdzenie bezpiecznym podpisem elektronicznym jest obsługiwane dla wszystkich deklaracji zbiorczych i pojedynczych oraz pism ogólnych. 2. Przed podpisaniem deklaracja musi zostać odpowiednio przygotowana: Dokument XML musi być w postaci kanonicznej Kompresja: o W pierwszym kroku deklaracja zbiorcza (PIT-11Z, PIT-8CZ, PIT-40Z, PIT-RZ) powinna zostać skompresowana przy użyciu algorytmu ZIP o (metoda DEFLATE). Dokumentów pojedynczych nie wolno kompresować musza pozostać w formie tekstowej. Ostatnim krokiem przed podpisaniem jest zakodowanie danych algorytmem base64 3. Zakodowaną algorytmem base64binary deklarację opatruje się podpisem elektronicznym z wykorzystaniem jednego z formatów określonych przez: a. specyfikację techniczną ETSI TS 101 903 XML Advanced Electronic Signatures (XAdES Basic Electronic Signature, w skrócie XAdES-BES) wydaną przez European Telecommunications Standards Institute, w którym do przygotowania formy kanonicznej deklaracji wykorzystano standardową metodę wyspecyfikowaną w standardzie XMLDSIG oraz treść podpisywanej deklaracji została umieszczona w elemencie ds:object. Atrybut Id dla elementu ds:object zawierającego deklarację musi przyjmować wartość "Dokument", b. dokument PKCS#7 Cryptographic Message Syntax Standard wydany przez RSA Security. 4. Do podpisania danych i zapisania ich w formacie: a. XML-dsig typu enveloped muszą być użyte algorytmy: CanonicalizationMethod Algorithm=http://www.w3.org/TR/2001/REC-xml-c14n-20010315 SignatureMethod Algorithm=http://www.w3.org/2000/09/xmldsig#rsa-sha1 DigestMethod Algorithm=http://www.w3.org/2000/09/xmldsig#sha1 Transform Algorithm= http://www.w3.org/2000/09/xmldsig#enveloped-signature b. PKCS#7 muszą być użyte atrybuty: - contenttype (typ zawartości) contenttype ATTRIBUTE ::= { WITH SYNTAX ContentType EQUALITY MATCHING RULE objectidentifiermatch SINGLE VALUE TRUE ID pkcs-9-at-contenttype } 25/56
ContentType ::= OBJECT IDENTIFIER - messagedigest (skrót zawartości) messagedigest ATTRIBUTE ::= { WITH SYNTAX MessageDigest EQUALITY MATCHING RULE octetstringmatch SINGLE VALUE TRUE ID pkcs-9-at-messagedigest } MessageDigest ::= OCTET STRING 5. a. Podpisany dokument w formacie XAdES musi zawierać następujące elementy: element KeyInfo zawierający X509Certificate element Object zawierający SigningCertificate b. Podpisany dokument w formacie PKCS#7 musi zawierać następujące elementy: element SignedData zawierający version, digestalgorithms, contentinfo, signerinfos 6. Podpisany dokument XML jest umieszczany w komunikacie wywołującym operację webserwisu w postaci zakodowanej algorytmem base64 (jest to drugie kodowanie base64 w ramach przygotowania dokumentu). 2.11.1 Przykładowy dokument XML podpisany bezpiecznym podpisem weryfikowanym przy pomocy ważnego kwalifikowanego certyfikatu, gotowy do zakodowania base64 i umieszczenia w elemencie <Dokument> w komunikacie wywołującym operację wyslijpismoogolne <?xml version="1.0" encoding="utf-8"?><signatures Id="ID-14915f5a-d114-3fcc-032b-a07ff514c84b"> <ds:signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="ID-14915f5a-d114-3fcc-032b-a07ffefae319"> <ds:signedinfo Id="ID-14915f5a-d114-3fcc-032b-a07ff8f48796"> <ds:canonicalizationmethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <ds:signaturemethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <ds:reference Id="ID-14915f5a-d114-3fcc-032b-a07ff9d229b6" URI="#ID-14915f5a-d114-3fcc-032b-a07ffcd3f0d7"> <ds:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:digestvalue>ypet6uhhy91rba4jvjmjrzg1pgy=</ds:digestvalue> </ds:reference> <ds:reference Id="ID-14915f5a-d114-3fcc-032b-a07ff73b4465" URI="#ID-14915f5a-d114-3fcc-032b-a07ffb5c52ee" Type="http://uri.etsi.org/01903#SignedProperties"> <ds:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:digestvalue>e1+1cwaumm8icv8gbfact7jgdza=</ds:digestvalue> </ds:reference> </ds:signedinfo> <ds:signaturevalue Id="ID-14915f5a-d114-3fcc-032ba07ff67e9133">dq8ElJjGt9grXpAlRvkqKXfzm74ujdgTtry4J1Dp4llk2QdhUOPCwSfhmKmMwdO+IEeKxQ43PAH939wc pg9/o1koa65g/dikin6gvrxjujhmvs3kn6nyhydmymu8t1mzezfqihdnzuacc+nmxycwxq3axlsuqg84 D4a53FoCzwo=</ds:SignatureValue> <ds:keyinfo> <ds:x509data> <ds:x509certificate>miie2dcca8cgawibagiic3zcnjqllqgwdqyjkozihvcnaqewbqawgykxfdasbgnvbautcw5yihdwaxn1 OiAzMQswCQYDwQQGEwJeTDE4MDYGA1UECgwvUG9sc2thIFd5dHfDs3JuaWEgUGFwaWVyw7N3IFdhwnRv xztjaw93ewnoifmuqs4xkjaobgnwbammivnpz2lsbhvtifbdq0uglsbrd2fsawzpa293yw55ienbmtae Fw0xNwAxMzAyMzAwMDBaFw0xNjAxMzAyMzAwMDBaMIGeMQswCQYDVQQGEwJQTwEUMBIGA1UECAwebWF6 b3dpzwnrawuxhjacbgnvbacmfu5vd3kgrhfds3igtwf6b3dpzwnratesmbaga1uebawjunv0a293c2tp MQ4wDAYDVQQqDAVKYWNlazEbMBkGA1UEBRMSUEVTRUw6IDc2MDIwOTA1NDU2MRgwFgYDVQQDDA9KYWNl aybsdxrrb3dza2kwgz8wdqyjkozihvcnaqewbqadgy0amigjaogbak0tsoyls18bexsmvvcvaokirdyv +w9/3opqanmh7txicmcqeymea9pioigbupn6mdf6lizqabdcyolgoiudid4mzbhgzauexsccifgew3pt 6twe65bAHO80pIfTmwwi9e3od6wyvGOyoteEiqUbkdzXI9f/v9bsAVdtZaMBOguvAgMBAAGjggGvMIIB qwahbggrbgefbqcbaweb/wqsmbawdgyjkoroawudaqeccgebmcaga1udeqqzmbebfwpydxrrb3dza2la c3lnbml0es5wbdambgnvhrmbaf8eajaamb8ga1udiwqymbaafor6b0zklkkm6cqlup86idnelgq1miib IwYDVR0gAQH/BIIBFzCCARMwggEPBgsqhGgBhvcYCgEBADCB/zCBwwYIKwYBBQUHAgIwgbYMgbNDZXJ0 ewzpa2f0ihbvd3n0ycwcihcgb3bhcmnpdsbvifbvbgl0ewtpifbdq0ugzgxhienlcnr5zmlryxtds3cg S3dhbGlmaWtvd2FueWNoLiBUcmXFm8SHIFBvbGl0eWtpIG9yYXogUmVneWxhbWluIFBDQ0Ugem5hamR1 amugc2nemsbwb2qgywryzxnlbsbodhrwoidvd3d3lnnpz2lsbhvtlnbsl3jlcg96exrvcml1bta3bggr BgEFBQcCARYraHR0cDovL3d3dy5zaWdpbGx1bS5wbC9zaWctY21zd3MvcGFnZS8/RDs4ODAOBgNVHQ8B Af8EBAMCBkAwDQYJKoZIhvcNAQEFBQADggEBADF5Yth1gLcZSBlqhG3Q12esCb5cZV+IzHWHLQBap7JY O/AP6Q8EcSIujD3Ab5KMEmLqPYR7jCd3lAa1eKxwpKWsPYgi5gvCOY+3l3UMiIl31McIAcDW3OPrAwfs p2zl7depodjeuct4fafu7bd2h2cspabuywu3p7/2pok9nevcwfcs/kwh2f8phpf10mjukhzgtdbvfyjw UE+/9dHLL5PXrAleuVflefR2IoIwjcAN5a6v4V0hA8hDxV4IRazYrYOHxDFVZFIKAg96OngGtKM1Savb CGG6J/lpTDpFo+F4y9DhPZhAFg/+tLt4XamKF8Nj8G+cWJR7ZLtQmy4n9X8=</ds:X509Certificate> </ds:x509data> </ds:keyinfo> <ds:object> <xades:qualifyingproperties xmlns:xades="http://uri.etsi.org/01903/v1.3.2#" Id="ID-14915f5a-d114-3fcc-032b-a07ffa938ec6" Target="#ID- 14915f5a-d114-3fcc-032b-a07ffefae319"> <xades:signedproperties Id="ID-14915f5a-d114-3fcc-032b-a07ffb5c52ee"> <xades:signedsignatureproperties> <xades:signingtime>2014-02-04t11:55:07z</xades:signingtime> <xades:signingcertificate> <xades:cert> <xades:certdigest> <ds:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:digestvalue>obulsg3ilbsnoxjkfxluqp2vbyo=</ds:digestvalue> </xades:certdigest> <xades:issuerserial> 26/56
<ds:x509issuername>cn=sigillum PCCE - kwalifikowany CA1,O=Polska Wytwórnia Papierów Wartościowych S.A.,C=PL,serialNumber=Nr wpisu: 99</ds:X509IssuerName> <ds:x509serialnumber> xxxxxxxx </ds:x509serialnumber> </xades:issuerserial> </xades:cert> </xades:signingcertificate> </xades:signedsignatureproperties> <xades:signeddataobjectproperties> <xades:dataobjectformat ObjectReference="#ID-14915f5a-d114-3fcc-032b-a07ffcd3f0d7"> <xades:description>binary_format [ZIP]</xades:Description> <xades:mimetype>text/plain</xades:mimetype> <xades:encoding>http://www.w3.org/2000/09/xmldsig#base64</xades:encoding> </xades:dataobjectformat> </xades:signeddataobjectproperties> </xades:signedproperties> </xades:qualifyingproperties> </ds:object> <ds:object Encoding="http://www.w3.org/2000/09/xmldsig#base64" Id="ID-14915f5a-d114-3fcc-032b-a07ffcd3f0d7" MimeType="text/plain"> UEsDBBQACAgIANRmREQAAAAAAAAAAAAAAAAMAAAAUElUXzExX1oueG1s7ZjNbuM2EMfveQpBp/bgUJRI2g5sLYKmWaS7mwj5wAK5BIzMTWR90JDkVa1jgaIP0dfZfa9S1siRM3GK 3aJAUdiAIYl/znD4IzkaaPLm1zSxPqu8iHQ2temhY1sqC/Usyh6m9s316WBkW0Ups5lMdKam9koV9hv/YHKi4kTmMpxLy3jIiqn9WJaLI0LCfHb4oD8fLhJS1TonrkM9Ql3iMELH 4yGx2/5HWeG+ZGNEUoSPKpXliszqSJl/pitF0k+NK0ocQVxK1Ak5UZ+iLArn6nq1WPXcet/h1iPOmNBR4zY4u74ktn9gmd/kXD4kplfcPq6b3unZqc7TpZl9La1Yz65WRalSXa2m tredugr94do/2o0u6jks4+vask1cz2o5v9x3uopklbnitu1b26om/lm8aoizltyb87ptt45uj2rrtf4uh2ueyazsaa4zibj1yeinldwmulzmwguhaxptnbb9oie9odf9usd+a2zc mrut6d/ktzotfcf81ghcc0umbcobgarppetqzp+y+qzff5nlfsv2z6xzcucxhb6x55fz0nov1lkvkk2x87papynqrnwpkyaka8m9a5vk8lzwlftpzk8vbshlxcvpa9ctngiguyoy kg4cm/ky2wz6crwy2m/tl8gevum6bg9nl8aoh9vxahziw6nbe+oc2y9mar3d6ytwtgb53puyhzox7wc06x2wriqivf4vtfkbhzunndksdoxkaezfrp3uprpdcc/bnchs3jthyl3z TDowu300cIet8ba6zYD8DYS1++NZropbaeIv6rg5X3Dk1u3mFF4en9g7Ilt3CXSC5U0Xs5zvcjlf+sH7NpxNw26bj3quKhNDWWn/g6zNwVdhHKnWvi/udhE02aL0zdEualkVcQQb uw3ebfc2jqwkmjotudu22+ymiulpy+tq+kxlutzjlbabcftxt/f5fqltpe/r7my2z68zvnextjb+qns9xcnumw+rmhehrnqrpptbx3l1eqmd1qvj1+audtiybdzy0/7awpguz6fc I95XZPfG6mn9/drPSV2i2ModTe5RV3VYqwfdZNlnXoM7lzUpfX1FEvedtcSxJEASWBqCNMTSCKQRlsYgjZHkOa1krkiiIFEsuSC5WPJA8rDEQMI0PKDhYRoe0PAwDQ9oeJiGBzQ8 TMMDGh6mwYAGwzQY0GCYBgMaDNNgQINhGgxoMEyDAQ2GaTCgwTANBjQYpsGABsM0GNBgmAYHGhzT4ECDYxocaHBMgwMNjmlwoMExDQ40OKbBgQbHNDjQ4JgGBxoc0+BAg2MaAmgI TEMADYFpCKAhMA0BNASmIYCGwDQE0BCYhgAaAtMQQENgGgJoCExDAA2BaQyBxhDTGAKNIaYxdNt8OOznUbIrkXZKV/z9x4s9yqigjHuUfnuxR/9BsUe/q9ij3sChA5fti73/T7Hn Mv6txR4X+2JvX+zti71n0r7Y60v7Yq8v7Yu9vvTvFXvLsKlGlH8rrWX4uLqPmidr/b32y+91rFNrAZ8vpfVgXpmRpWeL5jU/qyOZZPrrn1/+sBamCqyipiWTVmWZd42KC+Mmlnm2 Sq3CXI3DVXrYjN+NeDAhTx/U/YO/AFBLBwioV5GCtAQAAJYXAABQSwECFAAUAAgICADUZkREqFeRgrQEAACWFwAADAAAAAAAAAAAAAAAAAAAAAAAUElUXzExX1oueG1sUEsFBgAA AAABAAEAOgAAAO4EAAAAAA== </ds:object> </ds:signature> </Signatures> 2.12 Potwierdzanie autentyczności Pism Ogólnych Pisma ogólne muszą być potwierdzane przy użyciu podpisu elektronicznego. W odróżnieniu od pozostałych dokumentów podpis dla pism ogólnych jest typu Enveloped tzn. pole z podpisem znajduje się w strukturze, która jest podpisywana. Dla pism ogólnych dane podpisu znajdują się w elemencie Signature. Obsługiwany jest tylko podpis kwalifikowany w oparciu o XAdES-BES. 2.12.1 Przykładowy podpisany dokument z Pismem Ogólnym, gotowy do zakodowania base64 i umieszczenia w elemencie <Dokument> w komunikacie wywołującym operację wyslijpismoogolne <?xml version="1.0" encoding="utf-8" standalone="no"?> <Dokument xmlns="http://crd.gov.pl/wzor/2011/06/08/599/" xmlns:adr="http://crd.gov.pl/xml/schematy/adres/2009/11/09/" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:meta="http://crd.gov.pl/xml/schematy/meta/2009/11/16/" xmlns:oso="http://crd.gov.pl/xml/schematy/osoba/2009/11/16/" xmlns:str="http://crd.gov.pl/xml/schematy/struktura/2009/11/16/" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <OpisDokumentu/> <DaneDokumentu/> <TrescDokumentu format="string" kodowanie="base64"> <Tytul>String</Tytul> <RodzajWnioskuRozszerzony/> </TrescDokumentu> <ds:signature Id="ID-0475b2d8-7114-5992-252f-807fff396de7"> <ds:signedinfo Id="ID-0475b2d8-7114-5992-252f-807ffb40e93f"> <ds:canonicalizationmethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/> <ds:signaturemethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/> <ds:reference Id="ID-0475b2d8-7114-5992-252f-807ffc3f2f80" URI=""> <ds:transforms> <ds:transform Algorithm="http://www.w3.org/TR/1999/REC-xpath-19991116"> <ds:xpath xmlns="http://uri.etsi.org/01903/v1.3.2#">not(ancestor-or-self::ds:signature)</ds:xpath> </ds:transform> </ds:transforms> <ds:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:digestvalue>uxilchsrhpgz7pkmpto0p9cntbu=</ds:digestvalue> </ds:reference> <ds:reference Id="ID-0475b2d8-7114-5992-252f-807ffa2d3554" Type="http://uri.etsi.org/01903#SignedProperties" URI="#ID-0475b2d8-7114-5992-252f-807ffe169acc"> <ds:digestmethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/> <ds:digestvalue>2gficozkivb1cta3oxaq1xh++wm=</ds:digestvalue> </ds:reference> </ds:signedinfo> <ds:signaturevalue Id="ID-0475b2d8-7114-5992-252f- 807ff9b41a36">YfDIqUfdA4R9iEoOZ2PSpBB9BR3/F+Lzj47rUgbYokK/RVDOed46mo9ZPL+IC/AgoU1kSM7lXe4UWLHy 98X72I6FHs2za+1jD8x0G2edCN9m8egAW13F+dLUp1na7zWZQ9bPc5MgqU/ru/QpCcJJ+cqegHo6BTG2 R659yEkSnsSucTzNQqD9haadShQoA4VI4ElSTZcYsyblAxl/WyfuKmH9BTu8LFt9ctJhCVJ5EXGU3J7K MnWVBotYpjvVZCR3Gcoh3mymHGl4ZuIp4aBvAuZzKQzYihd/FA7dEH/8culLO7XsxBxrTZFWCTWdzwLK qrqns4dka6sjua4dnffmog==</ds:signaturevalue> <ds:keyinfo> <ds:x509data> <ds:x509certificate>miidxtccakwgawibagibezanbgkqhkig9w0baqufadbwmqswcqydvqqgewjwbdetmbega1uecawku29t ZS1TdGF0ZTERMA8GA1UEBwwIV2Fyc3phd2ExETAPBgNVBAoMCHRlc3R5X2NhMQwwCgYDVQQLDANzeWcw HhcNMTQwMzI3MTMyMzA0WhcNMjIwODE3MTMyMzA0WjByMR0wGwYDVQQDDBRNaXJvc8WCYXdhIER5d2/F hhnrytelmakga1uebhmcuewxezarbgnvbcomck1pcm9zxyjhd2exejaqbgnvbaqmcur5d2/fhhnryteb KqJ/+uGavhtZ6olkCt1CmADNCvPP5bWegpzWVVv/KikkLSKIHK3vwjV8MHAWfe/IU5L7zLk/IIRaBEyf qdyhq/mapned/v4/tsjdvrzn3e9ii/1pxfbpu2z/fsbkwkrt3hfgtedlqq5fhkbomxysyf2lhtrm43ra Fkib47SOiiMAEcfJOkKGP5O4fEaLzWfYVl97T9izEJ6qh43o2sRnvJD3OsY7qW49LHjdnjrA85o4KDZr pi2hg44bmcnxdhnse2hlfqidaqaboxowgdajbgnvhrmeajaamasga1uddwqeawif4danbgkqhkig9w0b AQUFAAOCAQEAQWr0BddWWUpHP4WVGA6fk3nwu4JLZLPblBW6NHSBU41tpnofaXvP6S+HF0C+LabzrHoi obno+eiiargcaymdj2ssg02zoasp7cinfco6y2b7pazkshjt+zzblpnjzlmpxu6t7sspmcsq2uejy3m2 27/56