REST API ABRA Flexi umožňuje exportovať aj importovať dáta v celom rade formátov. V tomto diele si prejdeme, ako sa formát určuje a ktorý sa hodí na aký účel.
Ako sa formát určuje
Formát môžete zvoliť dvoma spôsobmi: príponou v adrese, alebo hlavičkou HTTP požiadavky. Ktoré z nich má prednosť, závisí od smeru prenosu.
Pre výstup má prípona adresy (
.xml,.json, …) prednosť pred hlavičkouAccept. Ak príponu neuvedieťe, server sa riadi hlavičkou.Pre vstup sa formát určuje primárne podľa hlavičky
Content-Type.
⚠️ Príponu adresy a formát odosielaných dát vždy uvádzajte zhodne. Odoslanie XML na adresu končiacu na .json skončí chybou.
Prehľad podporovaných formátov
Formát | Na čo slúži | Prípona | Content-Type | Import |
XML | Strojovo čitateľná štruktúra, najčastejší formát pre integrácie |
|
| áno |
JSON | Strojovo čitateľná štruktúra, vhodná pre webové aplikácie a skripty |
|
| áno |
CSV | Tabuľkový výstup na ďalšie spracovanie |
|
| áno |
XLS | Tabuľkový výstup pre Excel |
|
| áno, od varianty Business |
DBF | Databázový výstup vo formáte dBase |
|
| áno |
ISDOC | Český štandard elektronickej fakturácie |
|
| áno |
EDI | Elektronická výmena dát vo formáte INHOUSE |
|
| áno |
Tlačová zostava, rovnaká ako v aplikácii |
|
| nie | |
HTML | Zobrazenie dát priamo v prehliadači |
|
| nie |
vCard | Export adresára do elektronickej vizitky |
|
| nie |
iCalendar | Export udalostí alebo splatností faktúr do kalendára |
|
| nie |
⚠️ Import vo formáte XLS je dostupný od varianty licencie Business. Pri variante Basic tento formát pre import nemožno použiť.
Import faktúr vo formáte ISDOC
ISDOC je pre zákazníkov najčastejšie využívaný formát mimo XML a JSON, pretože ide o český štandard elektronickej fakturácie. Pri importe je potrebné doplniť dva parametre:
typDoklje typ faktúry a je povinnýtypUcOpje predpis zaúčtovania a je nepovinný
Oba parametre sa zapisujú ako identifikátory záznamov, teda najčastejšie v tvare code:.
POST /c/firma/faktura-prijata.isdoc?typDokl=code:FAKTURA&typUcOp=code:NÁKUP SLUŽBY
Kódovanie a oddeľovač pri textových formátoch
Pri formátoch CSV a DBF môžete ovplyvniť kódovanie a oddeľovač stĺpcov pomocou parametrov v adrese. Hodí sa to vtedy, keď súbor spracúva starší systém, ktorý nepodporuje UTF-8.
?encoding=iso-8859-2nastaví kódovanie súboru?delimeter=;nastaví oddeľovač stĺpcov
💡 Kompletný prehľad formátov vrátane ďalších podporovaných variantov nájdete v článku o podporovaných formátoch. Pre tlač do PDF sa pozrite na export tlačových zostáv.
Ďalšie diely série
Podporované formáty (tento článok)