# Platby a zaokrúhľovanie

> Zoznam platieb na doklade, názvy platidiel a zaokrúhľovanie sumy pri platbe v hotovosti.

Zdroj: https://ekasa.ninedigit.sk/docs/receipt-registration/payments

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](#platby-payments): Názov platidla, suma a pravidlá pre zoznam platieb.
- [Zaokrúhľovanie](#zaokrúhľovanie): Pravidlo zaokrúhľovania a vlastnosť roundingAmount.
- [Príklady](#príklady): Hotovosť, karta, kombinácia platidiel a úhrada faktúry.
- [Tabuľka zaokrúhľovania](#tabuľka-zaokrúhľovania): Suma pred a po zaokrúhlení, cent po cente.

## 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.

**HTTP API:**

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

**.NET knižnica:**

```csharp
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 €.

[Obrázok: 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]

```http
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`.

```http
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 €** |

[Obrázok: 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]

```http
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á):

```json
{
  "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 €.

```http
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í:

- [Tlačová správa ministerstva financií](https://www.mfsr.sk/sk/media/tlacove-spravy/novela-zakona-cenach.html)
- [Návrh zákona](https://www.slov-lex.sk/legislativne-procesy/SK/LP/2021/14)

## Kam ďalej

- [Vyhotovenie dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration/printing): Papier, PDF alebo e-mail a vlastné texty.
- [Výsledok registrácie](https://ekasa.ninedigit.sk/docs/receipt-registration/result): Číslo dokladu, identifikátor a rekapitulácia DPH.
- [Zľavy](https://ekasa.ninedigit.sk/docs/receipt-registration/discounts): Zľava na položku a na celý doklad.
