# Informácie o tlačiarni

> Ako zistiť, akou tlačiarňou a s koľkými znakmi na riadok eKasa skutočne tlačí, a prečo sa hodnota môže líšiť od nastavení.

Dostupné od verzie: Windows 9.0.6, macOS 9.0.6, Linux 9.0.6, Android 9.0.10, .NET knižnica (PPEKK) 9.0.6

Zdroj: https://ekasa.ninedigit.sk/docs/printer-info

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

**HTTP API:**

```http
GET {server_address}/api/v1/printers/pos/info
```

**.NET knižnica:**

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

Príklad odpovede:

```json
{
  "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:

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

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

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

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

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

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

```json
{
  "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`.
