V článku PHP načítanie dát z Flexi sme si ukázali, ako načítať dáta z ABRA Flexi. Základom úspechu pri načítavaní dát je správne zostavené URL.
URL pre získanie dát z ABRA Flexi sa skladá z adresy servera, portu a identifikátora firmy.
https://server:port/c/identifikátor_firmy např. https://demo.flexibee.eu:5434/c/demo
Ďalej sa za identifikátor firmy dopĺňa evidencia, z ktorej budete chcieť dáta načítavať, formát, v ktorom ich ABRA Flexi poskytne, a prípadné ďalšie parametre.
server:port/c/identifikátor_firmy/evidence.xml?detail=full např. demo.flexibee.eu:5434/c/demo/adresar.xml?detail=full
Zoznam dostupných evidencií je dostupný na adrese:
server:port/c/identifikátor_firmy/evidence-list např. demo.flexibee.eu:5434/c/demo/evidence-list
Výstupné formáty
Flexi podporuje niekoľko výstupných formátov.
1. XML
Najčastejší formát, ak potrebujem vidieť štruktúrované dáta.
Náročný na dátové prenosy.
Dáta v tomto formáte získate tak, že za evidenciu doplníte .xml.
demo.flexibee.eu/c/demo/adresar.xml
2. JSON
Najčastejšie používaný formát všetkých napojení na ABRA Flexi.
Ľudským okom nečitateľný, ale dátovo menej náročný ako XML.
Stačí za evidenciu doplniť .json.
demo.flexibee.eu/c/demo/adresar.json
3. CSV
Ak je potrebné získať dáta na spracovanie v niektorej zo starších aplikácií, je možné z ABRA Flexi získať dáta vo formáte CSV.
Keď za evidenciu doplníte .csv, dáta budú uložené v tomto formáte.
Pozor však. CSV na rozdiel od XML a JSON nedokáže vypísať vnorené kolekcie (napríklad položky faktúr spoločne s faktúrou).
Pri tomto formáte je tiež možné parametrom encoding vynútiť kódovanie výstupného súboru.
demo.flexibee.eu/c/demo/adresar.csv demo.flexibee.eu/c/demo/adresar.csv?encoding=iso-8859-2
4. XLS a XLSX
Aj Excel je podporovaným výstupným formátom. Má však rovnaké obmedzenia ako CSV.
demo.flexibee.eu/c/demo/adresar.xls demo.flexibee.eu/c/demo/adresar.xslx
5. PDF
Z Flexi je možné cez API získať aj tlačové zostavy vo formáte PDF.
Pri tomto výstupnom formáte je možné parametrom ovplyvniť, ktorú tlačovú zostavu má ABRA Flexi vrátiť, v akom jazyku ju má vrátiť a či ju má podpísať.
Na výber tlačovej zostavy sa používa parameter report-name a na výber jazyka sa používa parameter report-lang.
Podpis PDF sa vynucuje pomocou parametra report-sign.
demo.flexibee.eu/c/demo/adresar.pdf demo.flexibee.eu/c/demo/adresar.pdf?report-name=obalkaDL demo.flexibee.eu/c/demo/adresar.pdf?report-lang=en
6. ISDOC
Formát isdoc je použiteľný len pri vydaných faktúrach.
Ak za evidenciu doplníte .isdoc, získate z ABRA Flexi ISDOC s faktúrou.
http://demo.flexibee.eu/c/demo/faktura-vydana.isdoc
7. DBF, vCard, iCalendar a EDI
Zostávajúce formáty sú už menej použiteľné a len na niektorých evidenciách.
vCard a iCalendar nemajú na niektorých evidenciách zmysel, pretože tieto evidencie neobsahujú dáta, ktoré by sa exportovali.
Formát DBF je dnes už nahradený inými formátmi.
Napriek tomu je možné z ABRA Flexi cez REST-API získať dáta v týchto formátoch.
Jediný formát, ktorý má zmysluplné využitie napríklad kvôli obchodným reťazcom, je EDI. Tento formát však podporujú len niektoré evidencie (vydané faktúry, výdajky a vydané objednávky). Importovať dáta vo formáte EDI je možné len pri prijatých objednávkach.
http://demo.flexibee.eu/c/demo/adresar.dbf demo.flexibee.eu/c/demo/adresar.vcf demo.flexibee.eu/c/demo/udalost.ical demo.flexibee.eu/c/demo/faktura-vydana/836.edi
Zdroj:
ABRA Flexi API Dokumentácia