|
3 | 3 | - podpora nového API ARES2 |
4 | 4 | - v [bin](./bin) jsou spustitelné ukázky, jak se dostat na číselníky a jak na ostatní endpointy |
5 | 5 | - pro IČO je vyžadován formát \d{8}, pokud je kratší, knihovna sama doplní nuly zleva |
6 | | -- očekávám že se změní url API, pro tento případ je připravená `public static h4kuna\Ares\Ares\Helper::$baseUrl`, kterou lze nahradit, bez nutnosti vyčkávat na nový release |
7 | | -- podobně lze dopnit nebo upravit url adresy endpointů |
| 6 | +- očekávám že se změní url API, pro tento případ je připravená `public static h4kuna\Ares\Ares\Helper::$baseUrl`, kterou |
| 7 | + lze nahradit, bez nutnosti vyčkávat na nový release |
| 8 | +- podobně lze doplnit nebo upravit url adresy endpointů |
8 | 9 | - php 8.0+ |
9 | 10 |
|
10 | 11 | ### Třidy |
11 | 12 |
|
12 | 13 | - h4kuna\Ares\Ares |
13 | | - - metoda `loadBasic()` stále vrací [Data](./src/Ares/Core/Data.php) |
14 | | - - metoda `loadBasicMulti()` |
15 | | - - nově vrací Generator nikoliv pole |
16 | | - - vrací jen existující záznamy, třída Error byla smazána, nemá náhradu |
17 | | - - počet IČO není omezen, interně se rozdělí na dávky po 100, záznamech a ještě před tím se odeberou duplicity, při iteraci duplicity zůstanou, jen objekty budou mít stejné reference |
18 | | - - bylo zachováno pojmenování, vstupem je `['foo' => 123456]`, název `foo` bude jako klíč při iteraci |
| 14 | + - metoda `loadBasic()` stále vrací [Data](./src/Ares/Core/Data.php) |
| 15 | + - metoda `loadBasicMulti()` |
| 16 | + - nově vrací Generator nikoliv pole |
| 17 | + - vrací jen existující záznamy, třída Error byla smazána, nemá náhradu |
| 18 | + - počet IČO není omezen, interně se rozdělí na dávky po 100, záznamech a ještě před tím se odeberou duplicity, |
| 19 | + při iteraci duplicity zůstanou, jen objekty budou mít stejné reference |
| 20 | + - bylo zachováno pojmenování, vstupem je `['foo' => 123456]`, název `foo` bude jako klíč při iteraci |
19 | 21 |
|
20 | 22 |
|
21 | 23 | - h4kuna\Ares\Ares\Core\Data |
22 | | - - zmizela metoda `psu()` bez náhrady, podobné informace jsou ve vlastnosti `$sources` |
23 | | - - zmizela metoda `isGroupVat()`, skupinové DPH nelze zjistit. Co se týče správnosti DIČ, [chystá se náprava](https://github.com/h4kuna/ares/issues/30#issuecomment-1719170527) |
24 | | - - odstraněné vlastnosti `$court`, `$file_number`, `$court_all` jsou dostupné na jiném endpointu, `Sources::SERVICE_VR` |
25 | | - - ~~DIČ je nově bez prefixu `CZ`~~, vlastnost `$tin` z důvodu zpětné kompatibility, prefix nese, ~~nová vlastnost `$vat_id` prefix nemá~~, vlastnost jsem odebral, `CZ` opět přidali |
26 | | - - ~~vlastnost `$created` je podle mě momentálně rozbitá, pro [Alzu](https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/27082440) datumVzniku vrací `2023-09-04`, v registru ekonomických subjektů vrací [2003-08-26](https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty-res/27082440) (nahlášeno)~~ (opraveno) |
27 | | - - byl změněn namespace pro `h4kuna\Ares\Basic\Data`, ale [aliases.php](./src/aliases.php) zajistí zpětnou kompatibilitu a bude hlásit aby jste si třídu přejmnovali, nicméně stará třída bude fungovat |
28 | | - - už není možnost do metody `toArray()` předat vlastní pole pro úpravu mapování |
29 | | - - přidané vlastnosti `$country` a `$country_code` |
| 24 | + - zmizela metoda `psu()` bez náhrady, podobné informace jsou ve vlastnosti `$sources` |
| 25 | + - zmizela metoda `isGroupVat()`, skupinové DPH nelze zjistit. Co se týče správnosti |
| 26 | + DIČ, [chystá se náprava](https://github.com/h4kuna/ares/issues/30#issuecomment-1719170527) |
| 27 | + - odstraněné vlastnosti `$court`, `$file_number`, `$court_all` jsou dostupné na jiném |
| 28 | + endpointu, `Sources::SERVICE_VR` |
| 29 | + - ~~DIČ je nově bez prefixu `CZ`~~, vlastnost `$tin` z důvodu zpětné kompatibility, prefix nese, ~~nová |
| 30 | + vlastnost `$vat_id` prefix nemá~~, vlastnost jsem odebral, `CZ` opět přidali |
| 31 | + - ~~vlastnost `$created` je podle mě momentálně rozbitá, |
| 32 | + pro [Alzu](https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/27082440) datumVzniku |
| 33 | + vrací `2023-09-04`, v registru ekonomických subjektů |
| 34 | + vrací [2003-08-26](https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty-res/27082440) ( |
| 35 | + nahlášeno)~~ (opraveno) |
| 36 | + - byl změněn namespace pro `h4kuna\Ares\Basic\Data`, ale [aliases.php](./src/aliases.php) zajistí zpětnou |
| 37 | + kompatibilitu a bude hlásit aby jste si třídu přejmnovali, nicméně stará třída bude fungovat |
| 38 | + - už není možnost do metody `toArray()` předat vlastní pole pro úpravu mapování |
| 39 | + - přidané vlastnosti `$country` a `$country_code` |
30 | 40 |
|
31 | 41 | - h4kuna\Ares\Exceptions\ConnectionException |
32 | | - - nastavena jako deprecated, zpětně funkční |
33 | | - - nahrazena h4kuna\Ares\Exceptions\ServerResponseException |
| 42 | + - nastavena jako deprecated, zpětně funkční |
| 43 | + - nahrazena h4kuna\Ares\Exceptions\ServerResponseException |
34 | 44 |
|
35 | 45 | ### Závěrem |
36 | 46 |
|
37 | | -`Ares::loadBasic()` pokud si pohlídáte s jakými vlastnostmi pracujete a nebudou tam ty smazané, tak je to zpětně kompatibilní. Vstup je zpětně kompatibilní. |
| 47 | +`Ares::loadBasic()` pokud si pohlídáte s jakými vlastnostmi pracujete a nebudou tam ty smazané, tak je to zpětně |
| 48 | +kompatibilní. Vstup je zpětně kompatibilní. |
38 | 49 |
|
39 | | -`Ares::loadBasicMulti()` je potřeba vzít v potaz že to je zpětně nekompatibilní a nově se vrací Generator. Vstup je zpětně kompatibilní. |
| 50 | +`Ares::loadBasicMulti()` je potřeba vzít v potaz že to je zpětně nekompatibilní a nově se vrací Generator. Vstup je |
| 51 | +zpětně kompatibilní. |
40 | 52 |
|
41 | | -Přidal jsem ADIS, služba která ověří zda se jedná o plátce DPH, identifikovanou osobu nebo neplátce DPH. U plátce vrátí, zda se jedná o spolehlivého plátce DPH. Ukázka je v [bin/adis](./bin/adis). |
| 53 | +Přidal jsem ADIS, služba která ověří zda se jedná o plátce DPH, identifikovanou osobu nebo neplátce DPH. U plátce vrátí, |
| 54 | +zda se jedná o spolehlivého plátce DPH. Ukázka je v [bin/adis](./bin/adis). |
42 | 55 |
|
43 | 56 | ### Chování validace pomocí ADIS |
44 | 57 |
|
45 | | -| | ARES | ADIS (Data::$adis::$exists) | Data::$vat_payer | Data::$tin | Spolehlivý plátce DPH Data::$adis::$reliable | |
46 | | -|-------------------------------------|-----------|-----------------------------|------------------|------------|----------------------------------------------| |
47 | | -| Plátce DPH | vrací DIČ | Existuje (true) | true | vyplněno | true/false | |
48 | | -| Skupinové DPH / již není plátce DPH | vrátí DIČ | Neexistuje (false) | null * | null | null | |
49 | | -| Identifikovaná osoba | vrátí DIČ | Existuje (true) | false | vyplněno | null | |
50 | | -| neplátce | null | null | false | null | null | |
| 58 | +Třída [Data](./src/Ares/Core/Data.php) a třída vyplněná pomocí [ADIS](./src/Adis/StatusBusinessSubjects/Subject.php). |
51 | 59 |
|
52 | | -> * Nelze určit, zda se jedná o Skupinové DPH nebo společnost již není plátce DPH |
| 60 | +| | ARES | ADIS <br> Data::$adis::$exists | Data::$vat_payer | Data::$tin | Spolehlivý plátce DPH <br> Data::$adis::$reliable | |
| 61 | +|-------------------------------------|-----------|--------------------------------|------------------|------------|---------------------------------------------------| |
| 62 | +| Plátce DPH | vrací DIČ | true | true | vyplněno | true/false | |
| 63 | +| Skupinové DPH / již není plátce DPH | vrátí DIČ | false | null * | null | null | |
| 64 | +| Identifikovaná osoba | vrátí DIČ | true | false | vyplněno | null | |
| 65 | +| Neplátce | null | null | false | null | null | |
| 66 | + |
| 67 | +> \* Nelze určit, zda se jedná o Skupinové DPH nebo společnost již není plátce DPH |
53 | 68 |
|
54 | 69 | # v2.0.0 |
55 | 70 |
|
@@ -77,10 +92,10 @@ Přidal jsem ADIS, služba která ověří zda se jedná o plátce DPH, identifi |
77 | 92 |
|
78 | 93 | - interface IData was removed |
79 | 94 | - change data keys: |
80 | | - - person -> is_person |
81 | | - - add house_number |
82 | | - - add city_post |
83 | | - - add city_district |
| 95 | + - person -> is_person |
| 96 | + - add house_number |
| 97 | + - add city_post |
| 98 | + - add city_district |
84 | 99 | - all data keys are visible every time (court, file_number) |
85 | 100 | - class Data extends Messenger |
86 | 101 | - class Data suggest property |
|
0 commit comments