Platby a zaokrúhľovanie

Integrujem cez

Platby (payments) hovoria, čím zákazník zaplatil: hotovosťou, platobnou kartou, stravnými lístkami alebo ich kombináciou. Zoznam platieb je nepovinný a na servery finančnej správy sa neodosiela.

Pri platbe v hotovosti sa suma zaokrúhľuje na 5 centov, aby sa obmedzilo používanie 1- a 2-centových mincí. Zaokrúhlenie uvádzate vo vlastnosti roundingAmount.

Platby (payments)

Váš softvér zoznam platieb vypĺňať nemusí. Ak platby uvedie, platí:

Pravidlo Hodnota
súčet platieb rovný alebo vyšší ako celková suma dokladu, teda súčet položiek (items) a zaokrúhlenia (roundingAmount)
počet platieb najviac 500

Každá platba sa skladá z dvojice vlastností:

Vlastnosť Povinná Hodnoty
name áno názov (slovný popis) platidla, 1 až 255 znakov
amount áno peňažný obnos platby s presnosťou na 2 desatinné miesta

Príklad: zákazník v kaviarni kúpi 2 × cappuccino a cheesecake za 9,30 € a zaplatí 10,00 € v hotovosti. Vydaných 0,70 € je druhá platba so zápornou sumou.

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

Zaokrúhľovanie

Od 1. 7. 2022 platí zmena zákona o cenách, ktorá priniesla povinné zaokrúhľovanie s cieľom obmedziť používanie 1- a 2-eurocentových mincí. Cena platená v hotovosti sa zaokrúhľuje na 5 eurocentov:

  • zvyšok nižší ako polovica z 5 eurocentov sa zaokrúhľuje nadol,
  • zvyšok rovný alebo vyšší ako polovica z 5 eurocentov sa zaokrúhľuje nahor,
  • cena v hotovosti 1 alebo 2 eurocenty sa zaokrúhľuje na 5 eurocentov.

Podľa poslednej číslice sumy v hotovosti to znamená:

Posledná číslica Zaokrúhli sa roundingAmount
0, 5 nezaokrúhľuje sa 0
1, 2 nadol na 0 -0.01, -0.02
3, 4 nahor na 5 0.02, 0.01
6, 7 nadol na 5 -0.01, -0.02
8, 9 nahor na 0 0.02, 0.01
celá suma 0,01 € alebo 0,02 € nahor na 0,05 € 0.04, 0.03
  • Zaokrúhľuje sa iba čiastka platená v hotovosti. Časť dokladu hradená bezhotovostne (platobnou kartou, stravnými lístkami atď.) sa nezaokrúhľuje.
  • DPH sa vypočíta zo sumy pred zaokrúhlením. Zaokrúhľovanie pri platbe v hotovosti tak nemá vplyv na výpočet DPH z nákupu tovaru.

Ako určiť roundingAmount, keď zákazník platí v hotovosti celú sumu alebo jej časť:

  1. Sčítajte položky Dostanete nezaokrúhlenú cenu nákupu.
  2. Odpočítajte bezhotovostné platby Platobná karta, stravné lístky a pod. Zvyšok je cena platená v hotovosti.
  3. Zaokrúhlite cenu v hotovosti na 5 centov Rozdiel medzi zaokrúhlenou a nezaokrúhlenou cenou je roundingAmount.

Vlastnosť roundingAmount

Vlastnosť Povinná Hodnoty Predvolená
roundingAmount nie číslo od -0.04 do 0.04 s presnosťou na 2 desatinné miesta 0

Vlastnosť majú všetky typy dokladov, ktoré eKasa eviduje. Celková suma dokladu sa počíta podľa typu dokladu:

Typ dokladu Identifikátor roundingAmount Celková suma dokladu
Pokladničný doklad CashRegister áno súčet položiek (items) + roundingAmount
Paragón Paragon áno súčet položiek (items) + roundingAmount
Faktúra (úhrada faktúry) Invoice áno, od verzie 5.24 amount + roundingAmount
Paragón pri úhrade faktúry InvoiceParagon áno, od verzie 5.24 amount + roundingAmount

Pri úhrade faktúry uvádzate v poli amount uhrádzanú sumu pred zaokrúhlením a eKasa k nej pripočíta roundingAmount.

Príklady

Príklad 1: úhrada v hotovosti

Espresso a croissant za 3,28 € zákazník platí v hotovosti, suma sa preto zaokrúhli: k 3,28 € doplníte zaokrúhlenie roundingAmount 0,02 €, výsledná suma účtu je 3,30 €. DPH sa počíta z 3,28 €.

Doklad: Espresso 1,99 €, Croissant 1,29 €, zaokrúhlenie +0,02, suma 3,30 EUR, hotovosť 3,30, obrat v sadzbe 19 % 1,99 a v sadzbe 5 % 1,29; zvýraznený je riadok zaokrúhlenia

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

Príklad 2: úhrada bezhotovostne

Ak zákazník zaplatí celý nákup bezhotovostne, cena sa nezaokrúhľuje: roundingAmount je 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
        }
      ]
    }
  }
}

Príklad 3: úhrada kombináciou platidiel

Pri kombinácii hotovosti a iných platidiel sa zaokrúhľuje iba cena hradená v hotovosti.

Nákup v potravinách stojí 15,53 €. Kupujúci chce zaplatiť dvomi stravnými lístkami po 6,00 €, spolu 12,00 €, a zvyšok doplatiť v hotovosti. Stravné lístky nie sú hotovosť, ich hodnota sa odpočíta z nezaokrúhlenej ceny nákupu:

Suma
cena nákupu pred zaokrúhlením 15,53 €
stravné lístky −12,00 €
zvyšok platený v hotovosti 3,53 €
hotovosť po zaokrúhlení (matematicky nahor), kupujúci doplatí 3,55 €
roundingAmount 0,02 €
výsledná cena nákupu po zaokrúhlení 15,55 €

Doklad: Rožok, Mlieko polotučné, Čaj ovocný a Káva mletá spolu 15,53 €, zaokrúhlenie +0,02, suma 15,55 EUR, stravné lístky 12,00, hotovosť 3,55; zvýraznené sú zaokrúhlenie a platby

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

Odpoveď (skrátená):

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

Príklad 4: úhrada faktúry v hotovosti

Zákazník platí v hotovosti faktúru na 246,37 €. Suma sa zaokrúhli nadol na 246,35 €, zaokrúhlenie je −0,02 €. V poli amount je suma faktúry pred zaokrúhlením, celková suma dokladu bude 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
        }
      ]
    }
  }
}

Tabuľka zaokrúhľovania

Platená cena v hotovosti pred zaokrúhlením a po ňom:

Pred zaokrúhlením Po zaokrúhlení roundingAmount Poznámka
0,01 € 0,05 € 0.04 cena do 0,02 € vrátane, ktorá by sa matematicky zaokrúhlila na 0,00 €, sa zaokrúhli nahor na 0,05 €
0,02 € 0,05 € 0.03 cena do 0,02 € vrátane, ktorá by sa matematicky zaokrúhlila na 0,00 €, sa zaokrúhli nahor na 0,05 €
0,03 € 0,05 € 0.02 matematické zaokrúhlenie
0,04 € 0,05 € 0.01 matematické zaokrúhlenie
0,05 € 0,05 € 0 nezaokrúhľuje sa
0,06 € 0,05 € -0.01 matematické zaokrúhlenie
0,07 € 0,05 € -0.02 matematické zaokrúhlenie
0,08 € 0,10 € 0.02 matematické zaokrúhlenie
0,09 € 0,10 € 0.01 matematické zaokrúhlenie
0,10 € 0,10 € 0 nezaokrúhľuje sa
0,11 € 0,10 € -0.01 matematické zaokrúhlenie
0,12 € 0,10 € -0.02 matematické zaokrúhlenie
0,13 € 0,15 € 0.02 matematické zaokrúhlenie
0,14 € 0,15 € 0.01 matematické zaokrúhlenie
0,15 € 0,15 € 0 nezaokrúhľuje sa
0,16 € 0,15 € -0.01 matematické zaokrúhlenie
0,17 € 0,15 € -0.02 matematické zaokrúhlenie
0,18 € 0,20 € 0.02 matematické zaokrúhlenie
0,19 € 0,20 € 0.01 matematické zaokrúhlenie
0,20 € 0,20 € 0 nezaokrúhľuje sa
… … … …

Viac informácií o zaokrúhľovaní:

Kam ďalej

Esc

↑↓ výberEnter otvoriťEsc zavrieť

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.