# Registration result

> What the receipt registration result contains: isSuccessful, the receipt number, the unique identifier and the VAT summary.

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

After every receipt registration, your software receives a result. It tells you how the registration ended: the
receipt was registered online, accepted in offline mode, or rejected by the eKasa system. It also contains the data
your software needs next: the receipt number, the unique identifier for a later cancellation or return of goods,
and the VAT summary.

Before registering, read [Duplicate protection](https://ekasa.ninedigit.sk/en/docs/receipt-registration/external-id): the `externalId`
prevents recording a sale twice when the response is lost.

## <span id="analysing-the-receipt-registration-result" class="anchor"></span>What the result contains

**HTTP API:**

The API returns the result in the body of the receipt registration response.

**.NET library:**

The `RegisterReceiptAsync` method returns a `RegisterReceiptResult` object with the `IsSuccessful`, `Request`,
`Response` and `Error` properties.

| Property | Content | Has a value |
|---|---|---|
| `isSuccessful` | How the registration ended, see [Three possible outcomes](#three-possible-outcomes). | `true`, `null` or `false` |
| `request` | The request sent to the eKasa system: the original data sent by the parent application and added data, such as the receipt number (`receiptNumber`) and the business verification code (`okp`). | always |
| `response` | The result of processing the receipt, with information from the Financial Administration's eKasa system. | only if `isSuccessful` is `true` |
| `error` | An error object with information from the Financial Administration's eKasa system. | only if `isSuccessful` is `false` |

## Three possible outcomes

| `isSuccessful` | What happened | `response` | `error` |
|---|---|---|---|
| `true` | The receipt was successfully registered **in online mode**. | processing result | `null` |
| `null` | The registration was accepted **in offline mode**. | `null` | `null` |
| `false` | The registration was handled in online mode, but **the eKasa system rejected it**. | `null` | error |

The examples below show only selected properties.

**Online** – receipt successfully recorded in online mode:

```json
{
  "request": {
    "data": {
      "receiptNumber": 2,
      "okp": "04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0"
    }
  },
  "response": {
    "data": {
      "id": "O-7DBCDA8A56EE426DBCDA8A56EE426D1A"
    },
    "processDate": "2026-01-20T15:34:14+01:00"
  },
  "isSuccessful": true,
  "error": null,
  "$type": "Receipt"
}
```

**Offline** – receipt recorded in offline mode:

```json
{
  "request": {
    "data": {
      "receiptNumber": 2,
      "okp": "04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0"
    }
  },
  "response": null,
  "isSuccessful": null,
  "error": null,
  "$type": "Receipt"
}
```

**Rejected** – request rejected by the Financial Administration server:

```json
{
  "request": {
    "data": {
      "receiptNumber": 2,
      "okp": "04eacca4-6ff07dea-c2c85513-28181bb6-f46edcb0"
    }
  },
  "response": null,
  "isSuccessful": false,
  "error": {
    "message": "Chyba v podpise dátovej správy.",
    "code": -10
  },
  "$type": "Receipt"
}
```

## Where to find the receipt data

**HTTP API:**

| Data | Property | Details |
|---|---|---|
| Receipt number | `request.data.receiptNumber` | [Getting the receipt number](#getting-the-receipt-number) |
| Unique identifier (online) | `response.data.id` | [Getting the unique identifier](#getting-the-unique-receipt-identifier) |
| Business verification code (offline) | `request.data.okp` | [Getting the unique identifier](#getting-the-unique-receipt-identifier) |
| VAT summary | `request.data.vatRatesTaxSummary` | [VAT summary](#vat-summary) |
| Error from the eKasa system | `error.code`, `error.message` | [Three possible outcomes](#three-possible-outcomes) |

**.NET library:**

| Data | Property | Details |
|---|---|---|
| Receipt number | `result.Request.Data.ReceiptNumber` | [Getting the receipt number](#getting-the-receipt-number) |
| Unique identifier (online) | `result.Response.Data.Id` | [Getting the unique identifier](#getting-the-unique-receipt-identifier) |
| Business verification code (offline) | `result.Request.Data.OKP` | [Getting the unique identifier](#getting-the-unique-receipt-identifier) |
| VAT summary | `VatRatesTaxSummary.Create(result.Request.Data.Items)` | [VAT summary](#vat-summary) |
| Error from the eKasa system | `result.Error.Code`, `result.Error.Message` | [Three possible outcomes](#three-possible-outcomes) |

```csharp
RegisterReceiptResult result = await client.RegisterReceiptAsync(
    request, RegisterReceiptPrintContext.CreatePos(), cancellationToken);

ReceiptNumber receiptNumber = result.Request.Data.ReceiptNumber;

switch (result.IsSuccessful)
{
    case true:  // online: receipt registered in the eKasa system
        EKasaReceiptId id = result.Response.Data.Id;
        break;
    case null:  // offline: registration accepted in offline mode
        OKP okp = result.Request.Data.OKP;
        break;
    case false: // online, but the eKasa system rejected the receipt
        int? code = result.Error.Code;
        string message = result.Error.Message;
        break;
}

VatRatesTaxSummary? vatSummary = result.Request.Data.Items is { } items
    ? VatRatesTaxSummary.Create(items)
    : null;
```

## Example request and response

The example is a café purchase paid in cash. It contains items at the 23 %, 19 % and 5 % VAT rates and returnable
packaging (not subject to VAT). The receipt is printed to PDF:

[Image: Printed café receipt with items at 23 %, 19 % and 5 %, returnable packaging, cash rounding, the VAT summary, UID and OKP]

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "headerText": "https://ekasa.ninedigit.sk",
      "footerText": "Ďakujeme za nákup!",
      "items": [
        {
          "type": "Positive",
          "name": "Cappuccino",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": 2.90,
          "price": 5.80,
          "vatRate": 19.00
        },
        {
          "type": "Positive",
          "name": "Croissant maslový (3 ks za 4 €)",
          "quantity": {
            "amount": 3.00,
            "unit": "ks"
          },
          "unitPrice": 1.333333,
          "price": 4.00,
          "vatRate": 5.00
        },
        {
          "type": "Positive",
          "name": "Minerálka 0,33 l (2 ks za 2,25 €)",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": 1.125,
          "price": 2.25,
          "vatRate": 19.00
        },
        {
          "type": "Positive",
          "name": "Pohľadnica Bratislava",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": 0.88,
          "price": 1.76,
          "vatRate": 23.00
        },
        {
          "type": "Positive",
          "name": "Záloha PET",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": 0.15,
          "price": 0.30
        },
        {
          "type": "ReturnedContainer",
          "name": "Vrátenie zálohy PET",
          "quantity": {
            "amount": 3.00,
            "unit": "ks"
          },
          "unitPrice": -0.15,
          "price": -0.45
        }
      ],
      "roundingAmount": -0.01,
      "payments": [
        {
          "name": "Hotovosť",
          "amount": 20.00
        },
        {
          "name": "Výdavok",
          "amount": -6.35
        }
      ]
    }
  }
}
```

Response, selected properties. The receipt number `35` is printed on the **Doklad** (receipt) line,
`response.data.id` on the **UID** line and `okp` on the **OKP** line:

```json
{
  "request": {
    "data": {
      "receiptNumber": 35,
      "amount": 13.65,
      "okp": "C1E7A53E-6D1D48B0-801EE45D-6B67BF63-6C2AA5CF"
    }
  },
  "response": {
    "data": {
      "id": "O-488AE60F5DDC432E8AE60F5DDC7-TEST"
    },
    "processDate": "2026-11-19T02:08:43+01:00"
  },
  "isSuccessful": true,
  "error": null,
  "$type": "Receipt"
}
```

**Full response**

```json
{
  "request": {
    "data": {
      "receiptType": "CashRegister",
      "amount": 13.65,
      "roundingAmount": -0.01,
      "issueDate": "2026-11-19T02:08:43+01:00",
      "receiptNumber": 35,
      "invoiceNumber": null,
      "paragonNumber": null,
      "icdph": "SK1234567890",
      "ico": "76543210",
      "basicVatAmount": 0.33,
      "reducedVatAmount": 1.29,
      "secondReducedVatAmount": 0.19,
      "taxFreeAmount": null,
      "nonTaxableAmount": -0.15,
      "taxBaseBasic": 1.43,
      "taxBaseReduced": 6.76,
      "taxBaseSecondReduced": 3.81,
      "items": [
        {
          "type": "Positive",
          "name": "Cappuccino",
          "price": 5.80,
          "unitPrice": 2.900000,
          "quantity": {
            "amount": 2.0000,
            "unit": "ks"
          },
          "referenceReceiptId": null,
          "vatRate": 19.00,
          "specialRegulation": null,
          "voucherNumber": null,
          "seller": null,
          "description": null
        },
        {
          "type": "Positive",
          "name": "Croissant maslový (3 ks za 4 €)",
          "price": 4.00,
          "unitPrice": 1.333333,
          "quantity": {
            "amount": 3.0000,
            "unit": "ks"
          },
          "referenceReceiptId": null,
          "vatRate": 5.00,
          "specialRegulation": null,
          "voucherNumber": null,
          "seller": null,
          "description": null
        },
        {
          "type": "Positive",
          "name": "Minerálka 0,33 l (2 ks za 2,25 €)",
          "price": 2.25,
          "unitPrice": 1.125000,
          "quantity": {
            "amount": 2.0000,
            "unit": "ks"
          },
          "referenceReceiptId": null,
          "vatRate": 19.00,
          "specialRegulation": null,
          "voucherNumber": null,
          "seller": null,
          "description": null
        },
        {
          "type": "Positive",
          "name": "Pohľadnica Bratislava",
          "price": 1.76,
          "unitPrice": 0.880000,
          "quantity": {
            "amount": 2.0000,
            "unit": "ks"
          },
          "referenceReceiptId": null,
          "vatRate": 23.00,
          "specialRegulation": null,
          "voucherNumber": null,
          "seller": null,
          "description": null
        },
        {
          "type": "Positive",
          "name": "Záloha PET",
          "price": 0.30,
          "unitPrice": 0.150000,
          "quantity": {
            "amount": 2.0000,
            "unit": "ks"
          },
          "referenceReceiptId": null,
          "vatRate": null,
          "specialRegulation": null,
          "voucherNumber": null,
          "seller": null,
          "description": null
        },
        {
          "type": "ReturnedContainer",
          "name": "Vrátenie zálohy PET",
          "price": -0.45,
          "unitPrice": -0.150000,
          "quantity": {
            "amount": 3.0000,
            "unit": "ks"
          },
          "referenceReceiptId": null,
          "vatRate": null,
          "specialRegulation": null,
          "voucherNumber": null,
          "seller": null,
          "description": null
        }
      ],
      "vatRatesTaxSummary": {
        "totalVatBase": 12.00,
        "totalVatAmout": 1.81,
        "totalTaxableAmount": 13.81,
        "totalNonTaxableAmount": -0.15,
        "totalAmount": 13.66,
        "items": [
          {
            "vatRate": 19.00,
            "vatBase": 6.76,
            "vatAmount": 1.29,
            "totalAmount": 8.05
          },
          {
            "vatRate": 5.00,
            "vatBase": 3.81,
            "vatAmount": 0.19,
            "totalAmount": 4.00
          },
          {
            "vatRate": 23.00,
            "vatBase": 1.43,
            "vatAmount": 0.33,
            "totalAmount": 1.76
          },
          {
            "vatRate": null,
            "vatBase": -0.15,
            "vatAmount": 0.00,
            "totalAmount": -0.15
          }
        ]
      },
      "okp": "C1E7A53E-6D1D48B0-801EE45D-6B67BF63-6C2AA5CF",
      "pkp": "bRkmkbk9S/Kn9sylBgRQphmLLU/o+7gcao0q5TXJyb/ZHnQ27oVOERwQqUKqZeR0Q9J5j35fv1ucBn/TmT85yUfdmZ5a2c3rOdoB/h+z8YT+LFC0+5QCh9bbKkWu9TdXKMdPU4Exkl8bLY8rqpP80Ay/Uz/ACx7jEqdE5lPjIQoijyeYDEPkIWyAtr8vCql07x0c2oCP3fs0i1hcUz18uKcnYxpC08+60hpP1Rmj8FfAfd3S2Xqxo9W3Yn87lCs6n3LcbrNQbXLrHbCfKDuJa7yUyLY0Vh9i1zn5lFQBop9mWRyI+KUCYbWIQzBjIWUtJuz0fo/ofpHLhH54vyT9gQ==",
      "payments": [
        {
          "name": "Hotovosť",
          "amount": 20.00
        },
        {
          "name": "Výdavok",
          "amount": -6.35
        }
      ],
      "headerText": "https://ekasa.ninedigit.sk",
      "footerText": "Ďakujeme za nákup!",
      "createDate": "2026-11-19T02:08:43+01:00",
      "dic": "1234567890",
      "cashRegisterCode": "88812345678900001"
    },
    "id": "9dc3e9ed-695c-4885-b96f-1ff8fa038a85",
    "externalId": null,
    "date": "2026-11-19T02:08:43+01:00",
    "sendingCount": 1
  },
  "response": {
    "data": {
      "id": "O-488AE60F5DDC432E8AE60F5DDC7-TEST"
    },
    "processDate": "2026-11-19T02:08:43+01:00"
  },
  "isSuccessful": true,
  "error": null,
  "$type": "Receipt"
}
```

The receipt registration response also contains summary information by VAT category (standard vs. reduced). When
several rates of the same category are combined (for example 23 % and 20 % on receipts from the transition period,
both standard rates), these can lead to **ambiguous results**. To get financial figures on VAT turnover, do not use
these properties and use the `vatRatesTaxSummary` property ([VAT summary](#vat-summary)) instead. These properties
may be removed in future versions.

| Property | Content | In the example |
|---|---|---|
| `basicVatAmount` | VAT at the standard rate (23 %) | `0.33` |
| `taxBaseBasic` | tax base at the standard rate (23 %) | `1.43` |
| `reducedVatAmount` | VAT at the reduced rate (19 %) | `1.29` |
| `taxBaseReduced` | tax base at the reduced rate (19 %) | `6.76` |
| `secondReducedVatAmount` | VAT at the second reduced rate (5 %) | `0.19` |
| `taxBaseSecondReduced` | tax base at the second reduced rate (5 %) | `3.81` |
| `taxFreeAmount` | VAT-exempt amount | `null` |
| `nonTaxableAmount` | amount of items not subject to VAT | `-0.15` |

## Getting the receipt number

The receipt number is in the `request.data.receiptNumber` field. It is unique within a calendar month and forms a
continuous number sequence shared by all types of cash register receipts.

## Getting the unique receipt identifier

Keep the unique receipt identifier in the parent application in case the receipt needs to be cancelled later, or
when goods are returned (complaint, …). Where you find it depends on the mode in which the request was handled:

| Mode | `isSuccessful` | Identifier | Field |
|---|---|---|---|
| online | `true` | unique receipt identifier assigned by the eKasa system | `response.data.id` |
| offline | `null` | the eKasa system identifier is not available; the business verification code (OKP) is used instead | `request.data.okp` |

When [correcting a receipt](https://ekasa.ninedigit.sk/en/docs/receipt-registration/corrections), put one of these two identifiers in the
`referenceReceiptId` field of the receipt item.

You can verify a receipt from the integration environment on the Financial Administration page, see
[Setup and test](https://ekasa.ninedigit.sk/en/docs/environment-setup#3-send-your-first-receipt).

## VAT summary

From version `7.0.0`, the response also contains the `request.data.vatRatesTaxSummary` property: summary information
split by VAT rate (the VAT summary). It is also available for receipts created by older versions of the application
(before the update to version `7.0.0`). When the receipt has no items (the `items` property is `null`),
`vatRatesTaxSummary` is also `null`.

| Property | Meaning | Example |
|---|---|---|
| `totalVatBase` | Total tax base of items subject to VAT | `12.00` |
| `totalVatAmout` | Total tax amount (the property name really is spelled this way) | `1.81` |
| `totalTaxableAmount` | Total amount of items subject to VAT | `13.81` |
| `totalNonTaxableAmount` | Total amount of items not subject to VAT | `-0.15` |
| `totalAmount` | Total amount of all items | `13.66` |
| `items` | List of summary information by VAT rate. It contains the VAT rates (or items not subject to VAT) that appear in the receipt's item list (the `items` property). | |

Each element of the `items` list:

| Property | Meaning | Example |
|---|---|---|
| `vatRate` | The VAT rate (`23.00` means 23 %), or `null` for items not subject to VAT (for example selling or returning returnable packaging) | `23.00` |
| `vatBase` | The total tax base for the VAT rate | `1.43` |
| `vatAmount` | The VAT amount for the VAT rate | `0.33` |
| `totalAmount` | The total turnover for the VAT rate | `1.76` |

For each element (including the summary for items not subject to VAT, that is `vatRate` is `null`):

$$
\text{vatBase} + \text{vatAmount} = \text{totalAmount}
$$

### Example

The VAT summary from the [example above](#example-request-and-response). On the printed receipt it corresponds to
the **Sadzba – Základ – Daň – Obrat** (rate, base, tax, turnover) table.

```json
{
"totalVatBase": 12.00,
"totalVatAmout": 1.81,
"totalTaxableAmount": 13.81,
"totalNonTaxableAmount": -0.15,
"totalAmount": 13.66,
"items": [
  {
    "vatRate": 19.00,
    "vatBase": 6.76,
    "vatAmount": 1.29,
    "totalAmount": 8.05
  },
  {
    "vatRate": 5.00,
    "vatBase": 3.81,
    "vatAmount": 0.19,
    "totalAmount": 4.00
  },
  {
    "vatRate": 23.00,
    "vatBase": 1.43,
    "vatAmount": 0.33,
    "totalAmount": 1.76
  },
  {
    "vatRate": null,
    "vatBase": -0.15,
    "vatAmount": 0.00,
    "totalAmount": -0.15
  }
]
}
```

## Where next

- [Cancellations and returns](https://ekasa.ninedigit.sk/en/docs/receipt-registration/corrections): Correcting a receipt, returning goods and invoice payments.
- [System status check](https://ekasa.ninedigit.sk/en/docs/status): Queue of unsent messages, storage and printer.
- [Receipt lookup](https://ekasa.ninedigit.sk/en/docs/receipt-lookup): Receipts by number, identifier or externalId.
