Všechny sbírky
Dokumentace a nápověda
Tipy a triky
Import dat do Flexi přes Open source aplikaci
Import dat do Flexi přes Open source aplikaci

Jak importovat data do Flexi přes Open source

Lenka Haringerová avatar
Autor: Lenka Haringerová
Aktualizováno před více než týdnem

Zatímco podnikatelé si systém ABRA Flexi chválí pro cloudovou dostupnost a jednoduchost, mezi ajťáky je ceněn především pro své rozhraní REST API. Přes velmi dobře zdokumentované API se do účetního systému otevírají vrátka pro aplikace třetích stran a komunikaci s dalšími datovými zdroji.

Vítězslav Dvořák z Vitex Software nám představil vlastní PHP knihovnu FlexiPeeHP, kterou vytvořil pro společnost Spoje.net. Knihovnu napsal jako zakázkovou aplikaci pro převod dat ze staršího účetního systému do ABRA Flexi. A jako fanda Linuxu a Open source aplikaci zveřejnil, po dohodě s investorem, pod licencí GNU na Githubu.

Dvořák FlexiPeeHP sám popisuje jako „PHP knihovnu pro snadnou práci s českým ekonomickým systémem Flexi. Knihovnu stále aktivně vyvíjí, a je tak k dispozici pro všechny, kteří hledají nástroj pro přenos dat do Flexi.

Vznik knihovny

Firma Spoje.net poskytuje na Praze 6 internetové připojení a další hostingové služby. Množství klientů do podnikání přineslo velké objemy účetních dat, a ty si zase vyžádaly změny na poli účetního programu. Obnova SW vybavení byla nevyhnutelná, a proto Spoje oslovily nezávislého konzultanta a vývojáře Vítězslava Dvořáka s požadavkem na řešení převodu dat do moderního účetního systému. „Když chce zákazník účetní systém, nerozmýšlím se a doporučím ABRA Flexi,“ říká V. Dvořák. „Důvodem je především otevřené rozhraní REST API.“ Spoje využily doporučení a domluvily se na vytvoření datového můstku pro převod dat ze staršího účetního systému do ABRA Flexi.

Spoje.net a FlexiPeeHP

  • 24000 faktur převedeno během 6 hodin.

  • Převedeno přes 4000 skladových záznamů.

  • net umožnily knihovnu zveřejnit jako OpenSource.

Použití knihovny

FlexiPeeHP má univerzální využití. Je to nástroj, který poskytuje objekty připravené pracovat s agendami účetního systému. Snadno se instaluje na Debianu, Ubuntu a odvozených operačních systémech. Pro ostatní systémy je k dispozici jako PHP Knihovna pro Composer nebo jako kontejner pro Docker.

Pro základní použití stačí jen 2-3 řádky kódu – programátor nemusí v knihovně nic víc měnit a volá jen příslušné funkce knihovny.

FlexiPeeHP je pro vývojáře k dispozici včetně jednoduchého příkladu jak nastavit připojení a vyžádat si ze serveru data. Ústřední komponentou celé knihovny je Třída FlexiRO, která je schopna pomocí PHP rozšíření curl komunikovat s REST Api Flexi. Z ní jsou pak odvozeny třídy pro jednotlivé evidence, obsahující metody pro často používané operace, například „Spáruj“ v případě vydaných faktur.

Aktuálnost knihovny zaručena přímo od V. Dvořáka

Knihovna FlexiPeeHP obsahuje i stále se rozrůstající sadu UnitTestů. S každou verzí ABRA Flexi vychází nová verze knihovny – je tak zajištěna maximální kompatibilita s účetním systémem. Každá nová verze je strojově testována a kontrolována několika nástroji pro zlepšování kvality kódu.

Vývojový Nástroj Flexplorer

Od stejného autora s využitím knihovny FlexiPeeHP je k dispozici také specializovaný OpenSource Vývojářský nástroj Flexplorer který umožňuje:

  • zobrazovat informace o Flexi a jeho Licenci,

  • pracovat s formáty JSON, XML a CSV,

  • zobrazovat obsah všech dostupných evidencí ve všech firmách,

  • zobrazovat strukturu evidence,

  • odesílat přímé požadavky na server a zobrazovat výsledky,

  • nastavovat ChangesAPI a přidávat WebHooks,

  • testovat odpovědi WebHook skriptu zpracovávajícího změny z Flexi,

  • hromadně zakládat a rušit účetní období,

  • rozlišovat evidence, které jsou z důvodu licence nedostupné,

  • zobrazovat vedle json výsledku požadavku i stránku z Flexi,

  • upravovat Externí ID záznamů.

Jak se nezávislému vývojáři spolupracuje s ABRA Flexi

„Oceňuji Flexi jako produkt, ale také jako firmu, která mě, nezávislého programátora, vždy podpořila. Z mého pohledu je Flexi výjimečné tím, že jde provozovat pod Linuxem, svými možnostmi REST API a integrace obecně a suprovým dotazovacím jazykem. Musel jsem pochopit názvosloví systému, a pak již nebyly větší problémy,“ popisuje Vítězslav Dvořák. „Oceňuji také myšlenku a systém externích ID, kterých jde, z externích systémů, uložit více. No a podpora ze strany vývoje Flexi je vstřícná – mají svatou trpělivost s mými ne vždy bystrými otázkami a bugreporty.“

Vítězslav Dvořák z Vitex Software při prezentaci FlexiPeeHP.

Dostali jste odpověď na svou otázku?