Registration result

Integrating via

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:

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

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

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

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

Where next

Esc

↑↓ selectEnter openEsc close

Chýba vám niečo v dokumentácii?

Napíšte nám, s čím potrebujete pomôcť. Ozveme sa do pár hodín.

Údaje použijeme len na odpoveď. Viac v ochrane osobných údajov.