Popis datového rozhraní k iFIS Závazky: Porovnání verzí
Bez shrnutí editace |
Bez shrnutí editace |
||
| Řádek 1: | Řádek 1: | ||
__TOC__ | __TOC__ | ||
Rozhraní je využíváno okolními aplikacemi pro zápis závazkových prvotních dokladů do evidencí iFIS | Rozhraní je využíváno okolními aplikacemi pro zápis závazkových prvotních dokladů do evidencí iFIS/Finance. Přes datová rozhraní mohou být do iFIS zapisovány: | ||
*požadavky dodavatelů, zaměstnanců nebo jiných subjektů na vyplacení zálohy | *požadavky dodavatelů, zaměstnanců nebo jiných subjektů na vyplacení zálohy | ||
*dodavatelské faktury | *dodavatelské faktury | ||
| Řádek 7: | Řádek 7: | ||
*výplatní listiny (mzdové výplatní listiny, seznamy stipendií k výplatě, apod.) | *výplatní listiny (mzdové výplatní listiny, seznamy stipendií k výplatě, apod.) | ||
Samotný zápis dat je možné provádět buď prostřednictvím REST API služby, nebo pomocí konektorů (funkcí) na úrovni databáze Oracle iFIS. Návratovou hodnotou volání datového rozhraní je vždy jednoznačné číslo vytvořeného záznamu v iFIS | Samotný zápis dat je možné provádět buď prostřednictvím REST API služby, nebo pomocí konektorů (funkcí) na úrovni databáze Oracle iFIS. Návratovou hodnotou volání datového rozhraní je vždy jednoznačné číslo vytvořeného záznamu v iFIS/Finance. Přes tento identifikátor může externí systém zjišťovat podrobnosti o stavu zpracování jednotlivých dokladů. | ||
{{Poznamka|Příjem a zpracování dodavatelských faktur v ISDOC formátu je zajišťováno na rozhraní iFIS | {{Poznamka|Příjem a zpracování dodavatelských faktur v ISDOC formátu je zajišťováno na rozhraní iFIS/Spisová služba/e-Podatelna. ISDOC faktury jsou následně předávány ke zpracování do iFIS/Finance.}} | ||
===Předání dat přes webovou službu iFIS=== | ===Předání dat přes webovou službu iFIS=== | ||
| Řádek 40: | Řádek 40: | ||
*Konektor kontroluje všechna databázová integritní omezení | *Konektor kontroluje všechna databázová integritní omezení | ||
*Jakákoliv chyba při zpracování transakce způsobí automatické odvolání všech změn, které funkce provedla | *Jakákoliv chyba při zpracování transakce způsobí automatické odvolání všech změn, které funkce provedla | ||
*Konektor automaticky vrací po provedení transakce tzv. výstupní argumenty. Tyto výstupní argumenty informují externí aplikaci o stavu provedené transakce (informace o správně provedené transakci, informace o jednoznačných identifikátorech nově založených záznamů v iFIS, informace o chybných vstupních argumentech, o porušených integritních omezení, či o porušení pravidel pro uložení dat do iFIS | *Konektor automaticky vrací po provedení transakce tzv. výstupní argumenty. Tyto výstupní argumenty informují externí aplikaci o stavu provedené transakce (informace o správně provedené transakci, informace o jednoznačných identifikátorech nově založených záznamů v iFIS, informace o chybných vstupních argumentech, o porušených integritních omezení, či o porušení pravidel pro uložení dat do iFIS/Finance) | ||
*Další pravidla jsou součástí popisu příslušných funkcí (viz dále) | *Další pravidla jsou součástí popisu příslušných funkcí (viz dále) | ||
Konektorům se postupně předají data hlavičky i řádků závazku, připojí se dokumenty do přílohy a na závěr se zavolá konektor pro uzavření dokladu. Návratovou hodnotou tohoto volání je číslo závazku, který byl uložený v iFIS | Konektorům se postupně předají data hlavičky i řádků závazku, připojí se dokumenty do přílohy a na závěr se zavolá konektor pro uzavření dokladu. Návratovou hodnotou tohoto volání je číslo závazku, který byl uložený v iFIS/Finance/Závazky/Zásobník podkladů. Popis jednotlivých argumentů volání konektorů i postup jejich volání je naznačený v připojeném souboru [[Media:Priklad zapisu konecneho vyuctovani pres rozhrani IMP_DOFA.sql|Priklad zapisu konecneho vyuctovani pres rozhrani IMP_DOFA.sql]]. | ||
Verze z 7. 1. 2022, 12:09
Rozhraní je využíváno okolními aplikacemi pro zápis závazkových prvotních dokladů do evidencí iFIS/Finance. Přes datová rozhraní mohou být do iFIS zapisovány:
- požadavky dodavatelů, zaměstnanců nebo jiných subjektů na vyplacení zálohy
- dodavatelské faktury
- drobná vydání (paragony)
- konečná vyúčtování (např. vyúčtování služebních cest)
- výplatní listiny (mzdové výplatní listiny, seznamy stipendií k výplatě, apod.)
Samotný zápis dat je možné provádět buď prostřednictvím REST API služby, nebo pomocí konektorů (funkcí) na úrovni databáze Oracle iFIS. Návratovou hodnotou volání datového rozhraní je vždy jednoznačné číslo vytvořeného záznamu v iFIS/Finance. Přes tento identifikátor může externí systém zjišťovat podrobnosti o stavu zpracování jednotlivých dokladů.
|
Poznámka |
| Příjem a zpracování dodavatelských faktur v ISDOC formátu je zajišťováno na rozhraní iFIS/Spisová služba/e-Podatelna. ISDOC faktury jsou následně předávány ke zpracování do iFIS/Finance. |
Předání dat přes webovou službu iFIS
REST služba ZAVAZKY je obvykle provozována na aplikačním serveru iFIS (Oracle iAS), data se na jejím rozhraní předávají v podobě JSON souboru.
Technický popis služby i popis struktury je k dispozici pod odkazy:
BBM-s.r.o8-i-fis_zavazky_rest_api-12.20.1-swagger.json
BBM-s.r.o8-i-fis_zavazky_rest_api-12.20.1-swagger.yaml
dynamic-html-documentation-generated.zip
html2-documentation-generated.zip
html-documentation-generated.zip
Příklad předávaného datového souboru s předpisy dvou závazků v EUR, které mají být vyplaceny zaměstnancům, je v souboru zavazky_vyuctovani_EUR_v1.json
Předání dat přes databázové konektory iFIS
Externí aplikace přistupuje do databáze iFIS obvykle přes privátní db-link a předává data prostřednistvím databázových funkcí (konektorů), které jsou k dispozici v rámci rozhraní IMP_DOFA.
- Externí aplikace ovlivňuje chování jednotlivých konektorů zadáním tzv. vstupních argumentů
- Vstupní argumenty konektorů, které mají definovány default hodnoty, jsou nepovinné
- Argumenty, u nichž jsou uvedeny možné hodnoty, nebo odkazy na domény, nebo odkazy na jiné číselníky jsou na tyto hodnoty kontrolovány.
- Konektor kontroluje všechna databázová integritní omezení
- Jakákoliv chyba při zpracování transakce způsobí automatické odvolání všech změn, které funkce provedla
- Konektor automaticky vrací po provedení transakce tzv. výstupní argumenty. Tyto výstupní argumenty informují externí aplikaci o stavu provedené transakce (informace o správně provedené transakci, informace o jednoznačných identifikátorech nově založených záznamů v iFIS, informace o chybných vstupních argumentech, o porušených integritních omezení, či o porušení pravidel pro uložení dat do iFIS/Finance)
- Další pravidla jsou součástí popisu příslušných funkcí (viz dále)
Konektorům se postupně předají data hlavičky i řádků závazku, připojí se dokumenty do přílohy a na závěr se zavolá konektor pro uzavření dokladu. Návratovou hodnotou tohoto volání je číslo závazku, který byl uložený v iFIS/Finance/Závazky/Zásobník podkladů. Popis jednotlivých argumentů volání konektorů i postup jejich volání je naznačený v připojeném souboru Priklad zapisu konecneho vyuctovani pres rozhrani IMP_DOFA.sql.
Podrobnější popis jednotlivých konektorů (funkcí) a jejich argumentů v rámci rozhraní IMP_ODFA je uvedený v souboru Konektory na rozhraní IMP_DOFA.docx.
