História zmien

6.7.2 - 2023-11-09

  • API: Vylepšenie a optimalizácia Expose služby.
  • Pridaná podpora "In-memory" úložiska: Úložisko určené predovšetkým pre vývojárov, alebo pre testovanie eKasy na integračnom prostredí, bez nutnosti pripájať fyzické úložisko či tlačiareň.

6.7.1 - 2023-10-18

  • API: Oprava súvisiaca s úpravou konfiguračného súboru.

6.7 - 2023-10-17

  • Pridaná podpora pre CHDU Lite v1.4

6.6 - 2023-10-13

  • Pridané detailnejšie informácie o stave tlačiarne: otvorené dvierka, blížiaci sa koniec papiera, chýbajúci papier. Táto funkcionalita vyžaduje úložisko CHDU Lite vo verzii 1.4 alebo novšie a tlačiareň podporujúcu indikáciu týchto stavov, napríklad od výrobcov Bixolon alebo Epson.
  • Pridaná podpora autentifikácie v API službe a vo webadmin rozraní: odteraz je možné prístup k eKase podmieniť vložením mena a hesla.
  • Pridaná podpora pre Expose službu, ktorá nahrádza pôvodné Cloud rozšírenie. Služba Expose umožňuje bezpečne zverejniť túto eKasa API na internete prostredníctvom HTTPS protokolu. Vaša eKasa bude dostupná online prostredníctvom zabepečeného šifrovaného spojenia, s ochranu pred neoprávneným prístupom. Expose zriadite bez komplikovanej konfigurácie smerovača, inštalácie aplikácií tretích strán či bez nutnosti vlastniť statickú IP adresu. Je to ideálny spôsob, ako využívať eKasa API z akejkoľvek cloudovej aplikácie alebo e-shopu. V prípade záujmu o aktiváciu služby Expose nás kontaktujte na adrese info@ninedigit.sk.
  • Vylepšené zaznamenávanie chýb do denníka aplikácie
  • Vylepšené chybové hlásenia pri nenájdených identifikačných údajoch.
  • Oprava chyby, ktorá v niektorých situáciách mohla spôsobiť neodoslanie offline dokladu pri nestabilnom internetovom pripojení.
  • Oprava chyby "Duplicitný identifikátor"

6.5 - 2023-08-07

  • Oprava kontroly exspirácie autentifikačných údajov vo webovom rozhraní.
  • Oprava chyby, ktorá nastávala pri pokuse o tlač PDF/e-dokladu v offline režime.
  • Oprava chyby, ktorá znemožňovala tlač hlavičky subjektu.

6.4 - 2023-01-23

  • Optimalizácie vo vyhľadávaní PDF súborov.
  • Pridaná možnosť nastaviť automatické odstraňovanie PDF súborov na základe uvedenia počtu dní.
  • Čiarové kódy v e-doklade odteraz používajú rovnakú jednotku výšky, ako v tlačiarni papierových dokladov (pos).

6.3 - 2023-01-11

  • Oprava vo vyhľadávaní PDF súboru k dokladu registrovanému pdf tlačiarňou.

6.2 - 2023-01-05

  • Pridaná možnosť získať obsah PDF súboru k dokladu registrovanému pdf tlačiarňou.
  • Pridaná podpora pre tlač čiarových kódov v pdf tlačiarni.
  • Vylepšené chybové hlásenie pri použití nepovolených znakov pri tlači nefiskálneho dokladu.
  • Oprava aplikovania typu písma zvoleného v nastaveniach papierovej tlače.
  • Oprava aplikovania čísla dokladu po prerušenej registrácii.

6.1 - 2022-11-22

  • Prísnejšia kontrola znakov v čísle faktúry a vo vlastnostiach fyzickej polohy pokladnice.
  • Vylepšenia a opravy pri prideľovaní čísla dokladu.

6.0 - 2022-10-13

  • Zapracované zmeny pre kompatibilitu s operačným systémom macOS (macOS 11 "Big Sur", alebo novší). V prípade záujmu o inštalátor API služby určený pre macOS nás kontaktujte.
  • Pridaný sprievodca nastavením vo webovej admin aplikácii. Po nainštalovaní API služby sa sprievodca nastavením automaticky otvorí v predvolenom prehliadači v prípade, ak neexistuje konfiguračný súbor v pracovnom adresári eKasa aplikácie.
  • Oprava chyby Value does not fall within the expected range. (Parameter 'typeName@4'), ktorá vznikla vo verzii 5.27.
  • Spätná kompatibilita s verziou 5:

5.27 - 2022-08-11

  • Zvýšená stabilita pri práci s úložiskom CHDU-SK. Dôkladnejšia kontrola návratových hodnôt stavu zariadenia.
  • Pridaná podpora pre CHDU Lite v1.3
  • Do API bolo pridané volanie GET .../storage/devices, ktoré vráti zoznam dostupných chránených dátových uložísk pripojených k počítaču.
  • DLL knižnica: oprava NuGet definície, v ktorej od verzie 5.26 nebola uvedená závislosť System.Text.Encoding.CodePages.

5.26 - 2022-07-20

  • Nová obrazovka nastavení vo webadmin aplikácii.
  • Pridaná podpora pre službu NineDigit Cloud.
  • API je od tejto verzie postavená na technológii .NET 6 (doteraz bola využívaná platforma .NET Core 3.1).
  • Zmenená práca s prístupom na sériový port.
  • DLL knižnica: zmenený menný priestor niektorých tried z NineDigit.eKasa.Core.Data.Validation na NineDigit.eKasa.Core.Validation.

5.25.2 - 2022-09-12

  • Pridaná podpora pre CHDU Lite v1.3

5.25.1 - 2022-07-20

  • Vylepšenia v inštalátore API služby: .NET závislosti sú inštalované v tichom režime, API služba je kompilovaná už aj ako 64-bit proces.

5.25 - 2022-07-18

  • Oprava vyčítavania záznamov presahujúcich 127 pamäťových blokov (úložisko CHDU Lite).
  • Počet riadkov na konci dokladu sa dá nastaviť aj na záporné číslo (v rozsahu od -5 do 250) pre vynechanie prázdneho priestoru na konci dokladu pri niektorých modeloch tlačiarní.
  • Inštalátor viac v procese inštalácie nerealizuje kontrolu nutnosti aktualizácie pomocných (indexovacích) súborov z formátu používanom aplikáciou do verzie 3.X.

5.24.1 - 2022-06-27

  • Pridaná možnosť uvedenia výšky zaokrúhlenia pre doklady typu faktúra a paragón pri úhrade faktúry aj do webovej admin aplikácie.

5.24 - 2022-06-21

  • Pridaná možnosť uvedenia výšky zaokrúhlenia (roundingAmount) aj pre doklady typu faktúra (invoice) a paragón pri úhrade faktúry (invoiceParagon).

5.23.7 - 2022-06-08

  • Úprava inštalátora API služby: inštalátor pokračuje v inštalácii služby aj v prípade, ak sa nepodarí nainštalovať bezpečnostné KB záplaty pre operačný systém Windows 7.

5.23.6 - 2022-05-20

  • Oprava validačnej kontroly v prípade záporného zaokrúhlenia pri neplatnom doklade a doklade typu paragón (chyba sa týka iba API rozhrania a neprejavovala sa v DLL knižnici).
  • Upravená webová admin aplikácia (verzia 2.0.7):
    • Upravené poradie stavových kontroliek
    • Úprava kontroly zaokrúhľovania vo formulári registrácie dokladu
  • Úprava inštalátora API služby: Bezpečnostné KB záplaty pre OS Windows 7 sa inštalujú iba v prípade, ak na počítači nie sú už nainštalované.

5.23.1 - 2022-03-25

  • Úprava inštalátora API služby: Softvérová závislosť Visual studio C++ redistributable 2015-2019 sa inštaluje iba v prípade, ak na počítači nie je už nainštalovaná rovnaká alebo novšia verzia.

5.23 - 2022-03-25

  • Pridaná podpora firmvéru 1.2 pre chránené dátové úožisko "CHDU Lite".

5.22 - 2022-02-28

  • Unikátny identifikátor kupujúceho bol zrušený v zmysle rozhodnutia Ústavného súdu SR č. 492/2021 Z. z., Nález Ústavného súdu Slovenskej republiky č. k. PL. ÚS 25/2019-117 z 10. novembra 2021. Pre dodržanie spätnej kompatibility je Portos eKasa naďalej schopná prijať od nadradenej aplikácie identifikátor kupujúceho, avšak nie je ďalej zasielaný finančnému riaditeľstvu SR.
  • Úprava odosielania neodoslaných dátových: po predchádzajúcom odpojení a pripojení chráneného dátového úložiska sa fronta neodoslaných dátových správ pri najbližšej registrácii dokladu opäť začne spracúvať.
  • Oprava práce so zoznamom neodoslaných dátových správ a vyriešenie stavu, ktoré mohlo spôsobiť chybové hlásenie Dáta v tabuľke indexov nekorešpondujú s dátami v úložisku po zlyhanom zápise do úložiska.
  • Oprava validačnej kontroly v prípade záporného zaokrúhlenia. (chyba sa týka iba API rozhrania a neprejavovala sa v DLL knižnici).
  • Oprava tlačového výstupu pri neplatcovi DPH, kde IČO nebolo správne zarovnané.
  • Pridaný logo token pre tlač grafického loga v hlavičke dokladu, päte dokladu, alebo v popise položky dokladu.

5.21 - 2022-01-04

  • Úprava práce s timeoutmi pri použití úložiska CHDU Lite.
  • Oprava informácie o peňažnej mene na riadku so sumou dokladu.
  • Úprava inštalátora API služby, ktorý nemusel správne nainštalovať všetky potrebné softvérové závislosti.

5.20 - 2021-12-06

  • Zmena na úrovni knižnice NineDigit.eKasa.dll: závislosť LazyCache bola nahradená závislosťou Microsoft.Extensions.Caching.Memory.
  • K verzii 5.20 nebude vydaný API inštalátor, naďalej ostáva aktuálna verzia 5.19.

5.19 - 2021-11-15

Vylepšenia:

  • Pridaná podpora zaokrúhľovania: uvedená nová vlastnosť roundingAmount pre doklady typu pokladničný doklad (cashRegister), pargagón (paragon) a neplatný doklad (invalid). Hodnota môže nadobúdať číselný rozsah od -0.04 do 0.04.
  • Vylepšenie pri práci s tvorbou e-dokladu. PDF súbor používa písmo vstavané priamo v knižnici a nepoužíva sa písmo nainštalované v systéme.
  • Pridaná podpora pre písmo "C" pri tlači pokladničného dokladu. Konfiguračná premenná použiť malé písmo (konfiguračná vlastnosť printers.pos.useCondensedFont bola nahradená novou vlastnosťou printers.pos.font, kt. môže nadobúdať hodnoty FontA, FontB a FontC. Vrámci spätnej kompatibility je pre useCondensedFont == true použitá hodnota FontB vo vlastnosti Font).
  • Pridaná podpora pre tlač QR kódu na tlačiarniach od výrobcu Sanei - v nastaveniach režimu tlače QR kódu je pridaný nový mód Sanei.

5.18 - 2021-06-09

Opravy a vylepšenia:

  • opravy súvisiace s obnovou tabuľky indexov.
  • prísnejšia kontrola hodnôt: číslo jednoúčelového poukazu (voucherNumber), identifikátor dokladu (referenceReceiptId) a poloha pokladnice špecifikovaná vo voľnom formáte nesmú viac obsahovať netlačiteľné kontrolné znaky.

Servisná aplikácia:

  • pri vkladaní nových autentifikačných údajov je zobrazené potvrdzovacie okno, ktoré obsahuje dátum vydania a dátum exspirácie načítaného certifikátu.

5.17 - 2021-05-27

Opravy a vylepšenia:

  • doplnená automatická oprava vkladaných autentifikačných údajov v prípade, ak obsahujú nepovolené netlačiteľné znaky.
  • oprava chyby "BeginTransaction can only be called when the connection is open", ktorá vzniká pri čítaní nekompletných/poškodených záznamov v úložisku.
  • detailnejšie logovanie činnosti API služby (pridané ID vlákna, correlation ID a kompletné chybové odpovede).

5.16 - 2021-05-13

Opravy a vylepšenia:

  • jednoduchšia inštalácia viacerých API služieb na rovnakom počítači.
  • oprava pri spracovaní e-mailového dokladu: parameter RecipientDisplayName je označený, ako voliteľný.
  • v API službe pribudla možnosť pre získanie verzie produktu aj bez získania informácii o úložisku. Adresa endpointu: api/v1/product/info/ppekk.
  • Drobné opravy v OpenAPI / swagger dokumentácii dostupnej na adrese localhost:3010/docs.

5.15.1 - 2021-04-23

  • Vydaná servisná aplikácia "Portos eKasa servis", v ktorej je opravená možnosť použitia klávesy ENTER v nastaveniach predvoleného tela e-mailového dokladu.

5.15.0 - 2021-04-14

  • Pridaná podpora firmvéru 1.1 pre chránené dátové úožisko "CHDU Lite".

5.14.0 - 2021-04-08

Opravy a vylepšenia:

  • Vylepšené správanie aplikácie po zlyhanom pokuse o zápis do úložiska, kedy mohlo v niektorých prípadoch dôjsť k chybe Indexovacia tabuľka pokrýva viac záznamov, ako samotné úložisko.
  • Vylepšená indikácia chybových stavov vo webovej admin aplikácii (verzia web admin aplikácie 2.0.2).

Spätná kompatibilita:

  • Pri použití HTTP WEB API rozhrania ide o 100% spätne kompatibilnú verziu.
  • Pri použití DLL knižnice aktualizácia obsahuje jedinú spätne nekompatibilnú zmenu: vlastnosť ProductInfo triedy NineDigit.eKasa.Client bola nahradená metódou GetProductInfoAsync(CancellationToken).

5.13.0 - 2021-03-12

Opravy a vylepšenia:

  • Odstránená príčina chybového hlásenia The instance of entity type 'Unknown' cannot be tracked because another instance with the same key value for {'Id'} is already being tracked., ktorá nastávala po zlyhanom pokuse o zápis do úložiska.

5.12.0 - 2021-03-08

Opravy a vylepšenia:

  • Vylepšená kontrola uzamknutého stavu úložiska CHDU Lite.

5.11.0 - 2021-01-11

Opravy a vylepšenia:

  • Nové nastavenie RecipientDisplayName, ktorým je možné uviesť zobrazovacie meno adresáta pri odosielaní e-mailového dokladu.
  • Presnejšie a výpovednejšie chybové správy vznikajúce pri odosielaní e-mailových dokladov.

Webové admin rozhranie:

  • Dôležitá oprava, ktorá opravuje chybu znemožňujúcu načítanie zoznamu subjektov v prípade, ak niektorému z certifikátov ostávalo 5 až 30 dní do exspirácie. Nahratie nového certifikátu bolo v dôsledku tejto chyby skomplikované (dočasným riešením bolo vloženie údajov priamo cez adresu localhost:3010/subjects/edit alebo použitie servisnej aplikácie).
  • V sekcii nastavenia pribudla možnosť odoslania testovacieho dokladu e-mailom pre možnosť overenia správneho vloženia e-mailových nastavení.
  • Opravené vrátenie nepovinných polí do predvolených (prázdnych) hodnôt v sekcii emailových nastavení.

5.10.0 - 2020-12-18

Opravy a vylepšenia:

  • Oprava stavu po prerušenom, prípadne neúspešnom zápise do chráneného dátového úložiska, po ktorom mohla aplikácia vyhlásiť chybu Dáta v tabuľke indexov nekorešpondujú s dátami v úložisku.
  • Oprava pri vyčítavaní hlavičky nekorektne zapísaného, resp. poškodeného záznamu
  • Vylepšené logovanie chybových hlásení pri použití API služby.

5.9.0 - 2020-12-04

Vylepšenia:

  • Vylepšené hromadné vyčítavanie údajov pri úložisku typu CHDU Lite.

5.8.0 - 2020-11-26

Vylepšenia:

  • Vylepšenia a opravy v procese migrácie tabuľky indexov.
  • Opravené vyčítanie dokladov nespĺňajúcich validačné pravidlá pridané vo verzii 5.4, resp. 5.7.
  • Voľnejšia kontrola formátu emailovej adresy.

API služba:

Táto aktualizácia neobsahuje spätne nekompatibilné zmeny je pri použití pomocou HTTP API 100% spätne kompatibilná s predošlou verziou (5.7.x).

.NET knžinica:

  • Zvýšená verzia závislosti FluentValidation z 8.0.0 na 9.3.0 v knižnici NineDigit.eKasa.
  • Zverejnená servisná aplikácia PORTOS eKasa Servis vo verzii 5.8.0.
  • Zverejnená knižnica NineDigit.eKasa.StorageManagement vo verzii 2.2.4.
  • Zverejnená knižnica NineDigit.eKasa.Configuration vo verzii 3.1.0.

5.7.3 - 2020-11-03

  • Pridaná podpora pre chránené dátové úložisko typu "CHDU Lite".
  • Vydaná knižnica .NET knižnica Portos eKasa s označením 5.7.0.
  • Vydaná aplikácia Portos eKasa API 5.7.3.
  • Vydaná servisná aplikácia Portos eKasa Servis 5.7.4.

5.6.3 - 2020-10-27

Opravy:

  • Upravená kontrola použitia jednoúčelového poukazu: Ak sa okrem jednoúčelového poukazu na doklade nenachádza iná kladná položka v rovnakej sadzbe DPH, aplikácia vráti chybové hlásenie: Uplatnenie jednoúčelového poukazu nie je možné, nakoľko v rovnakej sadzbe DPH nebola nájdená žiadna položka s kladnou cenou, na ktorú sa poukaz uplatňuje..
  • Oprava pri kontrole maximálnej výšky zľavy pre danú sadzbu DPH.

5.6.2 - 2020-10-15

Vylepšenia v API:

  • Online aj offline .exe inštalátor v prípade Windows 7 automaticky nainštaluje .NET Framework 4.5

Vylepšenia v servisnej aplikácii:

  • Tlačidlo na export údajov z binárneho obrazu je po novom prístupné aj v prípade, ak CHDÚ nie pripojené k počítaču.

5.6.1 - 2020-10-12

Vylepšenia v API:

  • Inštalátor detekuje potrebu prítomnosti .NET Framework 4.5 na počítači (vzťahuje pre počítače s Windows 7)
  • Optimalizácia rýchlosti migračnej utility, ktorá je počas inštalácie zobrazená.

Vylepšenia v servisnej aplikácii:

  • Pridaná indikácia predpokladaného zostávajúceho času potrebného pre vytvorenie binárneho obrazu úložiska.

5.6.0 - 2020-10-07

Vylepšenia:

  • Interné opravy a vylepšenia pri práci s tabuľkou indexov.
  • Doplnene hlásenia pri logovaní.
  • Opravený návratový chybový kód, kedy pri neexistujúcom certifikáte bolo vrátené chybové hlásenie o exspirovanom certifikáte.

5.5.0 - 2020-09-29

Vylepšenia:

  • Interné opravy a vylepšenia v procesoch spracovávania fronty neodoslaných dátových správ.

5.4.0 - 2020-09-24

Zmeny:

  • Upravený výpočet celkovej sumy dokladu: v prípade, ak sa na doklade nachádza položka typu Voucher (jednoúčelový poukaz) prevyšujúca sumu položiek dokladu pre rovnakú sadzbu DPH, suma účtu pre danú sadzbu dokladu je nulová (predtým bola záporná). Napríklad: doklad obsahujúci prvú položku v hodnote 10 eur a sadzbe 20% a druhú položku typu Voucher v hodnote -10 eur a sadbze 10% má výslednú sumu 10 eur, nakoľko poukaz sa aplikuje iba na položky v rovnakej sadzbe DPH.
  • Nové validačné pravidlo pre položky dokladu (Items): Suma zliav (položky typu Discount) nesmie presiahnúť sumu ostatných evidovaných položiek dokladu v rovnakej sadzbe DPH.

Vylepšenia:

  • Optimalizácia a zvýšenie rýchlosti pri práci s veľkými index tabuľkami.
  • Interné vylepšenia v logovaní spracovávania fronty neodoslaných dátových správ.

5.3.3 - 2020-08-25

API služba:

  • Interné opravy a vylepšenia v inicializačnej procedúre API služby.

5.3.2 - 2020-08-24

API služba:

  • Opravy v migračnej utilite.

5.3.1 - 2020-08-20

API služba:

  • Opravy v migračnej utilite.

5.3.0 - 2020-08-13

Táto verzia je pri použití pomocou HTTP API 100% spätne kompatibilná s predošlou verziou (5.2.x). Pri použití pomocou .NET standard knižnice je zoznam zmien spísaný nižšie.

Vylepšenia:

  • Zvýšená rýchlosť pri práci s veľkými index tabuľkami.
  • Vylepšenia spracovávača fronty, týkajúce sa prioritizácie spracovania dátových správ.
  • Oprava chyby načítania certifikačných informácií na UNIX platforme.
  • Skrátenie času registrácie prvého dokladu vďaka automatickej inicializácii po štarte služby (podporované pri API službe). V prípade použitia cez knižnicu je možné pri štarte programu volať metódu Client.InitializeAsync

.NET standard knižnica:

  • Metódy InitializeAsync a InitializeQueueAsync pre inicializáciu triedy Cient po novom nepreberajú parameter ORPCode
  • Zmenený typ parametera metódy Certificate.IsValid z DateTime na DateTimeOffset.
  • V rozhraní ICertificateManager boli zmenené názvy metód: FindAllCertificatesAsync -> FindLatestCertificatesAsync, FindAllCertificateInfoAsync -> FindLatestCertificateInfoAsync, FindCertificateAsync -> FindLatestCertificateAsync, FindCertificateInfoAsync -> FindLatestCertificateInfoAsync, FindValidCertificateAsync -> FindLatestValidCertificateAsync, FindValidCertificateInfoAsync -> FindLatestValidCertificateInfoAsync.
  • V rozhraní IIdentityManager boli zmenené názvy metód: FindAllIdentitiesAsync -> FindLatestIdentitiesAsync, GetIdentityAsync -> GetLatestIdentityAsync, GetSingleAsync -> GetSingleIdentityAsync.

Knižnica StorageManagement:

  • v triede MigrationManager bola pridaná metóda IsUpgradableAsync, vďaka ktorej je možné zistiť potrebu migrácie.

5.2.1 - 2020-05-27

API služba:

  • interné vylepšenia súvisiace s inštalátorom API služby a migračným nástrojom.

.NET standard knižnica:

  • bola vydaná podporná knižnica NineDigit.eKasa.StorageManagement, ktorá obsahuje triedu MigrationManager vďaka ktorej je možné spustiť migráciu indexovacích súborov z formátu používaného do verzie 3 na formát používaný od verzie 5.

5.2.0 - 2020-05-14

Opravy:

  • oprava súvisiaca s tlačou dokladu v offline režime.

5.1.0 - 2020-05-13

Zmeny:

  • Ak na serveri finančnej správy nastane neznáma chyba (označovaná aj ako -1), aplikácia Portos eKasa vytlačí offline doklad a požiadavku zaradí do fronty neodoslaných dátových správ.

Zmeny v HTTP API vrstve:

  • Pre účely rýchlejšieho vyčítania obsahu fronty neodoslaných dátových správ pre konkrétny kód pokladnice bola uvedená nová URL {{server_address}}/api/v1/queue/items/unprocessed?cashRegisterCode=88812345678900001. Volaním GET požiadavky sú získané samotné položky fronty, volaním HEAD požiadavky je získaný počet týchto položiek. Viac v článku Kontrola stavu systému - Kontrola obsahu fronty neodoslaných správ.
  • Hlavička Content-Range má pri 0 záznamoch formát zmenený z items 1-0/0 na items 0-0/0. Odpovede s viac, ako 0 položkami majú zachovaný formát (napríklad items 1-50/50).
  • Do informácii vrátených pri chybe ClientLocked (-101) bolo pridané pole OriginUUID.

Zmeny v .NET Standard knižnici:

  • V hlavnej triede Client bola pridaná metóda InitializeAsync, ktorá vykoná nevyhnutné nastavenia a taktiež aj inicializáciu fronty, čo má za následok zrýchlenie prvotného zaevidovania dokladu alebo polohy. Vyvolanie tejto metódy je voliteľné. Metódu nie je počas života inštancie volať viac krát. Ak nebude táto metóda vyvolaná, pred prvým zaevidovaním dokladu alebo polohy bude inicializácia vykonaná automaticky.
  • Do enumerácie RegistrationRecordProcessStatus boli pridané nové stavy spracovania registrácie dokladu alebo polohy: Unfinished a Failed.
  • Zmena menného priestoru z NineDigit.eKasa.Core.Services na NineDigit.eKasa.Core.Data pre nasledovné dátové typy: InternetConnectionState, InternetConnectionStateInfo, InternetConnectionStateChange, IReceiptNumberToken, IIndexTableRestorationStatus, IIndexTableStatus, IndexTableRestorationMode, IRegistrationResponseRecordPointerContext, IRegistrationRequestRecordPointerContext, IRegistrationRecordExchangePointer, IRegistrationRecordExchangeContext, IRegistrationResponseRecordPointer. Zároveň bol premenovaný dátový typ ConnectionStateChange na RecordRepositoryConnectionStateChange a typ ConnectionState na RecordRepositoryConnectionState.
  • Zmena menného priestoru z NineDigit.eKasa.Core.Services na NineDigit.eKasa.Core.Data.Queries pre nasledovné dátové typy: SingleIdentityQuery, CertificateFilter a ReceiptNumberSelector. Zároveň bol premenovaný dátový typ SingleIdentityQuery na SingleIdentityFilter.

5.0.0 - 2020-04-27

Novinky:

  • Pridaná podpora nového 12-miestneho formátu IČO (upozornenie: v čase vydania tejto verzie podpora nového IČO formátu ešte nie je pripravená na eKasa serveri finančnej správy, predčasné použitie takýchto dát môže vyústiť v zablokovanie úložiska).
  • Vybavovanie fronty neodoslaných dátových správ je dočasne pozastavené, ak nadradená aplikácia zašle dopyt na vytlačenie dokladu.
  • V nastaveniach papierového dokladu pribudla možnosť "Povoliť inverznú sekciu", ktorou je možné vypnúť čierne podfarbenie riadku s celkovou sumou dokladu.
  • Kompletne prerobená indexácia, ktorá umožňuje rýchlejšiu prácu systému.

Zmeny:

  • DIČ musí odteraz mať dĺžku 10 znakov (doteraz bola dovolená dĺžka 8 až 10 znakov).

Zmeny pri inštalácii API služby:

  • API služba od verzie 5.0.0 potrebuje na počítači nainštalovaný .NET Core 3.1.
  • Nový typ inštalátora API služby, ktorý okrem samotnej služby Portos eKasa na počítači nainštaluje aj všetky potrebné záplaty (KB) aj prostredie .NET Core 3.1.

Zmeny pri práci s tabuľkou indexov:

  • Zmena formátu a názvu súboru tabuľky indexov. Pre použitie pôvodnej tabuľky indexov s verziou 5.0.0 a vyššou je potrebné spustiť migračnú procedúru. Inštalácia API služby ju spúšťa automaticky, počas inštalácie. V servisnej aplikácii je taktiež pridaná možnosť migrovať tabuľku.
  • Zmena názvu súboru tabuľky indexov. Migračná procedúra pri úprave formátu automaticky premenuje názov súboru.

Zmena v HTTP API vrstve:

  • pri volaniach vykonávajúcich priamu interakciu s tlačiarňou (tlač kópie dokladu, tlač nefiskálneho textu, tlač neodoslných dátových správ) je miesto doterajšej odpovede 204 - No Content bez tela odpovede vrátená odpoveď 200 - OK alebo 202 - Accepted s objektom obsahujúcim vlastnosť printed, ktorá indikuje, či bola tlačiareň v čase požiadavky pripravená a zapnutá, alebo nie. Obdobne, pri otvorení peňažnej zásuvky je vrátený objekt s vlastnosťou opened.
  • v návratovej odpovedi na požiadavku GET {server_address}/api/connectivity/status boli vlastnosti ValidFrom a ValidTo nahradené vlastnosťou RequestDate.

Zmeny v .NET Standard knižnici:

  • Pridaná podpora pre operačné systémy macOS a Linux. zoznam podporovaných distribúcii.
  • Dátový typ TextFormat, používaný pri formátovaní textu, bol premenovaný na TextFormats.
  • metóda client.GetMemoryStreamer() bola premenovaná na client.ExportStorageAsync().
  • metóda client.GetLatestLocationsAsync(CancellationToken) bola premenovaná na client.FindLatestLocationsAsync(CancellationToken).
  • trieda IdentityFactory bola premenovná na IdentityHelper.
  • trieda CertificateFactory bola premenovná na CertificateHelper.
  • trieda EkasaPathResolver bola premenovaná na EKasaPathHelper.
  • trieda InternetConnectionStateValue bola premenovaná na InternetConnectionStateInfo.
  • v triede ConnectivityMonitorStatus boli vlastnosti ValidFrom a ValidTo nahradené vlastnosťou RequestDate.
  • triedy RegistrationRecordExchange, ReceiptRegistrationRecordExchange, LocationRegistrationRecordExchange boli presunuté do NineDigit.eKasa.Core.Data.
  • enumeračný typ DuplicateKeys bol premenovaný na DuplicateKey a zmenený na triedu.
  • návratový typ metód client.PrintReceiptCopyAsync(ORPCode, Guid, CancellationToken), client.PrintReceiptCopyAsync(ORPCode, ID, CancellationToken), client.PrintReceiptCopyAsync(ReceiptId, CancellationToken), client.PrintReceiptCopyAsync(SingleReceiptRegistrationFilter, CancellationToken), client.PrintUnprocessedRequestsAsync(UnprocessedRegistrationFilter, CancellationToken) a client.PrintTextAsync(TextPrintContext, CancellationToken) bol zmenený z Task na Task<PrintResult>.
  • návratový typ metódy client.OpenDrawerAsync(DrawerPin?, CancellationToken) bol zmenený na Task<OpenDrawerResult>
  • všetky preťaženia metódy client.RegisterReceiptAsync a metóda client.PrintTextAsync(TextPrintContext, CancellationToken) vedia zlyhať s chybou PrinterNotReadyException.
  • metóda CreateRegistrationQuery() pre tried ReceiptRegistrationQuery a LocationRegistrationQuery bola premenovaná na ToRegistrationQuery().
  • metóda CreateRegistrationFilter() pre tried ReceiptRegistrationFilter a UnprocessedRegistrationFilter bola premenovaná na ToRegistrationFilter().
  • metóda client.FindRegistrationsAsync(RegistrationFilter, CancellationToken) bola odstránená. Prosím, použite metódu client.FindRegistrationsAsync(RegistrationQuery, CancellationToken)
  • metóda client.FindReceiptRegistrationsAsync(ReceiptRegistrationFilter, CancellationToken) bola odstránená. Prosím, použite metódu client.FindReceiptRegistrationsAsync(ReceiptRegistrationQuery, CancellationToken)
  • upravený predvolený JsonSerializerSettings, ak sa trieda JsonClientConfigurationFileDataSource inštanciuje len s uvedením cesty k JSON súboru.
  • enumeračný typ NineDigit.eKasa.Configuration.StorageModel bol nahradený triedou NineDigit.eKasa.Core.Data.StorageModel.
  • stav fronty reprezentovaný enumeráciou NineDigit.eKasa.Core.Services.QueueProcessState má 3 nové stavy: SuspendRequested, Suspended a Completed. Stav Idle bol premenovaný na NotProcessing.
  • stav položky fronty reprezentovaný enumeráciou NineDigit.eKasa.Core.Data.RegisterState má 3 nové stavy: Initializing, InitializeFailed a Initialized.

3.12.0 - 2020-06-17

Opravy

  • ďalšie interné vylepšenia a opravy so spracovaním položiek vo fronte neodoslaných dátových správ.

3.11.0 - 2020-06-04

Opravy

  • oprava so spracovaním položiek vo fronte neodoslaných dátových správ.

3.10.0 - 2020-03-01

Zmeny:

  • Vylepšenie inštalátora pre API službu, ktorý obsahuje verziu produktu.

Opravy:

  • ďalšia oprava v práci s číslovaním dokladov, ktoré zapríčiňovali chybu po uskutočnení registrácie dokladu na rozhraní kalendárnych mesiacov.

3.9.0 - 2020-02-28

Opravy:

  • oprava chýb v práci s číslovaním dokladov, ktoré zapríčiňovali chybu pri vkladaní prvého dokladu do ešte nepoužitého chráneného dátového úložiska.

3.8.0 - 2020-02-27

Opravy:

  • oprava v práci s číslovaním dokladov pri preuršení požiadavky nadradenou aplikáciou.

3.7.0 - 2020-02-26

Zmeny:

  • zmena spôsobu overovania certifikátu finančnej správy. Súčasný spôsob overenia nebude fuknčný po 3.3.2020, 10:00.

Opravy:

  • oprava v práci s číslovaním dokladov.
  • oprava MSI inštalátora, ktorý spôsoboval zlyhanie inštalácie na operačnom systéme Windows 7 Embedded.

3.6.0 - 2020-02-05

Zmeny:

  • nefiskálny doklad viac neobsahuje na začiatku a na konci text * * * NEPLATNÝ DOKLAD * * *
  • peňažná zásuvka sa otvára skôr - ešte pred registráciou a tlačou dokladu.
  • záporné položky dokladu typu Vrátená a Vrátené obaly sú tlačené s kladnou cenou a záporným množstvom.
  • kompletne prepracovaná a vylepšená správa fronty neodoslaných dátových správ.
  • z aplikácie bola odstránená možnosť nastavenia nasledujúceho čísla dokladu.
  • aplikácia v offline režime pred vytlačením dokladu čaká 2 sekundy, z dôvodu dodržania legislatívy § 2 písm. v) zákona č. 289/2008 Z.z.
  • vylepšené zabezpečenie aplikácie pri nesprávne nastavenom čase na počítači.
  • zmeny v API službe:
    • API: opravený obsah HTTP hlavičky Content-Range, kedy rozsah začínal číslom 0 a nie číslom 1.
    • inštalátor API služby obsahuje slovenskú lokalizáciu.
    • inštalátor API služby automaticky nastavuje ServicesPipeTimeout v registroch počítača pre predĺženie maximálneho času povoleného na spustenie služby.
    • pridaná podpora CORS v API službe
    • Oprava vo web admin aplikácii, ktorá nereagovala na zmenu portu, na ktorom je nastavená služba.
  • spätne nekompatibilné zmeny v knižnici:
    • metóda GetErrors(string) v triede ValidationResult premenovaná na GetMemberErrorMessages(string).
    • Triedy PrintingOptions v statickej metóde Create nepreberajú jednotlivé hodnoty, tie sú po novom nastaviteľné priamo cez vlastnosti objektu.
    • viaceré modelové zmeny pri práci s frontou neodoslaných dátových správ.

Opravy:

  • opravy pri tlači neodoslaných dátových správ.
  • rozpis DPH na doklade je zobrazený aj pre tie sadzby, kedy je suma v danej sadzbe nulová, avšak doklad obsahuje aspoň jednu položku prislúchajúcu do danej sadzby.
  • ak subjekt nie je platcom DPH, pri položkách dokladu nie je zobrazený odkaz na triedu DPH "C".

3.5.0 - 2019-10-28

Zmeny:

  • inštalátor API služby má v nastaveniach logovania (súbor serilogsettings.json) textové súbory a konzolu. Systémove event logy boli vynechané.

Opravy:

  • oprava chyby súvisiacej s časovým pásmom, ktorá zapríčiňovala chybové hlásenie "Nesprávna hodnota PKP".
  • oprava procesu získania nasledujúceho čísla dokladu, ak pomocný súbor client.dat ešte nebol vytvorený.
  • oprava v procese spracovania formátovacích sekvencií pri tlači dokladu.
  • optimalizácia procesu obnovy tabuľky indexov.

3.4.0 - 2019-10-03

Portos eKasa API v3.4.0

Pridané

  • pridaná možnosť obnoviť tabuľku indexov aj priamo z webového rozhrania. Nebude tak nutné otvárať servisnú aplikáciu.

Zmeny:

  • úprava práce so súborom číselníka (client.dat): poškodený súbor číselníka viac nebude vyhodnotený ako chyba.
  • pri aktualizácii nastavení prostredníctvom API rozhrania budú neuvedené nastavenia zachované. Doposiaľ boli neuvedené nastavenia nahradené za predvolené hodnoty.
  • odstránený indikátor kontroly číselníka údajov v úvodnej obrazovke webového rozhrania.

Opravy:

  • oprava "ReadOnly" chyby, ktorá mohla v niektorých prípadoch nastať pri zápise do tabuľky indexov.

Portos eKasa Servis 1.0.8

Zmeny:

  • v zozname neodoslaných dátových správ je miesto dátumu vytvorenia opakovanej požiadavky na odoslanie po novom zobrazený dátum vytvorenia pôvodnej dátovej správy.
  • odstránený indikátor kontroly číselníka údajov v úvodnej obrazovke.

Opravy:

  • oprava nesprávnej hodnoty v možnostiach rýchlosti sériovej tlačiarne (hodnota 112500 miesto 115200)
  • manuálne vyprázdnene políčok IČO a IČ DPH vo formulári identifikačných údajov malo za následok nemožnosť uložiť údaje.

3.3.0 - 2019-08-20

Pridané:

  • V servisnej aplikácií je možné v sekcii "Nastavenia" otvoriť peňažnú zásuvku.
  • V servisnej aplikácií boli pridané nové informácie do tlačového výstupu tlačeného v sekcii "Nastavenia".

Zmeny:

  • Zmena vyhodnocovania cesty k indexovaciemu súboru: nastavenie môže odteraz okrem cesty k súboru nadobúdať aj cestu k adresáru, alebo prázdnu hodnotu (tá doteraz nebola povolená). Novou predvolenou hodnotou je prázdna hodnota, miesto doterajšej indexTable.dat. V prípade prázdnej hodnoty bude aplikácia používať súbor v predvolenom pracovnom adresári aplikácie, so systémom generovaným názvom súboru vo formáte indexTable-{sériové číslo úložiska}.dat. V prípade, ak hodnota určuje adreár, aplikácia použije tento adresár v kombinácií s generovaným názvom súboru. Táto zmena je spätne kompatibilná.

Opravy:

  • Opravy a optimalizácie v režime zrýchlenej obnovy tabuľky indexov.

3.2.0 - 2019-08-12

Zmeny:

  • Zmena interného vyhodnocovania poradového čísla dokladov.

Opravy:

  • Oprava režimu zrýchlenej obnovy tabuľky indexov.

3.1.0 - 2019-07-26

Zmeny:

  • Upravený vzhľad položiek účtu. Sadzby DPH sú identifikované pomocou písmena (A, B alebo C). Položky s krátkymi názvami sa tak zmestia do jedného riadku.
  • V sekcii identifikačných údajov sa tlačí krajina iba vtedy, ak nereprezentuje Slovenskú republiku (nerovná sa reťazcom "Slovenska Republika" alebo "SK" alebo "Slovensko").
  • Pridaný tlačový výstup (bez QR kódu) aj v prípade, ak finančná správa odmietne zaregistrovať doklad.
  • Automatické zapisovanie "backup" záznamov priamo na úložisko, vďaka čomu je proces obnovy úložiska po strate alebo poškodení tabuľky indexov skrátený z niekoľkých hodín na sekundy až minúty. Je potrebné, aby ešte pred prípadnou poruchou bola použitá táto verzia systému Portos.

Pridané:

  • Pridaná podpora pre bohatšie formátovanie textu. Horizontálne zarovnanie a formát textu. K dispozícii je akákoľvek kombinácia formátovania z možností: hrubé písmo, podčiarknuté písmo, dvojitá výška, dvojitá šírka a inverzia. Viac v sekcii tlač nefiskálneho dokladu - text token.
  • Pridaná podpora pre určenie grafického loga pre konkrétny doklad (pomocou nastavenia print.options.LogoMemoryAddress pri použití tlačiarne print.printerName: pos).
  • Pridaná podpora pre vytvorenie binárneho obrazu dátového úložiska priamo z knižnice.
  • V servisnej aplikácii aj vo webovom rozhraní je možné vytlačiť testovací tlačový výstup (v sekcii nastavenia).
  • V servisnej aplikácii aj vo webovom rozhraní je možné vytlačiť autentifikačné údaje podnikateľa.
  • V servisnej aplikácii je možné vyčítať obsah úložiska (binárny obraz) a taktiež aj jeho export do adresárovej štruktúry predpísanej finančnou správou.
  • Detailnejší prehľad kontroly stavu systému v servisnej aplikácii aj vo webovom rozhraní.

Opravy:

  • Oprava pri preberaní tlačových nastavení v HTTP API.
  • Oprava správy cache vo webovom rozhraní, ktorá zapríčiňovala, že po aktualizácii systému Portos.eKasa sa mohla zobrazovať predošlá verzia webového rozhrania.
  • Oprava štartu windows služby, ktorá zapríčiňovala, že sa niekedy nemusela služba spustiť spolu so štartom systému.
  • Oprava tlače dlhých dokladov, ktorá bola zapríčinená nedostatkom vo firméri chráneného dátového úložiska CHDU-SK.

3.0.0 - 2019-06-18

Zmeny:

  • Zmena dátového typu dátumových premenných z DateTime na DateTimeOffset (zmena len pre prácu s knižnicou, HTTP API rozhranie ostáva zachované).
  • Platba dokladu môže obsahovať aj nulový obnos
  • Na predtlači dokladu je pri paragóne zobrazený aj dátum a čas paragónu.
  • Na predtlači dokladu sú zobrazené časové informácie už aj so sekundami. Rok je v skrátenom, 2-miestnom formáte.

Pridané:

  • Pridaná podpora pre tlač na termo papier so šírkou 57mm.
  • Pridaná podpora pre tlač na šírku 40 znakov.
  • Pridané nastavenie printers.pos.useCondensedFont pre použitie menšieho písma (FontB)
  • Pridané nastavenie printers.pos.codePageTableNumber pre určenie kódovej stránky tlačiarne, ak sa kódová stránka pc852 nachádza pod iným číslom.
  • Pridané nastavenie printers.pos.feedLinesCount pre určenie počtu prázdnych riadkov pridaných na konci pokladničného dokladu.
  • Pridané nastavenie printers.qr.enableMargin pre možnosť odsadenia prázdnym riadkom pred a za grafickými prvkami - QR kódom a čiarovým kódom.
  • Pridaná možnosť tlače nefiskálneho dokladu s údajmi o podnikateľskom subjekte (v objekte nefiskálneho dokladu je potrebné uviesť okrem text aj pole cashRegisterCode).

Opravy:

  • Opravené vyhodnocovanie správnosti časovej zóny nastavenej na počítači.

2.0.4 - 2019-05-24

Zmeny:

  • Aplikované avizované zmeny zo strany finančnej správy, aktualizovaná adresa integračného rozhrania finančnej správy.
  • Predvolená hodnota voliteľného parametera čísla pinu pri otváraní peňažnej zásuvky nie je fixne pin2, ale preberá sa z konfigurácie aplikácie.

2.0.3 - 2019-05-20

Zmeny:

  • 1D Čiarový kód je v režime online tlačený v systéme Code93, miesto doterajšieho Code128, pre zvýšenie počtu kompatibilných zariadení.

Pridané:

2.0.1 - 2019-05-16

Opravy:

  • Oprava v tlačovej šablóne pokladničného dokladu.

2.0.0 - 2019-05-15

Zmeny:

  • Lepšie prispôsobenie predtlače na nastavenie počtu znakov na riadok configuration.printers.pos.charactersPerLine, pre nastavenie aj na 48 znakov na riadok.
  • Zvýšená verzia PPEKK (pokladničný program ekasa klient) z v1.0 na v2.0. Aby bola zarovnaná verzia Portos eKasa knižnice s verziou vstavaného PPEKK, preskakujeme verziu 1.X a z 0.X sa verzia zvyšuje rovno na 2.X.

0.6.2 - 2019-05-13

Opravy:

  • Oprava vyčíslenia percentuálneho progresu pri obnove tabuľky indexov.

Zmeny:

  • Optimalizované načítavanie aktuálnej podoby autentifikačných údajov z úložiska.

0.6.1 - 2019-05-13

Pridané:

  • Nový atribút elementWidth pri tlačení čiarového kódu pomocou barcodeToken pre určenie horizontálnej šírky elementu.
  • Nový atribút konfiguračného objektu configuration.printers.printReceiptIdBarcode, ktorým je možné zapnúť za QR kódom s unikátným identifikátorom dokladu tlač čiarového kódu, ktorý obsahuje v prípade dokladu zaregistrovaného v online režime unikátny identifikátor odkladu, v prípade offline režimu overovací kód podnikateľa (OKP). V oboch prípadoch ide o hodnotu, ktorú je treba uvádzať pri vrátení tovaru v poli referenceReceiptId. Odpadá tak nutnosť zabezpečovať snímače QR kódov. Čiarový kód však používa najjemnejšie nastavenie šírky elementu čiarového kódu (šírka elementu 1), ktorý nemusí byť podporovaný všetkými typmi tlačiarní. V prípade, že čiarový kód obsahuje OKP, hodnota je uvedená bez symbolov -, oddeľujúcich segmenty identifikátra. Napríklad miesto OKP c44b3977-0e415cc6-ee663aa1-776c973a-a143b660 je v čiarovom kóde uvedené c44b39770e415cc6ee663aa1776c973aa143b660. Unikátny identifikátor dokladu je v čiarovom kóde zakódovaný v pôvodnej podobe, teda aj s oddeľovacími symbolmi -.
  • Nová windows aplikácia Portos eKasa servis určená pre servisných technikov aplikácií, ktoré integrujú produkt Portos eKasa vo forme knižnice (mimo HTTP WEB API ktorá poskytuje na tieto úkony webovú admin aplikáciu).

Opravy:

  • opravená návratová hodnota vlastnosti taxFreeAmount pri registrácii dokladu.

0.6.0 - 2019-05-09

Pridané:

  • Nastavenie komunikačnej rýchlosti sériovej linky medzi chráneným dátovým úložiskom a sériovou tlačiarňou (configuration.Storage.ChduPrinterBaudRate).
  • Nový NuGet balík NineDigit.eKasa.Configuration pre inštanciáciu konfiguračného objektu z JSON alebo YAML súboru.

Zmeny:

  • Obohatený formát chybových výstupov z HTTP WEB API služby, ktorý po novom obsahuje vlastnosť code. Zoznam všetkých chybových kódov spolu s riešeniami vzniknutej situácie je k dispozícii v sekcii chybové kódy.
  • Optimalizácia spracovania fronty neodoslaných správ.
  • Upravený formát settings objektu v HTTP WEB API službe (language zmeneny na cultureName, všetky vlastnosti objektu client sú na úrovni koreňového objektu).

0.5.4 - 2019-05-01

Opravy:

  • Opravená chyba číslovania dokladu pri prechode na nový kalendárny mesiac.

0.5.2 - 2019-04-28

Opravy:

  • Oprava chyby pri rekonštrukcii tabuľky indexov.

0.5.1 - 2019-04-26

Pridané:

  • Pridaná voliteľná vlastnosť položky účtu ReceiptItem.Description, ktorá umožňuje vložiť doplnkové texty (sériové čísla, dátumy exspirácie, ...), ktoré nebudú odosielané do systému eKasa.

Opravy:

  • Odstránená chyba v tlačovej šablóne dokladu, ktorá zapríčiňovala, že v sumáre DPH nebola tlačená sadzba 0%.

0.5.0 - 2019-04-25

Zmeny:

  • Jednotková cena položky dokladu môže obsahovať až 6 desatinných miest.
  • Tlač grafického loga je zarovnávaná na stred dokladu.
  • Možnosť uviesť pri tlači dokladu nastavenia pre otvorenie zásuvky a tlač loga, ktoré majú prednosť pred nastavením aplikácie.
  • Dĺžka názvu platidla je zvýšená na 255 znakov.

Pridané:

  • Možnosť načítať počet záznamov z úložiska vyhovujúcich filtri bez potreby ich časovo náročnej deserializácie.

0.4.4 - 2019-04-20

Pridané:

  • Implementované stránkovanie (pagination) pri získavaní záznamov z dátového úložiska.