Registrácia dokladu

Integrujem cez

Registrácia dokladu je hlavná úloha integrácie: váš softvér pošle eKase údaje o predaji a eKasa doklad overí, zapíše do úložiska, odošle do systému eKasa, vyhotoví a vráti výsledok. Celý postup krok za krokom ukazuje Ako funguje eKasa. Táto stránka je prehľad, podrobnosti nájdete na podstránkach.

Vzorové riešenie s .NET knižnicou nájdete v projekte ninedigit-ekasa-quickstart na GitHube.

Typy dokladov

Každý typ dokladu má vlastnú adresu v API a vlastnú triedu požiadavky v knižnici:

Doklad Kedy Adresa
Pokladničný doklad predaj, vrátenie, oprava POST /api/v1/requests/receipts/cash_register
Paragón dodatočná evidencia dokladu z poruchy pokladnice POST /api/v1/requests/receipts/paragon
Úhrada faktúry platba faktúry na predajnom mieste POST /api/v1/requests/receipts/invoice
Paragón pri úhrade faktúry dodatočná evidencia úhrady faktúry z poruchy POST /api/v1/requests/receipts/invoice_paragon
Doklad Kedy Požiadavka pre client.RegisterReceiptAsync()
Pokladničný doklad predaj, vrátenie, oprava RegisterCashRegisterReceiptRequest
Paragón dodatočná evidencia dokladu z poruchy pokladnice RegisterParagonReceiptRequest
Úhrada faktúry platba faktúry na predajnom mieste RegisterInvoiceReceiptRequest
Paragón pri úhrade faktúry dodatočná evidencia úhrady faktúry z poruchy RegisterInvoiceParagonReceiptRequest

Doklady typu neplatný doklad, vklad a výber sa od 1. 1. 2026 neevidujú a eKasa ich od verzie 9 nepodporuje. Údaj o kupujúcom sa na doklade neuvádza od roku 2021, keď ho zrušil Ústavný súd SR.

Štruktúra požiadavky

Požiadavka cez HTTP API má tri časti:

{
  "request": {
    "data": { /* … údaje dokladu */ },
    "externalId": "objednavka-2026-000123"
  },
  "print": {
    "printerName": "pos"
  }
}
Časť Povinná Obsah
request.data áno údaje dokladu: kód pokladnice, položky, platby, texty
request.externalId vždy uveďte váš identifikátor, ktorý chráni pred dvojitou evidenciou tržby
print nie spôsob vyhotovenia: papier, PDF alebo e-mail. Predvolene papier.

V .NET knižnici zodpovedá request objekt požiadavky a print parameter RegisterReceiptPrintContext.

Témy

Esc

↑↓ výberEnter otvoriťEsc zavrieť

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.