ROZHRANÍ PŘENOS ÚČETNÍCH OBRATŮ VERA -UO IS R@DNICE VERA®
Verze 02.1 leden 2014
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA® Historie verzí dokumentu Historie změn - při každé věcné změně dokumentu je číslo verze zvětšeno a je doplněn záznam do tabulky. Verze
Datum změny
Popis změny
Zpracoval
01.
02.06.2013
První verze
Ing. Hrabalová
02.
01.11.2013
Rozšíření o datovou strukturu k přenesené daňové povinnosti
Ing. Hrabalová
1. Oprava popisu rozhraní 02
31. 12. 2013
V kapitole 2.2.1 Záhlaví souboru změna v Názvu souboru na
V kapitole 2.2.4 Struktura Těla souboru – popis Účetního dokladu opraven název elementu „název_uc_pripad“ na „obsah_uc_pripad“ doplněn element obchodního partnera
Ing. Hrabalová
2. Zařazení kapitoly Struktura Těla souboru – popis prenesena_povinnost za kapitolu 2.2.4 Struktura Těla souboru – popis Účetního dokladu 1. Změna v kapitole 2.2.1 záhlaví souboru 02.1
13.1.2014
Ing. Hrabalová
2. V kapitole 2.2.6 Struktura Těla souboru – popis Obratu dokladu Rozšíření pole Nástroj na 3 znaky z původních 2 znaků
Strana: 2/15
prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA® Obsah 1
ÚVOD .....................................................................................................................................................................4
2
DATOVÉ PRVKY A JEJICH STRUKTURA ..........................................................................................................5 2.1 Struktura Komunikačního rozhraní VERA–UO02.1 ....................................................................................5 2.2 Struktura jednotlivých částí Komunikačního rozhraní VERA–UO02.1 .....................................................5 2.2.1 Struktura Záhlaví .................................................................................................................................5 2.2.2 Struktura Hlavičky ...............................................................................................................................6 2.2.3 Struktura Těla souboru – popis Období ..............................................................................................6 2.2.4 Struktura Těla souboru – popis Účetního dokladu .............................................................................6 2.2.5 Struktura Těla souboru – popis Přenesená povinnost ........................................................................7 2.2.6 Struktura Těla souboru – popis Obratu dokladu .................................................................................8 2.2.7 Struktura Paty ...................................................................................................................................10
3
PROTOKOL O ZPRACOVÁNÍ ............................................................................................................................11 3.1 Struktura polí souboru Protokol: ...............................................................................................................11 3.2 Příklad vstupního souboru .........................................................................................................................12
prosinec 2013
Strana: 3/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA® 1 Úvod Komunikační rozhraní VERA-UO slouží pro přenos účetních obratů z/do informačního systému R@dnice VERA® agenda Rozpočtové účetnictví. Struktura rozhraní je postavena tak, aby jejím prostřednictvím bylo možné přijímat/odesílat veškeré informace spjaté s požadavky na vedení účetnictví obcí, dobrovolných svazků obcí a příspěvkových organizací. Nedílnou součástí rozhraní jsou i informace stanovené Vyhláškou 383/2009 Sb. o účetních záznamech v technické formě vybraných účetních jednotek a jejich předávání do centrálního systému účetních informací státu a o požadavcích na technické a smíšené formy účetních záznamů (technická vyhláška o účetních záznamech) ve znění pozdějších předpisů, potřebné pro zpracování statistických přehledů – Pomocného analytického přehledu. Komunikační rozhraní VERA-UO je založeno na využití formátu XML. Vedený materiál popisuje datové prvky, které tvoří strukturu účetních záznamů zahrnovaných do Komunikačního rozhraní VERA UO02.
Data může odesílat organizace (zpracovatelská) za jinou účetní jednotku (IČ účetní jednotky) Komunikační rozhraní je postaveno tak, aby bylo možné zasílat účetní obraty několika různých účetních období. V takovém případě se věta opakuje pro jednotlivé měsíce. Soubor může obsahovat data jedné účetní jednotky a jednoho roku. Daňové doklady musí obsahovat povinné údaje pro zpracování DPH, tj. DUZP, DUD, Období DPH a sazbu DPH. V případě přenesené povinnosti je povinností uvést IC, DIČ odběratele/příjemce, kód předmětu plnění a základ daně. Pro zdanitelné plnění podle §92b, §92c a §92d je dále povinné uvedení hodnoty rozsah plnění, zaokrouhlené na celé měrné jednotky a měrnou jednotku. Po importu se generuje soubor „protokol.xml“ obsahující informaci o úspěchu zpracování nebo seznam chyb v případě neúspěšného zpracování souboru (položka <error>)
Strana: 4/15
prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA® 2 Datové prvky a jejich struktura Vysvětlivky k datovým typům: povinné pole (mandatory) alfanumerické pole numerické pole fixní délka pole desetinné číslo (Decimal); tečka jako oddělovač desetinných míst
M x n ! d
Struktura Komunikačního rozhraní VERA–UO02.1
2.1
Kódování Záhlaví Hlavička Tělo
utf-8 nezaměnitelná identifikace účetního záznamu, informace informace o účetní jednotce, která záznam vytvořila, identifikace odesílatele vlastní přenášené informace o účetním období, účetních dokladech, informace o přenesené daňové povinnosti a jeho obratech souhrnné informace o přenášených dokladech a obratech
Pata
Ukázka struktury souboru: <doklad> <prenesena_povinnost> <pata>
Struktura jednotlivých částí Komunikačního rozhraní VERA–UO02.1
2.2 2.2.1
Struktura Záhlaví
Ukázka Záhlaví:
prosinec 2013
Strana: 5/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA®
2.2.2 Struktura Hlavičky
Elementy Hlavičky
Formát
Název elementu
40 x M
Identifikace přenosu
8n!M
IČ odesílatele souboru
76 x M
Název odesílatele souboru
<jmeno>
128 x M
Jméno odesílatele souboru
rrrr-mm-dd M hh:mm:ss M
Datum vyhotovení
Datum vyhotovení souboru
Čas vyhotovení
Čas vyhotovení souboru
Význam Jednoznačný identifikátor přenosové dávky IČ organizace, která soubor vyhotovila Název organizace, která soubor vyhotovila Jméno osoby, která soubor vyhotovila
Ukázka Hlavičky: 185 00277444 Město Veráčkov <jmeno>Novák Josef, Ing 2013-06-12 10:14:31
2.2.3 Struktura Těla souboru – popis Období Elementy Období
Formát
Název elementu
Význam
8n!M
Účetní jednotka
IČ účetní jednotky
76 x M
Název účetní jednotky
Název účetní jednotky
4 rrrr M
Účetní období - rok
2 mm M
Účetní období - měsíc
Rok účetního období, do něhož jsou účetní obraty pořízeny Měsíc účetního období, do něhož jsou účetní obraty pořízeny Počáteční stavy jsou identifikovány měsícem = 00
2.2.4 Struktura Těla souboru – popis Účetního dokladu Elementy Dokladu
Formát
Název elementu
Význam
8nM
Číslo účetního dokladu
Jedinečné číslo účetního dokladu
Strana: 6/15
prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA® v rámci účetního období
79 x
Název dokladu
10 n M
Číslo účetního případu
rrrr-mm-dd M
Datum účetního případu
240 x
Obsah účetního případu
rrrr-mm-dd
DUZP
rrrr-mm-dd
DUD
4 rrrr
Období DPH rok
2 mm
Období DPH měsíc
20 x
Čárový kód
14 x
DIČ partnera
10 x
IČ partnera
50 x 10 x
Název partnera Variabilný symbol
Textový popis účetního dokladu Evidenční číslo případu, které jednoznačně identifikuje doklad v rámci knihy, ve které je evidován Datum účetního případu Text – obsah účetního případu Datum uskutečnění zdanitelného plnění; pole je závazné pro daňové doklady Datum uplatnění daně; pole je závazné pro daňové doklady Označení roku - Období DPH; pole je závazné pro daňové doklady Označení měsíce - Období DPH; pole je závazné pro daňové doklady Čárový kód účetního dokladu Daňové identifikační číslo obchodního partnera Identifikační číslo obchodního partnera Název obchodního partnera Variabilný symbol partnera
2.2.5 Struktura Těla souboru – popis Přenesená povinnost Elementy Dokladu
Formát
Název elementu
1x
Kód předmětu
8x
Kód zboží
8x
Kód CZ-PCA
<jednotka>
10 x
Jednotka
<pocet>
(13,4) d
Rozsah plnění
<sazba_dph>
(5,2) d
Sazba DPH
(13,2) d
Základ DPH
prosinec 2013
Význam Přenesená povinnost – kód předmětu plnění Přenesená povinnost – kód zboží plnění Přenesená povinnost – kód CZPCA plnění Přenesená povinnost – jednotka; údaj se váže k danému kódu předmětu plnění Přenesená povinnost – rozsah plnění; údaj se váže k danému kódu předmětu plnění Přenesená povinnost – sazba DPH; údaj se váže k danému kódu předmětu plnění Přenesená povinnost – základ DPH; údaj se váže k danému kódu předmětu plnění
Strana: 7/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA® 2.2.6 Struktura Těla souboru – popis Obratu dokladu Elementy Obraty <su>
<polozka/>
Formát
Název elementu
3n!M
Syntetický účet
4n!M
Analytický účet
4n!
Oddíl,paragraf
4n!
Význam
Položka rozpočtu
Syntetický účtového jednotky Analytický účtového jednotky Funkční skladby Druhové skladby
účet dle platného rozvrhu účetní účet dle platného rozvrhu účetní třídění
rozpočtové
třídění
rozpočtové
dle
nástrojové
3n!
Nástroj
Financování třídění
1n!
Zdroj
Financování dle prostorového třídění pro označení původu
5n!
Účelový znak
Označení účelu transferů
<partner/>
<partner_tr/>
Strana: 8/15
3n!
Záznamová jednotka
10 n
Organizační jednotka
13 n
Organizační číslo
3n
Kapitola
8n
Analytické členění
3n !
Typ změny
8x
IČ partnera
8x
IČ transakce
Pole slouží pro označení: a) konsolidačního třídění dle vyhlášky 323/2002 b) identifikaci druhů zdanitelných plnění; povinné označení pro daňové doklady v souladu s metodikou VERA c) identifikaci pohybů pro potřeby zpracování Vlastního kapitálu v souladu s metodikou VERA Uživatelská položka pro zachycení funkčního třídění účetní jednotky Uživatelská položka pro potřeby účetní jednotky Uživatelská položka pro potřeby účetní jednotky Doplňující statistické členění SU v souladu s vyhláškou 383/2009 Doplňující statistické členění SU v souladu s vyhláškou 383/2009 Identifikace partnera aktiv/pasiv na příslušném analytickém členění v souladu s vyhláškou 383/2009 Identifikace partnera transakce na příslušném analytickém členění v souladu s vyhláškou
prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA® 383/2009 <poznamka/> <md/>
79 x
Popis obratu
(18,2) d
Má dáti
(18,2) d
Dal
(5,2) d
Sazba DPH
Textový popis účetního obratu Údaj pro uvedení částky na účetní straně Má dáti Údaj pro uvedení částky na účetní straně DAL Sazba DPH v souladu s platnou legislativou; pole je závazné pro daňové doklady
Ukázka Těla souboru: 00277444 Město Veráčkov 2013 1 <doklad> 41000001 4101 2013-01-10 Prodej zboží na pokladně 2013-01-10 2013-01-10 2013 1 57160 CZ12345678 12345678 Pelhrimov <prenesena_povinnost> 4 <jednotka>1 <pocet>2.0000 <sazba_dph>20.00 50.00 <prenesena_povinnost> <su>604 0010 <polozka/> 601 <partner/>
prosinec 2013
Strana: 9/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA® <partner_tr/> <poznamka/> <md/> 100.00 21.00
2.2.7 Struktura Paty Elementy Paty
Formát
Název elementu
Význam
<poc_obdobi>
2
Počet období
Počet účetních období v souboru
<poc_dokladu>
3
Počet účetních dokladů
Počet účetních dokladů v souboru
<poc_obratu>
3
Počet obratů
Počet obratů v souboru
<suma_md>
(18,2)
Suma MD
Celková suma MD
<suma_dal>
(18,2)
Suma DAL
Celková suma Dal
Ukázka Paty: <pata> <poc_obdobi>1 <poc_dokladu>17 <poc_obratu>71 <suma_md>729487.83 <suma_dal>729487.83
Strana: 10/15
prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA® 3 Protokol o zpracování Po importu se generuje soubor „protokol.xml“ obsahující informaci o úspěchu zpracování nebo seznam chyb v případě neúspěšného zpracování souboru (položka <error>)
Struktura polí souboru Protokol:
3.1
Odpověď se obsahuje shodnou strukturu jako věta . V těle zprávy jsou obsaženy tyto informace: <protokol> <stav>XXX <error>XXX Stav: error:
0 – bez chyby / číslo poslední chyby OK – bez chyby / číslo a textový popis chyby, případně více chyb
Příklad automaticky generovaného souboru Protokol po importu účetních dokladů: a) Po chybě 139 00277444 Město Veráčkov <jmeno>Novák Josef, Ing 2013-12-08 15:54:27 <protokol> <status>-349 <error>Chyba #349: Nesprávný formát des.tečkou'
údaje
[dal]
:'ABC'
-
Platný
formát
'číslo
s
b) Bez chyb 185 00277444 Město Veráčkov <jmeno> Novák Josef, Ing 2013-12-08 10:14:31
prosinec 2013
Strana: 11/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA® <protokol> <status>0 <error>OK
3.2
Příklad vstupního souboru
185 00277444 Město Veráčkov <jmeno>Novák Josef, Ing 2013-06-12 10:14:31 00277444 Město Veráčkov 2013 1 <doklad> 41000001 4101 2013-01-10 Prodej zboží na pokladně 2013-01-10 2013-01-10 2013 1 57160 CZ12345678 12345678 Pelhrimov <prenesena_povinnost> 4 <jednotka>1 <pocet>2.0000 <sazba_dph>20.00 50.00 <prenesena_povinnost> <su>604 0010 <polozka/>
Strana: 12/15
prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA® 601 <partner/> <partner_tr/> <poznamka/> <md/> 100.00 21.00 <su>343 0011 <polozka/> 601 <partner/> <partner_tr/> <poznamka/> <md/> 21.00 21.00 <doklad> 410002 nazev UD 4102 2013-01-11 obsah D 2013-01-11 2013-01-11 2013 1 59552 CZ9876543 9876543 Pluzen <prenesena_povinnost> 2 <jednotka>1 <pocet>1.0000 <sazba_dph>20.00
prosinec 2013
Strana: 13/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA® 350.00 <prenesena_povinnost> <prenesena_povinnost> 6 <jednotka>1 <pocet>100.0000 <sazba_dph>20.00 77.00 <prenesena_povinnost> <su>311 0000 <polozka/> 601 <partner/> <partner_tr/> <poznamka/> <md>-115.86 <doklad> 410002 nazev UD 1002 2013-01-11 pohledávka za služby 2012-12-10 2012-12-10 2012 12 59552 CZ44448888 44448888 Vltavce <su>311 0000 <polozka/>
Strana: 14/15
prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA® 601 <partner/> <partner_tr/> <poznamka/> <md>-115.00 <pata> <poc_obdobi>1 <poc_dokladu>17 <poc_obratu>71 <suma_md>729487.83 <suma_dal>729487.83
VERA, spol. s r.o. www.vera.cz Hotline : +420 495 703 212, [email protected]
prosinec 2013
Strana: 15/15