ARES XML služby končí k 1.1.2024

[BigOHenry]

Nový ares (REST API): zdroj

Vážení uživatelé,
tímto vám oznamujeme, že jsme spustili pilotní provoz modernizovaného Informačního systému ARES, který je dostupný na adrese "ares.gov.cz".

Technickou dokumentaci - katalog veřejných služeb pro vývojáře je možné získat:

ARES-Technicka-dokumentace-Katalog-verejnych-sluzeb (PDF, 1183 kB)
AresRestApi-verejne (.JSON, 326 kB)

Původní i modernizovaný systém bude provozován souběžně do 30. 9. 2023. Nezbytné změny doporučujeme provést co nejdříve. V případě dotazů se prosím obracejte na email: aresmfcr@mfcr.cz

[h4kuna]

Pěkný, to je pro mě celkem šibeniční termín. S tím abych to nastudoval a zajistil zpětnou kompatibilitu.

[h4kuna]

Vývoj je ve větvi 3.x

[BigOHenry]

Ten jeden měsíc je za mě nepochopitelnej. Nevím proč tak spěchají.

[josefsabl]

Vývoj je ve větvi 3.x

Prosím, v jakém stádiu je vývoj? Je to již nějak použitelné v alpha režimu? Pracuji na nové aplikaci, kde ARES využijeme, tak bych byl early adopter nové verze a mohl nějak pomoci s vychytáváním much 😄 .

[h4kuna]

Teď jsem to dodělal do stavu, že to implementuju do aplikace a nechám to tak týden běžet. Takže pokud chceš, můžeš

composer require h4kuna/ares:3.x-dev

Příklad v dokumentaci je funkční.

[h4kuna]

Tak oficiálně je to připravené na alfa testování, není tam nic co bych chtěl implementovat.

[BigOHenry]

Díky. Vypadá to že základ funguje. Jen ještě otázka, máš v plánu implementovat další endpointy? (RES, VR, atd.). Aspoň jako obecnou metodu kam člověk dá ičo, zvolí endpoint a vrátí to raw JSON

EDIT: Dobrý, už jsem našel :-)

[h4kuna]

Super že jsi to našel, nicméně i sem přidám odkaz na changelog

[BigOHenry]

Narazil jsem na jednu věc. Plátce DPH.

$data->tin = Strings::trimNull($json->dic ?? null);
$data->vat_payer = (bool) $data->tin;

To, že má osoba DIČ ještě neznamená že je plátce DPH. Může být jen jako identifikovaná osoba. Hodnota atributu vat_payer je tedy za mě špatně.

Hodnota plátce DPH vrací pouze ekonomicke-subjekty-szr -> zaznamSzr -> platceDPH

[h4kuna]

To znamená udělat dotaz na další endpoint... tomu jsem se chtěl vyhnout

[hubipe]

@BigOHenry To je hloupost, ekonomicke-subjekty-szr je endpoint pro Záznamy Zemědělského registru. Firmy a živnostníci tam nebudou. Obávám se, že ARES vůbec informaci o plátcovství DPH nezná. Na ověření plátce DPH slouží VIES.

@h4kuna V changelogu píšeš:

zmizela metoda isGroupVat() ARES již vrací DIČ pro skupinové DPH

Jenže ARES vrací DIČ pro skupinové DPH chybně...

Viz např.: https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/02445344 - ARES vrací DIČ 02445344, ale správné DIČ subjektu je CZ699004845
nebo: https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/49240901 - ARES vrací DIČ 49240901, ale správné DIČ subjektu je CZ699003154

Psal jsem před chvílí na aresmfcr@mfcr.cz s dotazem, jestli bude ARES vracet správná DIČ v případě skupinových registrací k DPH. Uvidíme co odpoví, jestli odpoví...

[BigOHenry]

@hubipe Co je hloupost? Vyhodnocení plátce DPH je špatně implementované. Nepsal jsem že szr vrací vše, jen jsem napsal který endpoint to vrací :-)

Jinak máš pravdu, ARES (žádný endpoint) tedy nevrací plátce DPH pro všechny subjekty.

Také potvrzuji špatné skupinové DIČ.
Díky a dej pak prosím vědět až odpoví (jestli) :-)

@h4kuna Bude to tedy spíše o tom atribut vat_payer úplně vyhodit.

[mabar]

Vyhazovat se nemusí, ale místo ano/ne to bude možná/ne

[SvatoplukHus]

@mabar Informace "možná" je poměrně málo použitelná.

Správné je nevracet info o plátcovství DPH, protože ho Ares neposkytuje.

Dedukovat nepřesné informace je asi mimo scope této knihovny.

[h4kuna]

@hubipe to jsem napsal. Měl jsem IČO v testech, který začalo dávat správný data, ale hlavní důvod je že odebrali parametr psu, kde to bylo extra uvedený. Navíc vraceli místo DIČ text Skupinove_DPH to taky už není. V tuto chvíli nevím čeho se chytit.