Popis datového rozhraní k iFIS*Organizace
Pro čtení aktuálně evidovaných údajů o firmách, podnikajících fyzických osobách nebo jiných právních subjektech z číselníku iFIS/Organizace se obvykle využívá databázové view (pohled). Pohled je nejčastěji umístěný v datovém schématu VYMENIK na rozhraní databáze iFIS. Datová struktura dat v tomto pohledu je naznačena v připojeném souboru Popis struktury vymenik.W_ORGANIZACE v31052021.xls.
Data z iFIS/Organizace lze získávat teké prostřednictvím REST API ORGANIZACE. K tomuto REST rozhraní přistupuje volající systém vždy s argumentem DIČ (daňové identifikační číslo daňového subjektu). Informace lze žádat také s argumentem IČO (identifikační číslo subjektu), případně s oběma argumenty DIČ i IČO. API ve své odpovědi vrací výpis veškerých informací, které jsou o daném subjektu v iFIS/Organizace evidované.
Příklad volání služby https://xxxx.bbm.cz:7102/org/sbj?extsys=test&dic=CZ40755592
Náhled na strukturu dat získanou přes toto REST API najdete v souboru REST ORGANIZACE - JSON výpis k DIC CZ40755592.png.
Pokud se volající systém přes API dotazuje na subjekt (DIČ / IČO), který dosud není v iFIS/Organizace evidovaný, na pozadí se automaticky volá služba pro vyhledání a stažení údajů o DIČ / IČO z oficiálních registrů ARES / VIES. Takto získaná data se registrují. V návaznosti na to se volajícímu systému z REST API vrací výpis aktuálně evidovaných dat v iFIS/Organizace.
Podrobná dokumentace k REST API ORGANIZACE:
ORG BBM-s.r.o8-iFis-Organizace-2.0.2-swagger.yaml
ORG BBM-s.r.o8-iFis-Organizace-2.0.2-swagger.json
ORG dynamic-html-documentation (1).zip