# Typy dokladov

> Pokladničný doklad, paragón, úhrada faktúry a paragón pri úhrade faktúry: kedy ktorý doklad použiť a ako ho zaregistrovať.

Zdroj: https://ekasa.ninedigit.sk/docs/receipt-registration/receipt-types

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.

```mermaid
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.

[Obrázok: Pokladničný doklad s dvoma cappuccinami a vernostnou zľavou, platba kartou]

**HTTP API:**

```http
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
        }
      ]
    }
  }
}
```

**.NET knižnica:**

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.

**Porucha**: pokladnica nefunguje
→
**Paragón**: vypísaný v čase T s číslom P
→
**Oprava**: porucha pominie
→
**Evidencia**: doklad 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.

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

**HTTP API:**

```http
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
        }
      ]
    }
  }
}
```

**.NET knižnica:**

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úra**: vystavená mimo eKasy
→
**Platba**: zá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](https://ekasa.ninedigit.sk/docs/receipt-registration/payments#zaokr%C3%BAh%C4%BEovanie)).

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

**HTTP API:**

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

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

**.NET knižnica:**

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úra**: vystavená mimo eKasy
→
**Porucha**: pokladnica nefunguje
→
**Paragón**: platba 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ť)

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

**HTTP API:**

```http
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
    }
  }
}
```

**.NET knižnica:**

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

## Kam ďalej

- [Položky dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration/items): Typ položky, cena, množstvo a sadzba DPH.
- [Platby a zaokrúhľovanie](https://ekasa.ninedigit.sk/docs/receipt-registration/payments): Platidlá a zaokrúhlenie hotovosti.
- [Vyhotovenie dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration/printing): Papier, PDF alebo e-mail a vlastné texty.
