Riešenie problémov

Integrujem cez

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:

  1. 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.

  2. 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 /.

  3. 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 externalId alebo identifikátor (UID či OKP).

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:

  1. Zistite adresu eKasy

    Na počítači so službou je to http://localhost:3010. Na Androide IP adresa zariadenia s portom 3010, napríklad http://192.168.1.24:3010. IP adresu nájdete v nastaveniach Wi-Fi zariadenia; počítač musí byť v rovnakej sieti.

  2. 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.zip v aktuálnom priečinku.

  3. Pošlite ich podpore

    Súbor ekasa-dennik.zip prilož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
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.