Službu Zaúčtovat prodejky, ktorú v aplikácii nájdete nad predajnou pokladňou, možno vyvolať aj cez REST API. Z predajok za zvolený deň vytvorí pokladničný doklad a naviaže ho na ne.

Volanie služby

Služba sa volá metódou PUT alebo POST, telo požiadavky nie je potrebné:

PUT https://demo.flexibee.eu/c/demo/prodejka/zauctovat-prodejky.json?datum=2026-09-09&kasa=code:KASA&pokladna=2&typPokDokl=5

Kompletná URL adresa vrátane nepovinných parametrov môže vyzerať napríklad takto:

PUT https://demo.flexibee.eu/c/demo/prodejka/zauctovat-prodejky.xml?datum=2026-09-09&kasa=37&pokladna=2&typPokDokl=5&typPohledavky[code:KARTA]=code:OST. POHLEDÁVKY

⚠️ Iná metóda než PUT alebo POST vracia 405 Method Not Allowed.

Parametre

Parameter	Pole v aplikácii	Hodnota
`datum`	Zaúčtovanie predajok od dátumu	Dátum vo formáte `yyyy-mm-dd`. Ak parameter neuvediete, použije sa dnešný dátum.
`kasa`	Predajky z pokladne	Povinný. Záznam z evidencie `typ-prodejky`.
`pokladna`	Pokladňa	Povinný. Záznam z evidencie `pokladna`.
`typPokDokl`	Typ pokladničného dokladu	Povinný. Záznam z evidencie `typ-pokladni-pohyb`.
`cisRada`	—	Záznam z evidencie `rada-pokladni-pohyb`. Vyžadovaný len vtedy, keď sa nenájde číselný rad zodpovedajúci zvolenej pokladni a typu pokladničného dokladu.
`genPoklNulCastka`	Vytvoriť pokladničný doklad pri nulovej sume	Predvolená hodnota je `true`.
`typPohledavky[forma-uhrady]`	—	Typ pohľadávky pre zaúčtovanie nehotovostnej úhrady. V hranatých zátvorkách je záznam z evidencie `forma-uhrady`, hodnotou je záznam z evidencie `typ-pohledavky`.
`dry-run`	—	Predvolená hodnota je `false`. S hodnotou `true` sa len overia podmienky zaúčtovania, žiadny doklad nevznikne.

Pri všetkých parametroch, ktoré identifikujú záznam, možno okrem číselného ID použiť aj ostatné podporované typy identifikátorov — napríklad &kasa=code:KASA.

ℹ️ Povinné parametre sa kontrolujú v poradí kasa, pokladna, typPokDokl — ak chýba viac než jeden, dozviete sa vždy len o prvom z nich. Neznáme parametre API tiché ignoruje, takže preklep v názve nepovinného parametra sa nijako neprejaví.

Overenie nasucho

Parameter dry-run=true je bezpečný spôsob, ako zistiť, či sú splnené podmienky pre zaúčtovanie. Pri úspechu vracia 200 s prázdnym telom, inak 400 alebo 404 so zodpovedajúcou chybovou správou:

PUT https://demo.flexibee.eu/c/demo/prodejka/zauctovat-prodejky.json?datum=2026-09-09&kasa=code:KASA&pokladna=2&typPokDokl=5&dry-run=true

💡 Chybové stavy sa v odpovedi vracajú ako HTML stránka, pokiaľ si formát nevyžiadate. Prípona .json alebo .xml v URL a hlavička Accept zaistia, že dostanete strojovo čitateľnú chybu s messageCode.

Výstup

Úspešné zaúčtovanie vracia 200 a štandardné návratové hodnoty. V results je vytvorený pokladničný doklad:

{
  "winstrom": {
    "@version": "1.0",
    "success": "true",
    "stats": {
      "created": "1",
      "updated": "0",
      "deleted": "0",
      "skipped": "0",
      "failed": "0"
    },
    "results": [
      {
        "id": "2034",
        "ref": "/c/demo/pokladni-pohyb/2034.json"
      }
    ]
  }
}

Zaúčtovaným predajkám sa nastaví datUcto a vznikne väzba na pokladničný doklad. Nájdete ju v relácii vazby, kde je predajka vo vlastnosti a a pokladničný doklad vo vlastnosti b:

GET https://demo.flexibee.eu/c/demo/prodejka/2852.json?relations=vazby

Chybové stavy

Stav	Kód chyby	Príčina
`400`	`missing_param_exception`	Chýba povinný parameter; správa ho pomenuje.
`400`	`zauctovaniProdejekNejsouProdejky`	Pre zvolený dátum a pokladňu nie sú žiadne nezaúčtované predajky.
`400`	`objectNotFound`	Neexistujúca forma úhrady alebo typ pohľadávky v parametri `typPohledavky[…]`.
`400`	—	Dátum v inom než požadovanom formáte — správa znie Zadaný text … musí byť dátum.
`404`	`formZaznamNenalezen`	Neexistujúca pokladňa, typ pokladničného dokladu alebo číselný rad.
`405`	—	Použitá HTTP metóda nie je `PUT` ani `POST`.

Súvisiace

Sorodni članki

Zaúčtovanie predajok