Informácie o tlačiarni

Integrujem cez

Dostupné od verzie

Pri tlači vlastných textov na doklade, napríklad stĺpcov s názvom a cenou, potrebujete vedieť, koľko znakov sa zmestí na jeden riadok. Táto hodnota sa môže líšiť od hodnoty v nastaveniach eKasy, nižšie je vysvetlené prečo.

V nastaveniach aplikácie je uchované, čo si používateľ zvolil; info endpoint indikuje, čím sa tlač skutočne riadi. Preto v prípade, ak vaša aplikácia zasiela voliteľné texty na doklad, alebo realizujete tlač nefiskálneho dokladu a váš tlačový výstup závisí od maximálneho počtu znakov na riadok, odporúčame načítavať informácie o tlačiarni pred kompozíciou vlastných textov. Hodnota z nastavení nemusí stačiť.

Získanie informácií o tlačiarni

GET {server_address}/api/v1/printers/pos/info
PrinterInfo printerInfo = await client.GetPrinterInfoAsync(PrinterName.Pos, cancellationToken);

Príklad odpovede:

{
  "connection": "Internal",
  "text": {
    "layout": "Monospace",
    "charactersPerLine": 42
  }
}

Prečo sa hodnoty líšia od nastavení

Hodnoty v nastaveniach sa môžu líšiť od skutočne použitých vlastností tlačiarne, ak eKasa beží na zariadení s Androidom so vstavanou tlačiarňou a tlačí sa na nej. Vstavané tlačiarne majú šírku riadku pevne danú, takže eKasa uprednostní túto hodnotu pred nastaveniami aplikácie.

Niektoré príklady vlastných hodnôt podľa modelu zariadenia:

výrobca model počet znakov na riadok
Sunmi P3 MIX s 80 mm tlačiarňou 48
Sunmi P3 MIX s 58 mm tlačiarňou 32
Sunmi D3 mini s 80 mm tlačiarňou 48
Sunmi D3 mini s 58 mm tlačiarňou 32
Sunmi D3 48
Sunmi V3, P2-EU, P3h Dual 32
Ingenico DX4000, DX8000 27 alebo 38 podľa písma
PAX A920 Pro 32

Na Sunmi P3h Dual teda môže byť v nastaveniach iná hodnota (predvolených 42 znakov alebo iná), ale doklad sa tlačí na 32 znakov.

Pri zariadeniach Sunmi sa počet znakov na riadok zisťuje priamo od vstavanej tlačiarne podľa šírky papiera: 58 mm tlačiareň (384 bodov) dáva 32 znakov, 80 mm tlačiareň (576 bodov) 48 znakov. Model zariadenia totiž šírku neurčuje spoľahlivo. Napríklad Sunmi P3 MIX aj D3 mini sa predávajú v 58 mm aj 80 mm verzii a obe verzie sa hlásia rovnakým názvom modelu. Hodnota podľa modelu sa použije len vtedy, keď tlačiareň šírku neohlási (napríklad tesne po štarte zariadenia) alebo ohlási šírku, ktorú aplikácia nepozná.

Pri automatickej voľbe tlačiarne sa hodnoty menia za behu. Ak je v nastaveniach zapnuté automatické prepínanie medzi internou a externou USB tlačiarňou, tlačí sa na externú tlačiareň vždy, keď je pripojená. Externá tlačiareň môže mať inú šírku riadku, než vstavaná tlačiareň. Pripojenie alebo odpojenie externej tlačiarne teda zmení efektívny počet znakov na riadok. A to aj bez toho, aby boli zmenené nastavenia aplikácie.

Vlastnosť connection

Spôsob pripojenia tlačiarne. Na rozdiel od rovnomenného nastavenia nikdy nenadobúda význam „zvoliť automaticky“, voľba je v tejto chvíli už vykonaná.

Hodnota Popis
Internal Vstavaná tlačiareň zariadenia, alebo tlačiareň pripojená k dátovému úložisku.
Usb Externá tlačiareň pripojená k zariadeniu cez USB.
null Tlačiareň, ktorej sa toto delenie netýka, napríklad pri vyhotovení e-dokladu.

Vlastnosť text

Popis textu, ktorý tlačiareň vyhotoví. Hodnota null znamená, že tlačiareň text nevyhotovuje.

text.layout

Hodnota Popis
Monospace Neproporcionálne písmo: každý znak je rovnako široký, takže riadok sa dá skladať počítaním znakov.
Proportional Proporcionálne písmo: šírka znaku závisí od znaku samotného, takže počet znakov na riadok určený nie je a zalomenie textu je na tlačiarni.

text.charactersPerLine

Počet znakov na riadok, ktorým sa tlač skutočne riadi, teda po zohľadnení šírky papiera vstavanej tlačiarne alebo úprav podľa modelu zariadenia. Uvedený je práve vtedy, keď je layout rovné Monospace; pri proporcionálnom (Proportional) písme je null.

Chýbajúci text a chýbajúci charactersPerLine neznamenajú to isté. Prvé hovorí, že sa nič netlačí; druhé, že sa text tlačí, ale nedá sa skladať počítaním znakov.

Príklady podľa situácie

Externá USB tlačiareň s neproporcionálnym písmom:

{
  "connection": "Usb",
  "text": {
    "layout": "Monospace",
    "charactersPerLine": 42
  }
}

Vstavaná tlačiareň zariadenia Sunmi P3h Dual, nastavenia hlásia 42, tlačí sa na 32:

{
  "connection": "Internal",
  "text": {
    "layout": "Monospace",
    "charactersPerLine": 32
  }
}

E-doklad, ktorého sa spôsob pripojenia netýka:

{
  "connection": null,
  "text": {
    "layout": "Monospace",
    "charactersPerLine": 42
  }
}

Zariadenie bez podporovanej tlačiarne (nič sa nevyhotovuje):

{
  "connection": "Internal",
  "text": null
}

Názvy tlačiarní

Názov tlačiarne ({printerName} v ceste /api/v1/printers/{printerName}/info) je povinný, pretože odpoveď sa pre každú tlačiareň líši.

Názov Popis
pos Tlačiareň papierových dokladov.
pdf Vyhotovenie e-dokladu vo forme PDF súboru.
email Vyhotovenie e-dokladu vo forme e-mailovej správy s prílohou.

Neplatný názov skončí odpoveďou 400.

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.