# Nefiškálny doklad

> Tlač vlastného textu cez eKasu: objednávka, účet pred zaplatením či potvrdenie. Text, hlavička podnikateľa a označenie NEPLATNÝ DOKLAD pri cenách.

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

Nefiškálny doklad je ľubovoľný text, ktorý eKasa vytlačí mimo evidencie tržieb: objednávka pre kuchyňu, účet pred
zaplatením, ponuka a podobne. Do systému eKasa sa neodosiela, ale ako každý
tlačový výstup sa zapíše do úložiska CHDÚ, ak tlač ide cez neho.

Doklad sa vytlačí na predvolenej tlačiarni. Pri úložisku In-Memory na počítači sa uloží do PDF, rovnako ako ukážky
nižšie. Nefiškálny doklad sa dá vytlačiť aj bez inicializačného balíka, preto sa hodí na prvý test tlačiarne.

## Požiadavka

**HTTP API:**

```http
POST http://localhost:3010/api/v1/printers/print
```

| Vlastnosť | Povinná | Popis |
|---|---|---|
| `text` | áno, ak chýba `cashRegisterCode` | text dokladu, riadky oddelené `\n` |
| `cashRegisterCode` | nie | kód pokladnice: pred text sa vytlačí hlavička podnikateľa |
| `contentFlags` | vždy uveďte | čo text obsahuje: `[]` alebo `["priceInformation"]`, ak obsahuje ceny |

**.NET knižnica:**

```csharp
var result = await client.PrintTextAsync(context, cancellationToken);
```

| Parameter `TextPrintContext` | Povinný | Popis |
|---|---|---|
| `Text` | áno | text dokladu, riadky oddelené `\n` |
| `ContentFlags` | áno | čo text obsahuje: `None` alebo `PriceInformation`, ak obsahuje ceny |
| `CashRegisterCode` | nie | kód pokladnice: pred text sa vytlačí hlavička podnikateľa |

## Text dokladu

Najjednoduchší nefiškálny doklad je samotný text, napríklad objednávka pre kuchyňu:

**HTTP API:**

```json
{
  "text": "Objednávka č. 42\nStôl 5\n\n2x Káva\n1x Koláč",
  "contentFlags": []
}
```

**.NET knižnica:**

```csharp
var context = new TextPrintContext(
    "Objednávka č. 42\nStôl 5\n\n2x Káva\n1x Koláč",
    NonfiscalReceiptContentFlags.None);

var result = await client.PrintTextAsync(context, cancellationToken);
```

[Obrázok: Nefiškálny doklad s objednávkou: Objednávka č. 42, Stôl 5, 2x Káva, 1x Koláč]

Text nesmie obsahovať riadiace znaky okrem konca riadku. V .NET to overíte metódou `ReceiptText.IsValid(text)`.

## Hlavička podnikateľa

S kódom pokladnice v `cashRegisterCode` vytlačí eKasa pred text hlavičku s identifikačnými údajmi podnikateľa:
názov, adresu, IČO, DIČ, IČ DPH a kód pokladnice.

**HTTP API:**

```json
{
  "text": "Objednávka č. 42\nStôl 5\n\n2x Káva\n1x Koláč",
  "cashRegisterCode": "88812345678900001",
  "contentFlags": []
}
```

**.NET knižnica:**

```csharp
var context = new TextPrintContext(
    "Objednávka č. 42\nStôl 5\n\n2x Káva\n1x Koláč",
    NonfiscalReceiptContentFlags.None,
    CashRegisterCode: "88812345678900001");
```

[Obrázok: Nefiškálny doklad s hlavičkou podnikateľa nad textom objednávky]

## Údaje o cene

Ak text obsahuje ceny tovaru alebo služieb, napríklad účet pred zaplatením, zákon vyžaduje, aby bol doklad
v každom treťom riadku označený slovami „NEPLATNÝ DOKLAD“
([§ 5 ods. 3 písm. t) 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-t)).
Zákazník tak nezamení takýto doklad s pokladničným dokladom. eKasa označenie doplní sama, keď v `contentFlags` uvediete
`priceInformation`.

**HTTP API:**

```json
{
  "text": "Účet pred zaplatením\nStôl 5\n\n2x Káva         8,00\n1x Koláč        3,00\n\nSpolu          11,00 EUR",
  "cashRegisterCode": "88812345678900001",
  "contentFlags": ["priceInformation"]
}
```

**.NET knižnica:**

```csharp
var context = new TextPrintContext(
    "Účet pred zaplatením\nStôl 5\n\n2x Káva         8,00\n1x Koláč        3,00\n\nSpolu          11,00 EUR",
    NonfiscalReceiptContentFlags.PriceInformation,
    CashRegisterCode: "88812345678900001");
```

[Obrázok: Nefiškálny doklad s cenami, v každom treťom riadku je text NEPLATNÝ DOKLAD]

| `contentFlags` | Kedy | Výsledok |
|---|---|---|
| `[]` | text bez cien: objednávka, poznámka, potvrdenie | text bez označenia |
| `["priceInformation"]` | text s cenami: účet pred zaplatením, ponuka | v každom treťom riadku „NEPLATNÝ DOKLAD“ |
| chýba alebo `null` | | ako pri `priceInformation`, aby označenie nechýbalo omylom |

Vlastnosť `contentFlags` je k dispozícii od verzie 8.

## Formátovanie

eKasa zalamuje text podľa počtu znakov na riadok tlačiarne tak, aby zlom nevznikol v strede slova. Ak skladáte
stĺpce, napríklad názov a cenu, zistite si počet znakov na riadok vopred:

**HTTP API:**

```http
GET http://localhost:3010/api/v1/printers/pos/info
```

**.NET knižnica:**

```csharp
PrinterInfo printerInfo = await client.GetPrinterInfoAsync(PrinterName.Pos, cancellationToken);
```

Nastavenia eKasy na to nestačia. Skutočný počet znakov závisí od šírky papiera vstavanej tlačiarne alebo modelu
zariadenia a pri automatickej voľbe tlačiarne aj od toho, či je pripojená externá tlačiareň. Podrobnosti sú v článku
[Informácie o tlačiarni](https://ekasa.ninedigit.sk/docs/printer-info).

Text môže obsahovať aj tučné písmo, zarovnanie, QR kódy či čiarové kódy. Vkladajú sa takzvanými tokenmi, pozri
[Tokeny a formátovanie textu](https://ekasa.ninedigit.sk/docs/token-syntax).

## Kam ďalej

- [Tokeny a formátovanie](https://ekasa.ninedigit.sk/docs/token-syntax): Tučné písmo, zarovnanie, QR a čiarové kódy.
- [Informácie o tlačiarni](https://ekasa.ninedigit.sk/docs/printer-info): Počet znakov na riadok a pripojenie tlačiarne.
- [Poukazy](https://ekasa.ninedigit.sk/docs/receipt-registration/vouchers): Potvrdenie o predaji viacúčelového poukazu s označením NEPLATNÝ DOKLAD.
