Službu Zaúčtovat prodejky, kterou v aplikaci najdete nad prodejní kasou, lze vyvolat i přes REST API. Z prodejek za zvolený den vytvoří pokladní doklad a naváže ho na ně.

Volání služby

Služba se volá metodou PUT nebo POST, tělo požadavku není potřeba:

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 včetně nepovinných parametrů může vypadat napří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

⚠️ Jiná metoda než PUT nebo POST vrací 405 Method Not Allowed.

Parametry

Parametr	Pole v aplikaci	Hodnota
`datum`	Zaúčtování prodejek z data	Datum ve formátu `yyyy-mm-dd`. Když parametr neuvedete, použije se dnešní datum.
`kasa`	Prodejky z kasy	Povinný. Záznam z evidence `typ-prodejky`.
`pokladna`	Pokladna	Povinný. Záznam z evidence `pokladna`.
`typPokDokl`	Typ pokladního dokladu	Povinný. Záznam z evidence `typ-pokladni-pohyb`.
`cisRada`	—	Záznam z evidence `rada-pokladni-pohyb`. Vyžadován jen tehdy, když se nenajde číselná řada odpovídající zvolené pokladně a typu pokladního dokladu.
`genPoklNulCastka`	Vytvořit pokladní doklad při nulové částce	Výchozí hodnota je `true`.
`typPohledavky[forma-uhrady]`	—	Typ pohledávky pro zaúčtování nehotovostní úhrady. V hranatých závorkách je záznam z evidence `forma-uhrady`, hodnotou je záznam z evidence `typ-pohledavky`.
`dry-run`	—	Výchozí hodnota je `false`. S hodnotou `true` se jen ověří podmínky zaúčtování, žádný doklad nevznikne.

U všech parametrů, které identifikují záznam, lze kromě číselného ID použít i ostatní podporované typy identifikátorů — například &kasa=code:KASA.

ℹ️ Povinné parametry se kontrolují v pořadí kasa, pokladna, typPokDokl — chybí-li víc než jeden, dozvíte se vždy jen o prvním z nich. Neznámé parametry API tiše ignoruje, takže překlep v názvu nepovinného parametru se nijak neprojeví.

Ověření nasucho

Parametr dry-run=true je bezpečný způsob, jak zjistit, zda jsou splněné podmínky pro zaúčtování. Při úspěchu vrací 200 s prázdným tělem, jinak 400 nebo 404 s odpovídající chybovou zprá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 se v odpovědi vracejí jako HTML stránka, pokud si formát nevyžádáte. Přípona .json nebo .xml v URL a hlavička Accept zajistí, že dostanete strojově čitelnou chybu s messageCode.

Výstup

Úspěšné zaúčtování vrací 200 a standardní návratové hodnoty. V results je vytvořený pokladní 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 prodejkám se nastaví datUcto a vznikne vazba na pokladní doklad. Najdete ji v relaci vazby, kde je prodejka ve vlastnosti a a pokladní doklad ve vlastnosti b:

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

Chybové stavy

Stav	Kód chyby	Příčina
`400`	`missing_param_exception`	Chybí povinný parametr; zpráva ho pojmenuje.
`400`	`zauctovaniProdejekNejsouProdejky`	Pro zvolené datum a kasu nejsou žádné nezaúčtované prodejky.
`400`	`objectNotFound`	Neexistující forma úhrady nebo typ pohledávky v parametru `typPohledavky[…]`.
`400`	—	Datum v jiném než požadovaném formátu — zpráva zní Zadaný text … musí být datum.
`404`	`formZaznamNenalezen`	Neexistující kasa, pokladna, typ pokladního dokladu nebo číselná řada.
`405`	—	Použitá HTTP metoda není `PUT` ani `POST`.

Související

Související články

Zaúčtování prodejek