Changelog
Hlavní změny ve verzi 4.2
Tato stránka obsahuje seznam změn změn v API od 1. června 2022.
Nově je možná využít u metod, které pracují s věřiteli (addeligibletocause, insert, update, updateeligible) použít parametr hidden_identity, který nastaví u věřitele takzvanou skrytou identitu, pokud je zaslán s boolean hodnotou true. V případě, že tento parametr není vyplněn, nebo je odeslán jako boolean hodnota false, není skrytá identita pro daného věřitele nastavena.
Zároveň je v případě použití skryté identity automaticky nulována zasílaná hodnota parametrů adresa a address_code a birthdate.
Po vložení povinného touto metodou dochází nyní navíc k přidání další návratové položky v odpovědi. Kromě cause_id, subject_id a message, API nyní vrací taktéž document_id, které obsahuje identifikátor vloženého dokumentu k povinnému.
Parametr foreigner, který při práci s povinnými a oprávněnými označuje cizince nyní pouze vypíná validační pravidla pro kontrolu rodnéhé čísla a IČO.
V níže uvedeném příkladu je vkládán cizinec s číslem pasu místo rodného čísla a adresou trvalého pobytu v ČR na adrese Vodičkova 681/18, 110 00 Praha 1.
U cizinců (právnických i fyzických) nebo osob, kteřé mají trvalou adresu nebo sídlo v zahraničí je nově přidán parametr foreign_address. Při použití tohoto parametru není povinnost zadat adresu ve tvaru RÚIAN. Tento parametr lze použít pouze pokud se adresa nachází skutečně v zahraničí, hodnota tohoto parametru je dvoumístný kód země ve tvaru ISO 3166-1 Alpha 2 a kód země nikdy nemůže být "CZ", aby nebylo možné tímto způsobem obejít kontrolu adres v České republice (příklady, jak zaslat osobu s adresou v ČR, pokud k ní neexistuje platný kód RÚIAN jsou uvedeny dále).
Použití parametru "foreign_address" není omezeno pouze na cizince. Do systému lze vložit i osobu s rodným číslem nebo IČO ale zároveň s trvalou adresou v zahraničí.
Pro případ, kdy má osoba trvalou adresu v České republice (bez ohledu zda se jedná o cizince nebo ne) a zároveň k této osobě nelze dohledat přesný kód adresního místa z RÚIAN (dům již neexistuje, nebo jiné výjimky z pravidel pro ISÚI/RÚIAN) lze místo parametru address_code použít nový parametr city_code jehož hodnota je kód obce dle číselníku ČÚZK. V tomto případě je nutné zaslat adresu v textovém tvaru a doplnit ji o kód obce.
Zároveň je nutné k tomuto parametru vždy připojit odůvodnění, proč není adresa vložena ve formátu kódu adresního místa. Tedy, že uvedenou adresu, nelze například v RÚIAN dohledat. Důvod je nutné uvést v parametru address_note.
Pouze výhradně v případě že osoba ukončila pobyt na území ČR a jeho další pobyt není znám je možné osobu do systému vložit tímto způsobem.
- Nový typ dokumentu 1410 - Zastaveno podle § 55 odst. 7 až 13 EŘ.
- Hodnota cause_terminated v návratových datech z /insertcompletion nyní vždy vrací 1 a v dalších verzích bude parametr zcela odstraněn. Kauza je ukončena vždy, pokud splní příslušná legislativní pravidla.
- Ukončena podpora metody /completiontypelist. Tato metoda nyní vrací to samé co metoda /documenttypelist.
- Přidán parametr auto_close, který označuje datum smazání povinného z Centrální Evidence Exekucí.
- Byly přidány nové typy dokumentů pro ukončování a vkládání kauz v souvislosti s milostivým létem. Kódy dokumentů naleznete v metodách /documenttypelist a completiontypelist.
- Nový parametr city_code na výstupu metod /insert a /detail v souvislosti s nadcházejícími úpravami v API 4.2.
- [V4] Možnost použít boolean parametr hidden_identity pro skrytou identitu věřitele.
- [V4] Nový povinný dokument ke kauze - druh exekučního titulu. Viz /insertenforcement a /updateenforcement související metody.
- [V4] Vložení věřitele je nově povinné pro všechny kauzy.
- [V4] V metodách /myoffice a /mine lze do URL přidat parametr ?page=1 pro stránkování, po 1000 záznamech.
- [V3] Použítí API KEY z API verze 4 ve starém API verze 3 vyhodí chybovou hlášku o nekompatibilitě.
- [V3] Odstranění podpory pro API verze 3. Dokumentace nyní k dispozici pouze pro API verze 4.
- [V3] Odstranění podpory metod /geocodeaddress, /ruiantoaddress.
- [V4] Výstup z API nyní escapuje Unicode a lomítka.
- [V4] Odstranění podpory parametru callback pro spuštění kódu pomocí techniky JSONP.
- [V3] [V4] Nový typ dokumentu: Pravomocné nařízení likvidace dědictví. Číselník dokumentu je 1406.
- [V4] Metoda /documenttypelist nyní vrací nové, upravené popisky dokumentů.
- [V3] [V4] Nový typ ukočení: Úmrtí povinného – povinný zemřel, exekuční řízení není zastaveno, ale čeká se, zda dojde ke změně v důsledku dědění, po rozhodnutí o procesním nástupnictví exekutor zapíše nového povinného. Číselník ukončení je 1305.
- [V4] Metoda /completiontypelist nyní vrací nové, upravené popisky ukočení.
- [V3] Odebrána metoda DELETE
- [V3] Nová metoda /validatesubject a objekt výstupu data.errors pro některé metody viz chyby, vyjímky, vyrování.
- [V3] Nová metoda /ruiantoaddress pro převod kódu ADM z RÚIAN na infomrace o adrese
- [V3] Nová metoda /geocodeaddress pro dohledání adresy z RÚIAN
- [V3] Při vkládání nebo změně FO, je možné poslat paramer gender s hodnotou
M
(muž) neboF
(žena) pro určení pohlaví povinného. Pokud není poslán, určí se z rodného čísla. Pokud osoba nemá rodné číslo - nebo z rodného čísla nelze rozpoznat pohlaví je tato položka povinná u fyzických osob. - [V3] Nově pokud /insert vloží kauzu a stejná kauza u kanceláře již existuje, bude stará kauza automaticky deaktivována.
- [V3] Neaktivní kauzy s datem založení starším než 30 dní jsou nyní automaticky přesouvány do archivu.
- [V3] Ve všech metodách byla vypnuta validace rodného čísla a IČ.
- [V3] Ve všech metodách >kromě /search byla vypnuta validace rodného čísla.
- [V3]
Parametr /insert nový parametr "foreigner" vkládání rodných čísel cizinců (také pro /updatesubject, /addsubjecttocause). - [V3]
Parametr /search nový parametr "foreigner" pro vyhledávání cizinců. - [V3] Parametr /insert one_time_price nyní může být "0" pro vyjádření nulové jistiny.
- [V3] Přidána metoda /completiontypelist pro seznam povolených typů ukončení.
- [V3] U metod /insertcompletion a /insertdocument lze nově místo pole ID povinných poslat hodnotu
all
a systém automaticky přiřadí požadavek všem aktivním povinným. - [V3] Z důvodu přetížení serveru jsme zavedli limit na jeden evidenční dotaz za jednu sekundu.
- [V3] Přidání nového typu dotazu - evidenční dotaz
- [V3] HTTP POST nyní akceptuje nejen form-data ale i
application/json
, vizte ukázku - [V3] U metody /search je nová položka
search_reason
- [V3] U metody /insert a /update je nová položka
software_version
- [V3] Zneplatnění metod /removesubjectfromcause a /removedocumentfromcause
- [V3] Přidána nová metoda /insertcompletion
- [V3] Upraveny datumy u kauzy, documents je povinná položka pro /insert a /addsubjecttocause, documents se váže na subject
- [V3] Přidány nové metody /courtlist, /documenttypelist
- [V3] Přidány nové metody /me, /colleagues
- [V3] Metoda /mine nyní vrací pouze kauzy, které jsou spojené s přiřazeným exekutorským účtem, nikoliv celou kanceláří. Pro zobrazení kauz z celé kanceláře je zde nová metoda /myoffice
- [V3] Vydána verze 3.0.0