e-Deklaracje Specyfikacja We

Transkrypt

Ministerstwo Finansów
Departament Informatyki
System e-Deklaracje
Specyfikacja Wejścia-Wyjścia
Wersja 1.9.3
Warszawa, 12.07.2013 r.
Copyright (c) 2013 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: [email protected]
1/55
Projekt e-Deklaracje 2
Historia dokumentu
Wersja Data wersji
Opis
1.3
2009-04-08
Modyfikacja
Akcja
(*)
W, Z
Rozdziały
(**)
1.4
2009-12-31
Modyfikacja
W, N, Z
1.5
2010-12-31
Modyfikacja
W, N, Z
1.5.1
2011-01-10
Modyfikacja
W, N, Z
1.5.2
2011-02-10
Modyfikacja
W, N, Z
1.6
2012-01-10
Modyfikacja
W, N, Z
1.7
2012-03-26
Modyfikacja
W, N, Z
1.8.0
2012-10-01
Modyfikacja
W, N, Z
1.9.0
2013-01-02
Modyfikacja
W, N, Z
1.9.1
2013-04-18
Modyfikacja
W, N, Z
1.9.2
2013-07-01
Modyfikacja
W, N, Z
1.4, 2, 2.2,
2.3, 2.4, 2.5,
2.5.5, 2.6,
2.9, 2.10, 3.4,
3.5, 4.1, 4.2,
4.3, 4.4
1.2, 1.3, 1.4,
2, 2.4, 2.5,
2.6, 2.8, 2.11,
2.12, 3.1, 3.5,
4.2, 4.3, 4.4,
4.5, 4.6
1.4, 2, 2.5.5,
2.6, 4.4.2
1.4, 2, 2.2.2,
2.5.5, 2.6,
2.8, 2.11,
2.11.1,
2.11.2,
2.11.3, 3.1,
3.2, 4.4.3
1.4, 2,
2.2.1.2, 2.5.5,
2.6
1.4, 4.4.2
1.9.3
2013-07-12
Modyfikacja
W, Z
1.4, 4.4.2
Autorzy
Zatwierdził
(***)
1.4, 2, 2.5
2.6, 2.8, 2.9,
3, 4
1.4, 2, 4.3,
4.5, 4.6
1.4, 2, 2.2.1,
2.2.2, 2.2.5,
2.5.5, 2.6,
3.4, 4, 4.2,
4.4.2
1.4, 2.3, 2.4,
2.9, 2.10,
4.2.2, 4.4.2
1.4, 3.1
(*) 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.
Informacja o zmianach w wersji 1.9.3
Dokument specyfikacji zmodyfikowany w związku ze zmianą opisu dla statusu błędu „423”.
Dokument specyfikacji zmodyfikowany w związku z publikacją w repozytorium CRD nowych wzorów XSD
oraz rozszerzeniem funkcjonalności systemu (nowe statusy błędu „423”, „424”, „425”).
2/55
Dokument specyfikacji zmodyfikowany w związku z publikacją w repozytorium CRD nowych wzorów XSD.
Dokument specyfikacji zmodyfikowany w związku z publikacją w CRD nowych wzorów XSD oraz
Rozporządzenia [34] Ministra Finansów z dnia 24 grudnia 2012 r. (Dz.U. z dnia 31.12.2012 r. poz. 1537).
Ponadto dodano w rozdziale 2.8 opis wymagania dotyczącego postaci kanonicznej dokumentu elektronicznego.
Dokument specyfikacji zmodyfikowany w związku z publikacją Rozporządzenia [32] i zmianami :
 funkcjonalności systemu e-Deklaracje i dodaniem obsługi kolejnej grupy deklaracji elektronicznych z
podpisem elektronicznym nieweryfikowanym za pomocą ważnego kwalifikowanego certyfikatu (dane
autoryzujące) obejmującej VAT-7(12), VAT-7D(3), VAT-7K(6) i PCC-3(2);
 funkcjonalności systemu e-Deklaracje i zmianą opisu dla statusów błędów „410”, „411”, „412”, „414”
oraz dodaniem nowego statusu błędu „422”.
3/55
Spis treści
1. WPROWADZENIE...................................................................................................................................... 6 1.1 1.2 1.3 1.4 PRZEZNACZENIE ...................................................................................................................................... 6 ZAKRES ................................................................................................................................................... 6 DEFINICJE, AKRONIMY, SKRÓTY ............................................................................................................. 6 REFERENCJE ............................................................................................................................................ 7 2. PREZENTACJA STRUKTURY DOKUMENTU ELEKTRONICZNEGO......................................... 10 2.1 OPIS STRUKTURY ................................................................................................................................... 10 2.2 GRAFICZNA PREZENTACJA STRUKTURY PRZYKŁADOWEGO DOKUMENTU – DEKLARACJA ....................... 10 2.2.1 Graficzna prezentacja struktury przykładowego dokumentu – element Naglowek ...................... 11 2.2.1.1 2.2.1.2 Graficzna prezentacja struktury przykładowego dokumentu – element Podmiot1 .................................... 12 Graficzna prezentacja struktury przykładowego dokumentu – element Podmiot1 bez adresu .................. 13 2.2.2 Graficzna prezentacja struktury przykładowego dokumentu – element PozycjeSzczegolowe ...... 14 2.2.3 Graficzna prezentacja struktury przykładowego dokumentu – element Zalaczniki ...................... 15 2.2.4 Graficzna prezentacja struktury przykładowego dokumentu – element DaneAutoryzujace ......... 16 2.2.5 Graficzna prezentacja struktury przykładowego dokumentu – element DaneAutoryzujaceVAP . 16 2.3 GRAFICZNA PREZENTACJA STRUKTURY PRZYKŁADOWEGO DOKUMENTU - ZAŁĄCZNIK .......................... 17 2.3.1 Graficzna prezentacja struktury przykładowego dokumentu ........................................................ 17 2.4 GRAFICZNA PREZENTACJA STRUKTURY DOKUMENTU – POTWIERDZENIE (UPO).................................... 18 2.4.1 Graficzna prezentacja struktury dokumentu ................................................................................. 18 2.5 ELEMENTY STRUKTURY PRZYKŁADOWEGO DOKUMENTU DEKLARACJA ................................................. 19 2.5.1 Prolog XML wzoru dokumentu ..................................................................................................... 19 2.5.2 Nagłówek ...................................................................................................................................... 19 2.5.3 Deklaracja .................................................................................................................................... 20 2.5.4 Pozycje szczegółowe ..................................................................................................................... 21 2.5.5 Podpis elektroniczny nieweryfikowany za pomocą ważnego kwalifikowanego certyfikatu (dane
autoryzujące) ................................................................................................................................................ 22 2.5.5.1 Struktura logiczna podpisu elektronicznego nieweryfikowanego za pomocą ważnego kwalifikowanego
certyfikatu (dane autoryzujące) .................................................................................................................................. 22 2.5.6 Podpis elektroniczny nieweryfikowany za pomocą ważnego kwalifikowanego certyfikatu (dane
autoryzujące VAP) ........................................................................................................................................ 23 2.5.6.1 Struktura logiczna podpisu elektronicznego nieweryfikowanego za pomocą ważnego kwalifikowanego
certyfikatu (dane autoryzujące VAP) .......................................................................................................................... 23 2.6 2.7 2.8 2.9 2.10 ZAKRES INFORMACYJNY DOKUMENTU ELEKTRONICZNEGO ................................................................... 25 KODOWANIE ZNAKÓW DOKUMENTU ELEKTRONICZNEGO ...................................................................... 25 POSTAĆ KANONICZNA DOKUMENTU ELEKTRONICZNEGO ....................................................................... 25 PODPISANIE BEZPIECZNYM PODPISEM DOKUMENTU ELEKTRONICZNEGO ............................................... 26 PRZYKŁADOWY DOKUMENT XML PODPISANY BEZPIECZNYM PODPISEM WERYFIKOWANYM PRZY
POMOCY WAŻNEGO KWALIFIKOWANEGO CERTYFIKATU .................................................................................... 27 2.11 PRZYKŁADOWY DOKUMENT XML PODPISANY PODPISEM ELEKTRONICZNYM NIEWERYFIKOWANYM ZA
POMOCĄ WAŻNEGO KWALIFIKOWANEGO CERTYFIKATU .................................................................................... 29 2.11.1 Przykładowy dokument XML podpisany podpisem elektronicznym nieweryfikowanym za pomocą
ważnego kwalifikowanego certyfikatu (w postaci kanonicznej) ................................................................... 30 2.11.2 Przykładowy dokument XML podpisany podpisem elektronicznym nieweryfikowanym za pomocą
ważnego kwalifikowanego certyfikatu (w postaci zakodowanej base64Binary) .......................................... 30 2.12 PRZYKŁADOWY DOKUMENT XML PODPISANY PODPISEM ELEKTRONICZNYM NIEWERYFIKOWANYM ZA
POMOCĄ WAŻNEGO KWALIFIKOWANEGO CERTYFIKATU .................................................................................... 31 2.13 PRZYKŁADOWY DOKUMENT XML ZAWIERAJĄCY WSKAZANE WE WZORZE XSD ZAŁĄCZNIKI............... 31 3. PRZESYŁANIE DOKUMENTU ELEKTRONICZNEGO DO SYSTEMU E-DEKLARACJE ........ 37 3.1 3.2 3.3 3.4 3.5 USTANOWIENIE SESJI ............................................................................................................................. 37 WYSYŁANIE DOKUMENTU ..................................................................................................................... 37 POBIERANIE DOKUMENTU (POTWIERDZENIA) ........................................................................................ 37 INFORMACJE DODATKOWE ZAWARTE W POBIERANYM DOKUMENCIE (POTWIERDZENIU)........................ 38 STRUKTURA LOGICZNA URZĘDOWEGO POŚWIADCZENIA ODBIORU (UPO) ............................................. 39 4. SPECYFIKACJA USŁUGI WEB SERVICE .......................................................................................... 42 4/55
FUNKCJE USŁUGI WEB SERVICE ........................................................................................................................ 42 4.1 USŁUGA SENDDOCUMENT ..................................................................................................................... 42 4.1.1 Opis ogólny ................................................................................................................................... 42 4.1.2 Opis szczegółowy .......................................................................................................................... 42 Możliwe statusy dokumentu: ...................................................................................................................................... 42 4.1.3 Przykład wykorzystania ................................................................................................................ 43 Dane wysłane do Web Service: .................................................................................................................................. 43 Dane zwrócone przez Web Service: ........................................................................................................................... 43 4.2 USŁUGA SENDUNSIGNDOCUMENT......................................................................................................... 44 4.2.1 Opis ogólny ................................................................................................................................... 44 4.2.2 Opis szczegółowy .......................................................................................................................... 44 Możliwe statusy dokumentu: ...................................................................................................................................... 44 4.2.3 Przykład I wykorzystania .............................................................................................................. 45 4.2.4 Przykład II wykorzystania usługi .................................................................................................. 45 Dane wysłane do Web Service: .................................................................................................................................. 45 Dane zwrócone przez Web Service: ........................................................................................................................... 45 Dane wysłane do Web Service: .................................................................................................................................. 45 Dane zwrócone przez Web Service: ........................................................................................................................... 45 4.3 USŁUGA SENDDOCUMENTWITHATTACHMENT...................................................................................... 46 4.3.1 Opis ogólny ................................................................................................................................... 46 4.3.2 Opis szczegółowy .......................................................................................................................... 46 Możliwe statusy dokumentu: ...................................................................................................................................... 46 4.3.3 Przykład wykorzystania ................................................................................................................ 47 Dane wysłane do Web Service: .................................................................................................................................. 47 Dane zwrócone przez Web Service: ........................................................................................................................... 47 4.4 USŁUGA REQUESTUPO .......................................................................................................................... 48 4.4.1 Opis ogólny ................................................................................................................................... 48 4.4.2 Opis szczegółowy .......................................................................................................................... 48 Możliwe statusy dokumentów: ................................................................................................................................... 48 4.4.3 Przykład I wykorzystania .............................................................................................................. 49 4.4.4 Przykład II wykorzystania usługi .................................................................................................. 51 Dane wysłane do Web Service: .................................................................................................................................. 49 Dane zwrócone przez Web Service: ........................................................................................................................... 49 4.5 4.6 Dane wysłane do Web Service: .................................................................................................................................. 51 Dane zwrócone przez Web Service: ........................................................................................................................... 51 PLIK WSDL DLA USŁUGI WEB SERVICE ................................................................................................ 52 PLIK XSD DLA USŁUGI WEB SERVICE ................................................................................................... 54 5/55
1. Wprowadzenie
1.1 Przeznaczenie
Celem tego dokumentu jest przedstawienie zasad wymiany informacji pomiędzy
systemem informatycznym e-Deklaracje a oprogramowaniem interfejsowym
przeznaczonym do przekazywania elektronicznych dokumentów do systemu
e-Deklaracje.
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-Deklaracje.
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
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.
6/55
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)
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
składania deklaracji w formie elektronicznej i podpisywania deklaracji
podpisem elektronicznym (Dz. U. z 2007 r. Nr 246, poz. 1818)
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.
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.
Nr 212, poz. 1766)* uchylone przez [24]
[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.)
7/55
[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
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
[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)
rozporządzenie w sprawie określenia rodzajów deklaracji, które mogą być
składane za pomocą środków komunikacji elektronicznej
[22] Rozporządzenie Ministra Finansów z dnia 6 października 2010 r. zmieniające
opatrzone (Dz.U. z 2010 r. Nr 209 poz. 1378)
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
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
Nr 76, poz. 412)
[27] Rozporządzenie Ministra Finansów z dnia 27 września 2011 r. zmieniające
Nr 207, poz. 1231)
wzoru pełnomocnictwa do podpisywania deklaracji składanej za pomocą
8/55
[29]
[30]
[31]
[32]
[33]
[34]
[35]
[36]
[37]
[38]
[39]
środków komunikacji elektronicznej oraz wzoru zawiadomienia o odwołaniu
tego pełnomocnictwa (Dz.U. z 2011 r. Nr 286 poz. 1681)
Rozporządzenie Ministra Finansów z dnia 23 grudnia 2011 r. zmieniające
Nr 293, poz. 1733)
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)
Rozporządzenie Ministra Finansów z dnia 4 kwietnia 2012 r. zmieniające
z 2012 r. Nr 1 poz. 387)
Rozporządzenie Ministra Finansów z dnia 26 września 2012 r. zmieniające
z 2012 r. Nr 1 poz. 1083)
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)
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)
Obwieszczenie Ministra Finansów z dnia 3 grudnia 2012 r. w sprawie
ogłoszenia jednolitego tekstu rozporządzenia Ministra Finansów w sprawie
komunikacji elektronicznej (Dz.U. z 2013 r. poz. 85)
Rozporządzenie Ministra Finansów z dnia 11 stycznia 2013 r. zmieniające
poz. 98)
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
Rozporządzenie Ministra Finansów z dnia 5 czerwca 2013 r. w sprawie
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)
9/55
2. Prezentacja struktury dokumentu elektronicznego
W rozdziale tym została przedstawiona struktura dokumentów elektronicznych,
przesyłanych do systemu e-Deklaracje jako pliki formatu XML, opatrzone bezpiecznym
podpisem weryfikowanym przy pomocy ważnego kwalifikowanego certyfikatu lub
zawierające element <DaneAutoryzujace> (dla schematu PIT-37(14)_v1-0.xsd dla rozliczeń
za rok 2008 oraz PIT-36(14)_v2-0.xsd, PIT-36L(5)_v1-0.xsd, PIT-37(14)_v2-0.xsd,
PIT-38(5)_v1-0.xsd, PIT-39(1)_v1-1.xsd dla rozliczeń za rok 2009 oraz PIT-36(16)_v10.xsd, PIT-36L(6)_v1-0.xsd, PIT-37(16)_v1-0.xsd, PIT-38(6)_v1-0.xsd, PIT-39(2)_v1-0.xsd,
PIT-28(15)_v1-0.xsd, PIT-16A(5)_v1-0.xsd, PIT-19A(4)_v1-0.xsd dla rozliczeń za rok 2010
oraz PIT-16(9)_v1-0.xsd, PIT-16(9)_ZL_v1-0.xsd od roku 2011 oraz opublikowanych
w CRD ePUAP (crd.gov.pl) wzorów
PIT-36(17), PIT-36L(7), PIT-37(17), PIT-38(7),
PIT-39(3), PIT-28(16), PIT-16A(6), PIT-19A(5) za rok 2011 oraz PIT-16(10)*,
PIT-16(10)_ZL* od roku 2012 oraz VAT-7(12), VAT-7D(3), VAT-7K(6), PCC-3(2) od roku
2012 oraz PIT-36(18), PIT-36L(8), PIT-37(18), PIT-38(8), PIT-39(4), PIT-28(16)**,
PIT-16A(6)**, PIT-19A(5)** dla rozliczeń za rok 2012 oraz VAT-7(13), VAT-7D(4),
VAT-7K(7), VAT-7(14), VAT-7D(5), VAT-7K(8) od roku 2013) lub zawierające element
<DaneAutoryzujaceVAP> dla wzoru VAP-1(1).
* - wersja obowiązuje - dla rozliczeń od roku 2012
** - wersja obowiązuje - od rozliczeń za rok 2011
2.1 Opis struktury
Do szczegółowego opisu struktury dokumentów używany jest standard XSD - XML
Schema Definition.
2.2 Graficzna prezentacja struktury przykładowego dokumentu – Deklaracja
10/55
2.2.1 Graficzna prezentacja struktury przykładowego dokumentu – element Naglowek
11/55
2.2.1.1
Graficzna prezentacja struktury przykładowego dokumentu – element Podmiot1
12/55
2.2.1.2
Graficzna prezentacja struktury przykładowego dokumentu – element Podmiot1 bez adresu
13/55
2.2.2 Graficzna prezentacja struktury przykładowego dokumentu – element PozycjeSzczegolowe
14/55
2.2.3 Graficzna prezentacja struktury przykładowego dokumentu – element Zalaczniki
15/55
2.2.4 Graficzna prezentacja struktury przykładowego dokumentu – element DaneAutoryzujace
2.2.5 Graficzna prezentacja struktury przykładowego dokumentu – element DaneAutoryzujaceVAP
16/55
2.3 Graficzna prezentacja struktury przykładowego dokumentu - Załącznik
2.3.1 Graficzna prezentacja struktury przykładowego dokumentu
17/55
2.4 Graficzna prezentacja struktury dokumentu – Potwierdzenie (UPO)
2.4.1 Graficzna prezentacja struktury dokumentu
18/55
2.5 Elementy struktury przykładowego dokumentu Deklaracja
2.5.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/2011/12/12/725/"
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/2011/12/08/eD/PITR/"
xmlns:zzu="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/10/07/eD/ORDZU/"
targetNamespace="http://crd.gov.pl/wzor/2011/12/12/725/" 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/Stru
kturyDanych_v3-0E.xsd"/>
<xsd:import namespace="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/12/08/eD/PITR/"
schemaLocation="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/12/08/eD/PITR/PIT-R(15)_Z_v
1-0E.xsd"/>
<xsd:import namespace="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/10/07/eD/ORDZU/"
schemaLocation="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/10/07/eD/ORDZU/ORD-ZU(2)_v2
-0E.xsd"/>
2.5.2 Nagłówek
<xsd:complexType name="TNaglowek">
<xsd:annotation>
<xsd:documentation>Nagłówek deklaracji</xsd:documentation>
</xsd:annotation>
<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 (19)"/>
<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="1-0E"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="WariantFormularza">
<xsd:simpleType>
<xsd:restriction base="xsd:byte">
<xsd:enumeration value="19"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="CelZlozenia">
<xsd:complexType>
<xsd:simpleContent>
<xsd:extension base="etd:TCelZlozenia">
<xsd:attribute name="poz" type="xsd:string" use="required" fixed="P_6"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
</xsd:element>
<xsd:element name="Rok">
<xsd:simpleType>
<xsd:restriction base="etd:TRok">
<xsd:minInclusive value="2011"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="KodUrzedu" type="etd:TKodUS"/>
</xsd:sequence>
</xsd:complexType>
19/55
2.5.3 Deklaracja
<xsd:element name="Deklaracja">
<xsd:annotation>
<xsd:documentation>INFORMACJA O DOCHODACH ORAZ O POBRANYCH ZALICZKACH NA PODATEK
DOCHODOWY</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="Naglowek" type="TNaglowek">
<xsd:annotation>
<xsd:documentation>Nagłówek deklaracji</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Podmiot1">
<xsd:complexType>
<xsd:complexContent>
<xsd:extension base="etd:TPodmiotDowolnyBezAdresu2">
<xsd:sequence>
<xsd:element name="AdresZamieszkaniaSiedziby">
<xsd:complexType>
<xsd:extension base="etd:TAdres">
<xsd:attribute name="rodzajAdresu" type="xsd:string"
use="required" fixed="RAD"/>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="rola" type="xsd:string" use="required"
fixed="Płatnik"/>
</xsd:extension>
</xsd:complexType>
</xsd:element>
<xsd:element name="Podmiot2">
<xsd:complexType>
<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_20A"/>
</xsd:extension>
</xsd:complexType>
</xsd:element>
<xsd:element ref="PozycjeSzczegolowe">
<xsd:annotation>
<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</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Oswiadczenie">
<xsd:simpleType>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Oświadczam, że są mi znane przepisy Kodeksu
karnego skarbowego o odpowiedzialności za uchybienie obowiązkom płatnika."/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Zalaczniki" minOccurs="0">
<xsd:complexType>
<xsd:sequence>
<xsd:element ref="zr:Zalacznik_PIT-R" minOccurs="0"/>
<xsd:element ref="zzu:Zalacznik_ORD-ZU" minOccurs="0"/>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
20/55
2.5.4 Pozycje szczegółowe
<xsd:element name="PozycjeSzczegolowe">
<xsd:complexType>
<xsd:sequence>
<xsd:sequence minOccurs="0">
<xsd:annotation>
<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:annotation>
<xsd:element name="P_34">
<xsd:annotation>
<xsd:documentation>Koszty uzyskania przychodów, wykazane w poz.36,
zostały uwzględnione do wysokości przysługującej podatnikowi</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:byte">
<xsd:enumeration value="1">
<xsd:annotation>
<xsd:documentation>z jednego stosunku pracy (stosunków
pokrewnych)</xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:annotation>
<xsd:documentation>z więcej niż jednego stosunku pracy
(stosunków pokrewnych)</xsd:documentation>
</xsd:annotation>
</xsd:enumeration>
<xsd:annotation>
<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:annotation>
</xsd:enumeration>
<xsd:annotation>
<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>
</xsd:annotation>
</xsd:enumeration>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="P_35" type="etd:TKwota2Nieujemna">
<xsd:annotation>
<xsd:documentation>Przychód</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="P_36" type="etd:TKwota2Nieujemna" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Koszty uzyskania przychodów</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="P_37" type="etd:TKwota2Nieujemna">
<xsd:annotation>
<xsd:documentation>Dochód</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="P_38" type="etd:TKwota2Nieujemna" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Dochód zwolniony od podatku</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="P_39" type="etd:TKwotaCNieujemna">
<xsd:annotation>
<xsd:documentation>Zaliczka pobrana przez płatnika</xsd:documentation>
</xsd:annotation>
</xsd:element>
…
</xsd:complexType>
</xsd:element>
21/55
2.5.5 Podpis elektroniczny nieweryfikowany za pomocą ważnego kwalifikowanego certyfikatu (dane
autoryzujące)
Podpis elektroniczny zapewniający autentyczność deklaracji i podań, oparty na zestawie cech
informacyjnych podatnika składającego deklarację lub podanie może być użyty:
dla schematu PIT‐37(14)_v1‐0.xsd dla rozliczeń za rok 2008 oraz PIT‐36(14)_v2‐0.xsd, PIT‐36L(5)_v1‐0.xsd, PIT‐37(14)_v2‐0.xsd, PIT‐38(5)_v1‐0.xsd, PIT‐39(1)_v1‐1.xsd dla rozliczeń za rok 2009 oraz PIT‐36(16)_v1‐0.xsd, PIT‐36L(6)_v1‐0.xsd, PIT‐37(16)_v1‐0.xsd, PIT‐38(6)_v1‐0.xsd, PIT‐39(2)_v1‐0.xsd, PIT‐28(15)_v1‐0.xsd, PIT‐16A(5)_v1‐0.xsd, PIT‐19A(4)_v1‐0.xsd dla rozliczeń za rok 2010 oraz PIT‐16(9)_v1‐0.xsd, PIT‐16(9)_ZL_v1‐0.xsd od roku 2011 oraz wzorów PIT‐36(17), PIT‐36L(7), PIT‐37(17), PIT‐38(7), PIT‐39(3), PIT‐28(16), PIT‐16A(6), PIT‐19A(5) dla rozliczeń za rok 2011 oraz wzorów PIT‐16(10), PIT‐16(10)_ZL od roku 2012 oraz wzorów VAT‐7(12), VAT‐7D(3), VAT‐7K(6), PCC‐3(2) od roku 2012 oraz wzorów PIT‐36(18), PIT‐36L(8), PIT‐37(18), PIT‐38(8), PIT‐39(4), PIT‐28(16), PIT‐16A(6), PIT‐19A(5) dla rozliczeń za rok 2012 oraz wzorów VAT‐7(13), VAT‐7D(4), VAT‐7K(7), VAT‐7(14), VAT‐7D(5), VAT‐7K(8) od roku 2013. 2.5.5.1
Struktura logiczna podpisu elektronicznego nieweryfikowanego za pomocą ważnego
kwalifikowanego certyfikatu (dane autoryzujące)
<xsd:schema xmlns:podp="http://e-deklaracje.mf.gov.pl/Repozytorium/Definicje/Podpis/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://e-deklaracje.mf.gov.pl/Repozytorium/Definicje/Podpis/"
elementFormDefault="qualified" attributeFormDefault="unqualified" xml:lang="pl">
<xsd:element name="DaneAutoryzujace">
<xsd:annotation>
<xsd:documentation>Element użyty do autoryzacji deklaracji i podań składanych do
systemu e-Deklaracje od 01.01.2012 r.</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:choice>
<xsd:element name="NIP">
<xsd:annotation>
<xsd:documentation>Identyfikator podatkowy NIP</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:whiteSpace value="collapse"/>
<xsd:pattern value="[1-9]((\d[1-9])|([1-9]\d))\d{7}"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="PESEL">
<xsd:annotation>
<xsd:documentation>Identyfikator podatkowy numer
PESEL</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:pattern value="\d{11}"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:choice>
<xsd:element name="ImiePierwsze">
<xsd:annotation>
<xsd:documentation>Pierwsze imię</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:normalizedString">
<xsd:minLength value="1"/>
<xsd:maxLength value="30"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Nazwisko">
22/55
<xsd:annotation>
<xsd:documentation>Nazwisko</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:normalizedString">
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="DataUrodzenia">
<xsd:annotation>
<xsd:documentation>Data urodzenia</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:date">
<xsd:minInclusive value="1900-01-01"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Kwota">
<xsd:annotation>
<xsd:documentation>Kwota przychodu wykazana w zeznaniu lub rocznym
obliczeniu podatku za rok podatkowy, o dwa lata wcześniejszy niż rok, w którym jest składany
dokument elektroniczny</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:decimal">
<xsd:totalDigits value="16"/>
<xsd:fractionDigits value="2"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
2.5.6 Podpis elektroniczny nieweryfikowany za pomocą ważnego kwalifikowanego certyfikatu (dane
autoryzujące VAP)
Podpis elektroniczny zapewniający autentyczność deklaracji i podań, oparty na zestawie cech
informacyjnych podatnika składającego deklarację lub podanie może być użyty:
dla wzoru VAP‐1(1) od roku 2012. 2.5.6.1
Struktura logiczna podpisu elektronicznego nieweryfikowanego za pomocą ważnego
kwalifikowanego certyfikatu (dane autoryzujące VAP)
<xsd:schema xmlns:podpis="http://e-deklaracje.mf.gov.pl/Repozytorium/Definicje/Podpis/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://e-deklaracje.mf.gov.pl/Repozytorium/Definicje/Podpis/"
elementFormDefault="qualified" attributeFormDefault="unqualified" xml:lang="pl">
<xsd:element name="DaneAutoryzujaceVAP">
<xsd:annotation>
<xsd:documentation>Element użyty do autoryzacji deklaracji składanych do systemu eDeklaracje od 01.04.2012 r / Element used for authorization of the declarations submitted to
the system e-declarations as from 1 April 2012 / Das Element für die Authentifizierung der
Erklärungen einreichen an das System E-Erklärungen seit 1. April 2012
</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="NumerIdentyfikacyjny">
<xsd:annotation>
<xsd:documentation>Numer identyfikacyjny VAP na potrzeby wykonywanych na
terytorium kraju usług międzynarodowego przewozu drogowego / The VAP identification number for
the purposes of international road carriage services supplied within the territory of Poland /
Die VAP-Identifikationsnummer für den Bedarf der auf dem Gebiet der Republik Polen erbrachten
internationalen Straßenbeförderungsleistungen</xsd:documentation>
</xsd:annotation>
23/55
<xsd:simpleType>
<xsd:pattern value="[0]{3}\d{7}"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="PodstawaObliczeniaPodatku">
<xsd:annotation>
<xsd:documentation>Kwota podstawy opodatkowania wykazana w poz. „Podstawa"
deklaracji VAP-1, ostatnio złożonej za kwartał poprzedzający kwartał, za który składana jest
deklaracja, albo wartość „0” (zero), w przypadku gdy deklaracja jest składana po raz pierwszy
lub gdy deklaracja nie została złożona za poprzedni kwartał / The taxable amount from the item
"Taxable amount" of the declaration VAP-1, submitted for the quarter preceding the quarter for
which the declaration is submitted or the value "0" (zero) in case the declaration is
submitted for the first time or in case the declaration was not submitted for the previous
quarter / Der Betrag der Steuerbemessungsgrundlage aus Position “Besteuerungsgrundlage” der
für das vorherigen Quartal eingereichten VAP-1 Erklärung oder der Betrag „0“ (Null), wenn
solche Erklärung zum ersten Mal eingereicht wird oder keine Erklärung für das vorherigen
Quartal eingereicht wurde</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:integer">
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="KwotaPodatku">
<xsd:annotation>
<xsd:documentation>Kwota podatku podlegającego wpłacie do urzędu skarbowego
wykazana w poz. „Podatek" deklaracji VAP-1, ostatnio złożonej za kwartał poprzedzający
kwartał, za który składana jest deklaracja, albo wartość „0” (zero), w przypadku gdy
deklaracja jest składana po raz pierwszy lub gdy deklaracja nie została złożona za poprzedni
kwartał / The amount of tax to be paid to the tax office from the item "Tax" of the
declaration VAP-1, submitted for the quarter preceding the quarter for which the declaration
is submitted or the value "0" (zero) in case the declaration is submitted for the first time
or in case the declaration was not submitted for the previous quarter / Der Steuerbetrag, der
der Einzahlung beim Finanzamt unterliegt aus Position „Steuer“ der für das vorherigen Quartal
eingereichten VAP-1 Erklärung oder der Betrag „0“ (Null), wenn solche Erklärung zum ersten Mal
eingereicht wird oder keine Erklärung für das vorherigen Quartal eingereicht
wurde</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:integer">
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
24/55
2.6 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 zawierać element
<DaneAutoryzujace> dla schematu:



PIT-37(14)_v1-0.xsd dla rozliczeń za rok 2008
PIT-36(14)_v2-0.xsd, PIT-36L(5)_v1-0.xsd, PIT-37(14)_v2-0.xsd, PIT-38(5)_v1-0.xsd,
PIT-39(1)_v1-1.xsd dla rozliczeń za rok 2009
PIT-36(16)_v1-0.xsd, PIT-36L(6)_v1-0.xsd, PIT-37(16)_v1-0.xsd, PIT-38(6)_v1-0.xsd,
PIT-39(2)_v1-0.xsd, PIT-28(15)_v1-0.xsd, PIT-16A(5)_v1-0.xsd, PIT-19A(4)_v1-0.xsd dla
rozliczeń za rok 2010
PIT-16(9)_v1-0.xsd, PIT-16(9)_ZL_v1-0.xsd od roku 2011

dla wzoru:
 PIT-36(17), PIT-36L(7), PIT-37(17), PIT-38(7), PIT-39(3), PIT-28(16), PIT-16A(6), PIT-19A(5)



dla rozliczeń za rok 2011
PIT-16(10), PIT-16(10)_ZL od roku 2012
VAT-7(12), VAT-7D(3), VAT-7K(6), PCC-3(2) od roku 2012
PIT-36(18), PIT-36L(8), PIT-37(18), PIT-38(8), PIT-39(4), PIT-28(16), PIT-16A(6), PIT-19A(5)
dla rozliczeń za rok 2012
VAT-7(13), VAT-7D(4), VAT-7K(7), VAT-7(14), VAT-7D(5), VAT-7K(8) od roku 2013

lub zawierać element <DaneAutoryzujaceVAP> dla wzoru:

VAP-1(1) od roku 2012
2.7 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-Deklaracje 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.8 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:
25/55
<Deklaracja xsi:schemaLocation="http://crd.gov.pl/wzor/2012/12/07/1072/
http://crd.gov.pl/wzor/2012/12/07/1072/schemat.xsd"
xmlns="http://crd.gov.pl/wzor/2012/12/07/1072/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Naglowek>
<KodFormularza rodzajZobowiazania="Z" wersjaSchemy="1-0E" kodSystemowy="PIT-39 (4)"
kodPodatku="PPR">PIT-39</KodFormularza>
<WariantFormularza>4</WariantFormularza>
<CelZlozenia poz="P_6">1</CelZlozenia>
<Rok>2012</Rok>
<KodUrzedu>1416</KodUrzedu>
</Naglowek>
<Podmiot1 poz="P_1A" rola="Podatnik">
...
 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:
<Deklaracja xmlns="http://crd.gov.pl/wzor/2012/12/07/1072/"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://crd.gov.pl/wzor/2012/12/07/1072/
http://crd.gov.pl/wzor/2012/12/07/1072/schemat.xsd">
<Naglowek>
<KodFormularza kodPodatku="PPR" kodSystemowy="PIT-39 (4)" rodzajZobowiazania="Z"
wersjaSchemy="1-0E">PIT-39</KodFormularza>
<Rok>2012</Rok>
</Naglowek>
...
2.9 Podpisanie bezpiecznym podpisem dokumentu elektronicznego
1. Deklaracje 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.
2. Do podpisania danych i zapisania ich w formacie:
a. XML-dsig typu enveloped muszą być użyte algorytmy:
1. CanonicalizationMethod Algorithm=http://www.w3.org/TR/2001/REC-xml-c14n-20010315
2. SignatureMethod Algorithm=http://www.w3.org/2000/09/xmldsig#rsa-sha1
3. DigestMethod Algorithm=http://www.w3.org/2000/09/xmldsig#sha1
4. 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 ::= {
26/55
WITH SYNTAX ContentType
EQUALITY MATCHING RULE objectIdentifierMatch
SINGLE VALUE TRUE
ID pkcs-9-at-contentType
}
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
3. a. Podpisany dokument w formacie XAdES musi zawierać następujące elementy:
1. element KeyInfo zawierający X509Certificate
2. element Object zawierający SigningCertificate
b. Podpisany dokument w formacie PKCS#7 musi zawierać następujące elementy:
3. element SignedData zawierający version, digestAlgorithms, contentInfo, signerInfos
4. Podpisany dokument XML przed wysłaniem jest kodowany zgodnie z formatem
base64Binary.
2.10 Przykładowy dokument XML podpisany bezpiecznym podpisem weryfikowanym
przy pomocy ważnego kwalifikowanego certyfikatu
<ds:Signature xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="Signature-0">
<ds:SignedInfo xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="SignedInfo-0">
<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="SignedProperties-Reference0"
Type="http://uri.etsi.org/01903#SignedProperties" URI="#SignedProperties-0">
<ds:DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/>
<ds:DigestValue>F1AU/ZMhmb9IFs851qQ/Ljio7s4=</ds:DigestValue>
</ds:Reference>
<ds:Reference URI="#Dokument-0">
<ds:DigestValue>hetosTBSjdtZBGEH1Bst5IdvR68=</ds:DigestValue>
</ds:Reference>
</ds:SignedInfo>
<ds:SignatureValue Id="SignatureValue0">Ao+efyZIwK8RVoDLK8xIz1Ddy1Bjd8REBmsSY81ktn2FN/gfxNZmZLlATqBkVzzXnsUQ4hjb4Y04UPu03WfhkmAGzcz
IeIWrnT9mJODu4bxOsZ1p6HVmNAVN7ej7pojH1o5CrNqd1ZG8/HoNYLHIRQfMQhikMQxKXQ=</ds:SignatureValue>
<ds:KeyInfo Id="KeyInfo-0">
<ds:X509Data>
<ds:X509Certificate>MIIFTzCCBDegAwIBAgIERBOm1TANBgkqhkiG9w0BAQUFADCBjjELMAkGA1UEBhMCUEwxPTA
7BJRCeQwWxgcpZVesVQGVM/B3vdCZT8sJX2/1zuZlEoRhGlPpULTg==</ds:X509Certificate>
</ds:X509Data>
</ds:KeyInfo>
<ds:Object>
<xades:QualifyingProperties xmlns:xades="http://uri.etsi.org/01903/v1.3.2#"
Target="#Signature-0">
<xades:SignedProperties xmlns:ds="http://www.w3.org/2000/09/xmldsig#"
xmlns:xades="http://uri.etsi.org/01903/v1.3.2#" Id="SignedProperties-0">
<xades:SignedSignatureProperties>
<xades:SigningCertificate>
<xades:Cert>
<xades:CertDigest>
<ds:DigestValue>YDs8TOZRfRRTEvt1j8bfDBIHkfo=</ds:DigestValue>
</xades:CertDigest>
<xades:IssuerSerial>
<ds:X509IssuerName>OID.2.5.4.5=Nr wpisu: 3, CN=Sigillum PCCE kwalifikowany CA1, O=Sigillum Polskie Centrum Certyfikacji Elektronicznej,
C=PL</ds:X509IssuerName>
<ds:X509SerialNumber>xxxxxxxxx</ds:X509SerialNumber>
27/55
</xades:IssuerSerial>
</xades:Cert>
</xades:SigningCertificate>
</xades:SignedSignatureProperties>
</xades:SignedProperties>
</xades:QualifyingProperties>
</ds:Object>
<ds:Object xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="Dokument-0">
xmlns:etd="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/eD/DefinicjeTypy/">
<Naglowek>
<KodFormularza kodPodatku="PIT" kodSystemowy="PIT-11 (19)" rodzajZobowiazania="Z"
<Rok>2011</Rok>
</Naglowek>
<Podmiot1 rola="Płatnik">
<etd:OsobaNiefizyczna>
<etd:NIP>1121121134</etd:NIP>
<etd:PelnaNazwa>NAZWAPŁATNIKA</etd:PelnaNazwa>
</etd:OsobaNiefizyczna>
<AdresZamieszkaniaSiedziby rodzajAdresu="RAD">
<etd:AdresPol>
<etd:KodKraju>PL</etd:KodKraju>
<etd:Wojewodztwo>MAZOWIECKIE</etd:Wojewodztwo>
<etd:Powiat>WARSZAWA</etd:Powiat>
<etd:Gmina>WARSZAWA</etd:Gmina>
<etd:Ulica>MIŁA</etd:Ulica>
<etd:NrDomu>1</etd:NrDomu>
<etd:Miejscowosc>WARSZAWA</etd:Miejscowosc>
<etd:KodPocztowy>00-001</etd:KodPocztowy>
<etd:Poczta>WARSZAWA</etd:Poczta>
</etd:AdresPol>
</AdresZamieszkaniaSiedziby>
</Podmiot1>
<etd:OsobaFizyczna>
<etd:PESEL>80010111110</etd:PESEL>
<etd:ImiePierwsze>JAN</etd:ImiePierwsze>
<etd:Nazwisko>NOWAK</etd:Nazwisko>
<etd:DataUrodzenia>1980-01-01</etd:DataUrodzenia>
</etd:OsobaFizyczna>
<etd:AdresZamieszkania rodzajAdresu="RAD">
<etd:AdresPol>
<etd:Powiat>WARSZAWA</etd:Powiat>
<etd:Gmina>WARSZAWA</etd:Gmina>
<etd:Ulica>LOKALNA</etd:Ulica>
</etd:AdresPol>
</etd:AdresZamieszkania>
</Podmiot2>
<PozycjeSzczegolowe>
<P_34>1</P_34>
<P_35>4000.00</P_35>
<P_36>1335.00</P_36>
<P_37>2665.00</P_37>
<P_39>250</P_39>
<P_75>450.00</P_75>
<P_77>220.00</P_77>
<P_81>2</P_81>
</PozycjeSzczegolowe>
<Oswiadczenie>Oświadczam, że są mi znane przepisy Kodeksu karnego skarbowego o
odpowiedzialności za uchybienie obowiązkom płatnika.</Oswiadczenie>
</Deklaracja>
</ds:Object>
</ds:Signature>
28/55
2.11 Przykładowy dokument XML podpisany podpisem elektronicznym
nieweryfikowanym za pomocą ważnego kwalifikowanego certyfikatu
(wizualizacja w formacie „pretty print”)
<Naglowek>
<Rok>2012</Rok>
</Naglowek>
<etd:OsobaFizyczna>
<etd:ImiePierwsze>ADAM</etd:ImiePierwsze>
<etd:Nazwisko>KOWALSKI</etd:Nazwisko>
<etd:AdresPol>
<etd:Powiat>WARSZAWSKI</etd:Powiat>
<etd:Gmina>M.ST.WARSZAWA</etd:Gmina>
<etd:Ulica>LOKALNA</etd:Ulica>
<etd:NrLokalu>2</etd:NrLokalu>
</etd:AdresPol>
</Podmiot1>
<P_6>1</P_6>
<P_37>24500.00</P_37>
<P_38>1335.00</P_38>
<P_39>23165.00</P_39>
<P_41>2000</P_41>
<P_60>24500.00</P_60>
<P_61>1335.00</P_61>
<P_62>23165.00</P_62>
<P_63>2000</P_63>
<P_95>23165.00</P_95>
<P_96>0.00</P_96>
<P_103>23165.00</P_103>
<P_104>23165</P_104>
<P_105>3613.68</P_105>
<P_107>3613.68</P_107>
<P_114>3613.68</P_114>
<P_118>3614</P_118>
<P_119>2000</P_119>
<P_120>1614</P_120>
<Pouczenie>W wypadku niewpłacenia w obowiązującym terminie kwoty z poz.120 lub wpłacenia
jej w niepełnej wysokości niniejsze zeznanie stanowi podstawę do wystawienia tytułu
wykonawczego, zgodnie z przepisami ustawy z dnia 17 czerwca 1966 r. o postępowaniu
egzekucyjnym w administracji (Dz.U. z 2012 r. poz. 1015).</Pouczenie>
odpowiedzialności za podanie danych niezgodnych z rzeczywistością. W przypadku zaznaczenia w
poz.6 kwadratu nr 2, 3 albo 4, kwadratu w poz.7 lub w poz.8, oświadczam, iż spełnione są
warunki do opodatkowania dochodów w wybrany sposób. W przypadku zastosowania art.6 ust.2a
ustawy, oświadczam pod rygorem odpowiedzialności karnej za fałszywe zeznania, że spełniony
jest warunek przewidziany w tym przepisie.</Oswiadczenie>
<podp:DaneAutoryzujace
xmlns:podp="http://e-deklaracje.mf.gov.pl/Repozytorium/Definicje/Podpis/">
<podp:PESEL>80010111110</podp:PESEL>
<podp:ImiePierwsze>ADAM</podp:ImiePierwsze>
<podp:Nazwisko>KOWALSKI</podp:Nazwisko>
<podp:DataUrodzenia>1980-01-01</podp:DataUrodzenia>
<podp:Kwota>125.60</podp:Kwota>
</podp:DaneAutoryzujace>
</Deklaracja>
29/55
2.11.1 Przykładowy dokument XML podpisany podpisem elektronicznym nieweryfikowanym za
pomocą ważnego kwalifikowanego certyfikatu (w postaci kanonicznej)
<?xml version="1.0" encoding="UTF-8"?><Deklaracja xmlns="http://crd.gov.pl/wzor/2012/12/07/107
0/" xmlns:etd="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/eD/DefinicjeTypy/"><Na
glowek><KodFormularza kodPodatku="PIT" kodSystemowy="PIT-37 (18)" rodzajZobowiazania="Z" wersj
aSchemy="1-0E">PIT 37</KodFormularza><WariantFormularza>18</WariantFormularza><CelZlozenia poz
="P_10">1</CelZlozenia><Rok>2012</Rok><KodUrzedu>1449</KodUrzedu></Naglowek><Podmiot1 poz="P_1
A" rola="Podatnik"><etd:OsobaFizyczna><etd:PESEL>80010111110</etd:PESEL><etd:ImiePierwsze>ADAM
</etd:ImiePierwsze><etd:Nazwisko>KOWALSKI</etd:Nazwisko><etd:DataUrodzenia>1980-01-01</etd:Dat
aUrodzenia></etd:OsobaFizyczna><etd:AdresZamieszkania rodzajAdresu="RAD"><etd:AdresPol><etd:Ko
dKraju>PL</etd:KodKraju><etd:Wojewodztwo>MAZOWIECKIE</etd:Wojewodztwo><etd:Powiat>WARSZAWSKI</
etd:Powiat><etd:Gmina>M.ST.WARSZAWA</etd:Gmina><etd:Ulica>LOKALNA</etd:Ulica><etd:NrDomu>1</et
d:NrDomu><etd:NrLokalu>2</etd:NrLokalu><etd:Miejscowosc>WARSZAWA</etd:Miejscowosc><etd:KodPocz
towy>00-001</etd:KodPocztowy><etd:Poczta>WARSZAWA</etd:Poczta></etd:AdresPol></etd:AdresZamies
zkania></Podmiot1><PozycjeSzczegolowe><P_6>1</P_6><P_37>24500.00</P_37><P_38>1335.00</P_38><P_
39>23165.00</P_39><P_41>2000</P_41><P_60>24500.00</P_60><P_61>1335.00</P_61><P_62>23165.00</P_
62><P_63>2000</P_63><P_95>23165.00</P_95><P_96>0.00</P_96><P_103>23165.00</P_103><P_104>23165<
/P_104><P_105>3613.68</P_105><P_107>3613.68</P_107><P_114>3613.68</P_114><P_118>3614</P_118><P
_119>2000</P_119><P_120>1614</P_120></PozycjeSzczegolowe><Pouczenie>W wypadku niewpłacenia w o
bowiązującym terminie kwoty z poz.120 lub wpłacenia jej w niepełnej wysokości niniejsze zeznan
ie stanowi podstawę do wystawienia tytułu wykonawczego, zgodnie z przepisami ustawy z dnia 17
czerwca 1966 r. o postępowaniu egzekucyjnym w administracji (Dz.U. z 2012 r. poz. 1015).</Pouc
zenie><Oswiadczenie>Oświadczam, że są mi znane przepisy Kodeksu karnego skarbowego o odpowiedz
ialności za podanie danych niezgodnych z rzeczywistością. W przypadku zaznaczenia w poz.6 kwad
ratu nr 2, 3 albo 4, kwadratu w poz.7 lub w poz.8, oświadczam, iż spełnione są warunki do opod
atkowania dochodów w wybrany sposób. W przypadku zastosowania art.6 ust.2a ustawy, oświadczam
pod rygorem odpowiedzialności karnej za fałszywe zeznania, że spełniony jest warunek przewidzi
any w tym przepisie.</Oswiadczenie><podp:DaneAutoryzujace xmlns:podp="http://e-deklaracje.mf.g
ov.pl/Repozytorium/Definicje/Podpis/"><podp:PESEL>80010111110</podp:PESEL><podp:ImiePierwsze>A
DAM</podp:ImiePierwsze><podp:Nazwisko>KOWALSKI</podp:Nazwisko><podp:DataUrodzenia>1980-01-01</
podp:DataUrodzenia><podp:Kwota>125.60</podp:Kwota></podp:DaneAutoryzujace></Deklaracja>
2.11.2 Przykładowy dokument XML podpisany podpisem elektronicznym nieweryfikowanym za
pomocą ważnego kwalifikowanego certyfikatu (w postaci zakodowanej base64Binary)
PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48RGVrbGFyYWNqYSB4bWxucz0iaHR0cDovL2NyZC5nb3
YucGwvd3pvci8yMDExLzEyLzE5LzczMi8iIHhtbG5zOmV0ZD0iaHR0cDovL2NyZC5nb3YucGwveG1sL3NjaGVtYXR5L2R6
aWVkemlub3dlL21mLzIwMTEvMDYvMjEvZUQvRGVmaW5pY2plVHlweS8iPjxOYWdsb3dlaz48S29kRm9ybXVsYXJ6YSBrb2
RQb2RhdGt1PSJQSVQiIGtvZFN5c3RlbW93eT0iUElULTM3ICgxNykiIHJvZHphalpvYm93aWF6YW5pYT0iWiIgd2Vyc2ph
U2NoZW15PSIxLTBFIj5QSVQtMzc8L0tvZEZvcm11bGFyemE+PFdhcmlhbnRGb3JtdWxhcnphPjE3PC9XYXJpYW50Rm9ybX
VsYXJ6YT48Q2VsWmxvemVuaWEgcG96PSJQXzEwIj4xPC9DZWxabG96ZW5pYT48Um9rPjIwMTE8L1Jvaz48S29kVXJ6ZWR1
PjE0NDk8L0tvZFVyemVkdT48L05hZ2xvd2VrPjxQb2RtaW90MSBwb3o9IlBfMUEiIHJvbGE9IlBvZGF0bmlrIj48ZXRkOk
9zb2JhRml6eWN6bmE+PGV0ZDpQRVNFTD44MDAxMDExMTExMDwvZXRkOlBFU0VMPjxldGQ6SW1pZVBpZXJ3c3plPkFEQU08
L2V0ZDpJbWllUGllcndzemU+PGV0ZDpOYXp3aXNrbz5LT1dBTFNLSTwvZXRkOk5hendpc2tvPjxldGQ6RGF0YVVyb2R6ZW
5pYT4xOTgwLTAxLTAxPC9ldGQ6RGF0YVVyb2R6ZW5pYT48L2V0ZDpPc29iYUZpenljem5hPjxldGQ6QWRyZXNaYW1pZXN6
a2FuaWEgcm9kemFqQWRyZXN1PSJSQUQiPjxldGQ6QWRyZXNQb2w+PGV0ZDpLb2RLcmFqdT5QTDwvZXRkOktvZEtyYWp1Pj
xldGQ6V29qZXdvZHp0d28+TUFaT1dJRUNLSUU8L2V0ZDpXb2pld29kenR3bz48ZXRkOlBvd2lhdD5XQVJTWkFXU0tJPC9l
dGQ6UG93aWF0PjxldGQ6R21pbmE+TS5TVC5XQVJTWkFXQTwvZXRkOkdtaW5hPjxldGQ6VWxpY2E+TE9LQUxOQTwvZXRkOl
VsaWNhPjxldGQ6TnJEb211PjE8L2V0ZDpOckRvbXU+PGV0ZDpOckxva2FsdT4yPC9ldGQ6TnJMb2thbHU+PGV0ZDpNaWVq
c2Nvd29zYz5XQVJTWkFXQTwvZXRkOk1pZWpzY293b3NjPjxldGQ6S29kUG9jenRvd3k+MDAtMDAxPC9ldGQ6S29kUG9jen
Rvd3k+PGV0ZDpQb2N6dGE+V0FSU1pBV0E8L2V0ZDpQb2N6dGE+PC9ldGQ6QWRyZXNQb2w+PC9ldGQ6QWRyZXNaYW1pZXN6
a2FuaWE+PC9Qb2RtaW90MT48UG96eWNqZVN6Y3plZ29sb3dlPjxQXzY+MTwvUF82PjxQXzM3PjI0NTAwLjAwPC9QXzM3Pj
xQXzM4PjEzMzUuMDA8L1BfMzg+PFBfMzk+MjMxNjUuMDA8L1BfMzk+PFBfNDE+MjAwMDwvUF80MT48UF82MD4yNDUwMC4w
MDwvUF82MD48UF82MT4xMzM1LjAwPC9QXzYxPjxQXzYyPjIzMTY1LjAwPC9QXzYyPjxQXzYzPjIwMDA8L1BfNjM+PFBfOT
U+MjMxNjUuMDA8L1BfOTU+PFBfOTY+MC4wMDwvUF85Nj48UF8xMDM+MjMxNjUuMDA8L1BfMTAzPjxQXzEwND4yMzE2NTwv
UF8xMDQ+PFBfMTA1PjM2MTMuNjg8L1BfMTA1PjxQXzEwNz4zNjEzLjY4PC9QXzEwNz48UF8xMTQ+MzYxMy42ODwvUF8xMT
Q+PFBfMTE4PjM2MTQ8L1BfMTE4PjxQXzExOT4yMDAwPC9QXzExOT48UF8xMjA+MTYxNDwvUF8xMjA+PC9Qb3p5Y2plU3pj
emVnb2xvd2U+PFBvdWN6ZW5pZT5XIHd5cGFka3Ugbmlld3DFgmFjZW5pYSB3IG9ib3dpxIV6dWrEhWN5bSB0ZXJtaW5pZS
Brd290eSB6IHBvei4xMjAgbHViIHdwxYJhY2VuaWEgamVqIHcgbmllcGXFgm5laiB3eXNva2/Fm2NpIG5pbmllanN6ZSB6
ZXpuYW5pZSBzdGFub3dpIHBvZHN0YXfEmSBkbyB3eXN0YXdpZW5pYSB0eXR1xYJ1IHd5a29uYXdjemVnbywgemdvZG5pZS
B6IHByemVwaXNhbWkgdXN0YXd5IHogZG5pYSAxNyBjemVyd2NhIDE5NjYgci4gbyBwb3N0xJlwb3dhbml1IGVnemVrdWN5
am55bSB3IGFkbWluaXN0cmFjamkgKER6LlUuIHogMjAwNSByLiBOciAyMjksIHBvei4xOTU0LCB6IHDDs8W6bi4gem0uKS
48L1BvdWN6ZW5pZT48T3N3aWFkY3plbmllPk/Fm3dpYWRjemFtLCDFvGUgc8SFIG1pIHpuYW5lIHByemVwaXN5IEtvZGVr
c3Uga2FybmVnbyBza2FyYm93ZWdvIG8gb2Rwb3dpZWR6aWFsbm/Fm2NpIHphIHBvZGFuaWUgZGFueWNoIG5pZXpnb2RueW
NoIHogcnplY3p5d2lzdG/Fm2NpxIUuIFcgcHJ6eXBhZGt1IHphem5hY3plbmlhIHcgcG96LjYga3dhZHJhdHUgbnIgMiwg
MyBhbGJvIDQsIGt3YWRyYXR1IHcgcG96LjcgbHViIHcgcG96LjgsIG/Fm3dpYWRjemFtLCBpxbwgc3BlxYJuaW9uZSBzxI
Ugd2FydW5raSBkbyBvcG9kYXRrb3dhbmlhIGRvY2hvZMOzdyB3IHd5YnJhbnkgc3Bvc8OzYi4gVyBwcnp5cGFka3UgemFz
dG9zb3dhbmlhIGFydC42IHVzdC4yYSB1c3Rhd3ksIG/Fm3dpYWRjemFtIHBvZCByeWdvcmVtIG9kcG93aWVkemlhbG5vxZ
tjaSBrYXJuZWogemEgZmHFgnN6eXdlIHplem5hbmlhLCDFvGUgc3BlxYJuaW9ueSBqZXN0IHdhcnVuZWsgcHJ6ZXdpZHpp
YW55IHcgdHltIHByemVwaXNpZS48L09zd2lhZGN6ZW5pZT48cG9kcDpEYW5lQXV0b3J5enVqYWNlIHhtbG5zOnBvZHA9Im
h0dHA6Ly9lIGRla2xhcmFjamUubWYuZ292LnBsL1JlcG96eXRvcml1bS9EZWZpbmljamUvUG9kcGlzLyI+PHBvZHA6UEVT
RUw+ODAwMTAxMTExMTA8L3BvZHA6UEVTRUw+PHBvZHA6SW1pZVBpZXJ3c3plPkFEQU08L3BvZHA6SW1pZVBpZXJ3c3plPj
xwb2RwOk5hendpc2tvPktPV0FMU0tJPC9wb2RwOk5hendpc2tvPjxwb2RwOkRhdGFVcm9kemVuaWE+MTk4MC0wMS0wMTwv
cG9kcDpEYXRhVXJvZHplbmlhPjxwb2RwOkt3b3RhPjEyNS42MDwvcG9kcDpLd290YT48L3BvZHA6RGFuZUF1dG9yeXp1am
FjZT48L0Rla2xhcmFjamE+
30/55
2.12 Przykładowy dokument XML podpisany podpisem elektronicznym
nieweryfikowanym za pomocą ważnego kwalifikowanego certyfikatu
(wizualizacja w formacie „pretty print”)
<Naglowek>
<KodFormularza kodPodatku="VAP" kodSystemowy="VAP-1 (1)" rodzajZobowiazania="Z"
wersjaSchemy="1-1E">VAP-1</KodFormularza>
<Rok>2012</Rok>
<Kwartal>1</Kwartal>
</Naglowek>
<Podmiot1 rola="Podatnik">
<OsobaNiefizyczna>
<NumerIdentyfikacyjny>0000000000</NumerIdentyfikacyjny>
<PelnaNazwa>STILO AV</PelnaNazwa>
</OsobaNiefizyczna>
<AdresSiedziby rodzajAdresu="RAD">
<etd:KodKraju>NL</etd:KodKraju>
<etd:KodPocztowy>3027SC</etd:KodPocztowy>
<etd:Miejscowosc>AMSTERDAM</etd:Miejscowosc>
<etd:Ulica>SIEDAMSEEWEG</etd:Ulica>
<Telefon>003112345678</Telefon>
<Email>[email protected]</Email>
</AdresSiedziby>
</Podmiot1>
<P_9>123456789B12</P_9>
<P_10>NL</P_10>
<P_C typ="G">
<P_CA>N1234NV</P_CA>
<P_CB>45</P_CB>
<P_CC>5500.00</P_CC>
</P_C>
<P_19>5500.00</P_19>
<P_PODSTAWA>5500</P_PODSTAWA>
<P_21>8</P_21>
<P_PODATEK>440</P_PODATEK>
<P_24>ADAM</P_24>
<P_25>NOWAK</P_25>
<Pouczenie>W przypadku niewpłacenia w obowiązującym terminie kwoty z poz.22 lub wpłacenia
jej w niepełnej wysokości, niniejsza deklaracja stanowi podstawę do wystawienia tytułu
egzekucyjnym w administracji (Dz.U. z 2005 r. Nr 229, poz.1954, z późn. zm.).</Pouczenie>
<podpis:DaneAutoryzujaceVAP
xmlns:podpis="http://e-deklaracje.mf.gov.pl/Repozytorium/Definicje/Podpis/">
<podpis:NumerIdentyfikacyjny>0000000000</podpis:NumerIdentyfikacyjny>
<podpis:PodstawaObliczeniaPodatku>0</podpis:PodstawaObliczeniaPodatku>
<podpis:KwotaPodatku>0</podpis:KwotaPodatku>
</podpis:DaneAutoryzujaceVAP>
</Deklaracja>
2.13 Przykładowy dokument XML zawierający wskazane we wzorze XSD załączniki
(wizualizacja dla wzoru 2012/12/07/1070 - PIT-37(18) - w formacie „pretty print”)
xmlns:z2k="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/12/15/eD/PIT2K/"
xmlns:zd="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/12/15/eD/PITD/"
xmlns:zo3x="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/12/15/eD/PITO3X/"
xmlns:zzu="http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/10/07/eD/ORDZU/">
<Naglowek>
31/55
<Rok>2012</Rok>
</Naglowek>
<etd:OsobaFizyczna>
<etd:ImiePierwsze>ADAM</etd:ImiePierwsze>
<etd:AdresPol>
<etd:Wojewodztwo>a</etd:Wojewodztwo>
<etd:Powiat>a</etd:Powiat>
<etd:Gmina>a</etd:Gmina>
<etd:Ulica>a</etd:Ulica>
<etd:Miejscowosc>a</etd:Miejscowosc>
<etd:Poczta>a</etd:Poczta>
</etd:AdresPol>
</Podmiot1>
<Podmiot2 poz="P_2A" rola="Małżonek">
<etd:OsobaFizyczna>
<etd:ImiePierwsze>ANNA</etd:ImiePierwsze>
<etd:AdresPol>
</etd:AdresPol>
</Podmiot2>
<P_6>2</P_6>
<P_7>1</P_7>
<P_8>1</P_8>
<P_37>0</P_37>
<P_38>0</P_38>
<P_39>0</P_39>
<P_40>0</P_40>
<P_41>0</P_41>
<P_42>0</P_42>
<P_43>0</P_43>
<P_44>0</P_44>
<P_45>0</P_45>
<P_46>0</P_46>
<P_47>0</P_47>
<P_48>0</P_48>
<P_49>0</P_49>
<P_50>0</P_50>
<P_51>0</P_51>
<P_52>0</P_52>
<P_53>0</P_53>
<P_54>0</P_54>
<P_55>0</P_55>
<P_56>0</P_56>
<P_57>0</P_57>
<P_58>0</P_58>
<P_59>0</P_59>
<P_60>0</P_60>
<P_61>0</P_61>
<P_62>0</P_62>
<P_63>0</P_63>
<P_64>0</P_64>
32/55
<P_65>0</P_65>
<P_66>0</P_66>
<P_67>0</P_67>
<P_68>0</P_68>
<P_69>0</P_69>
<P_70>0</P_70>
<P_71>0</P_71>
<P_72>0</P_72>
<P_73>0</P_73>
<P_74>0</P_74>
<P_75>0</P_75>
<P_76>0</P_76>
<P_77>0</P_77>
<P_78>0</P_78>
<P_79>0</P_79>
<P_80>0</P_80>
<P_81>0</P_81>
<P_82>0</P_82>
<P_83>0</P_83>
<P_84>0</P_84>
<P_85>0</P_85>
<P_86>0</P_86>
<P_87>0</P_87>
<P_88>0</P_88>
<P_89>0</P_89>
<P_90>0</P_90>
<P_91>0</P_91>
<P_93>0</P_93>
<P_92>0</P_92>
<P_94>0</P_94>
<P_95>0</P_95>
<P_96>0</P_96>
<P_97>0</P_97>
<P_98>0</P_98>
<P_99>0</P_99>
<P_100>0</P_100>
<P_101>0</P_101>
<P_102>0</P_102>
<P_103>0</P_103>
<P_104>0</P_104>
<P_105>0</P_105>
<P_106>0</P_106>
<P_107>0</P_107>
<P_108>0</P_108>
<P_110>0</P_110>
<P_109>0</P_109>
<P_111>0</P_111>
<P_112>0</P_112>
<P_113>0</P_113>
<P_114>0</P_114>
<P_115>0</P_115>
<P_116>0</P_116>
<P_117>0</P_117>
<P_118>0</P_118>
<P_119>0</P_119>
<P_120>0</P_120>
<P_122>0</P_122>
<P_123>0000000000</P_123>
<P_124>0</P_124>
<P_125>CEL</P_125>
<P_126>1</P_126>
<P_127>a</P_127>
<P_128>1</P_128>
<P_129>1</P_129>
<P_130>1</P_130>
<P_131>0</P_131>
<P_132>1</P_132>
<P_133>3</P_133>
<Pouczenie>W wypadku niewpłacenia w obowiązującym terminie kwoty z poz.120 lub wpłacenia
jej w niepełnej wysokości niniejsze zeznanie stanowi podstawę do wystawienia tytułu
egzekucyjnym w administracji (Dz.U. z 2012 r. poz. 1015).</Pouczenie>
odpowiedzialności za podanie danych niezgodnych z rzeczywistością. W przypadku zaznaczenia w
poz.6 kwadratu nr 2, 3 albo 4, kwadratu w poz.7 lub w poz.8, oświadczam, iż spełnione są
warunki do opodatkowania dochodów w wybrany sposób. W przypadku zastosowania art.6 ust.2a
ustawy, oświadczam pod rygorem odpowiedzialności karnej za fałszywe zeznania, że spełniony
jest warunek przewidziany w tym przepisie.</Oswiadczenie>
<Zalaczniki>
<zo3x:Zalacznik_PIT_O>
33/55
<zo3x:Naglowek>
<zo3x:KodFormularza kodSystemowy="PIT/O (18)" wersjaSchemy="10E">PIT/O</zo3x:KodFormularza>
<zo3x:WariantFormularza>18</zo3x:WariantFormularza>
</zo3x:Naglowek>
<zo3x:PozycjeSzczegolowe>
<zo3x:P_4>1</zo3x:P_4>
<zo3x:P_11>0</zo3x:P_11>
<zo3x:P_12>0</zo3x:P_12>
<zo3x:P_13>0</zo3x:P_13>
<zo3x:P_14>0</zo3x:P_14>
<zo3x:P_15>0</zo3x:P_15>
<zo3x:P_16>0</zo3x:P_16>
<zo3x:P_17>0</zo3x:P_17>
<zo3x:P_18>0</zo3x:P_18>
<zo3x:P_19>0</zo3x:P_19>
<zo3x:P_20>0</zo3x:P_20>
<zo3x:P_21>0</zo3x:P_21>
<zo3x:P_22>0</zo3x:P_22>
<zo3x:P_23>0</zo3x:P_23>
<zo3x:P_24>0</zo3x:P_24>
<zo3x:P_25>a</zo3x:P_25>
<zo3x:P_26>0</zo3x:P_26>
<zo3x:P_27>0</zo3x:P_27>
<zo3x:P_28>0</zo3x:P_28>
<zo3x:P_29>0</zo3x:P_29>
<zo3x:P_30>0</zo3x:P_30>
<zo3x:P_31>0</zo3x:P_31>
<zo3x:P_32>0</zo3x:P_32>
<zo3x:P_33>0</zo3x:P_33>
<zo3x:P_34>1</zo3x:P_34>
<zo3x:P_35>0</zo3x:P_35>
<zo3x:P_36>0</zo3x:P_36>
<zo3x:P_37>0</zo3x:P_37>
<zo3x:P_38>0</zo3x:P_38>
<zo3x:P_39>a</zo3x:P_39>
<zo3x:P_40>0</zo3x:P_40>
<zo3x:P_41>0</zo3x:P_41>
<zo3x:P_42>0</zo3x:P_42>
<zo3x:P_43>0</zo3x:P_43>
<zo3x:P_D typ="G">
<zo3x:P_D1>a</zo3x:P_D1>
<zo3x:P_D3>PL</zo3x:P_D3>
<zo3x:P_D10>0</zo3x:P_D10>
<zo3x:P_D11>0</zo3x:P_D11>
</zo3x:P_D>
<zo3x:P_E typ="G">
<zo3x:P_E1>00000000000</zo3x:P_E1>
<zo3x:P_E5>1</zo3x:P_E5>
<zo3x:P_E6>1</zo3x:P_E6>
</zo3x:P_E>
</zo3x:PozycjeSzczegolowe>
</zo3x:Zalacznik_PIT_O>
<zd:Zalacznik_PIT_D>
<zd:Naglowek>
<zd:KodFormularza kodPodatku="PIT" kodSystemowy="PIT/D (22)" wersjaSchemy="10E">PIT/D</zd:KodFormularza>
<zd:WariantFormularza>22</zd:WariantFormularza>
</zd:Naglowek>
<zd:Podmiot1 rola="Podatnik">
<etd:OsobaFizyczna>
<etd:AdresPol>
34/55
</etd:AdresPol>
</zd:Podmiot1>
<zd:Podmiot2 rola="Małżonek">
<etd:OsobaFizyczna>
<etd:AdresPol>
</etd:AdresPol>
</zd:Podmiot2>
<zd:PozycjeSzczegolowe>
<zd:P_30>0</zd:P_30>
<zd:P_31>0</zd:P_31>
<zd:P_32>0</zd:P_32>
<zd:P_33>0</zd:P_33>
<zd:P_34>0</zd:P_34>
<zd:P_35>0</zd:P_35>
<zd:P_36>0</zd:P_36>
<zd:P_37>a</zd:P_37>
<zd:P_38>0</zd:P_38>
<zd:P_39>0</zd:P_39>
<zd:P_40>0</zd:P_40>
<zd:P_41>0</zd:P_41>
<zd:P_42>0</zd:P_42>
<zd:P_43>0</zd:P_43>
<zd:P_44>0</zd:P_44>
<zd:P_45>0</zd:P_45>
<zd:P_46>0</zd:P_46>
<zd:P_47>0</zd:P_47>
<zd:P_48>0</zd:P_48>
<zd:P_49>0</zd:P_49>
<zd:P_50>0</zd:P_50>
<zd:P_51>0</zd:P_51>
<zd:P_52>0</zd:P_52>
<zd:P_53>0</zd:P_53>
<zd:P_54>0</zd:P_54>
<zd:P_55>0</zd:P_55>
</zd:PozycjeSzczegolowe>
</zd:Zalacznik_PIT_D>
<z2k:Zalacznik_PIT-2K>
<z2k:Naglowek>
<z2k:KodFormularza kodPodatku="PIT" kodSystemowy="PIT-2K (6)" wersjaSchemy="10E">PIT-2K</z2k:KodFormularza>
<z2k:WariantFormularza>6</z2k:WariantFormularza>
</z2k:Naglowek>
<z2k:Podmiot1 rola="Podatnik">
<etd:OsobaFizyczna>
<etd:AdresPol>
<etd:Ulica>1</etd:Ulica>
<etd:NrLokalu>a</etd:NrLokalu>
35/55
</etd:AdresPol>
</z2k:Podmiot1>
<z2k:Podmiot2 rola="Małżonek">
<etd:OsobaFizyczna>
<etd:AdresPol>
</etd:AdresPol>
</z2k:Podmiot2>
<z2k:PozycjeSzczegolowe>
<z2k:P_29>2</z2k:P_29>
<z2k:P_30>0</z2k:P_30>
<z2k:P_31>0</z2k:P_31>
<z2k:P_32>1990</z2k:P_32>
<z2k:P_33>2002</z2k:P_33>
<z2k:P_34>2002</z2k:P_34>
<z2k:P_35>0</z2k:P_35>
</z2k:PozycjeSzczegolowe>
<z2k:Oswiadczenie>Oświadczam, że są mi znane przepisy Kodeksu karnego skarbowego o
odpowiedzialności za podanie danych niezgodnych z rzeczywistością.</z2k:Oswiadczenie>
</z2k:Zalacznik_PIT-2K>
<zzu:Zalacznik_ORD-ZU>
<zzu:Naglowek>
<zzu:KodFormularza kodSystemowy="ORD-ZU (2)" wersjaSchemy="2-0E">ORDZU</zzu:KodFormularza>
<zzu:WariantFormularza>2</zzu:WariantFormularza>
</zzu:Naglowek>
<zzu:PozycjeSzczegolowe>
<zzu:P_13>OPIS</zzu:P_13>
</zzu:PozycjeSzczegolowe>
</zzu:Zalacznik_ORD-ZU>
</Zalaczniki>
</Deklaracja>
36/55
3. Przesyłanie dokumentu elektronicznego do systemu e-Deklaracje
Komunikacja w systemie pomiędzy klientem serwisu a serwerem pozwala na:
 przesłanie dokumentu elektronicznego do systemu,
 pobranie komunikatów z serwera.
Inicjatorem sesji jest zawsze klient.
3.1 Ustanowienie sesji
Klient w celu komunikowania się z serwisem musi ustanowić sesję przy wykorzystaniu
protokołu https (http + ssl).
Informacje nt. certyfikatu SSL serwera systemu e-Deklaracje dostępne są na stronie
internetowej
systemu
e-Deklaracje
w
zakładce
„Do
pobrania”
(http://www.finanse.mf.gov.pl/systemy-informatyczne/e-deklaracje/do-pobrania).
3.2 Wysyłanie dokumentu
Przesyłanie dokumentu odbywa się przy wykorzystaniu usługi Web Service.
Komunikaty wymieniane z serwisem:
 Dokument wysłany (sendDocumentMessage)
 Stan przetworzenia dokumentu (sendDocumentResponseMessage)
lub
 Dokument wysłany (sendUnsignDocumentMessage)
 Stan przetworzenia dokumentu (sendUnsignDocumentResponseMessage)
lub
 Dokument wysłany (sendDocumentWithAttachment)
 Stan przetworzenia dokumentu (sendDocumentWithAttachmentResponseMessage)
W wyniku przesłania dokumentu do systemu osoba wysyłająca otrzymuje zwrotnie
numer referencyjny dokumentu (identyfikator), numer statusu i opis statusu.
3.3 Pobieranie dokumentu (potwierdzenia)
Pobieranie dokumentu (potwierdzenia) odbywa się przy wykorzystaniu usługi Web
Service.
Komunikaty wymieniane z serwisem:
 Żądanie pobrania dokumentu (requestUPOMessage)
 Dokument potwierdzający przyjęcie dokumentu (requestUPOResponseMessage)
W wyniku przesłania żądania pobrania potwierdzenia złożenia dokumentu do systemu
(zawierającego numer referencyjny dokumentu), osoba wysyłająca otrzymuje zwrotnie
numer statusu oraz opis statusu złożonego dokumentu i Urzędowe Poświadczenie
Odbioru (UPO - tylko dla statusu 200).
37/55
3.4 Informacje dodatkowe zawarte w pobieranym dokumencie (potwierdzeniu)
1. Dla pobranego dokumentu (potwierdzenia) o numerze statusu 401 w opisie statusu
zawarta jest dodatkowa informacja, wskazująca na przyczynę błędu i odrzucenie
złożonego dokumentu (nie jest przekazywany do dalszego przetwarzania).
Przykładowy komunikat wygląda następująco:
Dokument niezgodny ze schematem xsd [cvc-complex-type.2.4.a: Znaleziono
nieprawidłową zawartość zaczynając od elementu 'P_35'. Spodziewano się jednego z
'{"":P_36, "":P_37, "":P_38, "":P_39, "":P_40, "":P_41, "":P_42}'.]
2. Do podpisania dokumentu UPO (potwierdzenia) o numerze statusu 200 zastosowano
podpis XML typu enveloping.
3. Element <SkrotDokumentu> Urzędowego Poświadczenia Odbioru zawiera ciąg
znaków składający się z oryginalnego skrótu przesłanego dokumentu oraz w
nawiasach [ ] skrót znormalizowanego dokumentu wyliczony algorytmem MD5.
Przykładowa zawartość elementu <SkrotDokumentu>:
<SkrotDokumentu>vS0OIgTu7dlYtE3K9Mtp7V3cFS0=
[E84A8167250133E1B262D9EAC1FC8101]</SkrotDokumentu>
4. Element <KodUrzedu> Urzędowego Poświadczenia Odbioru zawiera 4-znakowy kod
jednostki administracji podatkowej do której kierowano dokument elektroniczny ( kod
zgodny ze strukturą określoną we wzorze opublikowanym w CRD ePUAP pod
adresem
http://crd.gov.pl/xml/schematy/dziedzinowe/mf/2011/06/21/eD/DefinicjeTypy/KodyUrz
edowSkarbowych_v3-0E.xsd ).
38/55
3.5 Struktura logiczna urzędowego poświadczenia odbioru (UPO)
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"
attributeFormDefault="unqualified" version="1.0" xml:lang="PL">
<xsd:element name="Potwierdzenie">
<xsd:annotation>
<xsd:documentation>Element główny potwierdzenia</xsd:documentation>
</xsd:annotation>
<xsd:complexType>
<xsd:sequence>
<xsd:element name="NazwaPodmiotuPrzyjmujacego" fixed="Ministerstwo Finansów">
<xsd:annotation>
<xsd:documentation>Nazwa podmiotu przyjmującego dokument
elektroniczny</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:token">
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="NumerReferencyjny">
<xsd:annotation>
<xsd:documentation>Identyfikator złożonego dokumentu nadany przez
CRD</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="SkrotDokumentu">
<xsd:annotation>
<xsd:documentation>Wartość funkcji skrótu złożonego dokumentu - identyczna z
wartością użytą do podpisu składanego dokumentu</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="SkrotZlozonejStruktury">
<xsd:annotation>
<xsd:documentation>Wartość funkcji skrótu dokumentu w postaci otrzymanej
przez system (łącznie z podpisem elektronicznym)</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="NazwaStrukturyLogicznej">
<xsd:annotation>
<xsd:documentation>Nazwa pliku XSD struktury logicznej dotycząca złożonego
dokumentu</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="DataWplyniecia">
<xsd:annotation>
<xsd:documentation>Data wpłynięcia dokumentu do systemu informatycznego
administracji podatkowej (data ze stempla czasu)</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:restriction base="xsd:dateTime">
</xsd:restriction>
39/55
</xsd:simpleType>
</xsd:element>
<xsd:element name="StempelCzasu">
<xsd:annotation>
<xsd:documentation>Treść stempla czasu w postaci zakodowanej algorytmem
Base64</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:choice>
<xsd:element name="NIP1">
<xsd:annotation>
<xsd:documentation>Identyfikator podatkowy NIP podmiotu, występującego
jako pierwszy na dokumencie elektronicznym</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="PESEL1">
<xsd:annotation>
<xsd:documentation>Identyfikator podatkowy numer PESEL podmiotu,
występującego jako pierwszy na dokumencie elektronicznym</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="NumerIdentyfikacyjny">
<xsd:annotation>
<xsd:documentation>Numer identyfikacyjny VAP na potrzeby wykonywanych na
terytorium kraju usług międzynarodowego przewozu drogowego</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
<xsd:pattern value="[0]{3}\d{7}"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:choice>
<xsd:choice minOccurs="0">
<xsd:element name="NIP2">
<xsd:annotation>
<xsd:documentation>Identyfikator podatkowy NIP podmiotu, występującego
jako drugi na dokumencie elektronicznym</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="PESEL2">
<xsd:annotation>
<xsd:documentation>Identyfikator podatkowy numer PESEL podmiotu,
występującego jako drugi na dokumencie elektronicznym</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:choice>
<xsd:element name="KodUrzedu">
<xsd:annotation>
<xsd:documentation>Kod jednostki administracji podatkowej, do której
kierowano dokument elektroniczny</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
40/55
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="KodFormularza">
<xsd:annotation>
<xsd:documentation>Kod formularza przedłożonego dokumentu
elektronicznego</xsd:documentation>
</xsd:annotation>
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Przyjeto">
<xsd:simpleType>
<xsd:annotation>
<xsd:documentation>Typ logiczny</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:boolean">
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
<xsd:element name="Blad" minOccurs="0" maxOccurs="unbounded">
<xsd:simpleType>
</xsd:restriction>
</xsd:simpleType>
</xsd:element>
</xsd:sequence>
<xsd:attribute name="wersjaSchemy" type="xsd:string" use="optional">
<xsd:annotation>
<xsd:documentation>Wersja schemy 5.0</xsd:documentation>
</xsd:annotation>
</xsd:attribute>
</xsd:complexType>
</xsd:element>
</xsd:schema>
41/55
4. Specyfikacja usługi Web Service
Adres usługi Web Service - bramka w Ministerstwie Finansów:
https://bramka.e-deklaracje.mf.gov.pl/uslugi/dokumenty
Komponent bramka aktualnie realizuje usługi:
 sendDocument (przesłanie dokumentu),
 sendUnsignDocument (przesłanie dokumentu)
 sendDocumentWithAttachment (przesłanie dokumentu)
 requestUPO (pobranie UPO),
Funkcje usługi Web Service
4.1 Usługa sendDocument
4.1.1 Opis ogólny
Usługa sendDocument służy do przesyłania dokumentów elektronicznych. Wymagane jest,
aby każdy składany dokument był podpisany (XAdES lub PKCS#7) z wykorzystaniem
odpowiedniego certyfikatu, oraz posiadał odpowiednią strukturę (w specyfikacji WSDL jest to
operacja sendDocument).
4.1.2 Opis szczegółowy
Dane wejściowe:
 Dokument - binarna postać podpisanego dokumentu XML zakodowanego zgodnie
z formatem Base64Binary. Dokument powinien mieć format zgodny z aktualnie
obowiązującym schematem.
Dane wyjściowe:
 Numer Referencyjny – typu string – numer złożonego dokumentu. Numer
referencyjny nie jest zwracany w przypadku komunikatu dla dokumentu nie
nadającego się do przetworzenia.
 Status – typu int - numer statusu, jaki otrzymał złożony dokument.
 Opis statusu – typu string – opis statusu, jaki otrzymał złożony dokument.
Możliwe statusy dokumentu:
Status
Opis
Grupa komunikatów dla dokumentów, które nie nadają się do przetworzenia
100-199
(wadliwy komunikat SOAP) lub nastąpił krytyczny błąd serwera.
300-399
Grupa komunikatów dla dokumentów w trakcie przetwarzania.
Aktualnie usługa zwraca następujące statusy:
 100 - Błędny komunikat SOAP
 101 – Proszę o ponowne przesłanie dokumentu
 300 – Brak dokumentu
 301 – Dokument w trakcie przetwarzania, sprawdź wynik następnej weryfikacji
dokumentu
 302 – Dokument wstępnie przetworzony, sprawdź wynik następnej weryfikacji
dokumentu
42/55

303 – Dokument w trakcie weryfikacji podpisu, sprawdź wynik następnej weryfikacji
dokumentu
4.1.3 Przykład wykorzystania
Dane wysłane do Web Service:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="https://bramka.e-deklaracje.mf.gov.pl/xsd">
<soapenv:Header/>
<soapenv:Body>
<xsd:sendDocument>
<xsd:document>PD94cfgW0 … eGTzVT2=</xsd:document>
</xsd:sendDocument>
</soapenv:Body>
</soapenv:Envelope>
Dane zwrócone przez Web Service:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
<soapenv:Body>
<ns:sendDocumentResponse xmlns:ns="https://bramka.e-deklaracje.mf.gov.pl/xsd">
<ns:refId>40cf32ef75d875aed13300041abe21e2</ns:refId>
<ns:status>301</ns:status>
<ns:statusOpis>Dokument w trakcie przetwarzania, sprawdź wynik następnej weryfikacji
dokumentu</ns:statusOpis>
</ns:sendDocumentResponse>
</soapenv:Body>
</soapenv:Envelope>
43/55
4.2 Usługa sendUnsignDocument
4.2.1 Opis ogólny
Usługa sendUnsignDocument służy do przesyłania dokumentów elektronicznych.
Wymagane jest, aby każdy składany dokument zawierał element <DaneAutoryzujace> lub
<DaneAutoryzujaceVAP>, dodawany w elemencie <Deklaracja> jako ostatni element, oraz
posiadał
odpowiednią
strukturę
(w
specyfikacji
WSDL
jest
to
operacja
sendUnsignDocument).
Dane wejściowe:
 Dokument - binarna postać dokumentu XML zakodowanego zgodnie z formatem
Base64Binary. Dokument powinien mieć format zgodny z aktualnie obowiązującym
schematem.
 Wersja językowa w jakiej są dane dokumentu (opcjonalny element „language”).
Może przyjąć wartość „de”, „en” lub „pl”. Brak tego elementu oznacza wybór języka
polskiego.
 Rodzaj użytego podpisu elektronicznego (opcjonalny element „signatureType”).
Może przyjąć wartość „PIT” dla dokumentu z podpisem typu „dane autoryzujące” lub
„MPO” dla dokumentu z podpisem typu „dane autoryzujące VAP”. Brak tego
elementu oznacza użycie podpisu typu „dane autoryzujące”.
Dane wyjściowe:
 Numer Referencyjny – typu string – numer
złożonego
dokumentu.
Numer
Status
Opis
100-199
300-399
 101 – Proszę o ponowne przesłanie dokumentu
 300 – Brak dokumentu
 301 – Dokument w trakcie przetwarzania, sprawdź wynik następnej weryfikacji
dokumentu
dokumentu
44/55
4.2.3 Przykład I wykorzystania
<soapenv:Header/>
<soapenv:Body>
<xsd:sendUnsignDocument>
<xsd:document>PD94bWwgdmVyc … 9EZWtsYXJhY2phPg0K</xsd:document>
</xsd:sendUnsignDocument>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Body>
<ns:sendUnsignDocumentResponse xmlns:ns="https://bramka.e-deklaracje.mf.gov.pl/xsd">
</ns:sendUnsignDocumentResponse>
</soapenv:Body>
</soapenv:Envelope>
4.2.4 Przykład II wykorzystania usługi
<soapenv:Header/>
<soapenv:Body>
<xsd:sendUnsignDocument>
<xsd:document>PD94bWwgdmVyc2lvbj0iM … YWNqYT4NCg==</xsd:document>
<xsd:language>en</xsd:language>
<xsd:signatureType>MPO</xsd:signatureType>
</xsd:sendUnsignDocument>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Body>
<ns:sendUnsignDocumentResponse xmlns:ns="https://bramka.e-deklaracje.mf.gov.pl/xsd">
<ns:refId>e14b887e5b9152514033000afecedfba</ns:refId>
<ns:statusOpis>Document was subject to ongoing processing, check results of the next
verification</ns:statusOpis>
</ns:sendUnsignDocumentResponse>
</soapenv:Body>
</soapenv:Envelope>
45/55
4.3 Usługa sendDocumentWithAttachment
4.3.1 Opis ogólny
Usługa sendDocumentWithAttachment służy do przesyłania dokumentów elektronicznych
z załącznikiem binarnym. Wymagane jest, aby każdy składany dokument był podpisany
(XAdES lub PKCS#7) z wykorzystaniem odpowiedniego certyfikatu, oraz posiadał
odpowiednią
strukturę
(w specyfikacji
WSDL
jest
to
operacja
sendDocumentWithAttachment).
Dane wejściowe:
 Dokument - binarna postać podpisanego dokumentu XML zakodowanego zgodnie
z formatem Base64Binary. Dokument powinien mieć format zgodny z aktualnie
obowiązującym schematem.
 Załącznik - binarna postać dokumentu ZIP zakodowanego zgodnie z formatem
Base64Binary (element opcjonalny).
Dane wyjściowe:
 Numer Referencyjny – typu string – numer złożonego dokumentu. Numer
Status
Opis
100-199
300-399
Uwaga! W zależności od wykrytego rodzaju błędu w załączniku komunikat może być poszerzony o tekst:
„załącznik przekracza dopuszczalną długość” lub „błędny format pliku ZIP”.





101 – Proszę o ponowne przesłanie dokumentu
300 – Brak dokumentu
301 – Dokument w trakcie przetwarzania, sprawdź wynik następnej weryfikacji
dokumentu
302 – Dokument wstępnie przetworzony, sprawdź wynik następnej weryfikacji
dokumentu
303 – Dokument w trakcie weryfikacji podpisu, sprawdź wynik następnej weryfikacji
dokumentu
46/55
4.3.3 Przykład wykorzystania
<soapenv:Header/>
<soapenv:Body>
<xsd:sendDocumentWithAttachment>
<xsd:document>PGRzOlNpZ25 … aWduYXR1cmU+</xsd:document>
<xsd:attachment>UEsDBBQAAgA … oAy5TXmEd/9g3AA=</xsd:attachment>
</xsd:sendDocumentWithAttachment>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Body>
<ns:sendDocumentWithAttachmentResponse
xmlns:ns="https://bramka.e-deklaracje.mf.gov.pl/xsd">
</ns:sendDocumentWithAttachmentResponse>
</soapenv:Body>
</soapenv:Envelope>
47/55
4.4 Usługa requestUPO
4.4.1 Opis ogólny
Usługa requestUPO służy do pobrania Urzędowego Poświadczenia Odbioru (UPO) dla
podanego Numeru Referencyjnego dokumentu (w specyfikacji WSDL jest to operacja
requestUPO).
Dane wejściowe:
 Numer Referencyjny przedłożonego, operacją sendDocument lub
sendUnsignDocument lub sendDocumentWithAttachment, dokumentu,
 Wersja językowa w jakiej ma zostać zwrócony opis statusu przetwarzania
dokumentu elektronicznego (opcjonalny element „language”). Może przyjąć wartość
„de”, „en” lub „pl”. Brak tego elementu oznacza wybór języka polskiego.
Dane wyjściowe:
 UPO – podpisany dokument XML, typu: string, zwracany tylko w sytuacji, kiedy
został wygenerowany.
 Status - typu int - numer statusu, jaki otrzymał złożony dokument.
Możliwe statusy dokumentów:
Status
Opis
100-199
Grupa komunikatów dla dokumentów poprawnych lub uwzględniających
200-299
dodatkową interakcję.
300-399
Grupa komunikatów dla dokumentów niepoprawnych ze względu na błędy
400-499
strukturalne syntaktyki; kolejne statusy wskazują na powód odrzucenia
dokumentu.
 102 – Proszę o ponowne przesłanie żądania UPO
 200 - Przetwarzanie dokumentu zakończone poprawnie, pobierz UPO
 200 - Przesłałeś duplikat, pobrane UPO dotyczy oryginału dokumentu. Przetwarzanie
dokumentu zakończone poprawnie, pobierz UPO
 300 - Brak dokumentu
 301 - Dokument w trakcie przetwarzania, sprawdź wynik następnej weryfikacji
dokumentu
dokumentu
 303 – Dokument w trakcie weryfikacji podpisu, sprawdź wynik następnej weryfikacji
dokumentu
 400 - Przetwarzanie dokumentu zakończone błędem
 401 – Weryfikacja negatywna - dokument niezgodny ze schematem xsd
 402 - Brak aktualnego pełnomocnictwa/upoważnienia do podpisywania deklaracji
 403 - Dokument z niepoprawnym podpisem
 404 - Dokument z nieważnym certyfikatem
 405 - Dokument z odwołanym certyfikatem
48/55
















406 - Dokument z certyfikatem z nieobsługiwanym dostawcą
407 - Dokument z certyfikatem z nieprawidłową ścieżką
408 - Dokument zawiera błędy uniemożliwiające jego przetworzenie
409 – Dokument zawiera niewłaściwą ilość i/lub rodzaj elementów
410 – Złożony dokument bez podpisu nie może być korektą
411 – Weryfikacja negatywna - w systemie jest już złożony dokument z takim
identyfikatorem podatkowym
412 – Weryfikacja negatywna - niezgodność danych autoryzujących z danymi
w dokumencie (np. niezgodność NIP, numeru PESEL, daty urodzenia, nazwiska,
pierwszego imienia)
413 – Dokument z certyfikatem bez wymaganych atrybutów
414 – Weryfikacja negatywna - błąd w danych autoryzujących (np. błąd w nazwisku,
pierwszym imieniu, dacie urodzenia, NIP, numerze PESEL, kwocie przychodu)
415 – Zawartość załącznika niezgodna z deklarowaną listą plików
416 – Dla tego typu deklaracji załącznik binarny nie jest dozwolony
417 – Wniosek VAT-REF wymaga przynajmniej jednej z pozycji:
VATRefundApplication lub ProRataRateAdjustment
418 – Dla złożonej deklaracji wymagane jest użycie podpisu kwalifikowanego
419 – Brak zaznaczenia celu złożenia formularza jako korekty deklaracji (zeznania)
lub brak uzasadnienia przyczyny złożenia korekty deklaracji (zeznania)
420 - Użycie podpisu DaneAutoryzujaceVAP jest dozwolone jedynie dla dokumentu
VAP-1
421 - Dokument VAP-1 można złożyć jedynie z użyciem podpisu
DaneAutoryzujaceVAP




422 – Weryfikacja negatywna - dokument złożony z użyciem danych autoryzujących
może złożyć wyłącznie podatnik, będący osobą fizyczną
423 - Dokument może złożyć wyłącznie podmiot będący osobą fizyczną, niebędący
pełnomocnikiem
424 - Nie podano numeru VAT dostawcy lub numeru faktury, a nie jest to faktura
uproszczona
425 - Kod państwa członkowskiego identyfikacji dostawcy jest niezgodny z kodem
państwa, do którego kierowany jest wniosek
4.4.3 Przykład I wykorzystania
<soapenv:Header/>
<soapenv:Body>
<xsd:requestUPO>
<xsd:refId>3be2b2540e9b5d106833000a78e3404d</xsd:refId>
</xsd:requestUPO>
</soapenv:Body>
</soapenv:Envelope>
<?xml version="1.0" encoding="UTF-8"?><soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"><soapenv:Body><ns:requestUPOResponse
xmlns:ns="https://bramka.e-deklaracje.mf.gov.pl/xsd"><ns:upo><ds:Signature
xmlns:ds="http://www.w3.org/2000/09/xmldsig#" Id="Sgn_20111901313494_0"><ds:SignedInfo
Id="SgnInfo_20111902840860_7"><ds:CanonicalizationMethod
Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/><ds:SignatureMethod
49/55
Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/><ds:Reference
Type="http://www.w3.org/2000/09/xmldsig#Object" Id="Ref_20111902255098_4"
URI="#Obj_20111902019436_3"><ds:Transforms><ds:Transform
Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/></ds:Transforms><ds:DigestMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><ds:DigestValue>bc8TMsQZ5xa/YGB+llHRVGM59H
g=</ds:DigestValue></ds:Reference><ds:Reference
Type="http://uri.etsi.org/01903#SignedProperties" Id="Ref_20111902786020_5"
URI="#SgnProp_20111901413622_1"><ds:Transforms><ds:Transform
Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/></ds:Transforms><ds:DigestMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><ds:DigestValue>T6V8kCqMmXyGgwQhSN1KZK/O2f
s=</ds:DigestValue></ds:Reference></ds:SignedInfo><ds:SignatureValue
Id="SgnVal_20111902825902_6">0Y0UvX+iXz2nccvKC7NEsExIip6ela4aQ/D+I9EFIRsLt8FnaZI5tO4VgbFFzbQyb
ok8vjgMAHBd9h6WVGhb5k+ZlBLcf6BR6l6HvAYN3xKY2uGrUlwwbxiJUdnladGBllc51gAX09OmoseUc98yDTvwJwiZFGL
UrNgRS5a3lNtFXVrpn+UKDzU0aaBK9dLTe55Gu7K+EYDAKYKUZwaev7Rkpy5f65pLszbppzkq2hHW04OMyq3pOQ3pbcLH4
e3/kOc2e8xYxtX7JccqFkve3EllLJTEjVWmMSmVWIuzsmUKRPKf0mJNKiJbCkDVWeEQQX9KsH7BLBdeHhY4wl1DZg==</d
s:SignatureValue><ds:KeyInfo
Id="Key_20111901747144_2"><ds:X509Data><ds:X509Certificate>MIIGQzCCBSugAwIBAgIQagXuR3A2QYyAKdH
BLn272zANBgkqhkiG9w0BAQUFADB3MQswCQYDVQQGEwJQTDEiMCAGA1UEChMZVW5pemV0byBUZWNobm9sb2dpZXMgUy5BL
jEnMCUGA1UECxMeQ2VydHVtIENlcnRpZmljYXRpb24gQXV0aG9yaXR5MRswGQYDVQQDExJDZXJ0dW0gTGV2ZWwgSVYgQ0E
wHhcNMTIwNTIyMTMxODIyWhcNMTUwNTIxMTMxODIyWjCBtDELMAkGA1UEBhMCUEwxHjAcBgNVBAoMFU1pbmlzdGVyc3R3b
yBGaW5hbnNvdzELMAkGA1UECwwCTUYxETAPBgNVBAcMCFdhcnN6YXdhMRQwEgYDVQQIDAttYXpvd2llY2tpZTEfMB0GA1U
EAwwWZS1kZWtsYXJhY2plLm1mLmdvdi5wbDEuMCwGCSqGSIb3DQEJARYfaW5mby5lLWRla2xhcmFjamVAbW9mbmV0Lmdvd
i5wbDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAOhCVPa+9kltffAai7OjGnXV4UY2jHkUotvBolzkSUGX9uv
n+kvMTfWXNUaAi4ogn+89USsCYVZBkk6P1q07GNFCy+sqimgvXCsmJUQuJcny9DuUT5mkdGnppFa8IM0dJ2AQWlQOzzfuj
Xq7JblJyDBpcfKfB9QfSo59pLh/0XCC1uhUaAF+1zddTnP5VSK/Bct7pSsQtGyS47WlwOvGri2lsPqlNSgSaHd155ldgEc
CQBWJksLixbR+FD0FcB8av9sPovBRl1v9/50dDRMDtFJqvQ5KoKTuc0UIEn3zSavHNPTZMqj0dTuvn79mELhDjIxEOMcfB
ZZHoNTt9dRjOcMCAwEAAaOCAoswggKHMAwGA1UdEwEB/wQCMAAwLAYDVR0fBCUwIzAhoB+gHYYbaHR0cDovL2NybC5jZXJ
0dW0ucGwvbDQuY3JsMFoGCCsGAQUFBwEBBE4wTDAhBggrBgEFBQcwAYYVaHR0cDovL29jc3AuY2VydHVtLnBsMCcGCCsGA
QUFBzAChhtodHRwOi8vd3d3LmNlcnR1bS5wbC9sNC5jZXIwHwYDVR0jBBgwFoAUzUpGygNlkOYxEBqCxqUcXtFQzx8wHQY
DVR0OBBYEFMyqNW0AEavY9RcVms3De8P22IxdMA4GA1UdDwEB/wQEAwIE8DCCAT0GA1UdIASCATQwggEwMIIBLAYKKoRoA
Yb2dwICBDCCARwwJQYIKwYBBQUHAgEWGWh0dHBzOi8vd3d3LmNlcnR1bS5wbC9DUFMwgfIGCCsGAQUFBwICMIHlMCAWGVV
uaXpldG8gVGVjaG5vbG9naWVzIFMuQS4wAwIBARqBwFVzYWdlIG9mIHRoaXMgY2VydGlmaWNhdGUgaXMgc3RyaWN0bHkgc
3ViamVjdGVkIHRvIHRoZSBDRVJUVU0gQ2VydGlmaWNhdGlvbiBQcmFjdGljZSBTdGF0ZW1lbnQgKENQUykgaW5jb3Jwb3J
hdGVkIGJ5IHJlZmVyZW5jZSBoZXJlaW4gYW5kIGluIHRoZSByZXBvc2l0b3J5IGF0IGh0dHBzOi8vd3d3LmNlcnR1bS5wb
C9yZXBvc2l0b3J5LjAdBgNVHSUEFjAUBggrBgEFBQcDAgYIKwYBBQUHAwQwEQYJYIZIAYb4QgEBBAQDAgWgMCoGA1UdEQQ
jMCGBH2luZm8uZS1kZWtsYXJhY2plQG1vZm5ldC5nb3YucGwwDQYJKoZIhvcNAQEFBQADggEBAFYZpxv8CwW8R5pzvPy/J
NEvvoyzhHqHWnBkpcD+JnoEl+lyCgBbQY9/tCZ9Gj1gloS3u0Ko/cNqOVw0Rc6ERuwcIzijpQeqG/Q+eSgEvNCoaNjEV/x
RwkAY0u/XWv3N1MXKIbeOiz1mE7/hSxX55nJmv8t5UcGKrVylk2H99W/dknBkt8ebx29w3+lEE25pzn8Txo0CQx7UMftgk
Y7V1ndDKjKrnvRKDsHEB0TE0DlcCze15IAnEIq1ymB3QpAIAvjVlcb8OuCzJzSnOyZZe+qNtMtXhlYi0xNn2kgedN5xO8B
LAxQx7MNMsdiL9vzvgBXjKLX5xXk/Z6Jvl9lRBEw=</ds:X509Certificate><ds:X509IssuerSerial><ds:X509Iss
uerName>CN=Certum Level IV CA,OU=Certum Certification Authority,O=Unizeto Technologies
S.A.,C=PL</ds:X509IssuerName><ds:X509SerialNumber>140928961910906876916125607116213697499</ds:
X509SerialNumber></ds:X509IssuerSerial></ds:X509Data></ds:KeyInfo><ds:Object><etsi:QualifyingP
roperties xmlns:etsi="http://uri.etsi.org/01903/v1.3.2#"
Target="#Sgn_20111901313494_0"><etsi:SignedProperties
Id="SgnProp_20111901413622_1"><etsi:SignedSignatureProperties><etsi:SigningTime>2012-1126T09:08:40+01:00</etsi:SigningTime><etsi:SigningCertificate><etsi:Cert><etsi:CertDigest><ds:D
igestMethod
Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><ds:DigestValue>cEb+Yk9B1zpJDXyQyGCRarQGqg
Y=</ds:DigestValue></etsi:CertDigest><etsi:IssuerSerial><ds:X509IssuerName>CN=Certum Level IV
CA,OU=Certum Certification Authority,O=Unizeto Technologies
S.A.,C=PL</ds:X509IssuerName><ds:X509SerialNumber>140928961910906876916125607116213697499</ds:
X509SerialNumber></etsi:IssuerSerial></etsi:Cert></etsi:SigningCertificate><etsi:SignaturePoli
cyIdentifier><etsi:SignaturePolicyImplied/></etsi:SignaturePolicyIdentifier></etsi:SignedSigna
tureProperties></etsi:SignedProperties></etsi:QualifyingProperties></ds:Object><ds:Object
Id="Obj_20111902019436_3" MimeType="text/xml"><Potwierdzenie wersjaSchemy="5-0">
<NazwaPodmiotuPrzyjmujacego>Ministerstwo Finansów</NazwaPodmiotuPrzyjmujacego>
<NumerReferencyjny>3be2b2540e9b5d106833000a78e3404d</NumerReferencyjny>
<SkrotDokumentu>[AFE4551D7F099FBF67E28A92ADF5F154]</SkrotDokumentu>
<SkrotZlozonejStruktury>15234CCDF842F24E2341117A86E82AE4</SkrotZlozonejStruktury>
<NazwaStrukturyLogicznej>http://crd.gov.pl/wzor/2012/09/03/984/schemat.xsd dla VAT-7
wariant 12 schemat 2-0E</NazwaStrukturyLogicznej>
<DataWplyniecia>2012-11-26T09:08:33.000+01:00</DataWplyniecia>
<StempelCzasu>MjAxMi0xMS0yNlQwOTowODozMy4wMDArMDE6MDA=</StempelCzasu>
<NIP1>11111111111</NIP1>
<KodFormularza>VAT-7</KodFormularza>
<Przyjeto>true</Przyjeto>
</Potwierdzenie></ds:Object></ds:Signature>
</ns:upo><ns:status>200</ns:status><ns:statusOpis>Przetwarzanie dokumentu zakończone
poprawnie, pobierz UPO</ns:statusOpis>
</ns:requestUPOResponse></soapenv:Body></soapenv:Envelope>
50/55
4.4.4 Przykład II wykorzystania usługi
<soapenv:Header/>
<soapenv:Body>
<xsd:requestUPO>
<xsd:refId>abff67035e12ff53d133000a7e624fb5</xsd:refId>
<xsd:language>en</xsd:language>
</xsd:requestUPO>
</soapenv:Body>
</soapenv:Envelope>
<soapenv:Body>
<ns:requestUPOResponse xmlns:ns="https://bramka.e-deklaracje.mf.gov.pl/xsd">
<ns:statusOpis>Default in ticking the purpose of submitting the form as a correction
return (tax return) or default in providing justification of submitting the correction
return(tax return).</ns:statusOpis>
</ns:requestUPOResponse>
</soapenv:Body>
</soapenv:Envelope>
51/55
4.5 Plik WSDL dla usługi Web Service
GateService.wsdl – wersja 4.0
<wsdl:definitions xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/"
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
xmlns:ns="https://bramka.e-deklaracje.mf.gov.pl/xsd"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:gate="https://bramka.e-deklaracje.mf.gov.pl/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
targetNamespace="https://bramka.e-deklaracje.mf.gov.pl/">
<wsdl:types>
<xs:schema attributeFormDefault="qualified" elementFormDefault="qualified"
targetNamespace="https://bramka.e-deklaracje.mf.gov.pl/xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:include schemaLocation="GateService?xsd=GateService.xsd"/>
</xs:schema>
</wsdl:types>
<wsdl:message name="sendDocumentWithAttachmentResponseMessage">
<wsdl:part name="part1" element="ns:sendDocumentWithAttachmentResponse"/>
</wsdl:message>
<wsdl:message name="sendUnsignDocumentResponseMessage">
<wsdl:part name="part1" element="ns:sendUnsignDocumentResponse"/>
</wsdl:message>
<wsdl:message name="requestUPOResponseMessage">
<wsdl:part name="part1" element="ns:requestUPOResponse"/>
</wsdl:message>
<wsdl:message name="sendDocumentResponseMessage">
<wsdl:part name="part1" element="ns:sendDocumentResponse"/>
</wsdl:message>
<wsdl:message name="sendUnsignDocumentMessage">
<wsdl:part name="part1" element="ns:sendUnsignDocument"/>
</wsdl:message>
<wsdl:message name="sendDocumentMessage">
<wsdl:part name="part1" element="ns:sendDocument"/>
</wsdl:message>
<wsdl:message name="requestUPOMessage">
<wsdl:part name="part1" element="ns:requestUPO"/>
</wsdl:message>
<wsdl:message name="sendDocumentWithAttachmentMessage">
<wsdl:part name="part1" element="ns:sendDocumentWithAttachment"/>
</wsdl:message>
<wsdl:portType name="GateServicePortType">
<wsdl:operation name="sendDocument">
<wsdl:input message="gate:sendDocumentMessage"/>
<wsdl:output message="gate:sendDocumentResponseMessage"/>
</wsdl:operation>
<wsdl:operation name="sendUnsignDocument">
<wsdl:input message="gate:sendUnsignDocumentMessage"/>
<wsdl:output message="gate:sendUnsignDocumentResponseMessage"/>
</wsdl:operation>
<wsdl:operation name="sendDocumentWithAttachment">
<wsdl:input message="gate:sendDocumentWithAttachmentMessage"/>
<wsdl:output message="gate:sendDocumentWithAttachmentResponseMessage"/>
</wsdl:operation>
<wsdl:operation name="requestUPO">
<wsdl:input message="gate:requestUPOMessage"/>
<wsdl:output message="gate:requestUPOResponseMessage"/>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="GateServiceSOAP12Binding" type="gate:GateServicePortType">
<soap12:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<soap12:operation soapAction="urn:sendDocument" style="document"/>
<wsdl:input>
<soap12:body use="literal" namespace="https://bramka.e-deklaracje.mf.gov.pl/"/>
</wsdl:input>
<wsdl:output>
</wsdl:output>
</wsdl:operation>
<soap12:operation soapAction="urn:sendUnsignDocument" style="document"/>
<wsdl:input>
</wsdl:input>
52/55
<wsdl:output>
</wsdl:output>
</wsdl:operation>
<soap12:operation soapAction="urn:sendDocumentWithAttachment" style="document"/>
<wsdl:input>
</wsdl:input>
<wsdl:output>
</wsdl:output>
</wsdl:operation>
<soap12:operation soapAction="urn:requestUPO" style="document"/>
<wsdl:input>
</wsdl:input>
<wsdl:output>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:binding name="GateServiceSOAP11Binding" type="gate:GateServicePortType">
<soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
<soap:operation soapAction="urn:sendDocument" style="document"/>
<wsdl:input>
<soap:body use="literal" namespace="https://bramka.e-deklaracje.mf.gov.pl/"/>
</wsdl:input>
<wsdl:output>
</wsdl:output>
</wsdl:operation>
<soap:operation soapAction="urn:sendUnsignDocument" style="document"/>
<wsdl:input>
</wsdl:input>
<wsdl:output>
</wsdl:output>
</wsdl:operation>
<soap:operation soapAction="urn:sendDocumentWithAttachment" style="document"/>
<wsdl:input>
</wsdl:input>
<wsdl:output>
</wsdl:output>
</wsdl:operation>
<soap:operation soapAction="urn:requestUPO" style="document"/>
<wsdl:input>
</wsdl:input>
<wsdl:output>
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="GateService">
<wsdl:port name="GateServiceSOAP12port" binding="gate:GateServiceSOAP12Binding">
<soap12:address location="https://bramka.e-deklaracje.mf.gov.pl/uslugi/dokumenty/"/>
</wsdl:port>
<wsdl:port name="GateServiceSOAP11port" binding="gate:GateServiceSOAP11Binding">
<soap:address location="https://bramka.e-deklaracje.mf.gov.pl/uslugi/dokumenty/"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
53/55
4.6 Plik XSD dla usługi Web Service
GateService.xsd – wersja 4.0
<xs:schema xmlns="https://bramka.e-deklaracje.mf.gov.pl/xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="https://bramka.edeklaracje.mf.gov.pl/xsd" elementFormDefault="qualified" attributeFormDefault="qualified">
<xs:element name="sendDocument">
<xs:complexType>
<xs:sequence>
<xs:element name="document" type="xs:base64Binary" nillable="false"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sendDocumentResponse">
<xs:complexType>
<xs:sequence>
<xs:element name="refId" type="xs:string" nillable="false" minOccurs="0"
maxOccurs="1"/>
<xs:element name="status" type="xs:int" nillable="false"/>
<xs:element name="statusOpis" type="xs:string" nillable="false"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sendUnsignDocument">
<xs:complexType>
<xs:sequence>
<xs:element name="language" nillable="false" minOccurs="0" maxOccurs="1">
<xs:simpleType>
<xs:restriction base="xs:string">
<xs:enumeration value="de"/>
<xs:enumeration value="en"/>
<xs:enumeration value="pl"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
<xs:element name="signatureType" nillable="false" minOccurs="0" maxOccurs="1">
<xs:simpleType>
<xs:enumeration value="PIT"/>
<xs:enumeration value="MPO"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sendUnsignDocumentResponse">
<xs:complexType>
<xs:sequence>
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sendDocumentWithAttachment">
<xs:complexType>
<xs:sequence>
<xs:element name="attachment" type="xs:base64Binary" minOccurs="0" maxOccurs="1"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="sendDocumentWithAttachmentResponse">
<xs:complexType>
<xs:sequence>
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="requestUPO">
54/55
<xs:complexType>
<xs:sequence>
<xs:element name="refId" type="xs:string" nillable="false"/>
<xs:element name="language" nillable="false" minOccurs="0" maxOccurs="1">
<xs:simpleType>
<xs:enumeration value="de"/>
<xs:enumeration value="en"/>
<xs:enumeration value="pl"/>
</xs:restriction>
</xs:simpleType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element name="requestUPOResponse">
<xs:complexType>
<xs:sequence>
<xs:element name="upo" type="xs:string" nillable="false" minOccurs="0"
maxOccurs="1"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
55/55

e-Deklaracje Specyfikacja We

Transkrypt

Podobne dokumenty

Analiza strukturalna

SHIMANO ULTEGRA 14000 XSD

Kilka ważnych pojęć

Przekazywanie danych do systemu POL-on

plik w standardzie PDF

Funkcje skrzynki podawczej Poświadczenie przedłoŜenia (UPP

zakresu danych