Nefiškálny doklad

Integrujem cez

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

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
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:

{
  "text": "Objednávka č. 42\nStôl 5\n\n2x Káva\n1x Koláč",
  "contentFlags": []
}
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);

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.

{
  "text": "Objednávka č. 42\nStôl 5\n\n2x Káva\n1x Koláč",
  "cashRegisterCode": "88812345678900001",
  "contentFlags": []
}
var context = new TextPrintContext(
    "Objednávka č. 42\nStôl 5\n\n2x Káva\n1x Koláč",
    NonfiscalReceiptContentFlags.None,
    CashRegisterCode: "88812345678900001");

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.). Zákazník tak nezamení takýto doklad s pokladničným dokladom. eKasa označenie doplní sama, keď v contentFlags uvediete priceInformation.

{
  "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"]
}
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");

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:

GET http://localhost:3010/api/v1/printers/pos/info
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.

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.

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.