Storno a vrátenie

Integrujem cez

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 cash_register correction
zákazník vracia zakúpený tovar 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 cash_register correction
dobropisovanie faktúry uhradenej inak ako v hotovosti (napr. prevodom na účet) 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.

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

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

Storno doklad

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:

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:

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
        }
      ]
    }
  }
}
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
vrátiť zľavu samostatne položku zľavy zaregistrujete ako kladnú položku (positive) Príklad č.2

V oboch príkladoch zákazník vracia tovar z rovnakého pôvodného dokladu ako pri storne: 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

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

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

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

Pôvodný doklad

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

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 €

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

Doklad úhrady faktúry FA-0001 na 189,90 €

Vrátenie úhrady faktúry

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

Hotovostná úhrada faktúry:

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:

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

Doklad úhrady faktúry FA-0001 so sumou −189,90 €

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

{
  "print": {
    "printerName": "pdf"
  },
  "request": {
    "data": {
      "cashRegisterCode": "88812345678900001",
      "invoiceNumber": "FA-0001",
      "amount": -189.90
    }
  }
}
var creditNote = new InvoiceReceipt("88812345678900001", "FA-0001", -189.90m);

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

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.