# Riešenie problémov

> Známe problémy pri integrácii a prevádzke eKasy a ich riešenie, súbory denníka na diagnostiku a kontakt na podporu.

Zdroj: https://ekasa.ninedigit.sk/docs/troubleshooting

Keď niečo nefunguje, začnite [kontrolou stavu systému](https://ekasa.ninedigit.sk/docs/status): č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](https://ekasa.ninedigit.sk/docs/rest-api/error-codes).

## Známe problémy

- [Inštalátor pre Linux sa nespustí](https://ekasa.ninedigit.sk/docs/troubleshooting/linux-installer-tmp-noexec): Chyba Permission denied, keď je /tmp pripojený s noexec.

## 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](https://ekasa.ninedigit.sk/docs/product-info). Porovnajte ju s [históriou zmien](https://ekasa.ninedigit.sk/historia-zmien), chybu už mohla opraviť novšia verzia.
2. **Hľadajte riešenie v dokumentácii** Pozrite [Časté otázky](https://ekasa.ninedigit.sk/docs/faq), [Známe problémy](#známe-problémy) a [Chybové kódy](https://ekasa.ninedigit.sk/docs/rest-api/error-codes). 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](mailto:info@ninedigit.sk) alebo cez [formulár](#kontakt) pod článkom. Ako ich stiahnuť, popisuje časť [Ako získať súbory denníka](#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](https://ekasa.ninedigit.sk/docs/dotnet/logging).

### Cez webové rozhranie

V menu **Systém → Údržba**, riadok **Súbory denníka**, kliknite na tlačidlo **Archivovať**.

### <span id="logy-cez-api" class="anchor"></span>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:

```http
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:

```bash
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):

```powershell
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](https://ekasa.ninedigit.sk/docs/security#prihl%C3%A1senie)) |
| `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 |
