Hibakezelés
Ez az oldal a megbízotti számlakibocsátásra és az önszámlázásra jellemző hibakódokat sorolja fel: az eredeti üzenettel, az előfordulás helyzetével és a teendővel. Az általános Agent hibakezelés (a szlahu_error és szlahu_error_code headerek) leírása: Agent hibakezelés.
A hibák a folyamat lépései szerint csoportosítva szerepelnek:
- hogyan érkezik a hiba - hol keresd a hibaüzenetet és a kódot,
- kapcsolat és fióklétrehozás hibái - az
action-agent_ceg_mbhívás hibái, - számlaszám előtag hibái - a megbízotti előtag-logika hibái,
- számlaműveleti hibák - sztornó, helyesbítés, ismétlés,
- nyugta-hibák - megbízotti nyugtakibocsátás,
- tesztfiók-hibák - a tesztüzem sajátosságai.
Hogyan érkezik a hiba?
- Számla Agent: a hibaüzenet a
szlahu_errorHTTP válasz headerben, a numerikus kód aszlahu_error_codeheaderben érkezik. action-agent_ceg_mb: sikernél az eredmény azXML_AGENT_RESPONSEheaderben jön; hibánál ugyanazok aszlahu_error/szlahu_error_codeheaderek.- Webes felület: ugyanezek az üzenetek a vezérlőpulton jelennek meg.
Kapcsolat és fióklétrehozás hibái (action-agent_ceg_mb)
| Kód | Üzenet | Jelentés és teendő |
|---|---|---|
| 3 | Sikertelen bejelentkezés. | Hibás bejelentkezési név vagy jelszó. Javítsd a belépési adatokat, és próbáld újra. |
| 7 | Hiányzó adat: (mező). | Kötelező adat hiányzik a kérésből. Két esetben fordul elő: „Hiányzó adat: Számla Agent kulcs vagy bejelentkezési név/jelszó" (nem küldtél hitelesítési adatot), illetve „Hiányzó adat: Számlaszám előtag" (a <cegszamlaszamelotag> üres - az API-s kérelemben az előtag kötelező). Pótold a hiányzó mezőt. |
| 68 | Már létezik cég ezzel az adószámmal és számlaszám előtaggal. | Egyeztess másik előtagot a megbízóval. |
| 101 | Ez a bejelentkezési név már foglalt, kérjük, válassz másikat. | Csak új megbízói fiók létrehozásakor fordul elő: a <usremail>-ben megadott bejelentkezési nevet már használja egy felhasználó. Használj új, dedikált e-mail címet/bejelentkezési nevet a megbízotti felhasználóhoz. |
| 137 | Jelenleg nincs jogosultsága ahhoz, hogy ilyen módon hozzon létre számlázási fiókot. Ha mégis szeretne, vegye fel a kapcsolatot ügyfélszolgálatunkkal (szamlazz.hu/kapcsolat) | A fiókodban nincs engedélyezve az agent_ceg_mb interfész. Hozzáférést az ügyfélszolgálaton keresztül kérhetsz. |
| 164 | Ez a felhasználó (név) több számlázási fiókhoz is hozzáfér, így a funkció nem üzemképes. | A kérésben megadott felhasználó egynél több fiókhoz fér hozzá. Agent kérést (POST-tal beküldött XML-t) csak olyan felhasználóval lehet beküldeni, amely pontosan egy fiókhoz fér hozzá; szüntesd meg a felhasználó hozzáférését a többi fióknál, vagy használj dedikált felhasználót. |
| 250 | Ez a fiók nem használható, mert a fiókgazda még nem regisztrált. Üzenetet küldtünk a fiókgazdának, hogy vegye birtokba a fiókját (e-mail cím). | A <usrMb> felhasználóval próbáltál belépni vagy számlázni, mielőtt a megbízó birtokba vette volna az új fiókot. Ha van függőben lévő fiókgazdai meghívó, a rendszer ilyenkor automatikusan újraküldi a meghívó e-mailt a megbízónak. Várd meg, amíg a megbízó aktiválja a fiókot, és utána próbáld újra. |
| 309 | Érvénytelen adat: (mező). | Érvénytelen adat, pl. hibás formátumú adószám a <cegtaxnumber> mezőben. Javítsd az értéket, és küldd újra. |
| 337 | Az előtag csak nagybetűket és számokat tartalmazhat, és hossza legfeljebb 5 karakter lehet. | A <cegszamlaszamelotag> formátuma hibás. Csak nagybetűkből és számokból álló, legfeljebb 5 karakteres előtagot küldj. |
A 3-as, 164-es és 250-es hiba nem csak itt fordulhat elő: ezek a belépéskor keletkeznek, így bármely megbízotti Agent hívásnál (számla- vagy nyugtakiállításnál) is jelentkezhetnek.
Már létező fiók a megadott adószámmal
Ha a <cegtaxnumber>-ben megadott adószámmal már van fiók a rendszerben, az nem hiba: a hívás nem hoz létre második fiókot, hanem a helyzettől függően e-mailt küld (újra), és az eredményt szöveges válaszként az XML_AGENT_RESPONSE headerben adja vissza:
| Eset | Mi történik | Válasz (XML_AGENT_RESPONSE) |
|---|---|---|
| A fióknak még nincs fiókgazdája | A fiókgazdai meghívó e-mail újraküldésre kerül. | „Már létező fiók, nincs fiókgazdája. Fiókgazdai meghívó (megbízott számlakibocsátás) email újraküldve." |
Van fiókgazda, és a <usremail> felhasználóra már van függő kérelem | A csatlakozási kérelem e-mail újraküldésre kerül a fiókgazdának. | „Már létező fiók fiókgazdával. A csatlakozási kérelem emailt újraküldtük a fiókgazdának." |
| Van fiókgazda, nincs függő kérelem ehhez a felhasználóhoz | Új csatlakozási kérelem jön létre, a fiókgazda e-mail értesítést kap. | „Már létező fiók fiókgazdával. Csatlakozási kérelmet küldtünk a fiókgazdának." |
Ilyenkor a kérésben küldött cégadatok (cégnév, cím, bankszámla, e-mail stb.) a meglévő fiókot nem módosítják; az értesítő e-mail a fiókban tárolt cégemail címre és a fiókgazda e-mail címére megy, nem a kérésben megadott <cegemail>-re. Kapcsolódó hibák:
- 68 - ha a küldött
<cegszamlaszamelotag>előtagot ez az adószám már használja, a hívás a fenti táblázat helyett 68-as hibával áll le. Egyeztess másik előtagot a megbízóval. - 101 - csak új fiók létrehozásakor fordul elő; már létező fióknál a rendszer a meglévő
<usremail>felhasználót használja a kérelemhez. - 250 - ha a fiókgazda még nem vette birtokba a fiókot, és közben a
<usrMb>felhasználóval próbálsz belépni (lásd a táblázatban fentebb).
Számlaszám előtag hibái
| Kód | Üzenet | Jelentés és teendő |
|---|---|---|
| 200 | Ezt az előtagot ugyanezzel az adószámmal jelenleg is használja egy számlázási fiók számla/nyugta előtagként. Kérjük, válassz másik előtagot! | Az előtagot ugyanez az adószám egy másik aktív fiókban jelenleg is használja. Előfordulhat az action-agent_ceg_mb hívásnál, a csatlakozási kérelem elfogadásakor és új előtag regisztrálásakor is. Válassz másik előtagot. |
| 202 | Ez a számlaszám előtag nem létezik vagy nincs engedélyezve: (előtag). | Az előtag számlatömbje tiltott (nem engedélyezett) vagy NAV számlaszám-ütközés miatt blokkolt. A tiltott tömböt a megbízó fiókjában a Beállítások > Előtagok oldalon lehet engedélyezni; a NAV miatt blokkolt tömb nem oldható fel, helyette másik előtag kell. |
| 353 | Nincs egyetlen érvényes számlaszám előtag sem. | Nincs engedélyezett számlatömb a fiókban. Hozz létre vagy engedélyezz egy számlatömböt. |
| 354 | Ez a számlaszám előtag nem használható. | Az előtag másik megbízotté, nyugta típusú, vagy már készültek vele számlák, így nem vehető át. Az egyeztetett megbízotti előtagot használd. |
| 356 | A megadott számlaszám előtag helyett használd ezt: (előtag). | Már van megbízotti számlatömböd ennél a megbízónál. Az üzenetben visszaadott előtagot használd. |
| 357 | Kérjük, add meg a számlaszám-előtagot. | Nem küldtél előtagot, és automatikusan nem választható ki, mert nincs, vagy egynél több megbízotti számlatömböd van. Küldd az egyeztetett előtagot a <szamlaszamElotag> mezőben. |
| 360 | Ez az előtag nem módosítható, mert már használták számlakiállításhoz. | A felületen jelenik meg, amikor az előtagok szerkesztésére jogosult felhasználó (jellemzően a megbízó fiókgazdája) a Beállítások > Előtagok oldalon átnevezne egy olyan előtagot, amellyel már készült bizonylat. A már használt előtag nem módosítható; ha új előtagra van szükség, új számlatömböt kell létrehozni. |
| 362 | Ezt az előtagot ez az adószám korábban már használta. Kérjük, válassz másik előtagot. | Az előtagot ez az adószám korábban már használta egy azóta letiltott (már nem aktív) fiókban. Válassz másik előtagot. (A 200-as párja: ott a másik fiók még aktív.) |
A hibák mögötti döntési logika: Előtagkezelés - Döntési fa.
NAV számlaszám-ütközés miatt blokkolt előtag
A NAV Online Számla összekötés kialakításakor (és a NAV-beállítások mentésekor) a rendszer a fiók minden számlaszám előtagját ellenőrzi a NAV rendszerében: lekérdezi, hogy a következő kiállítandó számlaszám (pl. ELOTAG-2026-12) szerepel-e már a NAV adatszolgáltatásban. Ha igen - jellemzően azért, mert egy másik számlázó program már küldött be számlát ugyanezzel az előtaggal -, a rendszer a számlatömböt blokkolja, hogy ne keletkezhessen duplikált számlaszám.
A blokkolt tömb a Beállítások > Előtagok oldalon figyelmeztető ikonnal jelenik meg, nem szerkeszthető és nem is engedélyezhető újra; használj helyette másik előtagot. Ha blokkolt előtaggal próbálsz számlázni, 202-es hibát kapsz.
Számlaműveleti hibák (sztornó, helyesbítés, ismétlés)
| Kód | Üzenet | Jelentés és teendő |
|---|---|---|
| 358 | Ezt a számlát csak a fiók tulajdonosa sztornózhatja. | Megbízotti felhasználó próbálta a megbízó által kiállított számlát sztornózni. A sztornót a megbízó végezze. |
| 359 | Ez a számla megbízott számlakibocsátás keretében készült. A sztornózást kérd a megbízottól: (cégnév). | A megbízó próbált megbízotti számlát sztornózni. Az üzenet megnevezi a megbízottat. |
| 489 | Ez a számla megbízott számlakibocsátás keretében készült. Az ismétlést kérd a megbízottól: (cégnév). | A megbízó próbált megbízotti számlát ismételni. Kérd a megbízottól. |
| 493 | Ezt a számlát csak a fiók tulajdonosa helyesbítheti. | Megbízotti felhasználó próbálta a megbízó számláját helyesbíteni. A helyesbítést a megbízó végezze. |
| 494 | Ez a számla megbízott számlakibocsátás keretében készült. A helyesbítést kérd a megbízottól: (cégnév). | A megbízó próbált megbízotti számlát helyesbíteni. Az üzenet megnevezi a megbízottat. |
| 17 | Nem megengedett művelet. | Ezt a hibát kapod akkor is, ha megbízotti felhasználóként próbálsz számlát ismételni; az ismétlés megbízottként nem érhető el. |
Nyugta-hibák
| Kód | Üzenet | Jelentés és teendő |
|---|---|---|
| 7 | Hiányzó adat: nyugtaszám előtag. | Az <elotag> mező nyugtánál kötelező. Küldd az egyeztetett nyugta-előtagot. |
| 8 | Nincs jogosultságod vagy megfelelő díjcsomagod a művelet elvégzéséhez (művelet)! | A megbízott fiók szolgáltatáscsomagja nem tartalmazza az Agentes nyugtakibocsátást (az ingyenes csomag kivételével minden csomag tartalmazza), vagy a dedikált felhasználó szerepköréhez nincs hozzárendelve a nyugtakibocsátási jog. |
| 336 | Ezt az előtagot a számlázás már használja, így nem lehet nyugta előtag. | Az előtag már számla-előtag. Használj külön nyugta-előtagot. |
| 524 | Ez a nyugtaszám előtag nincs engedélyezve. | A nyugta-előtagot a megbízó fiókjában letiltották. Engedélyezni a Beállítások > Előtagok oldalon lehet, az előtagot kiválasztva az „Engedélyezem az előtag használatát" jelölővel. Kérd meg erre a megbízót, vagy használj másikat; meglévő nyugta sztornóját a tiltás nem akadályozza. |
Tesztfiók-hibák
| Kód | Üzenet | Jelentés és teendő |
|---|---|---|
| 167 | Teszt fiók számla darabszám túllépés. Kérjük, próbálkozz újra pár perc múlva. | A tesztfiók túllépte a néhány perc alatt Agenttel készíthető számlák számát. Várj pár percet, és próbáld újra. A limit éles fiókra nem vonatkozik. |
Tesztüzemben az Agent csak XSD-valid XML-t fogad el, így az éles fióknál esetleg tolerált sémahibák itt elutasításra kerülnek. Bővebben a tesztüzemi viselkedésről: A folyamat tesztelése.
Általános hibák, amelyek itt is előfordulhatnak
Minden standard Agent hiba előfordulhat megbízotti hívásoknál is: pl. XML feldolgozási hibák, hiányzó jog egy bizonylattípushoz (díjbekérő, szállítólevél, előlegszámla), vagy NAV-hoz kötődő hibák. Lásd az általános Agent hibakezelés oldalt.