# Kódovanie a špeciálne znaky

> Ktoré znaky eKasa povoľuje v názve položky a texte dokladu a ako sa text prevádza do kódovania tlačiarne (ibm852, windows-1250).

Zdroj: https://ekasa.ninedigit.sk/docs/encoding

Váš softvér posiela eKase text v kódovaní `utf8` (HTTP API) alebo `unicode` (.NET knižnica), teda so znakmi
v rozsahu `0` až `65535`. Tlačiareň však tlačí v kódovaní so znakmi v rozsahu `0` až `255`, väčšinou `ibm852`
alebo `windows-1250`. eKasa preto pred tlačou prevedie prijatý text do kódovania tlačiarne.

Na kódovaní záleží z dvoch dôvodov. Systém eKasa nedovoľuje, aby označenie tovaru alebo služby obsahovalo ľubovoľné
znaky, a takmer všetky riadiace znaky v názve položky odmietne. A nie každý znak má reprezentáciu v kódovaní, ktoré
ste pre tlačiareň zvolili.

**Váš softvér**: text v utf8 alebo unicode, znaky 0 až 65535
→ text dokladu
**eKasa**: kontrola povolených znakov a prevod do kódovania tlačiarne
→ kódová stránka
**Tlačiareň**: ibm852 alebo windows-1250, znaky 0 až 255

Článok sa venuje trom témam:

- [Povolené a zakázané znaky](#povolené-a-zakázané-znaky): Čo smie obsahovať názov položky a texty s tokenmi.
- [Prevod do kódovania tlačiarne](#prevod-do-kódovania-tlačiarne): Ako sa diakritika a symboly zapíšu v ibm852 a windows-1250.
- [Voľba kódovania](#voľba-kódovania): Nastavenia codePageName a codePageTableNumber.

## Povolené a zakázané znaky

Pravidlá platia pre názov položky a pre texty, ktoré podporujú [tokeny](https://ekasa.ninedigit.sk/docs/token-syntax) (hlavička, päta,
popis položky, nefiškálny doklad). V textoch s tokenmi sú oproti názvu položky navyše povolené znaky `0x1A`, `0x1E`
a `0x1F`, ktorými sa tokeny zapisujú (pozri [riadiace znaky v tokenoch](https://ekasa.ninedigit.sk/docs/token-syntax#riadiace-znaky)).

### Prehľad podľa rozsahov

Zakázané sú riadiace znaky `0` až `31` a `127` až `159`, okrem nového riadku a návratu vozíka. Všetky ostatné
znaky sú povolené.

| Desiatkovo | Šestnástkovo | Znaky | Názov položky | Texty s tokenmi |
|---|---|---|:---:|:---:|
| `0` – `9` | `0x00` – `0x09` | riadiace znaky | nie | nie |
| `10` | `0x0A` | Line feed (nový riadok) | áno | áno |
| `11` – `12` | `0x0B` – `0x0C` | riadiace znaky | nie | nie |
| `13` | `0x0D` | Carriage Return (návrat vozíka) | áno | áno |
| `14` – `25` | `0x0E` – `0x19` | riadiace znaky | nie | nie |
| `26` | `0x1A` | Substitute (`<SUB>`) | nie | áno |
| `27` – `29` | `0x1B` – `0x1D` | riadiace znaky | nie | nie |
| `30` – `31` | `0x1E` – `0x1F` | Record Separator (`<RS>`), Unit Separator (`<US>`) | nie | áno |
| `32` – `126` | `0x20` – `0x7E` | medzera, písmená, číslice a symboly | áno | áno |
| `127` | `0x7F` | Delete | nie | nie |
| `128` – `159` | `0x80` – `0x9F` | riadiace znaky | nie | nie |
| `160` – `65535` | `0xA0` – `0xFFFF` | všetky ďalšie symboly | áno | áno |

### Riadiace znaky 0 až 31

Úplný zoznam riadiacich znakov zo začiatku tabuľky. Zakázané sú aj znaky `127` / `0x7F` (Delete) a `128` až `159`
/ `0x80` až `0x9F`.

| Desiatkovo | Šestnástkovo | Popis | Názov položky | Texty s tokenmi |
|---|---|---|:---:|:---:|
| `0` | `0x00` | Null | nie | nie |
| `1` | `0x01` | Start of Header | nie | nie |
| `2` | `0x02` | Start of Text | nie | nie |
| `3` | `0x03` | End of Text | nie | nie |
| `4` | `0x04` | End of Transmission | nie | nie |
| `5` | `0x05` | Enquiry | nie | nie |
| `6` | `0x06` | Acknowledge | nie | nie |
| `7` | `0x07` | Bell | nie | nie |
| `8` | `0x08` | Backspace | nie | nie |
| `9` | `0x09` | Horizontal Tabulation | nie | nie |
| `10` | `0x0A` | Line feed | áno | áno |
| `11` | `0x0B` | Vertical Tabulation | nie | nie |
| `12` | `0x0C` | Form Feed | nie | nie |
| `13` | `0x0D` | Carriage Return | áno | áno |
| `14` | `0x0E` | Shift Out | nie | nie |
| `15` | `0x0F` | Shift In | nie | nie |
| `16` | `0x10` | Data Link Escape | nie | nie |
| `17` | `0x11` | Device Control 1 | nie | nie |
| `18` | `0x12` | Device Control 2 | nie | nie |
| `19` | `0x13` | Device Control 3 | nie | nie |
| `20` | `0x14` | Device Control 4 | nie | nie |
| `21` | `0x15` | Negative Acknowledge | nie | nie |
| `22` | `0x16` | Synchronous Idle | nie | nie |
| `23` | `0x17` | End of Transmission Block | nie | nie |
| `24` | `0x18` | Cancel | nie | nie |
| `25` | `0x19` | Medium | nie | nie |
| `26` | `0x1A` | Substitute | nie | áno |
| `27` | `0x1B` | Escape | nie | nie |
| `28` | `0x1C` | File Separator | nie | nie |
| `29` | `0x1D` | Group Separator | nie | nie |
| `30` | `0x1E` | Record Separator | nie | áno |
| `31` | `0x1F` | Unit Separator | nie | áno |

## Prevod do kódovania tlačiarne

Konkrétna reprezentácia symbolu na tlačiarni závisí od zvoleného kódovania tlačiarne. eKasa pred tlačou prevedie
prijatý text v kódovaní `unicode` (pri knižnici), resp. `utf8` (pri HTTP API) do kódovania tlačiarne. Ten istý znak
má preto v rôznych kódovaniach inú hodnotu:

| Symbol | Hodnota | Po konverzii do `windows-1250` | Po konverzii do `ibm852` |
| :-----: | ----- | ----- | ----- |
| ľ | `318` | `190` | `150` |
| š | `353` | `154` | `231` |
| č | `269` | `232` | `159` |
| ť | `357` | `157` | `156` |

Nie každý znak má reprezentáciu v zvolenom kódovaní tlačiarne. Na vytlačenie niektorých špeciálnych znakov,
napríklad `€`, `±` alebo `©`, treba použiť kódovanie `windows-1250`, pretože v `ibm852` sa nenachádzajú.

Prehľad dostupných znakov v najpoužívanejších kódovaniach:

| Kódová stránka | Zoznam znakov |
|-----|---|
| `ibm852` | [Character Grid for IBM852](https://www.fileformat.info/info/charset/IBM852/grid.htm) |
| `windows-1250` | [Character Grid for windows-1250](https://www.fileformat.info/info/charset/windows-1250/grid.htm) |

## Voľba kódovania

Kódovanie určujú v konfigurácii dve nastavenia:

| Nastavenie | Význam | Predvolená hodnota |
|-----|-----|----|
| `printers.pos.codePageName` | názov kódovej stránky, napríklad `ibm852` alebo `windows-1250` | `ibm852` |
| `printers.pos.codePageTableNumber` | číselné označenie kódovej stránky v tlačiarni | `18` |

Na štandardných tlačiarňach sú kódové stránky na týchto pozíciách:

| Kódovanie | Kedy | `codePageName` | `codePageTableNumber` |
|---|---|---|---|
| `ibm852` | predvolené nastavenie | `ibm852` | `18` |
| `windows-1250` | potrebujete tlačiť znaky ako `€`, `±` alebo `©` | `windows-1250` | `45` |

Kódové stránky vašej tlačiarne nájdete v dokumentácii jej výrobcu. V niektorých prípadoch sú tieto informácie
viditeľné aj na tlačovom výstupe „SELF TEST“, ktorý sa vytlačí, ak pri podržanom tlačidle **FEED** zapnete tlačiareň.

## Kam ďalej

- [Tokeny a formátovanie textu](https://ekasa.ninedigit.sk/docs/token-syntax): Riadiace znaky SUB, RS a US v texte dokladu.
- [Položky dokladu](https://ekasa.ninedigit.sk/docs/receipt-registration/items): Názov a ďalšie vlastnosti položky.
- [Informácie o tlačiarni](https://ekasa.ninedigit.sk/docs/printer-info): Počet znakov na riadok.
