Kópia a vyhľadanie dokladu

Integrujem cez

Zaevidovaný doklad môžete neskôr vyhľadať, napríklad keď sa odpoveď na registráciu stratila alebo potrebujete identifikátor dokladu pri vrátení tovaru, alebo vytlačiť jeho kópiu, keď zákazník pôvodný doklad stratil. Do systému eKasa sa pri tom nič neodosiela, eKasa doklad načíta z úložiska.

Doklad nájdete jedným z troch identifikátorov. Vždy uveďte aj kód pokladnice (cashRegisterCode).

Identifikátor Kde ho máte
číslo dokladu (rok, mesiac, poradové číslo) vytlačené na doklade, vo výsledku request.data.receiptNumber
externý identifikátor externalId váš vlastný, poslali ste ho pri registrácii
interný identifikátor id vo výsledku registrácie request.id

Podľa tých istých identifikátorov si stiahnete aj PDF súbor dokladu vyhotoveného ako pdf (Získanie PDF súboru).

Vyhľadanie dokladu

Vyhľadanie vráti uložený doklad s rovnakým výsledkom ako pri registrácii (pozri Výsledok registrácie). Ak doklad neexistuje, API vráti 404 Not Found a .NET knižnica null.

Vyhľadanie podľa čísla dokladu

Číslo dokladu je identifikované trojicou informácií: rokom, mesiacom a poradovým číslom v mesiaci.

GET {server_address}/api/v1/requests/receipts/receipt?cashRegisterCode=88812345678900001&year=2026&month=4&receiptNumber=83
var filter = new SingleReceiptRegistrationFilter(
    cashRegisterCode: "88812345678900001",
    receiptNumberId: new ReceiptNumberId(year: 2026, month: 4, number: 83u));

RegisterReceiptResult? receipt = await client.FindReceiptAsync(filter, cancellationToken);

Vyhľadanie podľa externého identifikátora

Externý identifikátor (externalId) uvádza nadradená aplikácia pri registrácii dokladu.

GET {server_address}/api/v1/requests/receipts/receipt?cashRegisterCode=88812345678900001&externalId=5cb23300ce3ccc2d38ccdbde
var filter = new SingleReceiptRegistrationFilter(
    cashRegisterCode: "88812345678900001",
    externalId: new ID("5cb23300ce3ccc2d38ccdbde"));

RegisterReceiptResult? receipt = await client.FindReceiptAsync(filter, cancellationToken);

Vyhľadanie podľa interného identifikátora

Interný identifikátor (id) generuje eKasa. Nejde o unikátny identifikátor dokladu (UID) zo systému eKasa.

GET {server_address}/api/v1/requests/receipts/receipt?cashRegisterCode=88812345678900001&id=2d419057-807c-41be-a5d6-aafea8eba13e
var filter = new SingleReceiptRegistrationFilter(
    cashRegisterCode: "88812345678900001",
    id: new Guid("2d419057-807c-41be-a5d6-aafea8eba13e"));

RegisterReceiptResult? receipt = await client.FindReceiptAsync(filter, cancellationToken);

Tlač kópie dokladu

Kópia sa vytlačí s označením „KÓPIA DOKLADU“ a bez unikátneho identifikátora dokladu, QR kódu a overovacieho kódu (OKP), ako to vyžaduje § 5 ods. 3 písm. e) zákona č. 384/2025 Z. z.. Ak doklad neexistuje, tlač skončí chybou -104: ReceiptNotFound.

Pôvodný doklad: Cappuccino a Croissant, suma 5,70 EUR, rekapitulácia DPH, QR kód, UID a OKP

Originál

Kópia toho istého dokladu: zvýraznené označenie KÓPIA DOKLADU, bez QR kódu, UID a OKP

Kópia

Tlač kópie podľa čísla dokladu

Číslo dokladu je identifikované trojicou informácií: rokom, mesiacom a poradovým číslom v mesiaci.

POST {server_address}/api/v1/requests/receipts/print_copy?cashRegisterCode=88812345678900001&year=2026&month=4&receiptNumber=83
var receiptId = new ReceiptId(cashRegisterCode: "88812345678900001", year: 2026, month: 4, number: 83u);

PrintResult result = await client.PrintReceiptCopyAsync(receiptId, cancellationToken);

Tlač kópie podľa externého identifikátora

Externý identifikátor (externalId) uvádza nadradená aplikácia pri registrácii dokladu.

POST {server_address}/api/v1/requests/receipts/print_copy?cashRegisterCode=88812345678900001&externalId=5cb23300ce3ccc2d38ccdbde
PrintResult result = await client.PrintReceiptCopyAsync(
    "88812345678900001", new ID("5cb23300ce3ccc2d38ccdbde"), cancellationToken);

Tlač kópie podľa interného identifikátora

Interný identifikátor (id) generuje eKasa. Nejde o unikátny identifikátor dokladu (UID) zo systému eKasa.

POST {server_address}/api/v1/requests/receipts/print_copy?cashRegisterCode=88812345678900001&id=2d419057-807c-41be-a5d6-aafea8eba13e
PrintResult result = await client.PrintReceiptCopyAsync(
    "88812345678900001", new Guid("2d419057-807c-41be-a5d6-aafea8eba13e"), 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.