Změny v REST API ve verzi 10.12

Právě dokončujeme vydání nové verze, která udělala velký posun oproti předchozí verzi. Jednou z oblastí, která doznala velkých změn je i programátorské rozhraní REST API a XML importy. Zde se pokusíme je shrnout.

Všechny změny by neměly měnit v negativním smyslu, pokud na něco narazíte, ozvěte se.

Mezi hlavní novinky lze uvést toto:

Výkonnostní úpravy:

• zvýšení výkonu při importu velkých dat – nyní je prováděno výrazně méně dotazů.
• bylo přidáno dávkové zpracování XML. Pokud nahrajete velké množství dat, je XML soubor zpracováván postupně a postupně ukládán do databáze. Současně nedochází k načtení celého XML do paměti, ale k jeho postupnému zpracování. Teoreticky by tedy systém měl být schopen zpracovat nekonečně velké XML.
• v případě, že máte více firem, nedojde k vícenásobnému startování účetního jádra. To je nyní sdíleno mezi firmami. Díky tomu lze otevřít současně výrazně více firem.
• při XML importu a WinStrom Sync byl přidán progress bar, který ukazuje aktuální stav importu. U REST API něco takového z technických důvodů nejde.

Rozsah importovaných dat:

• nyní lze importovat téměř všechny evidence – např. účty, uživatele, sklady, přílohy, uložené filtry, rezervace, …
• nyní lze přes REST API odečíst zálohový doklad nebo zálohový daňový doklad, lze vystavit daňový doklad na základě úhrady.
• lze přes REST API párovat platby (tj. platba XY uhrazuje fakturu YZ). Používáme také při migracích.
• lze imortovat výrobní čísla jako součást příjemky nebo přijaté faktury

• byla přidán atribut if-not-found="null" – pokud není nalezena druhá strana relace, není záznam uložen: http://www.winstrom.eu/pro-vyvojare/rest-api/devdoc/create-update-mode
• lze uvádět více identifikátorů záznamů současně. Např. [ext:SHOP:123][ean:123]. Můžete se tak snadno odkazovat. Pokud není některý identifikátor nalezen, nic se neděje, použije se jiný. Pokud každý záznam odkazuje jinam, je to považováno za chybu: http://www.winstrom.eu/pro-vyvojare/rest-api/devdoc/identifiers
• kvůli pracím na webovém rozhraní byla přidána podpora pro události změny. Lze tak reagovat na změny atributů podobně jako v aplikaci: http://www.winstrom.eu/pro-vyvojare/rest-api/devdoc/previous-value Má smysl pouze pokud pracujete se systémem jako s GUI.
• byla přidána možnost pro přeskočení záznamu při importu, pokud již existuje. Lze tak v rámci jednoho importu importovat např. firmu (a pokud existuje tak ji nepřepisovat) a současně i fakturu. Tento nástroj intenzivně používáme při importech z jiných systémů. http://www.winstrom.eu/pro-vyvojare/rest-api/devdoc/create-update-mode
• nyní lze exportovat a importovat data i ve formátech CSV a DBF a také EDI.
• na výstup XML lze aplikovat XSL transformace. Zatím tedy jen transformace, které jsou zakompilované do systému. Tato transformace může být jak pro import tak i pro export. Díky tomu, mohou z FlexiBee padat i různé jiné XML dokumenty. Rádi bychom tak zajistili, aby FlexiBee umělo pracovat se soubory mezinárodních standardů či konkurenčních systémů. Pokud budete chtít připravovat XSL transformace, použijte nástroj flexibee2xml. XSL transformace lze použít i na CSV a DBF soubory a lze tedy podporovat i cizí struktury v těchto formátech.
• vytvořili jsem soubor s XML Schématem exportovaných dat a také importovaných dat. Jedná se vždy o aktuální kopii, která se řídí licencí, přístupovými právy a type založené firmy. Importovaná data by měla být podmnožina exportovaných. http://www.winstrom.eu/pro-vyvojare/rest-api/devdoc/xsd

Úpravami v této verzi se dostáváme do oblastí komunikace, které nejen že jsou u ostatních ekonomických systémů složitě realizovatelné, ale i nemožné.

Rád bych citoval Štěpána Mrázka z firmy OxyOnline „Vygenerovat fakturu v PDF včetně elektronického podpisu umí v ČR jen dva systémy. FlexiBee je jedním z nich.“.