Typy dokladov

Integrujem cez

Typ dokladu určuje, v akej situácii doklad vzniká a ktoré údaje musí obsahovať. Väčšina predajov je pokladničný doklad. Ostatné typy pokrývajú poruchu pokladnice (paragón) a platby faktúr.

flowchart TD
    A{Platí zákazník<br/>faktúru?} -->|nie, bežný predaj| B{Fungovala pokladnica<br/>v čase predaja?}
    B -->|áno| C[Pokladničný doklad]
    B -->|nie, dodatočná evidencia| D[Paragón]
    A -->|áno| E{Fungovala pokladnica<br/>v čase platby?}
    E -->|áno| F[Úhrada faktúry]
    E -->|nie, dodatočná evidencia| G[Paragón pri<br/>úhrade faktúry]

Pokladničný doklad

Bežný pokladničný doklad, ktorý je vyhotovovaný pri predaji, prípadne pri vrátení tovaru alebo stornovaní dokladu.

Pokladničný doklad s dvoma cappuccinami a vernostnou zľavou, platba kartou

POST {server_address}/api/v1/requests/receipts/cash_register

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "positive",
          "name": "Cappuccino",
          "quantity": {
            "amount": 2.0,
            "unit": "ks"
          },
          "unitPrice": 2.9,
          "price": 5.8,
          "vatRate": 19.0
        },
        {
          "type": "discount",
          "name": "Vernostná zľava",
          "quantity": {
            "amount": 1.0
          },
          "unitPrice": -1.0,
          "price": -1.0,
          "vatRate": 19.0
        }
      ],
      "payments": [
        {
          "name": "Karta",
          "amount": 4.8
        }
      ]
    }
  }
}

Metóda: client.RegisterReceiptAsync(RegisterCashRegisterReceiptRequest, RegisterReceiptPrintContext, CancellationToken)

Pokladničný doklad - paragón

Keď pokladnica nefunguje, obsluha vypisuje zákazníkom papierové doklady, takzvané paragóny. Po obnovení prevádzky ich musí dodatočne zaevidovať v pokladnici, a to najneskôr do desiatich dní (§ 11 ods. 3 zákona č. 384/2025 Z. z.).

Výpadok internetu nie je porucha: pokladnica s úložiskom CHDÚ, ktorú eKasa vytvára, doklady ďalej vyhotovuje a zaeviduje ich v offline režime, odošle ich po obnovení spojenia. Paragón pri výpadku internetu ukladá zákon len softvérovej a virtuálnej pokladnici (§ 11 ods. 1), tie táto dokumentácia nepokrýva.

Poruchapokladnica nefunguje

Paragónvypísaný v čase T s číslom P

Opravaporucha pominie

Evidenciadoklad s issueDate T a paragonNumber P

Váš softvér preto potrebuje formulár, v ktorom obsluha k položkám zadá z paragónu:

  • issueDate: dátum a čas vyhotovenia paragónu (T),
  • paragonNumber: číslo paragónu (P).

Ostatné údaje sú rovnaké ako pri pokladničnom doklade.

Zaevidovaný paragón: hlavička Zaevidovanie paragónu, číslo a dátum paragónu, položky a platba

POST {server_address}/api/v1/requests/receipts/paragon

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "issueDate": "2026-11-18T12:30:40+01:00",
      "paragonNumber": 1,
      "items": [
        {
          "type": "positive",
          "name": "Cappuccino",
          "quantity": {
            "amount": 2.0,
            "unit": "ks"
          },
          "unitPrice": 2.9,
          "price": 5.8,
          "vatRate": 19.0
        },
        {
          "type": "discount",
          "name": "Vernostná zľava",
          "quantity": {
            "amount": 1.0
          },
          "unitPrice": -1.0,
          "price": -1.0,
          "vatRate": 19.0
        }
      ],
      "payments": [
        {
          "name": "Karta",
          "amount": 4.8
        }
      ]
    }
  }
}

Metóda: client.RegisterReceiptAsync(RegisterParagonReceiptRequest, RegisterReceiptPrintContext, CancellationToken)

Úhrada faktúry

Faktúru podnikateľ vystaví mimo eKasy, napríklad v účtovnom programe. Keď ju zákazník príde zaplatiť na predajné miesto, podnikateľ platbu zaeviduje ako úhradu faktúry.

Faktúravystavená mimo eKasy

Platbazákazník platí na predajnom mieste

Úhrada faktúryčíslo faktúry a uhrádzaná suma

Doklad úhrady faktúry nemá položky (items). Obsluha zadá:

  • invoiceNumber: číslo faktúry,
  • amount: uhrádzanú sumu s DPH, teda celú sumu faktúry alebo len jej časť, ak zákazník platí po častiach.

Ak zákazník platí v hotovosti, uveďte v amount sumu pred zaokrúhlením a zaokrúhlenie vo vlastnosti roundingAmount (pozri Zaokrúhľovanie).

Doklad úhrady faktúry: číslo faktúry a suma, bez položiek a rekapitulácie DPH

POST {server_address}/api/v1/requests/receipts/invoice

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "invoiceNumber": "FA-2026-0142",
      "amount": 189.9
    }
  }
}

Metóda: client.RegisterReceiptAsync(RegisterInvoiceReceiptRequest, RegisterReceiptPrintContext, CancellationToken)

Úhrada faktúry - paragón

Kombinácia oboch predchádzajúcich prípadov: zákazník platí faktúru v čase, keď pokladnica nefunguje. Obsluha mu vypíše paragón a po odstránení poruchy ho zaeviduje ako úhradu faktúry.

Faktúravystavená mimo eKasy

Poruchapokladnica nefunguje

Paragónplatba faktúry v čase T, číslo P

Evidenciaúhrada faktúry s T, P, číslom faktúry a sumou

Doklad nemá položky (items). Obsluha zadá:

  • issueDate: dátum a čas vyhotovenia paragónu (T),
  • paragonNumber: číslo paragónu (P),
  • invoiceNumber: číslo faktúry,
  • amount: uhrádzaná suma s DPH (celá suma faktúry alebo jej časť)

Zaevidovaný paragón pri úhrade faktúry: číslo a dátum paragónu, číslo faktúry a suma

POST {server_address}/api/v1/requests/receipts/invoice_paragon

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "issueDate": "2026-11-18T12:30:40+01:00",
      "invoiceNumber": "FA-2026-0143",
      "paragonNumber": 2,
      "amount": 189.9
    }
  }
}

Metóda: client.RegisterReceiptAsync(RegisterInvoiceParagonReceiptRequest, RegisterReceiptPrintContext, CancellationToken)

Kam ďalej

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.