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: the externalId
prevents recording a sale twice when the response is lost.
What the result contains
The API returns the result in the body of the receipt registration response.
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. | 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:
{
"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:
{
"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:
{
"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
| Data | Property | Details |
|---|---|---|
| Receipt number | request.data.receiptNumber |
Getting the receipt number |
| Unique identifier (online) | response.data.id |
Getting the unique identifier |
| Business verification code (offline) | request.data.okp |
Getting the unique identifier |
| VAT summary | request.data.vatRatesTaxSummary |
VAT summary |
| Error from the eKasa system | error.code, error.message |
Three possible outcomes |
| Data | Property | Details |
|---|---|---|
| Receipt number | result.Request.Data.ReceiptNumber |
Getting the receipt number |
| Unique identifier (online) | result.Response.Data.Id |
Getting the unique identifier |
| Business verification code (offline) | result.Request.Data.OKP |
Getting the unique identifier |
| VAT summary | VatRatesTaxSummary.Create(result.Request.Data.Items) |
VAT summary |
| Error from the eKasa system | result.Error.Code, result.Error.Message |
Three possible outcomes |
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:

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:
{
"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
{
"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) 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, 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.
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):
Example
The VAT summary from the example above. On the printed receipt it corresponds to the Sadzba – Základ – Daň – Obrat (rate, base, tax, turnover) table.
{
"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
}
]
}