Blog

„Nem létező országkód” – amit az első OKIRkapu XML-feltöltésem tanított

Október 20. előtt három héttel ülök neki egy ügyfél negyedéves EPR-bevallásának, és az OKIRkapu két sorban közli: kritikus hiba. Elmesélem, mi bukott el, mit javítottunk, és hogyan zárom ma már tíz perc alatt a negyedévet.

Varga Enikő – mérlegképes könyvelő, EPR és termékdíj ügyintéző2026. 09. 30.5 perc olvasás

Október eleje van, és ha EPR-kötelezett céget könyvelsz vagy vezetsz, most érzed a gyomrodban a határidőt: a 3. negyedéves adatszolgáltatást október 20-áig kell beküldeni az OKIRkapun. Én is ezen a héten ültem neki egy ügyfél zárásának – és az első feltöltésre a rendszer két sorban közölte: kritikus hiba.

A hibaüzenet annyit mondott: „Nem létező ország kód!” – a székhely és a kapcsolattartó országkódjára. Pedig az XML szerkezetileg rendben volt, a sémaellenőrzés hibátlanul lefutott. Akkor mi a baj?

A hiba, amire senki nem számít

A megoldás a kódlistákban rejlett: az OKIRkapu a 301-es kódlista szerinti, hárombetűs ISO országkódot vár – Magyarország esetén HUN-t –, mi pedig a mindennapokban megszokott, kétbetűs HU-t írtuk a fájlba. Egyetlen betű különbség, és a teljes feltöltés visszapattan.

A tanulság: a sémaellenőrzés csak azt nézi, hogy az XML szerkezete megfelel-e a hatósági leírásnak. Azt már a beküldéskor ellenőrzi a rendszer, hogy a tartalom – kódlista, azonosító, kötelező mező – is stimmel-e. Ezért éri meg beküldés előtt átfuttatni a fájlt egy ellenőrzőn, vagy olyan eszközből generálni, ami ezeket a részleteket is kezeli.

A három leggyakoribb buktató, amit a gyakorlatban látok

  • Hiányzó kötelező adatok: a székhely címe és a kapcsolattartó neve, beosztása, telefonszáma és e-mail-címe kötelező mező – ha bármelyik üres, a rendszer visszadobja a fájlt.
  • Rossz országkód-formátum: a mindennapi HU helyett az OKIRkapu a HUN hárombetűs kódot várja a 301-es kódlista szerint.
  • Elgépelt vagy rosszul bontott KF-kód: a nyolc karakteres kódot a rendszer négy részre bontva várja, és a 7. karakternek a teljesítési móddal, a 8.-nak a származással kell egyeznie.

Így zárom le ma már a negyedévet tíz perc alatt

  1. 1Kiválasztom a negyedévet, és átfutom a számlatételeket – a rendszer jelzi, ha hiányzik KF-kód vagy tömegadat.
  2. 2Megnézem a valós idejű MOHU-díj-előrejelzést, hogy ne a számla érkezésekor érjen meglepetés.
  3. 3Egy kattintással letöltöm a hivatalos sémának megfelelő OKIRkapu XML-t és a könyvelői Excel-kimutatást.
  4. 4Feltöltöm a kapu.okir.hu felületen, elmentem az érkeztetési visszaigazolást, és kipipálom a zárási ellenőrzőlistát.

A titok nem a sebesség, hanem az, hogy a fájl már a letöltés pillanatában beküldésre kész: az országkód HUN, a kötelező cég- és kapcsolattartói adatok a cégprofilból töltődnek, a KF-kódok pedig a számlatételekből, négy részre bontva kerülnek a fájlba.

Ne hagyd az utolsó napra: a határidő közeledtével az OKIRkapu rendszeresen túlterhelt, és a beküldés órákig is eltarthat. Ha október 20-a hétvégére vagy munkaszüneti napra esik, a határidő attól még nem tolódik automatikusan – mindig a tárgynegyedévet követő hónap 20. napja az irányadó.

Ha még nem töltötted ki a cégprofilban a székhelyet és a kapcsolattartó adatait, tedd meg most – az adatszolgáltatás-ellenőrző ezek hiányát már a letöltés előtt jelzi, nem a beküldéskor.

A 3. negyedév zárása nem kell, hogy rémálom legyen. Ha az adataid rendben vannak, a zárási varázsló végigvezet a lépéseken, és a végén olyan XML-t kapsz, amit az OKIRkapu elsőre elfogad – ahogy azt a fenti ügyfélnél is láttuk, amint a HUN kód a helyére került.

Kapcsolódó tudásbázis-cikkek