Payments and rounding

Integrating via

Payments (payments) say how the customer paid: in cash, by payment card, with meal vouchers or a combination of them. The list of payments is optional and is not sent to the Financial Administration servers.

When paying in cash, the amount is rounded to 5 cents to limit the use of 1 and 2 cent coins. You state the rounding in the roundingAmount property.

Payments (payments)

Your software does not have to fill in the list of payments. If it does list payments:

Rule Value
total of payments equal to or greater than the total amount of the receipt, which is the sum of the items (items) and the rounding (roundingAmount)
number of payments at most 500

Each payment consists of a pair of properties:

Property Required Values
name yes name (text description) of the payment method, 1 to 255 characters
amount yes amount of money paid, with a precision of 2 decimal places

Example: in a café, the customer buys 2 × cappuccino and a cheesecake for 9.30 € and pays 10.00 € in cash. The 0.70 € given back is a second payment with a negative amount.

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

{
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "positive",
          "name": "Cappuccino",
          "quantity": {
            "amount": 2,
            "unit": "ks"
          },
          "unitPrice": 2.90,
          "price": 5.80,
          "vatRate": 19
        },
        {
          "type": "positive",
          "name": "Cheesecake",
          "quantity": {
            "amount": 1,
            "unit": "ks"
          },
          "unitPrice": 3.50,
          "price": 3.50,
          "vatRate": 5
        }
      ],
      "payments": [
        {
          "name": "Hotovosť",
          "amount": 10.00
        },
        {
          "name": "Hotovosť",
          "amount": -0.70
        }
      ]
    }
  }
}
var items = new ReceiptItems
{
    new ReceiptItem(ReceiptItemType.Positive, "Cappuccino", 2.90m, new Quantity(2, "ks"), 19m),
    new ReceiptItem(ReceiptItemType.Positive, "Cheesecake", 3.50m, new Quantity(1, "ks"), 5m)
};

var receipt = new CashRegisterReceipt("88812345678900001", items)
{
    Payments = new ReceiptPayments
    {
        new ReceiptPayment("Hotovosť", 10.00m),
        new ReceiptPayment("Hotovosť", -0.70m)
    }
};

RegisterReceiptResult result = await client.RegisterReceiptAsync(
    new RegisterCashRegisterReceiptRequest(receipt),
    RegisterReceiptPrintContext.CreatePos(),
    cancellationToken);

Rounding

From 1. 7. 2022, an amendment to the Slovak Act on Prices introduced mandatory rounding to limit the use of 1 and 2 euro cent coins. A price paid in cash is rounded to 5 euro cents:

  • a remainder lower than half of 5 euro cents is rounded down,
  • a remainder equal to or higher than half of 5 euro cents is rounded up,
  • a cash price of 1 or 2 euro cents is rounded to 5 euro cents.

By the last digit of the cash amount, this means:

Last digit Rounded roundingAmount
0, 5 not rounded 0
1, 2 down to 0 -0.01, -0.02
3, 4 up to 5 0.02, 0.01
6, 7 down to 5 -0.01, -0.02
8, 9 up to 0 0.02, 0.01
whole amount 0.01 € or 0.02 € up to 0.05 € 0.04, 0.03
  • Only the amount paid in cash is rounded. The part of the receipt paid by non-cash means (payment card, meal vouchers, etc.) is not rounded.
  • VAT is calculated from the amount before rounding. Rounding a cash payment therefore does not affect the VAT calculated on the purchase.

How to determine roundingAmount when the customer pays all or part of the amount in cash:

  1. Add up the items This gives you the unrounded purchase price.
  2. Subtract the non-cash payments Payment card, meal vouchers and so on. The rest is the price paid in cash.
  3. Round the cash price to 5 cents The difference between the rounded and the unrounded price is roundingAmount.

The roundingAmount property

Property Required Values Default
roundingAmount no a number from -0.04 to 0.04 with a precision of 2 decimal places 0

All receipt types that eKasa records have this property. The total amount of the receipt depends on the receipt type:

Receipt type Identifier roundingAmount Total amount of the receipt
Cash register receipt CashRegister yes sum of the items (items) + roundingAmount
Paragon Paragon yes sum of the items (items) + roundingAmount
Invoice (invoice payment) Invoice yes, from version 5.24 amount + roundingAmount
Paragon for an invoice payment InvoiceParagon yes, from version 5.24 amount + roundingAmount

For an invoice payment, the amount field holds the amount paid before rounding, and eKasa adds roundingAmount to it.

Examples

Example 1: payment in cash

The customer pays for an espresso and a croissant, 3.28 € in total, in cash, so the amount is rounded: you add rounding (roundingAmount) of 0.02 € to 3.28 €, and the resulting total is 3.30 €. VAT is calculated from 3.28 €.

Receipt: Espresso 1.99 €, Croissant 1.29 €, rounding (Zaokrúhlenie) +0.02, total 3.30 EUR, cash (Hotovosť) 3.30, turnover at 19 % 1.99 and at 5 % 1.29; rounding line highlighted

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "positive",
          "name": "Espresso",
          "quantity": {
            "amount": 1,
            "unit": "ks"
          },
          "unitPrice": 1.99,
          "price": 1.99,
          "vatRate": 19
        },
        {
          "type": "positive",
          "name": "Croissant",
          "quantity": {
            "amount": 1,
            "unit": "ks"
          },
          "unitPrice": 1.29,
          "price": 1.29,
          "vatRate": 5
        }
      ],
      "roundingAmount": 0.02,
      "payments": [
        {
          "name": "Hotovosť",
          "amount": 3.30
        }
      ]
    }
  }
}

Example 2: non-cash payment

If the customer pays the whole purchase by non-cash means, the price is not rounded: roundingAmount is 0.

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

{
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "positive",
          "name": "Espresso",
          "quantity": {
            "amount": 1,
            "unit": "ks"
          },
          "unitPrice": 1.99,
          "price": 1.99,
          "vatRate": 19
        },
        {
          "type": "positive",
          "name": "Croissant",
          "quantity": {
            "amount": 1,
            "unit": "ks"
          },
          "unitPrice": 1.29,
          "price": 1.29,
          "vatRate": 5
        }
      ],
      "roundingAmount": 0,
      "payments": [
        {
          "name": "Karta",
          "amount": 3.28
        }
      ]
    }
  }
}

Example 3: payment with a combination of payment methods

If the purchase is paid with a combination of cash and other payment methods, only the cash part is rounded.

A grocery purchase costs 15.53 €. The customer wants to pay with two meal vouchers worth 6.00 € each, 12.00 € in total, and pay the rest in cash. Meal vouchers are not cash, so their value is subtracted from the unrounded purchase price:

Amount
purchase price before rounding 15.53 €
meal vouchers −12.00 €
remainder paid in cash 3.53 €
cash after rounding (mathematically up), paid by the customer 3.55 €
roundingAmount 0.02 €
total price after rounding 15.55 €

Receipt: Rožok, Mlieko polotučné, Čaj ovocný and Káva mletá 15.53 € in total, rounding (Zaokrúhlenie) +0.02, total 15.55 EUR, meal vouchers (Stravné lístky) 12.00, cash (Hotovosť) 3.55; rounding and payments highlighted

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "positive",
          "name": "Rožok",
          "quantity": {
            "amount": 4,
            "unit": "ks"
          },
          "unitPrice": 0.12,
          "price": 0.48,
          "vatRate": 5
        },
        {
          "type": "positive",
          "name": "Mlieko polotučné 1 l",
          "quantity": {
            "amount": 3,
            "unit": "ks"
          },
          "unitPrice": 1.09,
          "price": 3.27,
          "vatRate": 5
        },
        {
          "type": "positive",
          "name": "Čaj ovocný 20 × 2 g",
          "quantity": {
            "amount": 1,
            "unit": "ks"
          },
          "unitPrice": 2.79,
          "price": 2.79,
          "vatRate": 19
        },
        {
          "type": "positive",
          "name": "Káva mletá 500 g",
          "quantity": {
            "amount": 1,
            "unit": "ks"
          },
          "unitPrice": 8.99,
          "price": 8.99,
          "vatRate": 19
        }
      ],
      "roundingAmount": 0.02,
      "payments": [
        {
          "name": "Stravné lístky",
          "amount": 12.00
        },
        {
          "name": "Hotovosť",
          "amount": 3.55
        }
      ]
    }
  }
}

Response (shortened):

{
  "request": {
    "data": {
      "amount": 15.55,
      "roundingAmount": 0.02
    }
  }
}

Example 4: invoice paid in cash

The customer pays an invoice for 246.37 € in cash. The amount is rounded down to 246.35 €, so the rounding is −0.02 €. The amount field holds the invoice amount before rounding; the total amount of the receipt is 246.35 €.

POST {server_address}/api/v1/requests/receipts/invoice

{
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "invoiceNumber": "FA-2026-0142",
      "amount": 246.37,
      "roundingAmount": -0.02,
      "payments": [
        {
          "name": "Hotovosť",
          "amount": 246.35
        }
      ]
    }
  }
}

Rounding table

The price paid in cash before and after rounding:

Before rounding After rounding roundingAmount Note
0.01 € 0.05 € 0.04 a price up to and including 0.02 €, which would mathematically round to 0.00 €, is rounded up to 0.05 €
0.02 € 0.05 € 0.03 a price up to and including 0.02 €, which would mathematically round to 0.00 €, is rounded up to 0.05 €
0.03 € 0.05 € 0.02 mathematical rounding
0.04 € 0.05 € 0.01 mathematical rounding
0.05 € 0.05 € 0 not rounded
0.06 € 0.05 € -0.01 mathematical rounding
0.07 € 0.05 € -0.02 mathematical rounding
0.08 € 0.10 € 0.02 mathematical rounding
0.09 € 0.10 € 0.01 mathematical rounding
0.10 € 0.10 € 0 not rounded
0.11 € 0.10 € -0.01 mathematical rounding
0.12 € 0.10 € -0.02 mathematical rounding
0.13 € 0.15 € 0.02 mathematical rounding
0.14 € 0.15 € 0.01 mathematical rounding
0.15 € 0.15 € 0 not rounded
0.16 € 0.15 € -0.01 mathematical rounding
0.17 € 0.15 € -0.02 mathematical rounding
0.18 € 0.20 € 0.02 mathematical rounding
0.19 € 0.20 € 0.01 mathematical rounding
0.20 € 0.20 € 0 not rounded
… … … …

More information about rounding (in Slovak):

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.