Preskoči na glavno vsebino

Export tlačových zostáv (PDF / XLSX)

Ako exportovať tlačovú zostavu do PDF / XLS v REST API?

Avtor: Lenka Haringerová

Tlačové zostavy dostupné v aplikácii je možné získať aj cez REST API, a to obvykle jak pre konkrétny záznam, tak pre celý zoznam.

Zostavenie URL adresy

PDF

/c/<identifikátor firmy>/<evidence>.pdf
/c/<identifikátor firmy>/<evidence>/<ID záznamu>.pdf

XLS / XLSX

/c/<identifikátor firmy>/<evidence>.xlsx
/c/<identifikátor firmy>/<evidence>/<ID záznamu>.xlsx

Prípona .xlsx vracia formát Office Open XML, prípona .xls starší formát Excelu. Obe sú pre tlačové zostavy podporované.

Konkrétnu zostavu je možné vybrať použitím parametra report-name. Ak je to potrebné, je možné vybrať aj jazyk zostavy; na to slúži parameter report-lang. Podporované jazyky sú cs, sk, en a de.

Je možné vygenerovať aj elektronicky podpísané PDF. Táto funkcia má niekoľko obmedzení: funguje iba s certifikátmi uloženými v ABRA Flexi, a uložený môže byť práve jeden certifikát. Je potrebné v URL uviesť parameter report-sign=true. V budúcnosti bude možné vybrať z uložených certifikátov, ktorý sa má použiť.


Príklad URL adresy

PDF

/c/firma/faktura-vydana/1.pdf?report-name=dodaciList
/c/firma/faktura-vydana/1.pdf?report-name=dodaciList&report-lang=en
/c/firma/faktura-vydana/1.pdf?report-name=dodaciList&report-sign=true

XLS / XLSX

/c/firma/faktura-vydana/1.xlsx?report-name=dodaciList
/c/firma/faktura-vydana/1.xlsx?report-name=dodaciList&report-lang=en
/c/firma/faktura-vydana/1.xls?report-name=dodaciList

ℹ️ Parameter report-sign má význam iba pri výstupe do PDF. Pri tabuľkových výstupoch sa ignoruje.

Prehľad podporovaných reportov pre danú evidenciu nájdete na /c/<identifikátor firmy>/<evidence>/reports (napr. pre faktúru). Výstup je opäť možné exportovať vo formátoch XML či JSON.

Výstup obsahuje tieto informácie:

  • reportId: identifikátor reportu. Uvádza sa ako parameter report-name pri volaní

  • reportName: užívateľský názov. Je zobrazený v aktuálnom jazyku (podľa prehliadača/agenta).

  • isDefault: je zostava predvolená? Tj. vyberá sa pri stlačení rýchleho tlačidla.

  • predvybranyPocet: niektoré zostavy sú prehľadové, niektoré tlačia konkrétny záznam. Nadobúda hodnoty 1 a N.

  • rozsiritelna: existuje k tlačovej zostave jej rozšírená verzia?

  • sumovana: podporuje tlačová zostava sumáciu?


Formát ISDOC PDF

  • ABRA Flexi podporuje elektronické faktúry vo formáte ISDOC.PDF (dokument ISDOC vložený do PDF súboru):

    • Všetky PDF výstupy faktúr, ktoré nie sú typu zoznam, obsahujú implicitne vložený ISDOC

    • Súbor PDF s vloženým ISDOC je možné použiť na import faktúr z ISDOC

Ste s tem dobili odgovor na svoje vprašanje?