Znalostní báze

Ke stažení

• Instalace (aktuální verze 7.0.40): SetupXMLCaseImporter7040.msi
  
• XML schéma (XSD): XMLImport.xsd
  
• Ukázkový XML soubor: Import.xml
  

Soubory XSD a XML uložíte pravým tlačítkem myši a volbou „Uložit odkaz jako…“.

Přehled změn v jednotlivých verzích najdete v historii verzí.

Průběh importu

Import načte jeden XML soubor s jedním nebo více případy a pro každý případ založí v Evoliu exekuční spis (nebo návrh na exekuci) včetně subjektů, exekučních titulů, vymáhaných finančních položek a příloh.

1. Uživatel vybere XML soubor v dialogu. Soubor se proti XSD nevaliduje – za správnou strukturu odpovídá autor souboru.
   
2. Ze všech textových hodnot se odstraní vícenásobné mezery (nahradí se jednou mezerou).
   
3. Pro každý případ (Case) se zjistí, zda spis se stejnou značkou (ZNACKA, jinak VS) už v Evoliu existuje:
   
   • neexistuje – při prvním novém spisu se zobrazí dialog pro číslo spisu (prefix EX nebo EN, pořadové číslo, postfix /RR); další spisy dostávají čísla o 1 vyšší, obsazená čísla se přeskakují;
     
   • existuje – import se zeptá, zda spis přepsat. Při přepsání se původní spis včetně titulů, vazeb na subjekty a finančních položek smaže a založí znovu se stejným číslem. Jinak lze založit nový spis s novým číslem, nebo případ přeskočit.
     
4. Spis se zakládá v tomto pořadí: hlavička spisu a finanční přehled → exekuční tituly → subjekty a jejich vazby na spis → finanční položky → automatické položky (paušální náklady, odměna) → uložení do databáze → přílohy.
   
5. Na konci se v okně průběhu vypíší všechna varování a chyby.
   

Import zakládá pouze nové spisy (úvodní import). Pokud XML obsahuje sekce Activities, Fillings nebo Payments, import neproběhne vůbec – tyto sekce do souboru nevkládejte.

Struktura XML souboru

Všechna data se zadávají jako atributy elementů; názvy atributů rozlišují velká a malá písmena. Soubor má kódování UTF-8.

<?xml version="1.0" encoding="utf-8"?>
<Cases CasesCount="1">
  <Case C_POR="1" ZNACKA="..." DT_NAV="2024-03-05" VS="..." POZN="...">
    <Parties Count="2">      <Party .../> ...      </Parties>
    <Titles Count="1">       <Title .../> ...      </Titles>
    <FinItems Count="3">     <FinItem .../> ...    </FinItems>
    <Attachments Count="1">  <Attachment .../> ... </Attachments>
  </Case>
</Cases>

Počty jsou povinné a musí sedět. Import načte přesně tolik případů, kolik uvádí CasesCount, a v každé sekci přesně tolik položek, kolik uvádí její atribut Count. Položky nad tento počet se bez upozornění ignorují. Sekce bez atributu Count se nenačte vůbec.

Kořenový element Cases

Případ Case

Sekce uvnitř Case mohou být v libovolném pořadí; sekci, kterou nepotřebujete, vynechte.

Formáty hodnot

• Datum: RRRR-MM-DD, např. 2024-03-05.
  
• Částka a procento: funguje desetinná čárka i tečka (2560,26 i 2560.26), bez oddělovače tisíců a bez měny. Všechny částky jsou v CZK.
  
• Příznaky ano/ne: A = ano, cokoli jiného nebo prázdná hodnota = ne.
  

Subjekty – Parties / Party

Každý Party je oprávněný, povinný nebo právní zástupce. Import nejdřív hledá existujícího klienta v Evoliu; když ho nenajde, založí nového. Pak subjekt naváže na spis s poznámkou „import xml“.

Jak se dohledává existující klient

1. Podle IČO, DIČ a rodného čísla (v tomto pořadí; mezery, pomlčky a lomítka se ignorují). První shoda vyhrává.
   
2. Nemá-li subjekt IČO, DIČ ani RČ, ale má jméno, příjmení a datum narození, hledá se podle nich a uživatel shodu potvrdí v dialogu.
   
3. Je-li zapnuté rozšířené hledání (parametr AdvanceSearch), hledá se ještě podle názvu firmy (když je vyplněno IČO), resp. jména a příjmení, a trvalé adresy.
   
4. Jinak se založí nový klient.
   

Pravidla pro zástupce a adresy

• Zástupce musí v XML následovat až za subjektem, kterého zastupuje (jeho C_POR musí být vyšší než C_POR_Z). Jinak import spisu skončí chybou.
  
• Zástupce oprávněného se založí na straně oprávněného, zástupce povinného na straně povinného. Bez C_POR_Z se bere jako zástupce oprávněného a vypíše se varování.
  
• Město lze zadat i s částí obce ve tvaru Praha - Libeň; text před pomlčkou se uloží jako město, za ní jako část obce.
  
• Doručovací adresa se založí jen tehdy, když se od trvalé liší a AD_PAR_D není prázdné. Když je shodná, trvalá adresa se označí zároveň jako doručovací.
  
• Prázdný stát se doplní na CZ.
  
• Pozor na ZEME_PAR_D: název atributu je bez háčku. Starší soubory s ZEMĚ_PAR_D (s háčkem) se načtou, ale hodnota se ignoruje a stát doručovací adresy bude CZ.
  
• Existující klient se importem nepřepisuje – jen se naváže na spis.
  

<Parties Count="3">
  <Party C_POR="1" TYP_PAR="O" P_F_PAR="1" NZ_PAR="Věřitel a.s." C_PAR="12345678"
         AD_PAR="Hlavní 1" PSC_PAR="110 00" SD_PAR="Praha" ZEME_PAR="CZ"/>
  <Party C_POR="2" TYP_PAR="Z" C_POR_Z="1" P_F_PAR="2" JM_PAR="Jan" PRIJ_PAR="Advokát"
         C_PAR="87654321" AD_PAR="Národní 10" PSC_PAR="110 00" SD_PAR="Praha" ZEME_PAR="CZ"/>
  <Party C_POR="3" TYP_PAR="P" P_F_PAR="3" JM_PAR="Petr" PRIJ_PAR="Dlužník"
         RC_PAR="800101/1234" DN_PAR="1980-01-01"
         AD_PAR="Polní 5" PSC_PAR="602 00" SD_PAR="Brno - Královo Pole" ZEME_PAR="CZ"
         AD_PAR_D="Lesní 7" PSC_PAR_D="612 00" SD_PAR_D="Brno" ZEME_PAR_D="CZ"/>
</Parties>

Exekuční tituly – Titles / Title

Každý Title založí exekuční titul a naváže ho na spis. Tituly se zakládají před finančními položkami, takže na ně položky mohou odkazovat přes ET_C.

• Chybějící datum vydání, právní moci nebo vykonatelnosti titul nezastaví – pole zůstane prázdné a vypíše se varování.
  
• Soud (ET_VYD) se hledá mezi klienty podle názvu společnosti, mezery se ignorují. Když ho import nenajde, založí nového klienta typu SOUD. Pište proto název soudu přesně tak, jak je v Evoliu, jinak vzniknou duplicity (OS Brno vs. Okresní soud v Brně).
  

<Titles Count="2">
  <Title C_POR="1" ET_T="platební rozkaz" ET_C="12 C 345/2023" ET_DT="2023-01-10"
         ET_PM="2023-02-15" ET_VYK="2023-02-20" ET_VYD="Okresní soud v Brně"/>
  <Title C_POR="2" ET_T="usnesení" ET_C="12 C 345/2023-25" ET_DT="2023-05-02"
         ET_PM="2023-05-20" ET_VYK="2023-05-25" ET_VYD="Okresní soud v Brně"/>
</Titles>

Finanční položky – FinItems / FinItem

Každý FinItem založí jednu vymáhanou položku; druh určuje atribut F_TYP. Položky se zpracovávají v pořadí podle C_POR a na tomto pořadí záleží (viz Pořadí a vázání na jistinu).

Druhy položek (F_TYP)

Jiná hodnota F_TYP se přeskočí bez varování. Položka bez F_CASTKA nebo F_TYP se nezaloží a vypíše se varování.

Společné atributy

Parametry nákladů zastoupení dle tarifu (Z2, Z3, Z4)

Položky Z, Z2, Z3 a Z4 se označí jako ručně zadané, takže Evolio jejich částku nepřepočítává.

Pořadí a vázání na jistinu

• Každá jistina J dostane označení JISU1, JISU2, … v pořadí podle C_POR.
  
• Všechny položky za jistinou se váží k této jistině, dokud nepřijde další J. Proto vždy pište jistinu a za ní její příslušenství (úroky, náklady), pak další jistinu a její příslušenství.
  
• Položky před první jistinou dostanou označení JISU bez čísla.
  
• Je-li úrok U zpracován dřív než jakákoli jistina, nastaví se mu „datum do“ na dnešek a vypíše se varování.
  

Položky, které import přidá automaticky

Ke každému novému spisu se bez ohledu na XML založí:

• paušální náklady exekutora 3 500 Kč bez DPH + DPH 21 %;
  
• odměna exekutora z peněžitého plnění, příslušenství a nákladů, DPH 21 %.
  

Tyto položky do XML nevkládejte. Spis má navíc nastaveno „náklady paušálem“.

<FinItems Count="6">
  <!-- jistina 1 a její příslušenství -->
  <FinItem C_POR="1" F_TYP="J" F_CASTKA="25000" F_DT_OD="2022-11-30" ET_C="12 C 345/2023" VS="2022001"/>
  <FinItem C_POR="2" F_TYP="U" F_CASTKA="25000" F_DT_OD="2022-12-01" IND_RS="A" Z_PROC="8" ET_C="12 C 345/2023"/>
  <FinItem C_POR="3" F_TYP="P" F_CASTKA="1000" ET_C="12 C 345/2023"/>
  <FinItem C_POR="4" F_TYP="Z3" F_CASTKA="6800" F_NZ="Náklady právního zastoupení" F_PODTYP="A1-012"
           F_ZAKLAD="1500" F_POCETUKONU="2" F_REZIJNIPOPLATEK="300" F_POCETOSOB="1"
           F_POLOVICNIODMENA="N" F_DPH="21" ET_C="12 C 345/2023"/>
  <!-- jistina 2 a její příslušenství -->
  <FinItem C_POR="5" F_TYP="J" F_CASTKA="4200,50" F_DT_OD="2023-03-31" ET_C="12 C 345/2023-25"/>
  <FinItem C_POR="6" F_TYP="U" F_CASTKA="4200,50" F_PROC="10,25" F_DT_OD="2023-04-01" F_DT_DO="2023-12-31" ET_C="12 C 345/2023-25"/>
</FinItems>

Přílohy – Attachments / Attachment

Soubor musí ležet ve stejné složce jako importovaný XML. Vloží se do kořenové složky dokumentů spisu. Když soubor neexistuje, vypíše se varování a import pokračuje. Atributy TYP, POPIS a DRUH_DOK se načtou, ale nepoužijí.

Hlášení během importu

Poznámky k XSD

• Import soubor proti XSD nevaliduje. XSD navíc deklaruje cílový jmenný prostor http://tempuri.org/XML.xsd, který ukázkový soubor neuvádí – pro validaci v editoru je potřeba ho do XML doplnit (xmlns="http://tempuri.org/XML.xsd").
  
• Atributy F_CASTKA a F_PROC jsou v XSD textové (xs:string), aby prošla desetinná čárka i tečka; XSD tedy nehlídá, že jde o číslo.
  
• U REPO úroku je popis položky vždy „REPO sazbou navýšenou o 7%-ních bodů“, i když Z_PROC uvádí jinou hodnotu; výpočet použije Z_PROC.
  
• Sekce PaymentDescs se načte, ale nezpracuje. Sekce Activities, Fillings a Payments import zablokují.
  

Kompletní ukázka

<?xml version="1.0" encoding="utf-8"?>
<Cases NAME="030" Date="2026-10-05" CasesCount="1">
  <Case C_POR="1" ZNACKA="POH-2026-0001" VS="2026000001" DT_NAV="2026-09-30" POZN="Import z pojišťovny">
    <Parties Count="3">
      <Party C_POR="1" TYP_PAR="O" P_F_PAR="1" NZ_PAR="Věřitel a.s." C_PAR="12345678" DIC_PAR="CZ12345678"
             AD_PAR="Hlavní 1" PSC_PAR="110 00" SD_PAR="Praha" ZEME_PAR="CZ"/>
      <Party C_POR="2" TYP_PAR="Z" C_POR_Z="1" P_F_PAR="2" JM_PAR="Jan" PRIJ_PAR="Advokát" C_PAR="87654321"
             AD_PAR="Národní 10" PSC_PAR="110 00" SD_PAR="Praha" ZEME_PAR="CZ"/>
      <Party C_POR="3" TYP_PAR="P" P_F_PAR="3" JM_PAR="Petr" PRIJ_PAR="Dlužník" RC_PAR="800101/1234" DN_PAR="1980-01-01"
             AD_PAR="Polní 5" PSC_PAR="602 00" SD_PAR="Brno - Královo Pole" ZEME_PAR="CZ"
             AD_PAR_D="Lesní 7" PSC_PAR_D="612 00" SD_PAR_D="Brno" ZEME_PAR_D="CZ"/>
    </Parties>
    <Titles Count="1">
      <Title C_POR="1" ET_T="platební rozkaz" ET_C="12 C 345/2023" ET_DT="2023-01-10"
             ET_PM="2023-02-15" ET_VYK="2023-02-20" ET_VYD="Okresní soud v Brně"/>
    </Titles>
    <FinItems Count="5">
      <FinItem C_POR="1" F_TYP="J" F_CASTKA="25000" F_DT_OD="2022-11-30" ET_C="12 C 345/2023" VS="2026000001"/>
      <FinItem C_POR="2" F_TYP="U" F_CASTKA="25000" F_DT_OD="2022-12-01" IND_RS="A" Z_PROC="8" ET_C="12 C 345/2023"/>
      <FinItem C_POR="3" F_TYP="UC" F_CASTKA="1250,40" F_NZ="Kapitalizovaný úrok z prodlení" ET_C="12 C 345/2023"/>
      <FinItem C_POR="4" F_TYP="P" F_CASTKA="1000" ET_C="12 C 345/2023"/>
      <FinItem C_POR="5" F_TYP="Z3" F_CASTKA="6800" F_PODTYP="A1-012" F_ZAKLAD="1500" F_POCETUKONU="2"
               F_REZIJNIPOPLATEK="300" F_POCETOSOB="1" F_POLOVICNIODMENA="N" F_DPH="21" ET_C="12 C 345/2023"/>
    </FinItems>
    <Attachments Count="1">
      <Attachment C_POR="1" FILENAME="platebni_rozkaz.pdf"/>
    </Attachments>
  </Case>
</Cases>

Kontrolní seznam před importem

• CasesCount a všechny atributy Count odpovídají skutečnému počtu elementů.
  
• Každý případ má jednoznačnou ZNACKA (nebo VS) a vyplněné DT_NAV.
  
• Zástupce (TYP_PAR="Z") je vždy až za subjektem, na který ukazuje C_POR_Z.
  
• Doručovací stát je v atributu ZEME_PAR_D (bez háčku).
  
• Názvy soudů v ET_VYD odpovídají názvům v Evoliu.
  
• Každá jistina J je před svým příslušenstvím a má F_DT_OD.
  
• ET_C u finančních položek se přesně shoduje s ET_C titulu.
  
• XML neobsahuje sekce Activities, Fillings ani Payments a ručně nevkládá paušální náklady ani odměnu exekutora.
  
• Přílohy leží ve stejné složce jako XML soubor.