# Registrácia dokladu

> Prehľad registrácie dokladu: typy dokladov, adresy API a metódy knižnice, štruktúra požiadavky a odkazy na položky, platby, zľavy, opravy a výsledok.

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

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](https://ekasa.ninedigit.sk/docs/how-it-works). 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](https://github.com/ninedigit/ninedigit-ekasa-quickstart) na GitHube.

## Typy dokladov

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

**HTTP API:**

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

**.NET knižnica:**

| 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:

```jsonc
{
  "request": {
    "data": { /* … údaje dokladu */ },
    "externalId": "objednavka-2026-000123"
  },
  "print": {
    "printerName": "pos"
  }
}
```

| Časť | Povinná | Obsah |
|---|---|---|
| `request.data` | áno | údaje dokladu: kód pokladnice, [položky](https://ekasa.ninedigit.sk/docs/receipt-registration/items), [platby](https://ekasa.ninedigit.sk/docs/receipt-registration/payments), texty |
| `request.externalId` | vždy uveďte | váš identifikátor, ktorý chráni pred [dvojitou evidenciou tržby](https://ekasa.ninedigit.sk/docs/receipt-registration/external-id) |
| `print` | nie | [spôsob vyhotovenia](https://ekasa.ninedigit.sk/docs/receipt-registration/printing): papier, PDF alebo e-mail. Predvolene papier. |

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

## Témy

- [Ochrana pred duplicitou](https://ekasa.ninedigit.sk/docs/receipt-registration/external-id): externalId: prečo je nevyhnutný a ako ho použiť.
- [Typy dokladov](https://ekasa.ninedigit.sk/docs/receipt-registration/receipt-types): Pokladničný doklad, paragón a úhrada faktúry s príkladmi.
- [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.
- [Zľavy](https://ekasa.ninedigit.sk/docs/receipt-registration/discounts): Zľava na položku a na celý doklad.
- [Storno a vrátenie](https://ekasa.ninedigit.sk/docs/receipt-registration/corrections): Oprava dokladu, vrátenie tovaru a úhrady faktúry.
- [Poukazy](https://ekasa.ninedigit.sk/docs/receipt-registration/vouchers): Jednoúčelový a viacúčelový poukaz.
- [Odpočet zálohy](https://ekasa.ninedigit.sk/docs/receipt-registration/advances): Záloha prijatá pred dodaním tovaru.
- [Vyhotovenie dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration/printing): Papier, PDF alebo e-mail a vlastné texty.
- [Výsledok registrácie](https://ekasa.ninedigit.sk/docs/receipt-registration/result): isSuccessful, číslo dokladu a rekapitulácia DPH.
