Přeskočit na hlavní obsah

Složitější příklady API volání

Ukázky volání s filtrací, vazbami a vnořenými evidencemi — faktura s položkami a ceníkem, úhrady zálohových faktur

Autor: Petr Pech

Ukázky volání, ve kterých se kombinuje filtrace, úroveň detailu, vazby i vnořené evidence. Hodí se jako předloha, když potřebujete jedním dotazem vytáhnout data, která jsou v ABRA Flexi rozložena do několika evidencí.


Vydaná faktura včetně položek a údajů z ceníku

Parametr relations přidá do výstupu položky faktury a includes k nim dotáhne navázanou ceníkovou položku:

GET /c/{firma}/faktura-vydana.xml
?detail=full
&relations=polozkyDokladu
&includes=faktura-vydana/polozkyDokladu/faktura-vydana-polozka/cenik/

💡 Místo detail=full je úspornější vyjmenovat potřebná pole přes detail=custom:… — odpověď je menší a server ji sestaví rychleji.


Úhrady zálohových faktur přes vazby

Tento dotaz vybere uhrazené zálohové faktury a u každé vypíše i doklad, kterým byla uhrazena:

GET /c/{firma}/faktura-vydana/(typDokl='code:ZÁLOHA'
and stavUhrK in ('stavUhr.uhrazeno','stavUhr.uhrazenoRucne')
and id>=10).xml
?detail=custom:id,varSym,datUhr,vazby(typVazbyK,b(id),a(id))
&relations=vazby
&includes=/faktura-vydana/vazby/vazba/b/
&limit=0

Ve vazbě je a uhrazovaný a b uhrazující doklad; typVazbyK říká, o jaký druh vazby jde (například typVazbyDokl.uhradaZALOHY nebo typVazbyDokl.odpocetZALOHY).

⚠️ Filtr v adrese musí být zakódovaný — mezery jako %20, > jako %3E. Nezakódovaný filtr vrátí místo dat HTML stránku, viz Chyba 400 při odesílání URL.


Související

Dostali jste odpověď na svou otázku?