Keď niečo nefunguje, začnite kontrolou stavu systému: často ukáže príčinu sama, napríklad nepripravenú tlačiareň alebo výpadok spojenia. Chybu v odpovedi API vyhľadajte podľa kódu v článku Chybové kódy.
Známe problémy
Keď sa obraciate na podporu
Mnohé problémy vyriešite rýchlejšie sami. Skôr ako nám napíšete, prejdite tieto kroky:
- Overte, že máte najnovšiu verziu
Verziu nájdete na úvodnej stránke webového rozhrania v časti Pokladničný program alebo cez Informácie o produkte. Porovnajte ju s históriou zmien, chybu už mohla opraviť novšia verzia.
- Hľadajte riešenie v dokumentácii
Pozrite Časté otázky, Známe problémy a Chybové kódy. Celú dokumentáciu prehľadáte ikonou lupy alebo klávesom
/. - Napíšte nám a priložte súbory denníka
Na info@ninedigit.sk alebo cez formulár pod článkom. Ako ich stiahnuť, popisuje časť Ako získať súbory denníka.
Do správy uveďte:
- verziu eKasy a systém, na ktorom beží (Windows, macOS, Linux alebo Android a model zariadenia),
- čo ste urobili, čo ste očakávali a čo sa stalo, aj s približným časom,
- chybovú odpoveď API, ak prišla (kód a text),
- pri probléme s dokladom jeho
externalIdalebo identifikátor (UIDčiOKP).
Ako získať súbory denníka
Súbory denníka (logy) služby a aplikácie pre Android stiahnete ako jeden ZIP súbor vo webovom rozhraní alebo cez API. Pri .NET knižnici zapisuje denník vaša aplikácia, pozri Logovanie.
Cez webové rozhranie
V menu Systém → Údržba, riadok Súbory denníka, kliknite na tlačidlo Archivovať.
Cez API
Webové rozhranie nie je vždy dostupné. Na Androide sa napríklad neotvorí, kým zariadenie aktivuje alebo overuje licenciu, API na stiahnutie súborov denníka však funguje aj vtedy:
GET {server_address}/api/v1/logs
Accept: application/zip
Hlavička Accept musí byť application/zip alebo */*, inak eKasa odpovie 406 Not Acceptable.
Súbory denníka tak stiahnete z ľubovoľného počítača nástrojom curl, ktorý je súčasťou Windows 10 a 11, macOS aj bežných distribúcií Linuxu:
- Zistite adresu eKasy
Na počítači so službou je to
http://localhost:3010. Na Androide IP adresa zariadenia s portom3010, napríkladhttp://192.168.1.24:3010. IP adresu nájdete v nastaveniach Wi-Fi zariadenia; počítač musí byť v rovnakej sieti. - Stiahnite súbory denníka
V termináli spustite príkaz nižšie s adresou z prvého kroku. Uložia sa do súboru
ekasa-dennik.zipv aktuálnom priečinku. - Pošlite ich podpore
Súbor
ekasa-dennik.zippriložte k správe pre podporu.
macOS a Linux:
curl -f -o ekasa-dennik.zip -H "Accept: application/zip" http://192.168.1.24:3010/api/v1/logs
Windows (príkazový riadok aj PowerShell; v PowerShelli píšte curl.exe, samotné curl je tam iný príkaz):
curl.exe -f -o ekasa-dennik.zip -H "Accept: application/zip" http://192.168.1.24:3010/api/v1/logs
Ak sťahovanie zlyhá, curl súbor nevytvorí a vypíše kód chyby:
| Kód | Príčina | Riešenie |
|---|---|---|
401 |
eKasa vyžaduje prihlásenie | pridajte meno a heslo: -u meno:heslo (Prihlásenie) |
406 |
chýba hlavička Accept |
pridajte -H "Accept: application/zip" |
bez kódu (Failed to connect) |
nesprávna adresa alebo iná sieť | overte IP adresu a že počítač a zariadenie sú v rovnakej sieti |