# Storno a vrátenie

> Oprava zaevidovaného dokladu: storno, vrátenie tovaru, vrátenie úhrady faktúry a dobropis.

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

Zaevidovaný doklad sa nedá zmeniť ani zmazať. Chybu alebo vrátenie tovaru opravíte **novým dokladom**, ktorý sa
odvolá na pôvodný.

Oprava dokladu môže mať rôzne príčiny, a preto sa aj jej registrácia v systéme eKasa líši. Tento článok popisuje
situácie, ktoré pri opravách dokladov môžu nastať, a postup pre každú z nich.

## Ktorý postup použiť

| Situácia | Postup | Nový doklad | Typ položky |
|---|---|---|---|
| obsluha pokladnice vykonala omyl | [Storno dokladu](#storno-dokladu) | `cash_register` | `correction` |
| zákazník vracia zakúpený tovar | [Vrátenie tovaru](#vrátenie-tovaru) | `cash_register` | `returned` |
| zákazník uhradil faktúru v hotovosti a túto úhradu treba vrátiť | [Vrátenie úhrady faktúry](#vrátenie-úhrady-faktúry) | `cash_register` | `correction` |
| dobropisovanie faktúry uhradenej inak ako v hotovosti (napr. prevodom na účet) | [Dobropis faktúry](#dobropis-faktúry) | `invoice` so zápornou sumou | bez položiek |

Pri storne, vrátení tovaru aj vrátení úhrady faktúry sa každá opravná položka odvoláva na pôvodný doklad v poli
`referenceReceiptId`: uvediete v ňom unikátny identifikátor (alebo `OKP`) pôvodného dokladu. Kde ho nájdete, je
v článku [Výsledok registrácie](https://ekasa.ninedigit.sk/docs/receipt-registration/result).

## Storno dokladu

Ak treba opraviť už vyhotovený doklad (storno dokladu, vrátenie tovaru a podobne), zaregistrujete nový doklad.
Budú v ňom tie položky dokladu, ktoré majú byť opravené, s týmito rozdielmi:

| Pole položky | Hodnota v novom doklade |
|---|---|
| `type` | `correction` namiesto pôvodného typu |
| `unitPrice`, `price` | pôvodné ceny vynásobené `-1`, aby vznikol opačný obrat |
| `referenceReceiptId` | unikátny identifikátor (alebo `OKP`) pôvodného dokladu |

### Príklad

Pôvodný doklad: dve Coca Coly po 1,99 € s vernostnou zľavou 1 €, spolu 2,98 € v hotovosti. Storno doklad obsahuje
obe položky ako `correction` s opačnými cenami a odvolá sa na identifikátor pôvodného dokladu (`UID` na jeho spodku).

**Pôvodný doklad**

[Obrázok: Pôvodný doklad: Coca Cola 2 ks po 1,99 €, vernostná zľava −1,00 €, suma 2,98 € v hotovosti]

**Storno doklad**

[Obrázok: Storno doklad: Coca Cola −3,98 € a vernostná zľava 1,00 € s identifikátorom pôvodného dokladu, suma −2,98 €]

Pôvodný doklad:

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "positive",
          "name": "Coca Cola",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": 1.99,
          "price": 3.98,
          "vatRate": 23.00
        },
        {
          "type": "discount",
          "name": "Vernostná zľava",
          "quantity": {
            "amount": 1.00
          },
          "unitPrice": -1.00,
          "price": -1.00,
          "vatRate": 23.00
        }
      ],
      "payments": [
        {
          "name": "Hotovosť",
          "amount": 2.98
        }
      ]
    }
  }
}
```

Storno doklad:

**HTTP API:**

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "correction",
          "referenceReceiptId": "O-40198CCAA6D54C46998CCAA6D56-TEST",
          "name": "Coca Cola",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": -1.99,
          "price": -3.98,
          "vatRate": 23.00
        },
        {
          "type": "correction",
          "referenceReceiptId": "O-40198CCAA6D54C46998CCAA6D56-TEST",
          "name": "Vernostná zľava",
          "quantity": {
            "amount": 1.00
          },
          "unitPrice": 1.00,
          "price": 1.00,
          "vatRate": 23.00
        }
      ],
      "payments": [
        {
          "name": "Hotovosť",
          "amount": -2.98
        }
      ]
    }
  }
}
```

**.NET knižnica:**

```csharp
var original = "O-40198CCAA6D54C46998CCAA6D56-TEST";

var items = new ReceiptItems
{
    new ReceiptItem(ReceiptItemType.Correction, "Coca Cola", -1.99m, new Quantity(2, "ks"), 23m,
        referenceReceiptId: original),
    new ReceiptItem(ReceiptItemType.Correction, "Vernostná zľava", 1.00m, 1, 23m,
        referenceReceiptId: original)
};

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

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

## Vrátenie tovaru

Ak zákazník vráti zakúpený tovar, zaregistrujete nový doklad s tými položkami dokladu, ktoré sú vrátené:

| Pole položky | Hodnota v novom doklade |
|---|---|
| `type` | `returned` namiesto pôvodného typu |
| `quantity.amount` | počet vrátených jednotiek, kladné číslo |
| `unitPrice`, `price` | záporné, ako v príkladoch nižšie |
| `referenceReceiptId` | unikátny identifikátor (alebo `OKP`) pôvodného dokladu |

Ak sa na položku vzťahuje zľava, máte dve možnosti:

| Možnosť | Ako | Príklad |
|---|---|---|
| spojiť položku so zľavou | pôvodnú kladnú položku a prislúchajúcu zľavu vrátite ako jednu položku `returned`, ktorej celková suma sa rovná súčtu ceny kladnej položky a výšky prislúchajúcej zľavy | [Príklad č.1](#príklad-č1) |
| vrátiť zľavu samostatne | položku zľavy zaregistrujete ako kladnú položku (`positive`) | [Príklad č.2](#príklad-č2) |

V oboch príkladoch zákazník vracia tovar z rovnakého pôvodného dokladu ako pri [storne](#príklad): dve Coca Coly
po 1,99 € s vernostnou zľavou 1 €, spolu 2,98 € v hotovosti.

### Príklad č.1

Coca Cola a zľava v jednej vrátenej položke: 2 ks po −1,49 €, spolu −2,98 € (−3,98 € + 1,00 €).

**Pôvodný doklad**

[Obrázok: Pôvodný doklad: Coca Cola 2 ks po 1,99 €, vernostná zľava −1,00 €, suma 2,98 € v hotovosti]

**Doklad s vrátením tovaru**

[Obrázok: Doklad s vrátením tovaru: Coca Cola −2 ks po 1,49 €, suma −2,98 €, s identifikátorom pôvodného dokladu]

**HTTP API:**

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "returned",
          "referenceReceiptId": "O-40198CCAA6D54C46998CCAA6D56-TEST",
          "name": "Coca Cola",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": -1.49,
          "price": -2.98,
          "vatRate": 23.00
        }
      ],
      "payments": [
        {
          "name": "Hotovosť",
          "amount": -2.98
        }
      ]
    }
  }
}
```

**.NET knižnica:**

```csharp
var items = new ReceiptItems
{
    new ReceiptItem(ReceiptItemType.Returned, "Coca Cola", -1.49m, new Quantity(2, "ks"), 23m,
        referenceReceiptId: "O-40198CCAA6D54C46998CCAA6D56-TEST")
};
```

Doklad zaregistrujete rovnako ako pri [storne](#príklad), s platbou `new ReceiptPayment("Hotovosť", -2.98m)`.

### Príklad č.2

Coca Cola ako vrátená položka za pôvodnú cenu a vernostná zľava vrátená ako kladná položka „Vrátenie zľavy“.
Podrobnosti o sadzbách DPH pri vrátení zľavy sú v článku [Položky dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration/items).

**Pôvodný doklad**

[Obrázok: Pôvodný doklad: Coca Cola 2 ks po 1,99 €, vernostná zľava −1,00 €, suma 2,98 € v hotovosti]

**Doklad s vrátením tovaru**

[Obrázok: Doklad s vrátením tovaru: Coca Cola −3,98 € s identifikátorom pôvodného dokladu a vrátenie zľavy 1,00 €, suma −2,98 €]

**HTTP API:**

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "returned",
          "referenceReceiptId": "O-40198CCAA6D54C46998CCAA6D56-TEST",
          "name": "Coca Cola",
          "quantity": {
            "amount": 2.00,
            "unit": "ks"
          },
          "unitPrice": -1.99,
          "price": -3.98,
          "vatRate": 23.00
        },
        {
          "type": "positive",
          "name": "Vrátenie zľavy",
          "quantity": {
            "amount": 1.00
          },
          "unitPrice": 1.00,
          "price": 1.00,
          "vatRate": 23.00
        }
      ],
      "payments": [
        {
          "name": "Hotovosť",
          "amount": -2.98
        }
      ]
    }
  }
}
```

**.NET knižnica:**

```csharp
var items = new ReceiptItems
{
    new ReceiptItem(ReceiptItemType.Returned, "Coca Cola", -1.99m, new Quantity(2, "ks"), 23m,
        referenceReceiptId: "O-40198CCAA6D54C46998CCAA6D56-TEST"),
    new ReceiptItem(ReceiptItemType.Positive, "Vrátenie zľavy", 1.00m, 1, 23m)
};
```

Doklad zaregistrujete rovnako ako pri [storne](#príklad), s platbou `new ReceiptPayment("Hotovosť", -2.98m)`.

## Vrátenie úhrady faktúry

Hotovostnú úhradu faktúry zaregistrovanú cez systém eKasa dokladom typu `invoice` vrátite podobne ako tovar:
vytvoríte pokladničný doklad (typ `cash_register`) s touto položkou:

| Pole položky | Hodnota |
|---|---|
| `type` | `correction` |
| `unitPrice`, `price` | záporná suma pôvodnej hotovostnej úhrady faktúry |
| `referenceReceiptId` | identifikátor pôvodného dokladu, teda úhrady faktúry |
| `name` | napríklad „Vrátenie úhrady faktúry číslo …“ |

**Hotovostná úhrada faktúry**

[Obrázok: Doklad úhrady faktúry FA-0001 na 189,90 €]

**Vrátenie úhrady faktúry**

[Obrázok: Doklad s položkou Vrátenie úhrady faktúry číslo FA-0001 −189,90 € s identifikátorom úhrady faktúry]

Hotovostná úhrada faktúry:

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "invoiceNumber": "FA-0001",
      "amount": 189.90
    }
  }
}
```

Vrátenie hotovostnej úhrady faktúry:

**HTTP API:**

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "items": [
        {
          "type": "correction",
          "referenceReceiptId": "O-69EAABF5BE2B465BAAABF5BE2BC-TEST",
          "name": "Vrátenie úhrady faktúry číslo FA-0001",
          "quantity": {
            "amount": 1.00,
            "unit": "ks"
          },
          "unitPrice": -189.90,
          "price": -189.90,
          "vatRate": 0.00
        }
      ],
      "payments": [
        {
          "name": "Hotovosť",
          "amount": -189.90
        }
      ]
    }
  }
}
```

**.NET knižnica:**

```csharp
var items = new ReceiptItems
{
    new ReceiptItem(ReceiptItemType.Correction, "Vrátenie úhrady faktúry číslo FA-0001",
        -189.90m, new Quantity(1, "ks"), 0m,
        referenceReceiptId: "O-69EAABF5BE2B465BAAABF5BE2BC-TEST")
};

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

## Dobropis faktúry

Faktúru, ktorá nebola uhradená cez systém eKasa, a teda k nej neexistuje pokladničný doklad úhrady faktúry
s unikátnym identifikátorom, dobropisujete ako hotovostnú úhradu faktúry (doklad typu `invoice`) so záporným
znamienkom.

[Obrázok: Doklad úhrady faktúry FA-0001 so sumou −189,90 €]

**HTTP API:**

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "invoiceNumber": "FA-0001",
      "amount": -189.90
    }
  }
}
```

**.NET knižnica:**

```csharp
var creditNote = new InvoiceReceipt("88812345678900001", "FA-0001", -189.90m);

RegisterReceiptResult result = await client.RegisterReceiptAsync(
    new RegisterInvoiceReceiptRequest(creditNote),
    RegisterReceiptPrintContext.CreatePos(),
    cancellationToken);
```

## Kam ďalej

- [Položky dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration/items): Typy položiek a odkaz na pôvodný doklad.
- [Zľavy](https://ekasa.ninedigit.sk/docs/receipt-registration/discounts): Zľava na položku a na celý doklad.
- [Výsledok registrácie](https://ekasa.ninedigit.sk/docs/receipt-registration/result): Identifikátor dokladu, na ktorý sa oprava odvoláva.
