# Kópia a vyhľadanie dokladu

> Vyhľadanie zaevidovaného dokladu a tlač jeho kópie podľa čísla dokladu, externého alebo interného identifikátora.

Zdroj: https://ekasa.ninedigit.sk/docs/receipt-lookup

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](https://ekasa.ninedigit.sk/docs/receipt-registration/printing#z%C3%ADskanie-pdf-s%C3%BAboru)).

## Vyhľadanie dokladu

Vyhľadanie vráti uložený doklad s rovnakým výsledkom ako pri registrácii (pozri
[Výsledok registrácie](https://ekasa.ninedigit.sk/docs/receipt-registration/result)). 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.

**HTTP API:**

```http
GET {server_address}/api/v1/requests/receipts/receipt?cashRegisterCode=88812345678900001&year=2026&month=4&receiptNumber=83
```

**.NET knižnica:**

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

**HTTP API:**

```http
GET {server_address}/api/v1/requests/receipts/receipt?cashRegisterCode=88812345678900001&externalId=5cb23300ce3ccc2d38ccdbde
```

**.NET knižnica:**

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

**HTTP API:**

```http
GET {server_address}/api/v1/requests/receipts/receipt?cashRegisterCode=88812345678900001&id=2d419057-807c-41be-a5d6-aafea8eba13e
```

**.NET knižnica:**

```csharp
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.](https://www.slov-lex.sk/ezbierky-fe/pravne-predpisy/SK/ZZ/2025/384/20260101#paragraf-5.odsek-3.pismeno-e).
Ak doklad neexistuje, tlač skončí chybou [`-104: ReceiptNotFound`](https://ekasa.ninedigit.sk/docs/rest-api/error-codes#-104-receiptnotfound).

<figure>

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

<figcaption>Originál</figcaption>
</figure>
<figure>

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

<figcaption>Kópia</figcaption>
</figure>

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

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

**HTTP API:**

```http
POST {server_address}/api/v1/requests/receipts/print_copy?cashRegisterCode=88812345678900001&year=2026&month=4&receiptNumber=83
```

**.NET knižnica:**

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

**HTTP API:**

```http
POST {server_address}/api/v1/requests/receipts/print_copy?cashRegisterCode=88812345678900001&externalId=5cb23300ce3ccc2d38ccdbde
```

**.NET knižnica:**

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

**HTTP API:**

```http
POST {server_address}/api/v1/requests/receipts/print_copy?cashRegisterCode=88812345678900001&id=2d419057-807c-41be-a5d6-aafea8eba13e
```

**.NET knižnica:**

```csharp
PrintResult result = await client.PrintReceiptCopyAsync(
    "88812345678900001", new Guid("2d419057-807c-41be-a5d6-aafea8eba13e"), cancellationToken);
```

## Kam ďalej

- [Ochrana pred duplicitou](https://ekasa.ninedigit.sk/docs/receipt-registration/external-id): externalId, podľa ktorého doklad nájdete.
- [Výsledok registrácie](https://ekasa.ninedigit.sk/docs/receipt-registration/result): Čo obsahuje nájdený doklad.
- [Storno a vrátenie](https://ekasa.ninedigit.sk/docs/receipt-registration/corrections): Oprava dokladu s odkazom na pôvodný.
