Jméno firmy, adresa i DIČ už jednou existují ve veřejném rejstříku ARES. Ukazujeme, jak si je nechat doplnit automaticky místo ručního opisování při každém novém kontaktu.
Skoro každá česká firma zadává novým klientům nebo dodavatelům aspoň jednou stejná tři pole ručně: název firmy, sídlo a DIČ. Přitom tahle data už existují - ve veřejném rejstříku ARES, spravovaném Ministerstvem financí. Stačí znát IČO a zbytek si systém dokáže dohledat sám, bez jediného ručního přepisu.
Co je ARES a co jeho API vrací
ARES (Administrativní registr ekonomických subjektů) je veřejný registr, který sdružuje základní údaje o firmách a podnikatelích vedené v Česku - název, sídlo, právní formu, DIČ a stav subjektu. Ministerstvo financí k němu nabízí volně dostupné REST API, na které se dá zeptat podle IČO bez nutnosti přihlášení nebo placeného klíče.
Prakticky to znamená: kdykoliv máte IČO, jedním HTTP dotazem dostanete zpátky oficiální název firmy, adresu sídla a DIČ, přesně tak, jak jsou vedené ve veřejném rejstříku.
Kde se to dá automatizovat
V nocode automatizacích typu Apexloop se tenhle dotaz skládá ze standardních, obecných stavebních bloků - žádný vlastní kód, jen tři kroky za sebou:
- Spouštěč - nový záznam s vyplněným IČO (třeba z formuláře nebo ručně přidaný kontakt).
- HTTP uzel - zavolá veřejné API ARES s IČO z předchozího kroku.
- Aktualizace záznamu - výsledek z odpovědi (název, adresa, DIČ) se zapíše zpátky do polí záznamu.
Záznam má zatím jen IČO
Trigger na nový záznam zavolá přes HTTP uzel veřejné API ARES a výsledek automaticky doplní zbytek údajů - bez jediného ručního přepisu.
Celý postup je stejný obecný vzor, který se používá i jinde - webhook nebo HTTP uzel zavolá externí službu a podmínka rozhodne, co se stane dál. U ARES lookupu se navíc hodí přidat krok navíc: pokud subjekt nebyl nalezen (třeba u chybně zadaného IČO), automatizace může místo tichého selhání rovnou upozornit toho, kdo záznam založil.
Co všechno jde takhle ušetřit
- Zadávání nového kontaktu nebo klienta - stačí IČO, zbytek adresy a fakturačních údajů doplní automatizace.
- Kontrola před vystavením faktury - ověření, že fakturační údaje v záznamu odpovídají aktuálnímu stavu v rejstříku.
- Hromadné doplnění starých záznamů - u databáze kontaktů bez adres lze nechat automatizaci projít všechny záznamy s IČO a chybějící pole doplnit najednou.
Žádná z těchto situací nevyžaduje speciální „ARES konektor" - stačí obecný HTTP uzel, který dnešní nocode automatizace obvykle nabízejí, a tři minuty na složení flow.
Na co si dát pozor
Veřejné API ARES nevyžaduje autentizaci, ale má rozumné limity na počet dotazů - pro běžné firemní použití (desítky až stovky nových záznamů denně) to bohatě stačí, pro hromadné dotazování tisíců záznamů najednou se vyplatí dotazy rozložit v čase. Data v rejstříku navíc odrážejí oficiální stav se zpožděním po zápisu do rejstříku, takže u čerstvě založených firem se občas stane, že záznam ještě není dohledatelný - proto se vyplatí mít v automatizaci ošetřenou i variantu „subjekt nenalezen".
Celý tok od došlé poptávky přes doplnění firmy z ARESu až po zakázku čekající na schválení popisuje článek AI si přečte e-mail a založí zakázku.
Časté otázky k automatizaci s ARES
Potřebuji k volání ARES API nějaký klíč nebo registraci?
Ne. Veřejné REST API ARES je dostupné bez přihlášení a bez API klíče - stačí znát IČO subjektu, na který se ptáte.
Jde takhle doplnit i DIČ, ne jen adresu?
Ano, odpověď z ARES obsahuje i DIČ, pokud je subjekt plátcem DPH a je v rejstříku evidované. Automatizace ho může zapsat do stejného kroku jako název a adresu.
Co se stane, když automatizace zadá neplatné nebo neexistující IČO?
Dobře postavené flow by mělo tenhle případ ošetřit podmínkou - pokud ARES nevrátí žádný subjekt, automatizace může místo tichého selhání upozornit člověka, který záznam založil, ať IČO zkontroluje ručně.