﻿# Hibaelhárítás és GYIK

> Minden oldal a licenc oldalra visz. Az alkalmazásnak nincs érvényes licence (nincs, lejárt vagy sérült). Töltsön fel egy licencfájlt; amíg nincs érvényes licenc, ehhez nem kell bejelentkezni (Licenc).

Source: https://workwise-solutions.net/hu/docs/troubleshooting-faq/ · Language: hu · English version: https://workwise-solutions.net/docs/troubleshooting-faq/

## Hol kezdje a keresést

1. **Hiba Események**: a felhasználóknak visszaadott hibák, kérésazonosítóval ([Események és naplók](https://workwise-solutions.net/hu/docs/features/audit-and-logs/)).
2. **Naplófájlok**, vagy a szerver naplói: `docker logs -f worksmarthub`, `journalctl -t WorkSmartHub -f`, illetve a `Logs` mappa.
3. **Státusz**: verzió, adatbázis, felhasználói tár, valamint a saját jogosultságai és csoportjai.

## Telepítés és indulás

**Minden oldal a licenc oldalra visz.** Az alkalmazásnak nincs érvényes licence (nincs, lejárt vagy sérült). Töltsön fel egy licencfájlt; amíg nincs érvényes licenc, ehhez nem kell bejelentkezni ([Licenc](https://workwise-solutions.net/hu/docs/features/licence/)).

**`SECURITY:` figyelmeztetések a naplóban induláskor.** Valamelyik aláíró kulcs még a gyári értéken van, vagy a `PublicBaseUrl` üres ([Beállítások](https://workwise-solutions.net/hu/docs/installation/configuration/#aláíró-kulcsok)).

**`libsodium` hiba induláskor Windowson.** Hiányzik a Microsoft Visual C++ Redistributable (x64) ([Windows (IIS)](https://workwise-solutions.net/hu/docs/installation/windows-iis/)).

**Active Directoryval az alkalmazás nem indul Linuxon vagy Dockerben.** Az Active Directory csak Windowson használható. Használjon LDAP-ot, Entra ID-t vagy OAuth-t ([Hitelesítés](https://workwise-solutions.net/hu/docs/installation/authentication/)).

**A konténer nem érhető el.** Állítsa be a `HttpSettings__Urls__0=http://+:8080` értéket a `-p` leképezés konténer oldali portjával.

**`appsettings.json is read-only` a naplóban.** Csak tájékoztatás: egy újabb kiadás új beállításai az alapértelmezett értékükkel működnek, amíg fel nem veszi őket a fájlba.

**Nem futottak le az ütemezett háttérfolyamatok.** A folyamatnak folyamatosan futnia kell. IIS alatt ellenőrizze a *Start Mode: AlwaysRunning*, az *Idle Time-out: 0* és a *Preload Enabled* beállítást ([Windows (IIS)](https://workwise-solutions.net/hu/docs/installation/windows-iis/)). A futási időpontok a szerver helyi idejében értendők (Dockerben UTC).

## Bejelentkezés

**Bejelentkezés után azonnal kijelentkeztet, vagy elveszik a munkamenet.** A bejelentkezési süti csak HTTPS-en keresztül megy át. Szolgálja ki az oldalt HTTPS-en; telepített rendszeren ne kapcsolja ki a `SecureCookie` beállítást.

**Egy másik szerveren újra be kell jelentkezni.** Minden szervernek ugyanaz az `appsettings.json` kell, a JWT aláíró kulccsal együtt, és ugyanaz az adatbázis.

**Nem érkezik meg az elfelejtett jelszó e-mail.** Az oldal ismert és ismeretlen címre is ugyanazt a választ adja, így nem árulja el, létezik-e a fiók. Ellenőrizze az `EmailSettings` beállítást és a hiba eseményeket. Jelszó-visszaállítás csak lokális és külső felhasználóknak érhető el.

**„Bad Request – Header field too long” Active Directoryval.** A felhasználó sok csoport tagja; növelje a HTTP.sys fejléckorlátait ([Windows (IIS)](https://workwise-solutions.net/hu/docs/installation/windows-iis/)).

## Jogosultságok és láthatóság

**Egy felhasználó nem lát egy menüpontot.** Ellenőrizze az alkalmazás jogosultságait és a munkaterület szerepköreit ([Jogosultságok és szerepkörök](https://workwise-solutions.net/hu/docs/permissions-and-roles/)). Az *Alkalmazás* szakasz oldalai rejtve vannak azok elől, akiknek csak *Public* joguk van, kivéve, ha az **Oldal Láthatóságok** kategóriában engedélyezve vannak.

**Egy felhasználó nem lát egy munkajegyet.** A technikusok és olvasók csak a hozzájuk vagy a csoportjukhoz rendelt munkajegyeket látják. Ellenőrizze a munkajegy *Munkát végző felhasználók/csoportok* mezőjét és a felhasználó csoportjait (Státusz oldal, *Minden csoport*).

**A technikus nem tud módosítani egy mezőt.** A technikus csak a státuszt, a felelősöket, a munkafolyamatokat, a komponenseket és a mellékleteket módosíthatja; a többi mező csak olvasható.

**A munkajegy mentése után nem változtak az ügyfél adatai.** Az ügyfél adatait munkajegyből csak bizonyos felhasználók módosíthatják; a munkajegy elmentődött, az ügyfél nem ([Jogosultságok és szerepkörök](https://workwise-solutions.net/hu/docs/permissions-and-roles/#ügyféladatok-módosítása-munkajegyből)).

**A munkaterület választó azt írja: „Nincs hozzáférése egyetlen munkaterülethez sem”.** A felhasználónak egyetlen munkaterületen sincs szerepköre.

## Munkajegyek

**A mentés komponens mennyiségi hibával meghiúsul.** Egy komponensből nincs elég a raktárban. Csökkentse a mennyiséget, vagy növelje a készletet a **Komponensek** oldalon.

**„Munkajegy ezzel a névvel már létezik”.** A munkajegyek neve munkaterületen belül egyedi.

**Nem tudok szállítási státuszt választani.** A *Kiszállításra vár*, *Kiszállítás alatt* és *Kiszállítva* státuszhoz szállításnak kell lennie a munkajegyen.

**A „Fájlok kiválasztása” gomb nem aktív.** Előbb válasszon fájltárolót, és mentse el a munkajegyet.

**A „Késés értesítés küldése” gomb nem aktív.** A munkajegy lezárt státuszban van.

**Senki nem kapott értesítést.** A munkajegyhez nincs értesítési csatorna rendelve, vagy a felhasználók értesítési mezői üresek, illetve a profiljukon leiratkoztak. Próbálja ki a csatornát a **Teszt** gombbal.

**Nem mennek ki az ügyfél e-mailek.** Az ügyfél e-mailek az `appsettings.json` `EmailSettings` beállítását használják, nem az értesítési csatornákat. Feladó cím (`FromEmail`) nélkül az e-mailek elmaradnak, a munkajegyek ettől még elmentődnek. A sikertelen küldés figyelmeztetésként kerül a naplóba (*Failed to send … to client*), és az e-mail nem jelenik meg az **Ügyfél Email Események** oldalon, amely csak a ténylegesen elküldött e-maileket mutatja.

## Fájlok és feltöltések

**A feltöltés 413 Request Entity Too Large hibával meghiúsul.** Egy fordított proxy elutasította a kérés törzsét. Engedélyezzen legalább a darabméretnek megfelelő méretet (alapértelmezetten 25 MB): nginxben `client_max_body_size 50m;`, Kubernetesen az ingress body size annotációja.

**Nem tölthető fel komponenskép.** Csak PNG és JPEG fogadható el, és csak alkalmazás szintű fájltárolóba.

**Módosítás után sikertelen a fájltároló tesztje.** Adja meg újra a titkos értéket: egy módosított fájltároló teszteléséhez ez szükséges ([Fájltárolók](https://workwise-solutions.net/hu/docs/features/file-storages/)).

**A szerver áthelyezése után nem működnek a mellékletek linkjei.** A linkek minden kéréskor az aktuális kiszolgáló címével épülnek fel; ha mégsem működnek, megváltozott a linkek aláíró kulcsa. Költözéskor tartsa meg ugyanazokat a kulcsokat.

## E-mail csatornák

**Az SMTP teszt bekapcsolt SSL mellett sikertelen.** A szervernek STARTTLS-t kell támogatnia, megbízható és a gépnévvel egyező tanúsítvánnyal. A 465-ös port (implicit TLS) nem támogatott; használja az 587-est.

**Az SMTP szerver módosítása után a mentés hibát ad.** Ugyanabban a mentésben adja meg újra a jelszót: ha megváltozik, hová kerül egy titkos érték, újra meg kell adni.

## Számlák

**A végszámlává alakítás „próbálja újra később” üzenettel elutasítva.** Éppen rögzítés alatt áll egy fizetés a Számlázz.hu-ban; várjon 2 percet. Sikertelen fizetésrögzítés után előbb a **Fizetés rögzítése újra** műveletet használja.

**Figyelmeztetés szerint megváltozhatott a Számlázz.hu fiók.** A Számlázz.hu-ban talált bizonylat nem egyezett a számlával. Ellenőrizze, hogy az API kulcs a megfelelő fiókhoz tartozik-e ([Számlák](https://workwise-solutions.net/hu/docs/features/invoices-szamlazz-hu/)).

**Nem készült el automatikusan a számla.** Az automatikus számlázás csak akkor fut, ha Munkajegy Admin (nem technikus) teszi a munkajegyet *Számlázandó* státuszba, ha a munkajegyhez nem tartozik nem sztornózott számla (a sikertelen is ide számít), és ha a számlázás be van kapcsolva. Az elutasítás oka a **Hiba Események** oldalon és a naplóban látható.

**A munkajegyen a Számla kiállítása gomb nem használható.** A munkajegy számláinak ablakában az ellenőrzőlista pirossal mutatja, mi hiányzik: az API kulcs, a cégadatok, a számla előtag, az ügyfél neve, címe és városa, vagy a számlázható tételek. Pótolja a hiányzó adatot, és nyissa meg újra az ablakot.

![Ellenőrzőlista hiányzó adattal](https://workwise-solutions.net/docs/images/szamlazz-ticket-checklist-missing.png)
*Az Ügyfél neve, címe és városa megadva ellenőrzés piros: az ügyfélnek nincs megadva a városa.*

**A konfiguráció ellenőrzése sikertelen.** A *Sikertelen bejelentkezés. Ellenőrizze az API kulcsot.* üzenet azt jelenti, hogy a Számlázz.hu elutasította a tárolt kulcsot: adja meg újra a megfelelő fiók agent kulcsát. A *Nem sikerült csatlakozni a Számlázz.hu-hoz.* üzenet azt jelenti, hogy a szerver nem éri el a Számlázz.hu-t.

**Az előnézet elutasítja az áfakezelést.** Az ügyfél nem felel meg a választott áfakezelésnek, például magyar ügyfélnél közösségen belüli áfakezelés, vagy magyar adószám nélküli ügyfélnél belföldi fordított adózás esetén. Javítsa az ügyfél országát, közösségi adószámát vagy adószámát, vagy válasszon másik áfakezelést.

![Elutasított áfakezelés](https://workwise-solutions.net/docs/images/szamlazz-error-treatment.png)
*A Közösségen belüli szolgáltatás áfakezelés csak másik EU-tagállambeli ügyfélnek választható, az ügyfél magyarországi.*

**Az euró vagy dollár számlát az alkalmazás árfolyam nélkül elutasítja.** Ha a számla pénzneme eltér az árpénznemtől, meg kell adni a cég által a teljesítés napjára alkalmazott árfolyamot. Írja be az *Árfolyam* mezőbe.

![Hiányzó árfolyam](https://workwise-solutions.net/docs/images/szamlazz-error-rate.png)
*A HUF árakból EUR számla csak árfolyammal készülhet: az Árfolyam mező kitöltése kötelező.*

**A helyesbítés árfolyamot kér.** Az euró vagy dollár számlán nincs tárolt árfolyam. Írja be az eredeti számlán feltüntetett árfolyamot; nélküle a helyesbítő számla nem állítható ki.

![Árfolyamot kérő helyesbítés](https://workwise-solutions.net/docs/images/szamlazz-correction-rate.png)
*Az E-UCFXX-2026-127 számla EUR pénznemű, és nincs eltárolva az árfolyama.*

**A Számlázz.hu elutasította a számlát.** A számla *Sikertelen* állapotban tárolódik, és a sora mutatja a Számlázz.hu hibakódját és üzenetét. Szüntesse meg az okát, törölje a sikertelen számlát, és állítsa ki újra. A példában a beállításokban megadott számla előtag nem létezik a Számlázz.hu fiókban.

![A Számlázz.hu által elutasított számla](https://workwise-solutions.net/docs/images/szamlazz-error-refused.png)
*202: Ez a számlaszám előtag nem létezik vagy nincs engedélyezve.*

**A Számlázz.hu nem válaszolt.** A számlán ez áll: *A Számlázz.hu nem adott értékelhető választ a számla kiállítására*, a kimenetel ismeretlen. 5 percig nem indítható új kísérlet (*Az előző számla kiállítására a Számlázz.hu nem adott értékelhető választ, és néhány percig még elkészülhet.*). Utána az újrapróbálás előbb megkeresi a bizonylatot a Számlázz.hu-ban, és ha megvan, eltárolja; az állapotszinkronizáló háttérfolyamat a következő futásakor ugyanezt teszi. A Számlázz.hu-t nem kell kézzel ellenőriznie.

![Elutasított új kísérlet](https://workwise-solutions.net/docs/images/szamlazz-unknown-refusal.png)
*Az előző számla kiállítására a Számlázz.hu nem adott értékelhető választ, és néhány percig még elkészülhet.*

**Nem készül el a helyesbítő számla.** A helyesbítés előtt a WorkSmartHub frissíti a számla fizetési állapotát a Számlázz.hu-ból. Ha a Számlázz.hu nem válaszol, az üzenet így végződik: *A helyesbítő számla nem készült el; néhány perc múlva próbálja újra.* Ha a Számlázz.hu-ban a számla számán másik bizonylat van, ellenőrizze az API kulcsot.

**Az alkalmazás elutasítja a második számlát.** *A munkalaphoz már tartozik ilyen típusú érvényes vagy kiállítás alatt álló bizonylat.* A munkajegynek már van ilyen típusú nyitott bizonylata, vagy egy másik felhasználó ugyanabban a pillanatban kiállította. *A munkalapra az elmúlt 5 percben már készült bizonylat*: az elmúlt 5 percben már készült bizonylat a munkajegyre. Frissítse az oldalt, és nézze meg a munkajegy számláit.

**Mentéskor az alkalmazás elutasítja az áfakulcsot vagy a pénznemet.** Bekapcsolt számlázásnál az áfakulcs 27, 18, 5 vagy 0, az árpénznem HUF, EUR vagy USD lehet ([Számlák](https://workwise-solutions.net/hu/docs/features/invoices-szamlazz-hu/#beállítás)).

## GYIK

**Használható a WorkSmartHub telefonon?** A webes felület asztali képernyőre készült. Telefonon a mobil alkalmazást használja, amelyet a **Mobil Alkalmazás** menüpont QR kódjával lehet aktiválni ([Mobil alkalmazás](https://workwise-solutions.net/hu/docs/features/mobile-app/)).

**Módosíthatók az e-mailek szövegei?** Igen, a szerveren lévő sablonfájlok szerkesztésével ([Értesítések](https://workwise-solutions.net/hu/docs/features/notifications/#sablonok)).

**Megjeleníthető a felület angolul?** Nem, a felület magyar nyelvű.

**Az ügyfél törlése a munkajegyeit is törli?** Igen. Törlés helyett inkább állítsa az ügyfelet *Inaktív* állapotúra.

**A munkajegy törlésekor visszakerülnek a komponensek a készletbe?** Igen, a törölt munkajegy összes komponense visszakerül a raktárkészletbe.

**Hogyan látom, ki módosított egy munkajegyet?** Az **Események** oldalon, típusra és felhasználóra szűrve. A munkajegy lista időpontjai fölé víve az egeret az is látszik, ki hozta létre és ki módosította utoljára az adott munkajegyet.

**Használhatja több csapat ugyanazt a telepítést úgy, hogy ne lássák egymás munkáját?** Igen, erre valók a munkaterületek ([Munkaterületek](https://workwise-solutions.net/hu/docs/features/workspaces/)).
