# Receipt registration

> Overview of receipt registration: receipt types, API endpoints and library methods, request structure and links to items, payments, discounts and corrections.

Source: https://ekasa.ninedigit.sk/en/docs/receipt-registration

Receipt registration is the core task of the integration: your software sends eKasa the sale data, and eKasa
validates the receipt, writes it to the storage, sends it to the eKasa system, issues it and returns the result. The
whole process step by step is shown in [How eKasa works](https://ekasa.ninedigit.sk/en/docs/how-it-works). This page is an overview; you will
find the details on the subpages.

A sample solution using the .NET library is in the
[ninedigit-ekasa-quickstart](https://github.com/ninedigit/ninedigit-ekasa-quickstart) project on GitHub.

## Receipt types

Each receipt type has its own API endpoint and its own request class in the library:

**HTTP API:**

| Receipt | When | Endpoint |
|---|---|---|
| Cash register receipt | sale, return, correction | `POST /api/v1/requests/receipts/cash_register` |
| Paragon | recording a receipt issued during a cash register failure afterwards | `POST /api/v1/requests/receipts/paragon` |
| Invoice payment | paying an invoice at the point of sale | `POST /api/v1/requests/receipts/invoice` |
| Invoice payment paragon | recording an invoice payment from a failure afterwards | `POST /api/v1/requests/receipts/invoice_paragon` |

**.NET library:**

| Receipt | When | Request for `client.RegisterReceiptAsync()` |
|---|---|---|
| Cash register receipt | sale, return, correction | `RegisterCashRegisterReceiptRequest` |
| Paragon | recording a receipt issued during a cash register failure afterwards | `RegisterParagonReceiptRequest` |
| Invoice payment | paying an invoice at the point of sale | `RegisterInvoiceReceiptRequest` |
| Invoice payment paragon | recording an invoice payment from a failure afterwards | `RegisterInvoiceParagonReceiptRequest` |

Invalid receipts, deposits and withdrawals are no longer recorded from 1 January 2026, and eKasa does not support
them from version 9. Customer details have not been stated on receipts since 2021, when the Constitutional Court of
the Slovak Republic abolished them.

## Request structure

A request through the HTTP API has three parts:

```jsonc
{
  "request": {
    "data": { /* … receipt data */ },
    "externalId": "order-2026-000123"
  },
  "print": {
    "printerName": "pos"
  }
}
```

| Part | Required | Content |
|---|---|---|
| `request.data` | yes | receipt data: cash register code, [items](https://ekasa.ninedigit.sk/en/docs/receipt-registration/items), [payments](https://ekasa.ninedigit.sk/en/docs/receipt-registration/payments), texts |
| `request.externalId` | always send it | your identifier that protects against [recording a sale twice](https://ekasa.ninedigit.sk/en/docs/receipt-registration/external-id) |
| `print` | no | [how the receipt is issued](https://ekasa.ninedigit.sk/en/docs/receipt-registration/printing): paper, PDF or e-mail. Paper by default. |

In the .NET library, `request` corresponds to the request object and `print` to the `RegisterReceiptPrintContext`
parameter.

## Topics

- [Duplicate protection](https://ekasa.ninedigit.sk/en/docs/receipt-registration/external-id): externalId: why it is essential and how to use it.
- [Receipt types](https://ekasa.ninedigit.sk/en/docs/receipt-registration/receipt-types): Cash register receipt, paragon and invoice payment with examples.
- [Receipt items](https://ekasa.ninedigit.sk/en/docs/receipt-registration/items): Item type, price, quantity and VAT rate.
- [Payments and rounding](https://ekasa.ninedigit.sk/en/docs/receipt-registration/payments): Means of payment and cash rounding.
- [Discounts](https://ekasa.ninedigit.sk/en/docs/receipt-registration/discounts): Item discount and whole-receipt discount.
- [Cancellations and returns](https://ekasa.ninedigit.sk/en/docs/receipt-registration/corrections): Receipt correction, returned goods and invoice payment refunds.
- [Vouchers](https://ekasa.ninedigit.sk/en/docs/receipt-registration/vouchers): Single-purpose and multi-purpose vouchers.
- [Advance deduction](https://ekasa.ninedigit.sk/en/docs/receipt-registration/advances): An advance received before the goods are delivered.
- [Issuing the receipt](https://ekasa.ninedigit.sk/en/docs/receipt-registration/printing): Paper, PDF or e-mail and custom texts.
- [Registration result](https://ekasa.ninedigit.sk/en/docs/receipt-registration/result): isSuccessful, receipt number and VAT summary.
