V mnoha webových aplikacích, jako jsou e-shopy, fakturační systémy nebo registrační formuláře, je užitečné umožnit uživatelům předvyplnit firemní údaje na základě IČO (Identifikační číslo osoby) nebo DIČ (Daňové identifikační číslo). V České republice lze tyto údaje získat z veřejného registru ARES (Administrativní registr ekonomických subjektů), který spravuje Ministerstvo financí.

Tento článek vysvětluje, jak data z ARES načíst a použít je pro předvyplnění formulářů. Ukážeme si příklad v JavaScriptu.

Co je ARES?

ARES je veřejný registr, který obsahuje informace o firmách, podnikatelích a dalších subjektech v ČR. Mezi dostupné údaje patří:

• Název firmy
• Adresa (ulice, město, PSČ)
• Právní forma
• Datum vzniku
• A další

Jak načíst data z ARES

Kromě jiných možností existuje Swagger dokumentace:

ARES poskytuje několik endpointů. Nejběžnější je vyhledávání podle IČO pomocí URL:

https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/XXX

Kde XXX je IČO. Odpověď je v JSON formátu.

Živá ukázka

Zadejte platné IČO (například 27604977 pro Google Czech Republic) a klikněte na tlačítko:

Předvyplnění formuláře

Po získání dat je jednoduše vložte do příslušných polí formuláře. Doporučuji:

• Přidat tlačítko „Načíst data z ARES“ vedle pole pro IČO.
• Ověřit formální platnost IČO (např. 8 čísel a zkontrolovat kontrolní číslici), aby se nemusela stahovat vzdálená data u evidentně špatně vyplněného pole.
• Umožnit uživateli data upravit, protože ARES nemusí být vždy aktuální.
• Neposílat požadavky na ARES příliš často, abyste se vyhnuli blokování.

DIČ

Získat data na základě DIČ by mohlo být uživatelsky přívětivější, protože řada podnikatelů si ho na rozdíl od IČO pamatuje, jelikož je to jejich rodné číslo.

Nicméně našel jsem jen tyto zdroje pro získávání dat na základě DIČ, které ale nenabízejí tak jednoduché API:

• Registr plátců DPH – Ověření platnosti DIČ v ČR.
• EU VAT Validation – Ověření DIČ v rámci EU.

Závěr

Použití ARES API výrazně zlepšuje uživatelskou zkušenost tím, že minimalisuje ruční zadávání dat. Implementace je jednoduchá a lze ji integrovat do jakéhokoli webového projektu.

Pokud máte zkušenosti s ARES nebo tipy na lepší implementaci, nebo jak jednoduše získat data pro DIČ, dejte mi prosím vědět v komentářích.