Stav tlačiarne

Integrujem cez

Stav tlačiarne zistíte pred vyhotovením dokladu, napríklad aby ste obsluhu upozornili na dochádzajúci papier alebo otvorený kryt. Odpoveď obsahuje celkovú pripravenosť (state), stav papiera (paperState) a druh chyby (errorState).

GET {server_address}/api/v1/printers/status
PrinterStatusInfo printerStatus = await client.GetPrinterStatusInfoAsync(cancellationToken);

Príklad stavu tlačiarne:

{
  "state": "Ready",
  "paperState": "Ready",
  "errorState": "None"
}

Vlastnosť state

Celkový stav pripravenosti tlačiarne.

Hodnota Popis
Ready Tlačiareň je pripravená.
Error Tlačiareň nie je pripravená (zaneprázdnená alebo v chybovom stave).
Unknown Stav sa nepodarilo zistiť (najmä v dôsledku inej chyby).

Vlastnosť paperState

Dostupné od verzie 6.6.

Stav papiera a mechaniky. Hodnota null znamená, že použité úložisko alebo tlačiareň túto informáciu neposkytuje. Nejde teda o tvrdenie, že papier je v poriadku.

Hodnota Popis
Ready Papier je správne vložený a pripravený na tlač.
NearEnd Rolka je takmer prázdna. Tlač pokračuje, ide o varovanie.
Empty V tlačiarni nie je vložený papier.
CoverOpen Kryt tlačiarne je otvorený.
PaperJam Papier v tlačiarni je zaseknutý.
null Stav papiera nie je k dispozícii.

Vlastnosť errorState

Dostupné od verzie 9.0.6.

Druh chyby, ktorá sa netýka papiera.

Hodnota Popis
None Tlačiareň odpovedala a nenachádza sa v stave súvisiacom s chybou v tejto sekcii.
CutterError Chyba automatickej rezačky papiera (nožníc).
Recoverable Chyba, ktorá je dočasná a pominie sama po odstránení príčiny, napríklad prehriata tlačová hlava alebo nízke napájacie napätie.
Unrecoverable Porucha, ktorú nemožno odstrániť bez zásahu do zariadenia. Volajúcemu je odporúčané kontaktovanie servisu.
null Príčinu nie je možné zistiť. Tlačiareň alebo pripojené zariadenie tento typ chybového stavu nehlási.

Hodnoty None a null neznamenajú to isté. None je odpoveď tlačiarne, že žiadnu chybu netýkajúcu sa papiera nehlási, príčina teda leží inde. null znamená, že zariadenia alebo tlačiarne sa na príčinu nedá spýtať.

Príklady podľa situácie

Pripravená tlačiareň s dostatkom papiera:

{
  "state": "Ready",
  "paperState": "Ready",
  "errorState": "None"
}

Dochádzajúca rolka, tlač pokračuje, ide o varovanie:

{
  "state": "Ready",
  "paperState": "NearEnd",
  "errorState": "None"
}

Prázdna rolka:

{
  "state": "Error",
  "paperState": "Empty",
  "errorState": "None"
}

Otvorený kryt:

{
  "state": "Error",
  "paperState": "CoverOpen",
  "errorState": "None"
}

Otvorený kryt spolu s chybou, kryt a chyba sa nevylučujú:

{
  "state": "Error",
  "paperState": "CoverOpen",
  "errorState": "CutterError"
}

Chyba rezačky hlásená vstavanou tlačiarňou, ktorá stav papiera popri chybe nehlási:

{
  "state": "Error",
  "paperState": null,
  "errorState": "CutterError"
}

Úložisko, ktoré stav papiera ani príčinu chyby neposkytuje (napríklad CHDÚ-SK):

{
  "state": "Ready",
  "paperState": null,
  "errorState": null
}

Tlačiareň neodpovedala:

{
  "state": "Unknown",
  "paperState": null,
  "errorState": null
}

Čo ktoré zariadenie hlási

Pripojenie tlačiarne state paperState errorState
CHDÚ-SK áno vždy null vždy null
CHDÚ Lite, firmvér starší ako v1.4 áno vždy null vždy null
CHDÚ Lite, firmvér v1.4 a novší áno Ready, NearEnd, Empty, CoverOpen vždy null
Externá cez USB (ESC/POS) áno áno, všetky hodnoty áno, vrátane None
Vstavaná (zariadenie Sunmi) áno Ready, NearEnd, Empty, CoverOpen, PaperJam len konkrétna príčina, inak null
Vstavaná (zariadenie PAX) áno Ready, Empty, CoverOpen, PaperJam len konkrétna príčina, inak null
Vstavaná (zariadenie Ingenico) áno Ready, NearEnd, Empty, CoverOpen, PaperJam len konkrétna príčina, inak null
Zariadenie bez podporovanej tlačiarne vždy Ready vždy null vždy null

Vstavané tlačiarne hlásia cez sadu výrobcu vždy jedinú hodnotu stavu, takže z nej nemožno usúdiť, že žiadna ďalšia chyba nenastala. Preto pri nich errorState nikdy nenadobudne hodnotu None. Buď obsahuje konkrétnu príčinu, alebo null.

Správanie pri nepripravenej tlačiarni

V závislosti od spôsobu pripojenia tlačiarne je reakcia aplikácie na jej chybový stav rozdielna.

Pripojenie tlačiarne Doklad sa vyhotoví Správanie na nepripravenosť tlačiarne
CHDU-SK áno Chybový stav tlačiarne (napríklad ak ju obsluha nezapla do elektrickej siete) neovplyvňuje činnosť aplikácie, po zapnutí sa údaje z úložiska dodatočne (v rámci veľkosti bufferu) zašlú do tlačiarne. Ak sa však vnútorný buffer úložiska zaplní (odhadom 10 – 12 účteniek), úložisko sa zablokuje a pre jeho ďalšiu činnosť je potrebné ho vypnúť a zapnúť.
CHDU Lite nie Pri chybovom stave tlačiarne sa pokus o registráciu dokladu ihneď skončí chybou. Zariadenie nemá vstavaný buffer pre dodatočné doposlanie tlačového výstupu.
Vstavaná tlačiareň zariadenia (Sunmi, Pax, Ingenico, ..) nie Pri chybovom stave tlačiarne sa pokus o registráciu dokladu skončí chybou.
Externá cez USB nie Pripravenosť sa overuje pred zápisom dokladu do chráneného dátového úložiska, takže pri chybe doklad vôbec nevznikne. Doklad, ktorý sa nepodarí vytlačiť, sa nikdy netlačí znova, nakoľko originál smie byť vyhotovený len raz.

CHDÚ-SK je jediný typ úložiska, pri ktorom doklad vznikne aj vtedy, keď tlačiareň nie je pripravená. Úložisko si tlačový výstup odloží do vnútornej pamäte (buffer) a vytlačí ho dodatočne. Pri všetkých ostatných sa pripravenosť tlačiarne overuje pred vyhotovením dokladu, takže doklad, ktorý sa nedá vytlačiť, vôbec nevznikne. Nejde o odporúčaný režim prevádzky, nakoľko veľkosť buffera je limitovaná a vyústi v neresponzívny stav úložiska.

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.