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.