Kódovanie a špeciálne znaky

Integrujem cez

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értext v utf8 alebo unicode, znaky 0 až 65535

text dokladu

eKasakontrola 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

Pravidlá platia pre názov položky a pre texty, ktoré podporujú tokeny (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).

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
windows-1250 Character Grid for windows-1250

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

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.