Dokumentace pro vývojáře Obsah 1.
ÚVOD.................................................................................................................................... 2
2.
SLUŽBA CSSZ A JEJÍ TRANSAKCE OSVC_PRE............................................................ 2 2.1 Údaje v GovTalk obálce.............................................................................................. 2
3.
SYSTÉM PRO ZPRACOVÁNÍ DAT................................................................................... 2 3.1 Datové rozhraní transakce OSVC_PRE (CSSZ_OSVC_PRE) ................................... 3 3.1.1
3.2
3.2.1
3.3 3.4 3.5
Popis prvků obálky datové věty............................................................................... 4
Struktura datové věty (přehled OSVČ) - obsah elementu GovTalkMessage/Body/Message/Body (zašifrovaný) ................................................ 5 Datové typy ............................................................................................................. 9
Struktura datové věty (přehled OSVČ) – prázdný příklad .......................................... 9 Podepisování a šifrování datových vět ...................................................................... 10 Zpracování výstupů transakce CSSZ_OSVC_PRE................................................... 10
1.
ÚVOD
Tento dokument je popisem implementace služby „OSVČ pro Českou správu sociálního zabezpečení“. Dokumentace je určena pro vývojáře aplikací, kteří chtějí do svých programů zabudovat elektronické zasílání přehledů OSVČ České správě sociálního zabezpečení prostřednictvím transakční části PVS.
2.
SLUŽBA CSSZ A JEJÍ TRANSAKCE OSVC_PRE
Služba „OSVČ pro Českou správu sociálního zabezpečení“ je již třetí službou v pořadí, jejímž provozovatelem je Česká správa sociálního zabezpečení. Hlavním a zatím jediným účelem služby je možnost podávání elektronických přehledů OSVČ. Služba „OSVČ pro Českou správu sociálního zabezpečení“ má zatím jedinou implementovanou transakci s identifikátorem CSSZ_OSVC_PRE (obsah elementu CLASS v GovTalk obálce). 2.1 Údaje v GovTalk obálce Následuje výčet a kombinace údajů v GovTalk obálce v případě užití transakce CSSZ_OSVC_PRE.
Údaj v obálce
Hodnota údaje
GovTalkMessage/Header/MessageDetails/Class
CSSZ_OSVC_PRE
GovTalkMessage/GovTalkDetails/Keys/Key@Type
Atribut @Type může nabývat jediné hodnoty a to: vars – v případech použití služeb pod účty občana nebo jeho zástupce
GovTalkMessage/GovTalkDetails/Keys/Key
3.
Vlastní hodnoty známých údajů jsou vkládány přesně tak, jak byly zadány při registraci popř. při přihlášení ke službě.
SYSTÉM PRO ZPRACOVÁNÍ DAT
Systém zpracování dat pro službu „OSVČ pro Českou správu sociálního zabezpečení“ plní následující funkce:
•
Přijetí elektronického podání a potvrzení doručení od transakčního jádra PVS
•
Kontrola správnosti obálky, rozšifrování zprávy, kontrola digitálního podpisu
•
Kontrola oprávněnosti podání na ČSSZ (nutná registrace na ČSSZ)
•
Zaslání výsledku zpracování zpět do transakčního jádra PVS
2
3.1Datové rozhraní transakce OSVC_PRE (CSSZ_OSVC_PRE) Struktura vstupního dokumentu – následuje příklad GovTalk obálky včetně obálky datové věty.
<EnvelopeVersion>2.0 <MessageDetails> CSSZ_OSVC_PRE request submit XML <SenderDetails> <Message version=”1.1” xmlns="http://www.cssz.cz/XMLSchema/emp/envelope"> <Signature xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64"> MIICEAYJKoZIhvcNAQcDoIICATCCAf0CAQAxgc…. MIICEAYJKoZIhvcNAQcDoIICATCCAf0CAQAxgc YwgcMCAQAwbTBfMQswCQYDVQQG TlpA +Pjhkg==
3
3.1.1
Popis prvků obálky datové věty
Název elementu
Povinný údaj Popis elementu
Message
A
Identifikace dokumentu v rámci ČSSZ (interní obálka). Obálka pro elektronická podání ČSSZ je kvalifikována jmenným prostorem http://www.cssz.cz/XMLSchema/emp/envelope.
version
A
Verze obálky a struktury datové věty určené pro ČSSZ. Hodnota současné verze je 1.1. Hodnota popisuje použitou strukturu obálky.
Header
A
Hlavička obálky pro DIS server.
Signature
A
Element obsahuje digitální podpis datové věty (vlastního přehledu OSVČ)
Vendor
A
Informace o produktu, který dokument vygeneroval. Hodnoty jsou uvedeny v atributech: productName="název produktu" version="verze produktu"
Body
A
Vlastní zašifrovaná data uložená ve formátu base64
encrypted
A
Označuje, zda je datová věta zašifrována. V současné verzi (1.1) je šifrování povinné, a tedy encrypted musí být nastaveno na hodnotu „yes“.
contentEncoding
A
Označuje zda je obsah (datová věta) zašifrována v komprimované formě nebo v čisté formě. Atribut může nabývat hodnot „gzip“ a „raw“.
4
3.2 Struktura datové věty (přehled OSVČ) - obsah elementu GovTalkMessage/Body/Message/Body (zašifrovaný) Obsah elementu Message/Body (zašifrovaný) následující:
Název atributu
Popis
Dat. typ
Délka
Povinnost Kontroly Element
Prehledosvc.for
„prehledosvc“
A
11
A
prehledosvc.dep
3
A
prehledosvc. client.rok
číslo okresu (org. Jednotky N ČSSZ) rok podání přehledu N0
4
A
hlava
prehledosvc. client.dat
datum podání
D
10
N
hlava
prehledosvc.client.bno
rodné číslo
N0
9-10
A
kontr. RČ client
prehledosvc.client.den
Narozen
D
10
A
client
prehledosvc.client.name.sur Příjmení
AZ
1-35
A
client
prehledosvc.client.name.fir
Jméno
AZ
1-24
A
client
prehledosvc.client.name.tit
Titul
AZ
1-10
N
client
prehledosvc.client.adr.str
trvalý pobyt – ulice
ANZ
1-48
N
client
prehledosvc.client.adr.num
trvalý pobyt - č.p.
ANZ
1-8
A
client
prehledosvc.client.adr.pnu
trvalý pobyt - psč
ANZ
11
A
client
prehledosvc.client.adr.cit
trvalý pobyt – obec
ANZ
1-48
A
client
prehledosvc.client.adr.cnt
trvalý pobyt – stát
A
2
N
client
prehledosvc.client.vs
variabilní symbol OSVČ
N0
8
A
client
prehledosvc.client.zahc
datum posledního zahájení D CVČ Druh činnosti „H“-hlavní, „V“- A vedlejší a „S“ – souběh hlavní a vedlejší Daňový poradce A
10
A
client
1
A
client
1
A
client
D
10
N
client
D
10
N
client
A
1
A
client
A
1
A
client
D
10
N
client
prehledosvc.client.ucz
Lhůta pro předložení DP datum Datum oznámení prodloužení lhůty DP Povinnost podávat daňové přiznání Jsem polplatníkem daně z příjmu stanovené paušální částkou Datum protokolu o paušální částce Účtování v hosp. roce od
D
10
N
client
prehledosvc.client.uck
Účtování v hosp.roce do
D
10
N
client
A
1
N
vedc.zam
D
10
N
vedc.du
prehledosvc.client.druc prehledosvc.client.por prehledosvc.client.meldat prehledosvc.client.melozn prehledosvc.client.pov prehledosvc.client.pau prehledosvc.client.paud
prehledosvc.vedc.zam Zaměstnání 86220,-
s příjmem
nad
prehledosvc.vedc.du.od nárok na výplatu IČ nebo I nebo mi byl přiznán S od
5
hlava číselník
hlava
Název atributu
Popis
Délka
Povinnost Kontroly Element
D
Dat. typ
10
N
vedc.du
D
10
N
vedc.rp
10
N
vedc.rp
10
N
vedc.vs
10
N
vedc.vs
prehledosvc.vedc.nd.od
D nárok na RP nebo příspěvek při péči o blízkou od Vojenská nebo civilní služba D od Vojenská nebo civilní služba D do Nezaopatřeným dítětem od D
10
N
vedc.nd
prehledosvc.vedc.nd.do
Nezaopatřeným dítětem do
D
10
N
vedc.nd
prehledosvc.vedc.vt.od
D
10
N
vedc.vt
D
10
N
vedc.vt
D
10
N
vedc.du
D
10
N
vedc.du
D
10
N
vedc.rp
D
10
N
vedc.rp
D
10
N
vedc.vs
D
10
N
vedc.vs
prehledosvc.vedc.nd1.od
Vazba nebo trest odnětí svobody od Vazba nebo trest odnětí svobody do nárok na výplatu IČ nebo I nebo mi byl přiznán S od nárok na výplatu IČ nebo I nebo mi byl přiznán S do nárok na RP nebo příspěvek při péči o blízkou od nárok na RP nebo příspěvek při péči o blízkou od Vojenská nebo civilní služba od Vojenská nebo civilní služba do Nezaopatřeným dítětem od
D
10
N
vedc.nd
prehledosvc.vedc.nd1.do
Nezaopatřeným dítětem do
D
10
N
vedc.nd
prehledosvc.vedc.vt1.od
D
10
N
vedc.vt
D
10
N
vedc.vt
N0
9-10
N
kontr. RČ spo
prehledosvc.spo.name.sur
Vazba nebo trest odnětí svobody od Vazba nebo trest odnětí svobody do Rodné číslo spolupracující osoby Příjmení spolupracující osoby
AZ
1-35
N
spo
prehledosvc.spo.name.fir
Jméno spolupracující osoby
AZ
1-24
N
spo
prehledosvc.spo.name.tit
Titul spolupracující osoby
AZ
1-10
N
spo
prehledosvc.spo.den
Datum osoby adresa ulice adresa č.p. adresa psč adresa obec
narození spolupracující D
10
N
spo
spolupracující osoby – ANZ
1-48
N
spo
spolupracující osoby - ANZ
1-8
N
spo
spolupracující osoby - N
5
N
spo
spolupracující osoby – ANZ
1-48
N
spo
prehledosvc.vedc.du.do nárok na výplatu IČ nebo I nebo mi byl přiznán S do prehledosvc.vedc.rp.od nárok na RP nebo příspěvek při péči o blízkou od prehledosvc.vedc.rp.do prehledosvc.vedc.vs.od prehledosvc.vedc.vs.do
prehledosvc.vedc.vt.do prehledosvc.vedc.du1.od prehledosvc.vedc.du1do prehledosvc.vedc.rp1.od prehledosvc.vedc.rp1.do prehledosvc.vedc.vs1.od prehledosvc.vedc.vs1.do
prehledosvc.vedc.vt1.do prehledosvc.spo.bno
prehledosvc.spo.adr.str prehledosvc.spo.adr.num prehledosvc.spo.adr.pnu prehledosvc.spo.adr.cit
6
Název atributu
Popis
prehledosvc.spo.adr.cnt prehledosvc.pvv.pri
adresa spolupracující osoby – A stát Příjmy ND
Délka
Povinnost Kontroly Element
2
N
client
13
A
Pvv
prehledosvc.pvv.vyd
Výdaje
ND
13
A
Pvv
prehledosvc.pvv.roz
Příjmy po odpočtu výdajů
ND
13
A
Pvv
prehledosvc.pvv.mesc.h
Počet měsíců SVČ (spolupráce) celkem – hlavní Počet měsíců SVČ (spolupráce) celkem – vedlejší Počet měsíců SVČ (spolupráce) po odpočtu měsíců nemoci, vojenské služby at. - hlavní Počet měsíců SVČ (spolupráce) po odpočtu měsíců nemoci, vojenské služby at. – vedlejší Průměrný měsíční příjem
N
2
A
Pvv
N
2
A
Pvv
N
2
A
Pvv
N
2
A
pvy
ND
13
A
pvy
ND
13
A
pvy
ND
13
A
pvy
ND
9
A
pvy
ND
9
A
pvy
ND
9
N
pvy
ND
9
N
pvy
prehledosvc.pvv.mvz
Příjmy po odpočtu výdajů hlavní Příjmy po odpočtu výdajů vedlejší Vypočtený vyměřovací základ - hlavní Vypočtený vyměřovací základ - vedlejší Dílčí vyměřovací základ hlavní Dílčí vyměřovací základ vedlejší Minimální vyměřovací základ
N
9
A
pvy
prehledosvc.pvv.uvz
Určený vyměřovací základ
N
9
A
pvy
prehledosvc.pvv.poj
Pojistné
ND
9
A
pvy
prehledosvc.pvv.zal
Úhrn záloh
ND
9
A
pvy
prehledosvc.pvv.ned
Rozdíl mezi pojistným a ND zálohami- nedoplatek/přeplatek Přeplatek ve výši vrátit ND
9
A
pvy
9
N
Pre
prehledosvc.pvv.mesc.v prehledosvc.pvv.mesv.h prehledosvc.pvv.mesv.v prehledosvc.pvv.mesp prehledosvc.pvv.pov.h prehledosvc.pvv.pov.v prehledosvc.pvv.vvz.h prehledosvc.pvv.vvz.v prehledosvc.pvv.dvz.h prehledosvc.pvv.dvz.v
prehledosvc.pre.vra prehledosvc.pre.kam
Dat. typ
1
N
Pre
prehledosvc.pre.m1
Vrátit jak „S“ – složenkou, A „U“- na účet Měsíc použití přelatku – 1 A
1
N
Pre
prehledosvc.pre.m2
Měsíc použití přelatku – 2
A
1
N
Pre
prehledosvc.pre.m3
Měsíc použití přelatku – 3
A
1
N
Pre
prehledosvc.pre.m4
Měsíc použití přelatku – 4
A
1
N
Pre
prehledosvc.pre.m5
Měsíc použití přelatku – 5
A
1
N
Pre
prehledosvc.pre.m6
Měsíc použití přelatku – 6
A
1
N
Pre
prehledosvc.pre.m7
Měsíc použití přelatku – 7
A
1
N
Pre
prehledosvc.pre.m8
Měsíc použití přelatku – 8
A
1
N
Pre
prehledosvc.pre.m9
Měsíc použití přelatku – 9
A
1
N
Pre
prehledosvc.pre.m10
Měsíc použití přelatku – 10
A
1
N
Pre
7
Název atributu
Popis
Dat. typ
Délka
Povinnost Kontroly Element
prehledosvc.pre.m11
Měsíc použití přelatku – 11
A
1
N
Pre
prehledosvc.pre.m12
Měsíc použití přelatku – 12
A
1
N
Pre
prehledosvc.pre.iban
IBAN – mezinárodní číslo účtu ANZ
24
N
prehledosvc.pre.bs.pu
AZ
6
N
AZ
11
N
Pre
N
4
N
Pre
N
1-10
N
Pre
N
1-10
N
Pre
prehledosvc.pre.name.sur
Bankovní spojení pro přeplatek - předčíslí účtu Bankovní spojení pro přeplatek - číslo účtu Bankovní spojení pro přeplatek – kód banky Bankovní spojení pro přeplatek – SS Bankovní spojení pro přeplatek – VS Přeplatek poslat – Příjmení
Pre Pre
AZ
1-35
N
Pre
prehledosvc.pre.name.fir
Přeplatek poslat - Jméno
AZ
1-24
N
Pre
prehledosvc.pre.name.tit
Přeplatek poslat - Titul
AZ
1-10
N
Pre
prehledosvc.pre.adr.str
Přeplatek poslat - Ulice
ANZ
1-48
N
Pre
prehledosvc.pre.adr.num
Přeplatek poslat - č.p.
ANZ
1-8
N
Pre
prehledosvc.pre.adr.pnu
Přeplatek poslat - psč
ANZ
11
N
Pre
prehledosvc.pre.adr.cit
Přeplatek poslat – obec
ANZ
1-48
N
pre
prehledosvc.pre.adr.cnt
Přeplatek poslat – stát
A
2
N
pre
prehledosvc.zal.ved
Pro r. 2006 činnost hlavní nebo vedlejší Nejnižší měsíční vyměřovací základ Nejnižší měsíční záloha na pojistné na DP Nejnižší měsíční pojistné na NP OSVČ Celkem
A
1
N
zal
N
6
N
zal
N
6
N
pre
N
6
N
zal
N
6
N
zal
1
A
zal
Prehledosvc.dat.dre
Přihláška k účasti na DP„A“ – A přihlášen, „N“ - nepřihlášen Datum vyplnění formuláře D
10
A
Prehledosvc.pri.poc
Počet příloh
A
1
N
Prehledosvc.pri.img.nazev
Název souboru přílohy
AN
25
Prehledosvc.pri.img.typ
Přípona (typ) souboru přílohy
AN
3
prehledosvc.pre.bs.cu prehledosvc.pre.bs.kb prehledosvc.pre.bs.ss prehledosvc.pre.bs.vs
prehledosvc.zal.vz prehledosvc.zal.dp prehledosvc.zal.np prehledosvc.zal.cel Prehledosvc.zal.pri
Prehledosvc.pri.img.base64 Binární podoba data zakódovaná base64
příloha
3MB
8
N N N
pri
3.2.1
Datové typy
typ
Význam
A
alfaznaky (A - Z, a-z) + ŠŚŤŽŹšśťžźŁĄŞŻłąşĽľżŔÁÂĂÄĹĆÇČÉĘËĚÍÎĎĐŃŇÓÔŐÖ ŘŮÚŰÜÝŢßŕáâăäĺćçčéęëěíîďđńňóôőöřůúűüýţ
N
číslo - znaky 0-9, nesmí začínat nulou
AZ
alfaznaky A a znaménka: pomlčka(-), čárka (,), tečka(.), plus(+), lomítko (/), zpětné lomítko (\)
AN
alfaznaky A a numerické znaky (0-9)
ANZ
alfaznaky A, numerické znaky N a znaménka Z
N0
číslo - znaky 0-9, může začínat nulou
D
datum ve formátu unicode RRRR-MM-DD (nebo ve formátu D.M.rrrr)
ND
číslo - znaky 0-9, může obsahovat znaménko jako první znak a des. tečku (nebo des. čárku)
3.3 Struktura datové věty (přehled OSVČ) – prázdný příklad
<prehledosvc dep="" for=""> <por /> <meldat /> <melozn /> <pov /> <pau paud="" /> <rp od="" do="" /> <rp1 od="" do="" /> <spo bno="" den=""> <mesc h="" v="" /> <mesv h="" v="" /> <mesp /> <pov h="" v="" /> 9
<mvz /> <poj /> <pre vra="" kam=""> <m1 /> <m2 /> <m3 /> <m4 /> <m5 /> <m6 /> <m7 /> <m8 /> <m9 /> <m10 /> <m11 /> <m12 /> <pri poc=""> ![]()
3.4 Podepisování a šifrování datových vět Systémy pro zpracování podání v ČSSZ, na kterých jsou datové věty po rozšifrování načítány, podporuje několik typů kódování XML datových vět. Některé z těchto typů kódování (zejména typy UTF-??) jsou rozpoznávány tzv. Byte Order Marks (dále jen BOM). BOM hraje důležitou roli při načítání XML parsery na straně ČSSZ. Z tohoto důvodu je vhodné BOM zahrnovat při těchto kódováních do digitálního podpisu. Například součástí digitálního podpisu obsahující datovou větu v kódování UTF-8 bude vypadat následovně (žlutě je zvýrazněný BOM): 00000000: 00000010:
EF BB BF 3C 3F 78 6D 6C │ 20 76 65 72 73 69 6F 6E 3D 22 31 2E 30 22 20 65 │ 6E 63 6F 64 69 6E 67 3D
´╗┐
00000020: 22 55 54 46 2D 38 22 3F | 3E 0A 3C 50 69 73 65 6D "UTF-8"?>◙<Messa
3.5 Zpracování výstupů transakce CSSZ_OSVC_PRE Výstupy transakce CSSZ_OSVC_PRE jsou syntakticky shodné s výstupy transakcí CSSZ_RELDP a CSSZ_PRIHL. Popisy jsou k dispozici na stránkách ČSSZ (např. pro RELDP: http://www.cssz.cz/tiskopisy/ELDP_2004/evidencni_listy_2004.asp ). Konkrétní příklady výstupů doplněny v další verzi tohoto dokumentu.
10
