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.