Pri prechode z verzie 8 na verziu 9 je potrebné pri práci s knižnicou adaptovať niektoré spätne nekompatibilné zmeny.
1. Úprava registrácie hotovostného vkladu a výberu
Pri pokuse o registráciu dokladu typu vklad (Deposit) alebo výber (Withdrawal) aplikácia vyhlási chybu Registrácia vkladu, výberu a neplatného dokladu nie je v tejto verzii podporovaná.
Pre registráciu vkladu a výberu je možné vyvolať tlačový výstup API volaním POST {server_address}/api/v1/printers/print, pričom v tele požiadavky uvediete:
cashRegisterCode: kód pokladnice, ktorej hlavička (informácie o spoločnosti, predajnom mieste a kóde pokladnice) bude vytlačená na tlačovom výstupe.text: informácia o sume vkladu alebo výberu podľa príkladu nižšie.
{
"text": "\u001atext\u001econtent\u001fVKLAD: 100,00 EUR\u001eformat\u001f12\u001a",
"cashRegisterCode": "88812345678900001",
"contentFlags": []
}
Príklad tlače potvrdení o hotovostnom vklade pri použití DLL knižnice:
ORPCode cashRegisterCode = "88812345678900001";
decimal amount = 100;
ReceiptText receiptText = TextToken.Create(
$"VKLAD: {amount} EUR",
TextFormats.DoubleHeight | TextFormats.DoubleWidth)
.ToString();
NonfiscalReceiptContentFlags contentFlags = NonfiscalReceiptContentFlags.None;
TextPrintContext printContext = new TextPrintContext(
receiptText, contentFlags, cashRegisterCode);
await client.PrintTextAsync(printContext, cancellationToken);
2. Úprava používania neplatných dokladov
Pri pokuse o registráciu dokladu typu neplatný doklad (Invalid) aplikácia vyhlási chybu Registrácia vkladu, výberu a neplatného dokladu nie je v tejto verzii podporovaná.
Nakoľko neplatný doklad bol určený pre tlač dokladov v rámci školenia obsluhy, odporúčame v prípade takejto potreby používať nulové ceny a ostré pokladničné doklady.