V aplikaci jsou na vybraném adresářovém záznamu dostupné souhrnné informace pod záložkou Souhrnné informace — celková fakturovaná částka, nezaplacená částka, splatnost a podobně. Tatáž statistika finanční bilance s obchodním partnerem je dostupná i v REST API.
Sestavení URL
Požadavek se zasílá metodou GET na subevidenci summary konkrétního záznamu z adresáře:
GET https://demo.flexibee.eu/c/demo/adresar/123/summary.json
GET https://demo.flexibee.eu/c/demo/adresar/code:ABRA/summary.xml
⚠️ Firmu lze adresovat číselným ID nebo identifikátorem code:ZKRATKA. Filtrace v kulatých závorkách zde nefunguje — dotaz na /adresar/(kod='ABRA')/summary vrací 404 s hlášením Can't find record identified by (kod='ABRA').
Odpověď
Odpovědí je přehled souhrnných informací, stejný jako v aplikaci:
{
"winstrom": {
"adresarSummary": {
"celkFakt": "1.2290034529E8",
"limitFakt": "0.0",
"neuzNap": "0.0",
"neuzNav": "24306.55",
"neuzObp": "80952.43",
"neuzObv": "134.31",
"neuzPpp": "0.0",
"neuzPpv": "0.0",
"nezaplaceno": "1.2283741422E8",
"nezaplacenoPoDatSplat": "1.2284548008E8",
"prumProdleva": "-12.75",
"splatText": ""
}
}
}Vlastnost | Význam |
| Celkem fakturováno |
| Limit fakturace |
| Neuzavřené nabídky přijaté |
| Neuzavřené nabídky vydané |
| Nevyfakturované objednávky přijaté |
| Nenaskladněné objednávky vydané |
| Neuzavřené poptávky přijaté |
| Neuzavřené poptávky vydané |
| Nezaplaceno |
| Nezaplaceno po splatnosti |
| Průměrná prodleva splácení |
| Definovaná splatnost |
Neúspěšné požadavky
Situace | Odpověď |
Zadaná firma neexistuje |
|
ID není platný identifikátor — například |
|
Jiná HTTP metoda než |
|
FAQ
Jak provést službu „Aktualizovat vše" a „Aktualizovat z internetu" přes API?
Popisuje to článek Aktualizace firem z ARES přes API.
Jak v adresáři filtrovat podle typu vztahu?
Postup najdete v článku API adresář - typ vztahu, filtry.