2007.01_e-POLTAX_[Aplikacje Biznesowe].pdf
(
932 KB
)
Pobierz
441066135 UNPDF
Aplikacje
biznesowe
Janusz Ganczarski
e-POLTAX
Materiały do artykułu
zamieszczone zostały
na płycie CD 1
Finansów (MF) ogłosiło, że grupa oko-
ło 7.5 tysiąca największych podatników
o rocznych przychodach przekraczających 5 mln
euro, obsługiwanych przez tzw. wyspecjalizowa-
ne urzędy skarbowe (US), może składać deklara-
cje podatkowe drogą elektroniczną. Wykonaniem
i jednocześnie wdrożeniem systemu e-POLTAX,
obsługującego deklaracje elektroniczne zajęła się
Państwowa Wytwórnia Papierów Wartościowych
(PWPW).
W niniejszym artykule, poza przedstawieniem
sposobu działania systemu e-POLTAX, skupimy
się głównie na opisie formatów deklaracji elektro-
nicznej. Wszystkie prezentowane przykłady po-
wstały wyłącznie w oparciu o opublikowane przez
MF schematy dokumentów. Poprawność składnio-
wą plików XML weryikowano przy użyciu aplika-
cji off-line udostępnianej przez MF, natomiast do
testów poprawności strukturalnej użyto walidatora
dostępnego na stronie
http://tools.decisionsoft.com/
schemaValidate/.
Podstawowe akty prawne związane
z deklaracjami elektronicznymi
• Rozporządzenie Ministra Finansów z dnia 11 sierp-
nia 2006 r. w sprawie określenia rodzajów dekla-
racji, które mogą być składane za pomocą środ-
ków komunikacji elektronicznej (Dz.U. Nr 146, poz.
1060);
• Rozporządzenie Ministra Finansów z dnia 11 sierp-
nia 2006 r. w sprawie trybu składania i wzoru zawia-
domienia o zamiarze składania deklaracji w formie
elektronicznej (Dz.U. Nr 146, poz. 1061);
• Rozporządzenie Ministra Finansów z dnia 11 sierp-
nia 2006 r. zmieniające rozporządzenie w sprawie
zaświadczeń wydawanych przez organy podatkowe
(Dz.U. Nr 146, poz. 1062);
• Rozporządzenie Ministra Finansów z dnia 11
września 2006 r. w sprawie trybu składania oraz
struktury logicznej zgłoszenia upoważnienia po-
datnika lub osoby upoważnionej przez podatnika
do składania deklaracji w formie elektronicznej i
podpisywania deklaracji podpisem elektronicznym
(Dz.U. Nr 168, poz. 1196);
• Rozporządzenie Ministra Finansów z dnia 11 wrze-
śnia 2006 r. w sprawie struktury logicznej deklara-
cji, sposobu ich przesyłania oraz rodzajów podpi-
su elektronicznego, którymi powinny być opatrzone
(Dz.U. Nr 168, poz. 1197);
• Rozporządzenie Ministra Finansów z dnia 2 paź-
dziernika 2006 r. zmieniające rozporządzenie w
sprawie struktury logicznej deklaracji, sposobu ich
przesyłania oraz rodzajów podpisu elektroniczne-
go, którymi powinny być opatrzone (Dz.U. Nr 179,
poz. 1323).
Budowa i zasady funkcjonowania
systemu e-POLTAX
System e-POLTAX umożliwia składanie deklaracji
podatkowych na trzy sposoby:
• bezpośrednio poprzez mechanizmy udostępnio-
ne na stronie WWW umieszczonej pod adresem
https://e-poltax.mf.gov.pl
; do złożenia deklara-
cji wystarczy standardowa przeglądarka interne-
towa obsługująca protokół szyfrowania SSL v.3
(128 bitowy);
• przy pomocy aplikacji Off-Line, udostępnione na
stronach MF; niestety aktualna wersja 1.5 do-
stępna jest tylko dla systemów z rodziny Micro-
soft Windows;
• poprzez moduły wbudowane w aplikacje (np. sys-
temy inansowo-księgowe) dostarczone przez ir-
my trzecie i korzystające ze schematów doku-
mentów udostępnionych przez MF.
akceptuje wszystkie certyikaty dostępne na pol-
skim rynku.
Zanim jednak prześlemy pierwszą deklarację
drogą elektroniczną trzeba złożyć w US zawia-
domienie o zamiarze składania deklaracji ZAW-
E1 (oczywiście w papierowej wersji – patrz Ry-
sunek 1), odrębnie dla każdej osoby upoważnio-
nej do składania deklaracji. Następnie osoba upo-
ważniona przesyła drogą elektroniczną zgłosze-
nie w formacie ZAW-E2, w którym potwierdza
wolę składania deklaracji drogą elektroniczną. Po
weryikacji powyższych zawiadomień US wydaje
zaświadczenie ZAS-E potwierdzające zgodność
danych zawartych w zawiadomieniu ZAW-E1
z danymi w zgłoszeniu ZAW-E2 złożonym przez
osobę upoważnioną, a podatnik otrzymuje moż-
liwość składania deklaracji drogą elektroniczną.
Każdy z powyższych sposobów wymaga posiada-
nia przez podatnika bezpiecznego podpisu elek-
tronicznego weryikowanego za pomocą ważne-
go kwaliikowanego certyikatu. System e-POLTAX
Autor jest matematykiem i informatykiem
Kontakt z autorem:
JanuszG@enter.net.pl
Strona domowa:
www.januszg.hg.pl
26
www.sdjournal.org Software Developer’s Journal 1/2007
W
dniu 16 sierpnia 2006 roku Ministerstwo
e-POLTAX
Rysunek 1.
Zawiadomienie ZAW-E1
Warto zauważyć, że osobą upoważnioną nie musi być na-
wet pracownik irmy – może to być np. doradca podatkowy
prowadzący obsługę księgową irmy.
Niezależnie od wybranego sposobu złożenia deklara-
cji lub innego dokumentu, system e-POLTAX z założenia w
ciągu kilkudziesięciu minut generuje i przesyła potwierdze-
nie przyjęcia deklaracji na adres poczty elektronicznej oso-
by upoważnionej. Potwierdzenie ma postać pliku XML, któ-
ry zawiera następujące informacje:
• nazwa podmiotu przyjmującego dokument elektroniczny
(MF);
• identyikator złożonego dokumentu nadany przez Central-
ną Bazę Danych (CBD);
��������
������
����������
���������
������
�����������
������
���
����������
���������
��������������
��������
��������
������������������
����������������������������
���������������������
���
�������
��������
Rysunek 2.
Schemat budowy działania systemu e-POLTAX (źródło MF)
Software Developer’s Journal 1/2007
www.sdjournal.org
27
Aplikacje
biznesowe
• wartość funkcji skrótu złożonego dokumentu, która jest
identyczna z wartością użytą do podpisu składanego do-
kumentu;
• wartość funkcji skrótu dokumentu w postaci otrzyma-
nej przez system (łącznie z podpisem elektronicz-
nym);
• typ dokumentu, którego dotyczy potwierdzenie (deklara-
cja, wniosek lub zgłoszenie);
• data wpłynięcia dokumentu do systemu informatycznego
administracji podatkowej (data ze stempla czasu);
• treść stempla czasu w postaci zakodowanej algorytmem
Base64;
• numer NIP podmiotu głównego deklaracji, wniosku lub
zgłoszenia;
• informacja o przyjęciu lub odrzuceniu dokumentu oraz ko-
dy ewentualnych błędów.
Listing 1.
Przykładowy plik z zawiadomieniem ZAW-E2
<
?xml version=
"1.0"
encoding=
"UvTF-8"
?
>
<
Faks
>
0221234567
<
/Faks
>
<
Email
>
irmasa@irmasa.pl
<
/Email
>
<
/Kontakt
>
<
/Podmiot1
>
<!-- Zgłoszenie osoby upoważnionej do składania
i podpisywania deklaracji w formie elektronicznej
-->
<
ZgloszenieRej xmlns:xsi=
"http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation=
"http://e-poltax.mf.gov.pl/Repozytorium/Deklaracje/
ZAW-E2(1)_v1-0.xsd"
>
<!-- Dane osoby izycznej upoważnionej do podpisywania
deklaracji
-->
<
Podmiot2
>
<
OsobaFizyczna
>
<
NIP
>
1112223344
<
/NIP
>
<
ImiePierwsze
>
Jan
<
/ImiePierwsze
>
<
Nazwisko
>
Kowalski
<
/Nazwisko
>
<
DataUrodzenia
>
1980-01-01
<
/DataUrodzenia
>
<
PESEL
>
80010199999
<
/PESEL
>
<
/OsobaFizyczna
>
<
AdresZamieszkania rodzajAdresu=
"RAD"
>
<
AdresPol
>
<
KodKraju
>
PL
<
/KodKraju
>
<
Wojewodztwo
>
mazowieckie
<
/Wojewodztwo
>
<
Powiat
>
warszawski
<
/Powiat
>
<
Gmina
>
Centrum
<
/Gmina
>
<
Ulica
>
Aleje Jerozolimskie
<
/Ulica
>
<
NrDomu
>
4321
<
/NrDomu
>
<
NrLokalu
>
1
<
/NrLokalu
>
<
Miejscowosc
>
Warszawa
<
/Miejscowosc
>
<
KodPocztowy
>
00-001
<
/KodPocztowy
>
<
Poczta
>Warszawa</
Poczta
>
<
/AdresPol
>
<
/AdresZamieszkania
>
<
Kontakt
>
<
Telefon
>
0221234567
<
/Telefon
>
<
Faks
>
0221234567
<
/Faks
>
<
Email
>
jankowalski@irmasa.pl
<
/Email
>
<
/Kontakt
>
<
/Podmiot2
>
<!-- Nagłówek deklaracji
-->
<
Naglowek
>
<
KodFormularza kodSystemowy=
"ZAW-E2"
>
ZAW-E2
<
/KodFormularza
>
<
WariantFormularza
>
1
<
/WariantFormularza
>
<
/Naglowek
>
<!-- Dane podatnika lub płatnika, którego deklaracje
składane w formie elektronicznej podpisuje osoba
upoważniona
-->
<
Podmiot1
>
<
OsobaNieizyczna
>
<
NIP
>
1234567890
<
/NIP
>
<
PelnaNazwa
>
Firma S.A.
<
/PelnaNazwa
>
<
REGON
>
123456789
<
/REGON
>
<
/OsobaNieizyczna
>
<
AdresZamieszkaniaSiedziby rodzajAdresu=
"RAD"
>
<
AdresPol
>
<
KodKraju
>
PL
<
/KodKraju
>
<
Wojewodztwo
>
mazowieckie
<
/Wojewodztwo
>
<
Powiat
>
warszawski
<
/Powiat
>
<
Gmina
>
Centrum
<
/Gmina
>
<
Ulica
>
Aleje Jerozolimskie
<
/Ulica
>
<
NrDomu
>
1234
<
/NrDomu
>
<
NrLokalu
>
1
<
/NrLokalu
>
<
Miejscowosc
>
Warszawa
<
/Miejscowosc
>
<
KodPocztowy
>
00-001
<
/KodPocztowy
>
<
Poczta
>
Warszawa
<
/Poczta
>
<
/AdresPol
>
<
/AdresZamieszkaniaSiedziby
>
<
Kontakt
>
<
Telefon
>
0221234567
<
/Telefon
>
<!-- Zakres terminu uprawnień do podpisu dekl aracji
-->
<
ZakresTerminuUprawnien
>
<
WaznyOd
>
2006-10-01
<
/WaznyOd
>
<
WaznyDo
>
2006-12-31
<
/WaznyDo
>
<
/ZakresTerminuUprawnien
>
<
/ZgloszenieRej
>
28
www.sdjournal.org Software Developer’s Journal 1/2007
e-POLTAX
Z deklaracji aktualnie obsługiwanych przez system
e-POLTAX najpopularniejsze i zarazem najważniejsze są:
• PIT-4 – deklaracja na zaliczkę miesięczną na podatek do-
chodowy od łącznej kwoty dokonanych wypłat;
• PIT-8A – deklaracja o zryczałtowanym podatku dochodo-
wym;
• VAT-7 – deklaracja podatkowa dla podatku od towarów
i usług.
Przykładowo wg danych dostępnych na stronie Podlaskie-
go Urzędu Skarbowego w Białymstoku w 2005 roku do te-
go urzędu złożono 4388 deklaracji PIT-4 i 910 deklaracji
PIT-8A.
Rysunek 3.
Repozytorium schematów dokumentów
Repozytorium schematów dokumentów
Repozytorium schematów dokumentów (patrz Rysunek 3)
zostało podzielone na pięć części obejmujących: słowniki,
deinicje, potwierdzenie, szablony i deklaracje. Słowniki
zawierają kody urzędów skarbowych (plik
KodyUrzedow-
Skarbowych_v1-0.xsd
) i dwuliterowe kody krajów zgodne
ze standardem ISO 3166 (plik
KodyKrajow_v1-0.xsd
).
Aktualnie dostępne są tylko kody urzędów skarbowych
wyspecjalizowanych w obsłudze tzw. dużych podatników.
W potwierdzeniach znajduje się jedynie schemat urzędo-
wego potwierdzenia odbioru dokumentu elektronicznego
(plik
Potwierdzenie_v1-0.xsd
), a deinicje deklaracji i za-
łączników do deklaracji umieszczono oczywiście w dekla-
racjach.
Aktualnie repozytorium nie zawiera żadnych szablonów
dokumentów.
Oczywiście system e-POLTAX nie weryikuje poprawno-
ści merytorycznej deklaracji – tę może wykonać wyłącznie
pracownik US. Cały schemat działania systemu e-POLTAX
przedstawiono na Rysunku 2.
Deklaracje elektroniczne
Jako format danych na potrzeby deklaracji elektronicznych
wybrano XML, przy czym struktury poszczególnych doku-
mentów, typy danych oraz słowniki opisane zostały przy
użyciu XML Schema. Ta stosunkowo nowa technologia
(specyikacja pochodzi z 2001 roku) jest uważana za na-
stępcę DTD i posiada od tego ostatniego znacznie większe
możliwości.
Wszystkie dokumenty XSD (ang.
XML Schema Defini-
tion
) z definicjami dostępne są w repozytorium schema-
tów dokumentów umieszczonym na stronie WWW syste-
mu e-POLTAX (
https://e-poltax.mf.gov.pl/
). Schematy do-
kumentów elektronicznych są prawnie usankcjonowane
rozporządzeniami MF (patrz ramka).
Pierwsze akty prawne opisujące pliki XSD zostały
podpisane w dniu 11 września 2006r (od tego dnia rze-
czywiście można mówić o technicznej i prawnej możliwo-
ści składania deklaracji elektronicznych), a ostatnie do-
stępne w momencie powstawania niniejszego tekstu po-
chodzą z 2 października 2006 roku.
Także w drodze rozporządzenia MF określił termin
wprowadzania kolejnych wzorów deklaracji elektronicz-
nych (patrz ramka).
Rozporządzenia określają ponadto sposób opatrywa-
nia deklaracji i innych dokumentów bezpiecznym podpi-
sem elektronicznym weryikowanym za pomocą ważnego
kwaliikowanego certyikatu, algorytm bezpiecznego pod-
pisu elektronicznego, algorytm szyfrowania oraz funkcję
skrótu.
MF dopuściło opatrywanie dokumentów podpisem
elektronicznym przy użyciu jednego z dwóch formatów:
XAdES-BES (ETSI TS 101 903)
oraz
PKCS#7
, przy czym ten
pierwszy wydaje się być znacznie lepiej przystosowany do
potrzeb dokumentów w formacie XML.
Rysunek 4.
Program e-Poltax Off-Line z wczytanym
zawiadomieniem ZAW-E2
Software Developer’s Journal 1/2007
www.sdjournal.org
29
Aplikacje
biznesowe
W budowie dokumentów XML zawierających deklara-
cje, bardzo ważne są dokumenty zawarte w deinicjach
repozytorium. Zawierają one opis podstawowych typów
danych (plik
ElementarneTypyDanych_v1-0.xsd
) i struk-
tur (plik
StrukturyDanych_v1-0.xsd
) używanych w dekla-
racjach. Typy i struktury danych przedstawiamy bliżej
w ramce.
Na dokumenty, których schematy znajdują się w repo-
zytorium składają się nie tylko elektroniczne odpowiedniki
papierowych formularzy z deklaracjami. Znajdują się tam
także wybrane rodzaje załączników i wniosków, które nie
posiadają urzędowo określonego wzoru, a które mogą być
elementem składowym deklaracji obsługiwanych przez
system e-POLTAX. Typowym przykładem jest formularz
ORD-ZU, który zawiera uzasadnienie przyczyn składania
korekty deklaracji.
Pierwszym dokumentem elektronicznym, który przed-
stawimy nie będzie jednak żadna z deklaracji, ale omówione
wcześniej zawiadomienie ZAW-E2.
gramu e-Poltax Off-Line oraz gotowy do podpisania
z wyliczoną funkcją skrótu przedstawiono na rysunkach
nr 4 i 5.
PIT-4 – deklaracja na zaliczkę miesięczną na podatek
dochodowy od łącznej kwoty dokonanych wypłat
Strukturę deklaracji PIT-4 opisuje plik
PIT-4(17)_v1-0.xsd
.
Dokument zawiera cztery elementy:
Nagłówek
,
Podmiot1
,
Struktury danych opisane w pliku
StrukturyDanych_v1-0.xsd:
•
TAdres
– dane adresowe, może to być adres polski (ele-
ment
AdresPo
l) lub adres zagraniczny (element
AdresZagr
);
na adres polski składają się elementy:
KodKraju
, W
ojewódz-
two, Powiat, Gmina, Ulica, NrDomu, NrLokalu, Miejscowosc,
KodPocztowy i Poczta
; na adres zagraniczny składają się
elementy:
KodKraju
,
KodPocztowy
,
Miejscowosc
,
Ulica
,
NrDomu
,
NrLokalu
,
Pietro
,
NazwaRegionu
i
SkrzynkaPocz-
towa
;
•
TIdentyikatorOsobyFizycznej
– podstawowe dane identyi-
kujące osobę izyczną; są to następujące elementy:
NIP
,
Imie-
Pierwsze
,
Nazwisko
,
DataUrodzenia
i
PESEL
;
•
TIdentyikatorOsobyFizycznejPelny
– pełne dane iden-
tyikujące osobę izyczną; są to elementy: NIP, ImiePierw-
sze, Nazwisko, DataUrodzenia, ImieOjca, ImieMatki i PE-
SEL;
• TIdentyikatorOsobyNieizycznej – podstawowe dane identyi-
kujące podmioty nie będą osobami izycznymi; składają się na
elementy:
NIP
,
PelnaNazwa
i
REGON
;
• TPodmiotDowolnyBezAdresu – podstawowe dane dowolne-
go podmiotu; może to być osoba izyczna (element
Osoba-
Fizyczna
typu TIdentyikatorOsobyFizycznej) lub pozostałe
podmioty (element
OsobaNieizyczna
tylu
TidentyikatorO-
sobyNieizycznej
);
•
TIdentyikatorOsobyNieizycznejPelny
– pełne dane iden-
tyikujące podmioty nie będące osobami izycznymi; są to
następujące elementy:
NIP
,
PelnaNazwa
,
SkroconaNazwa
i
REGON;
•
TOsobaFizyczna
– podstawowe dane osoby izycznej; są to
następujące elementy:
OsobaFizyczna
(typ TIdentyikatorO-
sobyFizycznej) oraz
AdresZamieszkania
(typ TAdres + atrybut
rodzajAdresu
);
•
TOsobaNieizyczna
– podstawowe dane podmiotu nie będą-
cego osobą izyczną; są to elementy:
OsobaNieizyczna
(typ
TIdentyikatorOsobyNieizycznej) oraz
AdresSiedziby
(typ TA-
dres + atrybut
rodzajAdresu
);
•
TPodmiotDowolny
– podstawowe dane dowolnego podmio-
tu; typ jest rozszerzeniem typu TPodmiotDowolnyBezAdresu
i posiada dodatkowy element
AdresZamieszkaniaSiedziby
(typ
TAdres + atrybut
rodzajAdresu
);
•
TOsobaFizycznaPelna
– pełny zestaw danych o osobie izycz-
nej; elementy:
OsobaFizyczna
(typ
TidentyikatorOsobyFi-
zycznejPelny
) i
Adres
(typ Tadres);
•
TOsobaNieizycznaPelna
– pełny zestaw danych o podmio-
cie nie będącym osobą izyczną; elementy: OsobaNieizycz-
na (typ
TidentyikatorOsobyNieizycznejPelny
) i
Adres
(typ
Tadres
);
•
TPodmiotDowolnyPelny
– pełny zestaw danych o dowol-
nym podmiocie; element
OsobaFizyczna
(typ
TIdentyika-
torOsobyFizycznejPelny
) lub
OsobaNieizyczna
(typ
TIden-
tyikatorOsobyNieizycznejPelny
) oraz element
Adres
(typ
TAdres
).
ZAW-E2 – Zgłoszenie osoby upoważnionej do składania
i podpisywania deklaracji w formie elektronicznej
Strukturę zawiadomienia ZAW-E2 zawiera plik
ZAW-
E2(1)_v1-0.xsd
. Dokument zawiera cztery główne elemen-
ty. Pierwszy to
Nagłówek
opisujący kod i wariant formu-
larza. Nagłówki stanowią standardowy element każdego
dokumentu elektronicznego w systemie e-POLTAX. Da-
lej formularz ZAW-E2 zawiera element
Podmiot1
opisują-
cy dane podatnika, którego deklaracje będą składane dro-
gą elektroniczną oraz element
Podmiot2
zawierający da-
ne osoby upoważnionej, która w imieniu podatnika będzie
składała deklaracje. W danych obu podmiotów elementy
składowe
Kontakt
są opcjonalne. Wartość atrybutu
rodza-
jAdresu
w elementach
AdresZamieszkaniaSiedziby
i
Adre-
sZamieszkania
oznacza, że są to adresy rejestracyjne obu
podmiotów. Na końcu formularz ZAW-E2 zawiera okres
w jakim osoba upoważniona może składać deklaracje dro-
gą elektroniczną.
Przykładowy dokument z zawiadomieniem ZAW-E2
zawiera listing 1. Ten sam dokument wczytany do pro-
Rysunek 5.
Program e-Poltax Off-Line z gotowym do
podpisania zawiadomieniem ZAW-E2
30
www.sdjournal.org Software Developer’s Journal 1/2007
Plik z chomika:
Kapy97
Inne pliki z tego folderu:
2010.03_SOA Tworzenie serwisów wspomagających proces integracji_[Aplikacje Biznesowe].pdf
(1004 KB)
2010.05_Wdrożenia SAP – droga przez mękę_[Aplikacje Biznesowe].pdf
(1197 KB)
2010.06_Stary, dobry znajomy Oracle Forms_[Aplikacje Biznesowe].pdf
(548 KB)
2010.05_C++ Qt 4.5 _[Aplikacje Biznesowe].pdf
(1019 KB)
2009.09_Websphere MQ 7 _[Aplikacje Biznesowe].pdf
(581 KB)
Inne foldery tego chomika:
Algorytmy
Antyhaking
Aspekty
Bazy Danych
Biblioteka Miesiaca
Zgłoś jeśli
naruszono regulamin