Integrácia do aplikácie

Kontrolný zoznam na použitie registra vo fakturačnej alebo účtovnej aplikácii.

Nechajte svojho AI agenta integrovať vyhľadávanie a overenie firiem do aplikácie podľa týchto pravidiel.

Postup, ktorý funguje pre aplikáciu, akou je napríklad fakturačný nástroj:

Vyhľadávanie navrhuje

Výsledky /v1/search ukazujte počas písania, s oneskorením. Zobrazte názov, IČO a úplnú adresu: dva subjekty môžu mať rovnaký názov.

Rozhoduje len presný identifikátor

Keď používateľ vyberie výsledok, zavolajte /v1/lookup/{ico} a použite túto odpoveď. Nikdy sami nevypĺňajte formulár z prvého výsledku vyhľadávania.

Uchovávajte verzie

Ku kópii obchodného partnera si uložte source.version každej časti.

Kontrolujte denne

Raz denne zavolajte /v1/lookup:batch s fields: "versions" a ukážte používateľovi, čo sa zmenilo. Pozrite Sledovanie zmien.

Pravidlá, ktoré udržia doklady správne

Neznáme nie je „nenájdené“. 503, unknown a stale berte ako „neznáme“. Výpadok registra nesmie zablokovať vystavenie dokladu; nechajte používateľa pokračovať s údajmi, ktoré potvrdí.
Znenie o DPH. „Platiteľ DPH od …“ uvádzajte iba vtedy, keď je vat.payer true. Subjekty podľa §7 a §7a majú IČ DPH, ale nie sú platiteľmi DPH. Pozrite Stav DPH.
Zápis v registri sa predvyplní, používateľ ho potvrdí. identity.registrations[] uvádza súd a číslo pre právny údaj dodávateľa. Genitív názvu súdu a presné znenie si zostavíte sami.
Uvádzajte dátum. „Podľa zoznamu Finančnej správy k 10. 11. 2026“ je presné; „je platiteľ DPH“ bez dátumu nie.
IČ DPH iných štátov EÚ. Pýtajte sa priamo VIES: register ho nezrkadlí.
Uvedenie zdroja. Ak dáta ukazujete iným, ukážte aj texty attribution, ktoré vyžadujú licencie.

Bezpečné požiadavky GET po chybe spojenia zopakujte s rastúcim odstupom.
Pri 429 rešpektujte Retry-After.
Pri štarte si prečítajte /v1/capabilities: či je približné vyhľadávanie zapnuté a aké sú limity.