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 <ucetni_obraty xmlver="vera-uo02"> 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 <var_symbol> obchodního partnera 2. Zařazení kapitoly Struktura Těla souboru popis prenesena_povinnost za kapitolu 2.2.4 Struktura Těla souboru popis Účetního dokladu Ing. Hrabalová 02.1 13.1.2014 1. Změna v kapitole 2.2.1 záhlaví souboru <ucetni_obraty xmlver="vera-uo02.1"> 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ů Ing. Hrabalová 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 <obdobi> 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: M povinné pole (mandatory) x alfanumerické pole n numerické pole! fixní délka pole d desetinné číslo (Decimal); tečka jako oddělovač desetinných míst 2.1 Struktura Komunikačního rozhraní VERA UO02.1 Kódování Záhlaví Hlavička Tělo Pata 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 Ukázka struktury souboru: <?xml version="1.0" encoding="utf-8"?> <ucetni_obraty xmlver="vera-uo02.1"> <hlavicka> <obdobi> <doklad> <obrat> </doklad> </obdobi> <pata> </ucetni_obraty> 2.2 Struktura jednotlivých částí Komunikačního rozhraní VERA UO02.1 2.2.1 Struktura Záhlaví Ukázka Záhlaví: <?xml version="1.0" encoding="utf-8"?> <ucetni_obraty xmlver="vera-uo02.1"> 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 Význam <id_xml> <ic_org> <nazev_org> <jmeno> <datum> <cas> 40 x M 8 n! M Identifikace přenosu IČ odesílatele souboru 76 x M Název odesílatele souboru 128 x M Jméno odesílatele souboru rrrr-mm-dd M hh:mm:ss M Datum vyhotovení Čas vyhotovení 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 Datum vyhotovení souboru Čas vyhotovení souboru Ukázka Hlavičky: <hlavicka> <id_xml>185</id_xml> <ic_org>00277444</ic_org> <nazev_org>město Veráčkov</nazev_org> <jmeno>novák Josef, Ing</jmeno> <datum>2013-06-12</datum> <cas>10:14:31</cas> </hlavicka> 2.2.3 Struktura Těla souboru popis Období Elementy Období Formát Název elementu Význam <ic_uj> <nazev_uj> <uo_rok> <uo_mesic> 8 n! 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 <cislo_uc_dokladu> 8 n M Čí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 <nazev_uc_doklad> v rámci účetního období 79 x Název dokladu Textový popis účetního dokladu <cislo_uc_pripad> 10 n M Číslo účetního případu <datum_uc_pripad> <obsah_uc_pripad> <datum_dph_uzp> <datum_dph_dud> <dph_rok> <dph_mesic> <barcode> rrrr-mm-dd M Datum účetního případu 240 x Obsah účetního případu rrrr-mm-dd rrrr-mm-dd DUZP DUD 4 rrrr Období DPH rok 2 mm Období DPH měsíc 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 20 x Čárový kód Čárový kód účetního dokladu <dic_partner> 14 x DIČ partnera Daňové identifikační číslo obchodního partnera <ic_partner> 10 x IČ partnera Identifikační číslo obchodního partnera <nazev_partner> 50 x Název partnera Název obchodního partnera <var_symbol> 10 x Variabilný symbol Variabilný symbol partnera 2.2.5 Struktura Těla souboru popis Přenesená povinnost Elementy Dokladu Formát Název elementu Význam <kod_predmetu> 1 x Kód předmětu <kod_zbozi> 8 x Kód zboží <kod_czpca> 8 x Kód CZ-PCA <jednotka> 10 x Jednotka <pocet> (13,4) d Rozsah plnění <sazba_dph> (5,2) d Sazba DPH <zaklad_dph> (13,2) d Základ DPH Přenesená povinnost kód předmětu plnění Přenesená povinnost kód zboží plnění Přenesená povinnost kód CZ- PCA 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í prosinec 2013 Strana: 7/15
2.2.6 Struktura Těla souboru popis Obratu dokladu Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA Elementy Obraty Formát Název elementu Význam <su> <au> <od_pa/> <polozka/> 3 n! M Syntetický účet 4 n! M Analytický účet 4 n! Oddíl,paragraf 4 n! Položka rozpočtu Syntetický účet dle platného účtového rozvrhu účetní jednotky Analytický účet dle platného účtového rozvrhu účetní jednotky Funkční třídění rozpočtové skladby Druhové třídění rozpočtové skladby <nastroj/> 3 n! Nástroj Financování dle nástrojové třídění <zdroj/> 1 n! Zdroj Financování dle prostorového třídění pro označení původu <uc_znak/> <zaz_jed> <org_jed/> <org_cis/> <kapitola/> <anl_cleneni/> <typ_zmeny/> <partner/> <partner_tr/> 5 n! Účelový znak Označení účelu transferů 3 n! Záznamová jednotka 10 n Organizační jednotka 13 n Organizační číslo 3 n Kapitola 8 n Analytické členění 3n! Typ změny 8 x IČ partnera 8 x 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 Strana: 8/15 prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA <poznamka/> <md/> <dal> <per_dph> 383/2009 79 x Popis obratu Textový popis účetního obratu (18,2) d Má dáti (18,2) d Dal (5,2) d Sazba DPH Ú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: <obdobi> <ic_uj>00277444</ic_uj> <nazev_uj>město Veráčkov</nazev_uj> <uo_rok>2013</uo_rok> <uo_mesic>1</uo_mesic> <doklad> <cislo_uc_dokladu>41000001</cislo_uc_dokladu> <nazev_uc_doklad/> <cislo_uc_pripad>4101</cislo_uc_pripad> <datum_uc_pripad>2013-01-10</datum_uc_pripad> <obsah_uc_pripad>prodej zboží na pokladně</obsah_uc_pripad> <datum_dph_uzp>2013-01-10</datum_dph_uzp> <datum_dph_dud>2013-01-10</datum_dph_dud> <dph_rok>2013</dph_rok> <dph_mesic>1</dph_mesic> <barcode>57160</barcode> <dic_partner>cz12345678</dic_partner> <ic_partner>12345678</ic_partner> <nazev_partner>pelhrimov</nazev_partner> <var_symbol/> <kod_predmetu>4</kod_predmetu> <kod_zbozi/> <kod_czpca/> <jednotka>1</jednotka> <pocet>2.0000</pocet> <sazba_dph>20.00</sazba_dph> <zaklad_dph>50.00</zaklad_dph> <obrat> <su>604</su> <au>0010</au> <od_pa/> <polozka/> <nastroj/> <zdroj/> <uc_znak/> <zaz_jed>601</zaz_jed> <org_jed/> <org_cis/> <kapitola/> <anl_cleneni/> <typ_zmeny/> <partner/> prosinec 2013 Strana: 9/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA <partner_tr/> <poznamka/> <md/> <dal>100.00</dal> <per_dph>21.00</per_dph> </obrat> </doklad> </obdobi> 2.2.7 Struktura Paty Elementy Paty Formát Název elementu Význam <poc_obdobi> <poc_dokladu> <poc_obratu> <suma_md> <suma_dal> 2 Počet období Počet účetních období v souboru 3 Počet účetních dokladů Počet účetních dokladů v souboru 3 Počet obratů Počet obratů v souboru (18,2) Suma MD Celková suma MD (18,2) Suma DAL Celková suma Dal Ukázka Paty: <pata> <poc_obdobi>1</poc_obdobi> <poc_dokladu>17</poc_dokladu> <poc_obratu>71</poc_obratu> <suma_md>729487.83</suma_md> <suma_dal>729487.83</suma_dal> </pata> 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>) 3.1 Struktura polí souboru Protokol: Odpověď se obsahuje shodnou strukturu jako věta <hlavicka>. V těle zprávy jsou obsaženy tyto informace: <protokol> <stav>xxx </stav> <error>xxx </error> </protokol> 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ě <?xml version="1.0" encoding="utf-8"?> <ucetni_obraty xmlver="vera-uo02.1"> <hlavicka> <id_xml>139</id_xml> <ic_org>00277444</ic_org> <nazev_org> Město Veráčkov</nazev_org> <jmeno>novák Josef, Ing</jmeno> <datum>2013-12-08 </datum> <cas>15:54:27</cas> </hlavicka> <protokol> <status>-349</status> <error>chyba #349: Nesprávný formát údaje [dal] :'ABC' - Platný formát 'číslo s des.tečkou' </error> </protokol> </ucetni_obraty> b) Bez chyb <?xml version="1.0" encoding="utf-8"?> <ucetni_obraty xmlver="vera-uo02.1"> <hlavicka> <id_xml>185</id_xml> <ic_org>00277444</ic_org> <nazev_org>město Veráčkov</nazev_org> <jmeno> Novák Josef, Ing</jmeno> <datum>2013-12-08 </datum> <cas>10:14:31</cas> prosinec 2013 Strana: 11/15
Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA </hlavicka> <protokol> <status>0</status> <error>ok</error> </protokol> </ucetni_obraty> 3.2 Příklad vstupního souboru <?xml version="1.0" encoding="utf-8"?> <ucetni_obraty xmlver="vera-uo02.1"> <hlavicka> <id_xml>185</id_xml> <ic_org>00277444</ic_org> <nazev_org>město Veráčkov</nazev_org> <jmeno>novák Josef, Ing</jmeno> <datum>2013-06-12</datum> <cas>10:14:31</cas> </hlavicka> <obdobi> <ic_uj>00277444</ic_uj> <nazev_uj>město Veráčkov</nazev_uj> <uo_rok>2013</uo_rok> <uo_mesic>1</uo_mesic> <doklad> <cislo_uc_dokladu>41000001</cislo_uc_dokladu> <nazev_uc_doklad/> <cislo_uc_pripad>4101</cislo_uc_pripad> <datum_uc_pripad>2013-01-10</datum_uc_pripad> <obsah_uc_pripad> Prodej zboží na pokladně</obsah_uc_pripad> <datum_dph_uzp>2013-01-10</datum_dph_uzp> <datum_dph_dud>2013-01-10</datum_dph_dud> <dph_rok>2013</dph_rok> <dph_mesic>1</dph_mesic> <barcode>57160</barcode> <dic_partner>cz12345678</dic_partner> <ic_partner>12345678</ic_partner> <nazev_partner>pelhrimov</nazev_partner> <var_symbol/> <kod_predmetu>4</kod_predmetu> <kod_zbozi/> <kod_czpca/> <jednotka>1</jednotka> <pocet>2.0000</pocet> <sazba_dph>20.00</sazba_dph> <zaklad_dph>50.00</zaklad_dph> <obrat> <su>604</su> <au>0010</au> <od_pa/> <polozka/> <nastroj/> Strana: 12/15 prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA <zdroj/> <uc_znak/> <zaz_jed>601</zaz_jed> <org_jed/> <org_cis/> <kapitola/> <anl_cleneni/> <typ_zmeny/> <partner/> <partner_tr/> <poznamka/> <md/> <dal>100.00</dal> <per_dph>21.00</per_dph> </obrat> <obrat> <su>343</su> <au>0011</au> <od_pa/> <polozka/> <nastroj/> <zdroj/> <uc_znak/> <zaz_jed>601</zaz_jed> <org_jed/> <org_cis/> <kapitola/> <anl_cleneni/> <typ_zmeny/> <partner/> <partner_tr/> <poznamka/> <md/> <dal>21.00</dal> <per_dph>21.00</per_dph> </obrat> <doklad> <cislo_uc_dokladu>410002</cislo_uc_dokladu> <nazev_uc_doklad>nazev UD</nazev_uc_doklad> <cislo_uc_pripad>4102</cislo_uc_pripad> <datum_uc_pripad>2013-01-11</datum_uc_pripad> <obsah_uc_pripad >obsah D</obsah_uc_pripad > <datum_dph_uzp>2013-01-11</datum_dph_uzp> <datum_dph_dud>2013-01-11</datum_dph_dud> <dph_rok>2013</dph_rok> <dph_mesic>1</dph_mesic> <barcode>59552</barcode> <dic_partner>cz9876543</dic_partner> <ic_partner>9876543</ic_partner> <nazev_partner>pluzen</nazev_partner> <var_symbol/> <kod_predmetu>2</kod_predmetu> <kod_zbozi/> <kod_czpca/> <jednotka>1</jednotka> <pocet>1.0000</pocet> <sazba_dph>20.00</sazba_dph> prosinec 2013 Strana: 13/15
<zaklad_dph>350.00</zaklad_dph> <kod_predmetu>6</kod_predmetu> <kod_zbozi/> <kod_czpca/> <jednotka>1</jednotka> <pocet>100.0000</pocet> <sazba_dph>20.00</sazba_dph> <zaklad_dph>77.00</zaklad_dph> <obrat> <su>311</su> <au>0000</au> <od_pa/> <polozka/> <nastroj/> <zdroj/> <uc_znak/> <zaz_jed/> <org_jed/> <org_cis/> <kapitola/> <anl_cleneni/> <typ_zmeny>601</typ_zmeny> <partner/> <partner_tr/> <poznamka/> <md>-115.86</md> <dal/> <per_dph/> </obrat> </doklad> <doklad> <cislo_uc_dokladu>410002</cislo_uc_dokladu> <nazev_uc_doklad>nazev UD</nazev_uc_doklad> <cislo_uc_pripad>1002</cislo_uc_pripad> <datum_uc_pripad>2013-01-11</datum_uc_pripad> <obsah_uc_pripad >pohledávka za služby</obsah_uc_pripad > <datum_dph_uzp>2012-12-10</datum_dph_uzp> <datum_dph_dud>2012-12-10</datum_dph_dud> <dph_rok>2012</dph_rok> <dph_mesic>12</dph_mesic> <barcode>59552</barcode> <dic_partner>cz44448888</dic_partner> <ic_partner>44448888</ic_partner> <nazev_partner>vltavce</nazev_partner> <var_symbol/> <obrat> <su>311</su> <au>0000</au> <od_pa/> <polozka/> <nastroj/> <zdroj/> <uc_znak/> <zaz_jed/> <org_jed/> Rozhraní VERA-UO, verze 02.1 IS R@dnice VERA Strana: 14/15 prosinec 2013
Rozhraní VERA-UO; verze 02.1 IS R@dnice VERA <org_cis/> <kapitola/> <anl_cleneni/> <typ_zmeny>601</typ_zmeny> <partner/> <partner_tr/> <poznamka/> <md>-115.00</md> <dal/> <per_dph/> </obrat> </doklad> </obdobi> <pata> <poc_obdobi>1</poc_obdobi> <poc_dokladu>17</poc_dokladu> <poc_obratu>71</poc_obratu> <suma_md>729487.83</suma_md> <suma_dal>729487.83</suma_dal> </pata> </ucetni_obraty> VERA, spol. s r.o. www.vera.cz Hotline : +420 495 703 212, hotline@vera.cz prosinec 2013 Strana: 15/15