A QualitySoft KönyvelőHíd és Számlázó API-val a könyvelési iktató és a Számlázó modul programozottan\n kezelhető: bizonylat kiállítása, sztornózása, kifizetettség rögzítése, bizonylatok\n letöltése PDF-ben és XML-ben, iktatott számlák átadása és visszafrissítése.
\nA leírás fejlesztőknek készült, akiknek a számlázási vagy iktatási\n folyamatot automatizálni kell — egyszerű XML-üzenetekkel, HTTP-n keresztül.
" }, { "id": "hitelesites", "cim": "Hitelesítés", "rovid": "Számlázó-kulcs egy céghez, iroda-kulcs a KönyvelőHíd-műveletekhez.", "html": "\nMinden művelet első paramétere az apiKey. Kétféle kulcs van:
qsu_live_… / qsu_test_…) — egyetlen\n céghez tartozik. A companyId elhagyható: a kulcsból következik, és\n nem is írható át. Számlázó-integrációhoz ezt használd. A\n Beállítások → Számlázó API-kulcsok szekcióban hozod létre; a kulcs csak a\n létrehozáskor olvasható ki — utána már nem, csak visszavonható.companyId (legfeljebb 8 karakteres Cég azonosító) kötelező. A\n Beállítások → KönyvelőHíd API szekcióban generálod, könyvelt évenként\n egyet: ott jelszóval újra megjeleníthető, és új kulcs is generálható — ilyenkor a régi\n azonnal érvénytelen. Évnyitás után az új év kulcsát kell beírni.A cégek azonosítóit a cegek művelet adja, és a kulcs megjelenítésekor a\n Beállítások is felsorolja; egy cég azonosítóját a Fiók → Cégek oldalon lehet módosítani.\n A Számlázó-műveletekhez a Számlázó-kulcsok valók.
Kétféle kulcs adható ki, és a kettő különböző céget szolgál ki:
\nqsu_live_… — éles kulcs a valódi céghez: valódi sorszám,\n NAV-adatszolgáltatás, a bizonylat bekerül a könyvelési iktatóba.qsu_test_… — teszt kulcs a sandbox céghez. A sandbox egy\n önálló, DEMO licencű cég a fiók alatt, amit az API-kulcsok ablakban egy\n gombbal létre lehet hozni.A sandbox nem korlátozott üzemmód, hanem külön cég — ezért:
\nT20260731234753-897-24-2Y8f). Erre\n azért van szükség, mert a teszt rendszer minden demo felhasználó számára közös,\n és ott a sorszámok különben ütköznének — a NAV ilyenkor „a megadott számla\n sorszámmal már történt adatszolgáltatás\" hibát adna, ami félrevezető. A\n bizonylaton, a PDF-en és minden lekérdezésben a valódi sorszám marad; a\n NAV-nak küldött számot a szamlaAdatok válasza\n navSzamlaszam néven adja meg;Az integráció fejlesztését mindig teszt kulccsal kezdd. A\n szamlazoKulcsInfo válaszában a ceg.sandbox mondja meg, hogy a\n kulcsod melyik környezetben dolgozik.
SOAP 1.1, document/literal. Minden művelet önálló végpont és önálló\n WSDL: /docs_back/soap/<művelet>.php, illetve\n <művelet>.wsdl. A kérés POST,\n Content-Type: text/xml; charset=utf-8.
Bármely SOAP-kliens működik. PHP-ból:
\n$c = new SoapClient('https://ugyfelkapu.qualitysoft.hu/docs_back/soap/szamlaKiallitas.wsdl');\n$v = $c->szamlaKiallitas(['apiKey' => 'qsu_live_…', 'bizonylat' => $bizonylat]);\necho $v->szamlaszam; // SZR2026/0351" }, { "id": "korlatok", "cim": "Csomag-korlátok és sebességkorlát", "rovid": "Éves bizonylat-keret és kulcsonkénti sebességkorlát.", "html": "\n
Az ingyenes csomagok éves bizonylat-kerettel működnek. A keret állapotát\n a szamlazoKulcsInfo bármikor megmutatja, és minden kiállító válasz\n visszaadja a keretMaradek értékét. Keret kimerülésekor a válasz\n KERET_KIMERULT hiba.
A sztornó és a helyesbítő nem fogyaszt keretet — a hibajavítás ingyenes.
\nSebességkorlát (Számlázó-kulcs): kulcsonként 120 kérés / perc, csúszó\n egyperces ablakban. Felette SEBESSEGKORLAT hiba, és a következő percben újra\n mehet — az elutasított kérések nem tolják tovább a büntetést. Kötegelt feltöltésnél\n érdemes a hívások közé kis szünetet tenni, vagy a kötegelt műveleteket használni\n (a szamlaKiegyenlites egy hívásban több befizetést is rögzít).
Emellett IP-címenként percenként 20 sikertelen hitelesítés engedett;\n e felett minden Számlázó-hívás SEBESSEGKORLAT hibát kap arról a címről,\n akkor is, ha a kulcs érvényes. Ez kulcs-találgatás ellen véd — a gyakorlatban csak\n rosszul beállított kulcsnál fordul elő.
Iroda-kulcs (KönyvelőHíd-műveletek): kérésszám-korlát nincs — a\n könyvelőprogramok kötegelt szinkronja miatt. A sikertelen hitelesítésre itt is\n IP-címenként percenként 20 próba engedett: e felett az érvénytelen kulccsal\n érkező hívások SEBESSEGKORLAT hibát kapnak; az érvényes kulcsú hívásokat\n ez nem érinti.
Naplózás: minden hívásról napló készül (időpont, művelet, kulcs, cég,\n eredmény, válaszidő), amit az ügyfélkapu API-kulcsok ablakában az iroda maga\n is megnéz — hibakeresésnél ez az első hely, ahol érdemes körülnézni.\n A kérések tartalmát (vevő, tételek, összegek) nem naplózzuk, és a\n kulcs sem kerül bele, csak a lenyomata.
" }, { "id": "hibak", "cim": "Hibakezelés", "rovid": "SOAP Fault magyar szöveggel, gépi hibakóddal és mezőútvonallal.", "html": "\nA hibák SOAP-ENV:Fault formában jönnek. A faultstring\n magyar, felhasználónak is megmutatható szöveg; a detail gépi\n feldolgozásra adja a hibakódot és — validációnál — az érintett mező útvonalát.
<SOAP-ENV:Fault>\n <faultcode>SOAP-ENV:Client</faultcode>\n <faultstring>A vevő adószáma kötelező belföldi ÁFA alanynál.</faultstring>\n <detail>\n <kod>VALIDACIO</kod>\n <mezo>fej/vevoAdoszam</mezo>\n </detail>\n</SOAP-ENV:Fault>\n
Hibakódok: HITELESITES, NINCS_JOG, VALIDACIO,\n NEM_TALALHATO, ALLAPOT_HIBA, KERET_KIMERULT,\n NINCS_VALTOZAS, SEBESSEGKORLAT, NAV_HIBA,\n SZERVER_HIBA, FIOK_ZAROLVA, KH_LEJART.
A KönyvelőHíd-műveletek közös szabályai: a hiányzó companyId\n NEM_TALALHATO; a csak megtekintésre megosztott cégre író művelet\n (átvétel, kiegyenlítés, feltöltés) NINCS_JOG; a törlés alatt álló (zárolt) cégre\n FIOK_ZAROLVA, a lejárt KönyvelőHíd-előfizetésű fiókban KH_LEJART —\n ezekben az esetekben az olvasás, a letöltés is, továbbra is működik.
A tételszámítás bruttó egységárból indul — ez a QS számlázó és a számlakép\n hitelesített viselkedése:
\nbruttoErtek = mennyiseg × bruttoEgysegar × (1 − kedvezmeny/100)\nnettoErtek = bruttoErtek / (1 + afaSzazalek/100)\nafaErtek = bruttoErtek − nettoErtek\n
A tételen bruttoEgysegar vagy nettoEgysegar adható\n meg — a kettő együtt validációs hiba. Nettó megadásakor a szerver bruttót képez, majd\n a fenti képlettel számol vissza, ezért 1–2 filléres eltérés lehet a te\n nettó-alapú számításodhoz képest. A válasz minden tételnél visszaadja a tényleges,\n szerveroldali összegeket — ezeket tekintsd hitelesnek, ne a sajátodat.
A NAV-köteles bizonylat adatszolgáltatása nem szinkron: a kiállítás\n sorba állítja, a beküldés a háttérben fut. A válaszban ezért\n navStatusz = KULDES_ALATT szerepel.
A végállapotot a szamlaAdatok művelettel kérdezd le — jellemzően\n 1–5 percen belül SIKERES vagy HIBA. Hiba esetén a\n navHibaSzoveg adja a NAV üzenetét.
A beküldést szerveroldali háttér-feldolgozó végzi, néhány percenként — tehát\n akkor is lefut, ha senki nem nyitja meg a felületet.
\nSandbox környezetben a NAV a bizonylat valódi sorszáma helyett egy\n időbélyeges, egyedi számot kap (ld. Környezetek) — így a közös teszt rendszerben\n nem ütközik más demo felhasználó bizonylatszámával. A sztornó és a helyesbítő\n ugyanerre a számra hivatkozik, ezért a hivatkozási lánc a NAV-nál is helyes.
" } ], "csoportok": [ { "id": "szlazo-biz", "cim": "Számlázó · Bizonylatok", "alap": "szamlazo", "muveletek": [ { "nev": "szamlaKiallitas", "allapot": "eles", "sum": "Bizonylat létrehozása és kiállítása", "leiras": [ "Egy hívásban létrehozza a bizonylatot, és — ha azazonnaliVeglegesites értéke IGEN — ki is állítja: sorszámot ad a bizonylattípus maszkja szerint, pillanatképet ment a kibocsátóról és a vevőről, szerveroldalon újraszámolja az összegeket, PDF számlaképet generál, átvezeti a Kimenő számla iktatóba, és NAV-köteles típusnál sorba állítja az adatszolgáltatást.",
"Kiállítás után a bizonylat nem módosítható és nem törölhető — javítani sztornóval vagy helyesbítővel lehet. Ha a vevő még nem volt a partnertörzsben, automatikusan bekerül.",
"Előleg és végszámla. Az ELŐLEGSZÁMLA is ezzel a művelettel készül, bizonylatTipusKod=03 értékkel. A hozzá tartozó végszámlán az elolegSzamlaszam mezőben adja meg az előlegszámla sorszámát — a szerver a kiállításkor ellenőrzi, hogy létező, kiállított, nem sztornózott előlegszámláról van-e szó, amit még nem használt fel másik bizonylat, és a pénzneme a végszámláéval azonos. Az előleg levonását a szerver végzi: a tételek végére áfakulcsonként egy „Előleg levonása — előlegszámla: …” sor kerül, −1 mennyiséggel és az előleg bruttó összegével (a helyesbített előlegszámlánál a helyesbítés utáni összeggel), így a végszámla végösszege már a levont összeg; a NAV-adatban ezek a sorok előlegjelölést és a levont előleg adatait kapják. Levonó sort ne küldjön a tételek között. Egy előlegszámla egy bizonylathoz kapcsolható; a végszámla sztornózása felszabadítja, így újra felhasználható. Hibás hivatkozásnál VALIDACIO hiba érkezik, a mezo részletben fej/elolegSzamlaszam értékkel."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Cég- vagy iroda-szkópolt API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező; cég-kulcsnál elhagyható."
},
{
"k": "azonnaliVeglegesites",
"t": "IGEN|NEM",
"d": "Alapérték IGEN. NEM esetén piszkozat marad, később szamlaVeglegesites-sel állítható ki."
},
{
"k": "bizonylat/fej",
"t": "bizonylatFejType",
"r": 1,
"d": "A bizonylat feje.",
"gy": [
{
"k": "bizonylatTipusKod",
"t": "string(3)",
"r": 1,
"d": "Típuskód a bizonylatTipusLista-ból (pl. 01). Helyette bizonylatTipusId is adható."
},
{
"k": "vevoNev",
"t": "string(50)",
"r": 1,
"d": "A vevő neve, ahogy a számlán megjelenik."
},
{
"k": "vevoAdoszam",
"t": "string(13)",
"d": "Csak magyar adószám, formátum 12345678-2-42 (vagy a 8 jegyű törzsszám). Magyar, nem magánszemély vevőnél kötelező; megadva a NAV felé belföldi ÁFA-alanyként (DOMESTIC) megy, a vevő országától függetlenül. Betűt tartalmazó érték (pl. ATU12345678) VALIDACIO hiba — az EU-s adószám a vevoEuAdoszam-ba való."
},
{
"k": "vevoEuAdoszam",
"t": "string(16)",
"d": "Külföldi vevő adószáma — a jelentését a vevoOrszag dönti el. EU-tagállam: közösségi adószám, az ország kétbetűs előtagjával (pl. ATU12345678, DE123456789, görögnél EL…; a szóköz, pont, kötőjel kiesik); EU-s, nem magánszemély vevőnél kötelező, ha nincs magyar adószáma; HU előtag nem adható (a magyar vevő adószáma a vevoAdoszam-ba kerül). A NAV felé communityVatNumber. EU-n kívüli ország: a harmadik országbeli adóazonosító (thirdStateTaxId), nem kötelező (kivétel: XI előtagú észak-írországi közösségi adószám)."
},
{
"k": "vevoIrsz",
"t": "string(8)",
"r": 1,
"d": "Irányítószám. Nem magánszemély vevőnél a kiállítás feltétele (a NAV-adatszolgáltatás része): magyar címnél csak szám; külföldinél betű is lehet (pl. 1234 AB, nagybetűsítve megy a NAV-hoz), 3–10 karakter (betű, szám, szóköz, kötőjel). Ha a címnek nincs irányítószáma: 0000."
},
{
"k": "vevoVaros",
"t": "string(30)",
"r": 1,
"d": "Település."
},
{
"k": "vevoCim",
"t": "string(40)",
"r": 1,
"d": "Utca, házszám."
},
{
"k": "vevoEmail",
"t": "string(45)",
"d": "Ide megy a szamlaEmail küldése."
},
{
"k": "maganszemely",
"t": "IGEN|NEM",
"d": "Magánszemély vevő — a NAV felé PRIVATE_PERSON, név és cím nélkül."
},
{
"k": "kelte",
"t": "date",
"r": 1,
"d": "Bizonylat kelte. Éve meg kell egyezzen az aktuális könyvelt évvel."
},
{
"k": "teljesites",
"t": "date",
"r": 1,
"d": "Teljesítés kelte."
},
{
"k": "fizHatarido",
"t": "date",
"d": "Elhagyva a típus alapértelmezett határidejéből számolt érték."
},
{
"k": "fizetesiMod",
"t": "fizetesiModType",
"r": 1,
"enum": [
"ATUTALAS",
"KESZPENZ",
"BANKKARTYA",
"ELORE_UTALAS",
"UTANVET",
"CSEKK"
],
"d": "KESZPENZ esetén a bizonylat azonnal fizetettnek számít, és nem rögzíthető rá kiegyenlítés."
},
{
"k": "deviza",
"t": "devizaType",
"enum": [
"HUF",
"EUR",
"USD"
],
"d": "Alapérték HUF."
},
{
"k": "arfolyam",
"t": "double",
"d": "Deviza ≠ HUF esetén kötelező és nagyobb mint 0."
},
{
"k": "nyelv",
"t": "nyelvType",
"enum": [
"HU",
"EN",
"DE"
],
"d": "A számlakép nyelve."
},
{
"k": "megjegyzes",
"t": "string(500)",
"d": "A bizonylaton megjelenő megjegyzés."
},
{
"k": "kulsoAzonosito",
"t": "string(50)",
"d": "A hívó rendszer azonosítója (pl. rendelésszám). Idempotencia-kulcs: ha ezzel az azonosítóval már van kiállított bizonylat, a válasz a meglévőt adja vissza — hálózati újrapróbálkozás nem duplikál számlát."
},
{
"k": "elolegSzamlaszam",
"t": "string(26)",
"d": "Végszámla: a kapcsolt ELŐLEGSZÁMLA sorszáma — annak az előlegszámlának a sorszáma, amit ez a bizonylat elszámol. Létező, kiállított, nem sztornózott előlegszámlának (bizonylatTipusKod=03) kell lennie, amit még nem használt fel másik bizonylat, és a pénzneme ennek a bizonylatnak a pénznemével azonos; az ellenőrzés a kiállításkor történik. A levonó sorokat (áfakulcsonként „Előleg levonása — előlegszámla: …”, negatív összeggel) a szerver teszi a tételek végére. Egy előlegszámla egy bizonylathoz kapcsolható, a végszámla sztornózása pedig felszabadítja. Előlegszámlán nem adható meg. Magát az előlegszámlát a bizonylatTipusKod=03 értékkel állítja ki."
},
{
"k": "bizonylatTipusId",
"t": "int",
"d": "A bizonylattípus belső azonosítója. A bizonylatTipusKod helyett is használható — a kettő közül elég az egyik."
},
{
"k": "partnerAzonosito",
"t": "int",
"d": "Meglévő partner azonosítója a törzsből. Megadva a vevő adatai onnan töltődnek, és a külön megadott vevőmezők felülírják őket."
},
{
"k": "vevoOrszag",
"t": "string",
"d": "A vevő országa: kétbetűs ISO 3166-1 kód (pl. AT) vagy a magyar neve (Ausztria) — kis- és nagybetű, ékezet nélkül is; az angol név is felismerhető. Elhagyva belföldinek számít. Ismeretlen ország a kiállításkor VALIDACIO hiba (mezo: fej/vevoOrszag). Az EU-tagság dönti el, hogy a vevoEuAdoszam közösségi vagy harmadik országbeli adószám."
},
{
"k": "vevoTelefon",
"t": "string",
"d": "A vevő telefonszáma — csak a bizonylatképre kerül."
},
{
"k": "lablecMegjegyzes",
"t": "string",
"d": "A bizonylat aljára nyomtatott megjegyzés (a megjegyzes a fejlécbe kerül)."
},
{
"k": "munkaszam",
"t": "string",
"d": "Szabad szöveges munkaszám vagy hivatkozás; csak tárolódik és a bizonylatképre kerül."
}
]
},
{
"k": "bizonylat/tetel",
"t": "bizonylatTetelType[]",
"r": 1,
"d": "1–100 tétel.",
"gy": [
{
"k": "megnevezes",
"t": "string(100)",
"r": 1,
"d": "A tétel megnevezése."
},
{
"k": "mennyiseg",
"t": "double",
"r": 1,
"d": "Max. 2 tizedes."
},
{
"k": "egyseg",
"t": "string(6)",
"d": "Alapérték db."
},
{
"k": "bruttoEgysegar",
"t": "double",
"d": "Bruttó egységár. Vagy ez, vagy a nettoEgysegar."
},
{
"k": "nettoEgysegar",
"t": "double",
"d": "Nettó egységár — a szerver bruttót képez belőle (ld. Kerekítés és árképzés)."
},
{
"k": "afaSzazalek",
"t": "string(4)",
"r": 1,
"enum": [
"27",
"18",
"5",
"0",
"AM",
"AK",
"FO",
"EX"
],
"d": "Számos kulcs vagy különleges adózási mód."
},
{
"k": "afaMentessegKod",
"t": "string(20)",
"enum": [
"AAM",
"TAM",
"KBAET",
"KBAUK",
"EAM",
"NAM",
"ATK",
"EUFAD37",
"EUFADE",
"EUE",
"HO"
],
"d": "A mentesség / az áfakörön kívüliség jogcíme — csak AM, EX és AK kulcson (más kulcson figyelmen kívül marad). AM és EX mellett: AAM, TAM, KBAET, KBAUK, EAM, NAM, EUFAD37, HO; AK mellett: ATK, EUFAD37, EUFADE, EUE, HO — más kombináció VALIDACIO hiba. Elhagyva a kulcs alapértelmezése: AM → AAM, EX → KBAET, AK → ATK. A NAV XML-ben a case értéke; a NAV-elemet (vatExemption / vatOutOfScope) a jogcím dönti el (az EUFAD37 és a HO áfakörön kívüli). A számlaképen a jogcím felirata megjelenik. KBAET-hez a vevő közösségi adószáma kötelező."
},
{
"k": "kedvezmenySzazalek",
"t": "double",
"d": "Tételszintű kedvezmény."
},
{
"k": "vtszSzj",
"t": "string(10)",
"d": "VTSZ / SZJ / ITJ szám."
},
{
"k": "cikkszam",
"t": "string(11)",
"d": "Cikkszám, ha a tétel a cikktörzsből jön."
},
{
"k": "szolgaltatas",
"t": "IGEN|NEM",
"d": "Szolgáltatás (nem termék)."
},
{
"k": "afaKod",
"t": "string",
"d": "A NAV ÁFA-kódja. Elhagyva a szerver az afaSzazalek-ból vezeti le — csak eltérő esetben add meg."
},
{
"k": "tetelMegjegyzes",
"t": "string",
"d": "A tételsorhoz tartozó megjegyzés."
}
]
}
],
"valasz": [
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres feldolgozás jelzése."
},
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója — a további műveletekhez."
},
{
"k": "szamlaszam",
"t": "string(26)",
"d": "A kiállított sorszám a típus maszkja szerint. Piszkozatnál üres."
},
{
"k": "statusz",
"t": "bizonylatStatuszType",
"enum": [
"PISZKOZAT",
"KIALLITVA",
"SZTORNOZVA"
],
"d": "A bizonylat állapota."
},
{
"k": "jelleg",
"t": "bizonylatJellegType",
"enum": [
"NORMAL",
"SZTORNO",
"HELYESBITO"
],
"d": "A bizonylat jellege."
},
{
"k": "nettoOsszeg",
"t": "decimal",
"d": "Szerveroldalon számolt nettó összérték."
},
{
"k": "afaOsszeg",
"t": "decimal",
"d": "Szerveroldalon számolt ÁFA."
},
{
"k": "bruttoOsszeg",
"t": "decimal",
"d": "Szerveroldalon számolt bruttó összérték."
},
{
"k": "iktatoszam",
"t": "string",
"d": "A Kimenő számla iktatóba átvezetett tétel iktatószáma."
},
{
"k": "navStatusz",
"t": "navStatuszType",
"enum": [
"NINCS",
"KULDES_ALATT",
"SIKERES",
"HIBA"
],
"d": "NAV-köteles típusnál a kiállítás után KULDES_ALATT."
},
{
"k": "tetel",
"t": "tetelEredmenyType[]",
"d": "Minden tétel a tényleges, számolt összegeivel — ezt tekintsd hitelesnek.",
"gy": [
{
"k": "sorszam",
"t": "int",
"d": "A tétel sorszáma a bizonylaton. Helyesbítéskor erre kell hivatkozni az eredetiSorszam mezőben."
},
{
"k": "megnevezes",
"t": "string",
"d": "A tétel megnevezése."
},
{
"k": "cikkszam",
"t": "string",
"d": "Cikkszám, ha volt megadva."
},
{
"k": "vtszSzj",
"t": "string",
"d": "VTSZ / SZJ / TESZOR besorolás."
},
{
"k": "mennyiseg",
"t": "decimal",
"d": "Mennyiség."
},
{
"k": "egyseg",
"t": "string",
"d": "Mennyiségi egység."
},
{
"k": "nettoEgysegar",
"t": "decimal",
"d": "Nettó egységár, 3 tizedesjegyre."
},
{
"k": "bruttoEgysegar",
"t": "decimal",
"d": "Bruttó egységár, 3 tizedesjegyre — az árképzés ebből indul (ld. Kerekítés és árképzés)."
},
{
"k": "kedvezmenySzazalek",
"t": "decimal",
"d": "A soron érvényesített kedvezmény százaléka."
},
{
"k": "afaSzazalek",
"t": "string",
"d": "Az alkalmazott ÁFA-kulcs."
},
{
"k": "afaKod",
"t": "string",
"d": "A NAV ÁFA-kódja."
},
{
"k": "afaMentessegKod",
"t": "string",
"d": "A tétel választott jogcíme (mentes / áfakörön kívüli kulcson); üres, ha a kulcs alapértelmezése érvényes (AM → AAM, EX → KBAET, AK → ATK)."
},
{
"k": "nettoErtek",
"t": "decimal",
"d": "A sor nettó értéke. Szerveroldalon számolt érték — ezt tekintsd hitelesnek, ne a sajátodat."
},
{
"k": "afaErtek",
"t": "decimal",
"d": "A sor ÁFA-értéke, szerveroldalon számolva."
},
{
"k": "bruttoErtek",
"t": "decimal",
"d": "A sor bruttó értéke, szerveroldalon számolva."
},
{
"k": "szolgaltatas",
"t": "IGEN|NEM",
"d": "IGEN, ha a tétel szolgáltatás (nem termék)."
},
{
"k": "tetelMegjegyzes",
"t": "string",
"d": "A tételsorhoz tartozó megjegyzés."
}
]
},
{
"k": "keretMaradek",
"t": "int",
"d": "Az éves bizonylat-keretből hátralévő darabszám. Korlátlan csomagnál üres."
},
{
"k": "marLetezett",
"t": "IGEN|NEM",
"d": "IGEN, ha a bizonylat MÁR LÉTEZETT (kulsoAzonosito-egyezés) — nem készült új bizonylat, a válasz a meglévőt írja le."
},
{
"k": "uzenet",
"t": "string",
"d": "Tájékoztató üzenet (iktatás, keret-figyelmeztetés) — nem hibajelzés."
},
{
"k": "eredetiSzamlaszam",
"t": "string",
"d": "Sztornónál és helyesbítőnél az eredeti bizonylat sorszáma; normál bizonylatnál üres."
},
{
"k": "elolegSzamlaszam",
"t": "string",
"d": "A kapcsolt előlegszámla sorszáma; sztornónál és helyesbítőnél üres. Az eredetiSzamlaszam ennek a párja: az mindig csak sztornón/helyesbítőn van kitöltve."
},
{
"k": "kelte",
"t": "string",
"d": "A bizonylat kelte (ÉÉÉÉ-HH-NN)."
},
{
"k": "fizHatarido",
"t": "string",
"d": "Fizetési határidő (ÉÉÉÉ-HH-NN)."
},
{
"k": "deviza",
"t": "string",
"d": "A bizonylat devizaneme."
}
],
"hibak": [
"VALIDACIO",
"KERET_KIMERULT",
"NINCS_JOG",
"ALLAPOT_HIBA",
"HITELESITES"
],
"peldaKeres": "szamlaKiallitas azonnaliVeglegesites=NEM hívásával létrehozott piszkozat kiállítása: sorszám, pillanatképek, PDF, iktatás, NAV-sorbaállítás. Kiállított bizonylatra ALLAPOT_HIBA."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "szamlaId",
"t": "int",
"r": 1,
"d": "A piszkozat azonosítója."
}
],
"valasz": [
{
"k": "szamlaszam",
"t": "string(26)",
"d": "A kiadott sorszám."
},
{
"k": "statusz",
"t": "bizonylatStatuszType",
"d": "KIALLITVA."
},
{
"k": "iktatoszam",
"t": "string",
"d": "Iktatószám."
},
{
"k": "navStatusz",
"t": "navStatuszType",
"d": "NAV-állapot."
},
{
"k": "keretMaradek",
"t": "int",
"d": "Keret-maradék."
}
],
"hibak": [
"ALLAPOT_HIBA",
"VALIDACIO",
"KERET_KIMERULT",
"NEM_TALALHATO"
],
"peldaKeres": "SZTORNOZVA lesz, és a két bizonylat egymásra hivatkozik.",
"Helyesbítőre hívva a teljes láncot sztornózza (az alapszámlát a helyesbítőivel együtt) — a helyesbítő önmagában nem sztornózható. Sztornó bizonylat nem sztornózható.",
"A sztornó kelte a mai nap, a teljesítés dátuma az alapszámláé. A NAV felé STORNO művelettel jelentődik, az originalInvoiceNumber mindig az alapszámla. Nem fogyaszt bizonylat-keretet."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "szamlaszam",
"t": "string(26)",
"r": 1,
"d": "A sztornózandó bizonylat sorszáma. Helyette szamlaId is adható."
},
{
"k": "indoklas",
"t": "string(200)",
"d": "A sztornózás oka — a bizonylaton megjelenik."
},
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója. A szamlaszam helyett is használható — elég az egyik."
}
],
"valasz": [
{
"k": "szamlaId",
"t": "int",
"d": "A sztornó bizonylat azonosítója."
},
{
"k": "szamlaszam",
"t": "string(26)",
"d": "A sztornó bizonylat sorszáma."
},
{
"k": "jelleg",
"t": "bizonylatJellegType",
"d": "SZTORNO."
},
{
"k": "eredetiSzamlaszam",
"t": "string(26)",
"d": "A sztornózott bizonylat sorszáma."
},
{
"k": "elolegSzamlaszam",
"t": "string",
"d": "A kapcsolt előlegszámla sorszáma; sztornónál és helyesbítőnél üres. Az eredetiSzamlaszam ennek a párja: az mindig csak sztornón/helyesbítőn van kitöltve."
},
{
"k": "bruttoOsszeg",
"t": "decimal",
"d": "Negatív összeg."
},
{
"k": "navStatusz",
"t": "navStatuszType",
"d": "NAV-állapot."
}
],
"hibak": [
"ALLAPOT_HIBA",
"NEM_TALALHATO",
"NAV_HIBA"
],
"peldaKeres": "MODIFY művelet, növelt módosítási indexszel; az originalInvoiceNumber mindig az alapszámla, helyesbítőre hívva is. Ha nincs érdemi változás: NINCS_VALTOZAS. Nem fogyaszt keretet.",
"A helyesbítő kelte a mai nap, a teljesítés és a fizetési határidő az alapszámláé. Sztornózott vagy sztornó bizonylathoz nem készíthető helyesbítő; ha a bizonylathoz a felületen helyesbítő-piszkozat van nyitva, előbb azt kell kiállítani vagy törölni (ALLAPOT_HIBA).",
"Tétel-párosítás: az eredetiSorszam mondja meg, melyik sor módosítása az adott tétel. Az első helyesbítőnél ez az eredeti tétel sorszáma (a szamlaAdatok adja); ha a bizonylathoz már készült helyesbítő, az aktuális állapot sorainak sorszáma 1-től (az alapszámla megmaradt sorai a helyükön — a módosított sor az új értékével —, utána a korábbi helyesbítések új sorai). Elhagyva a tétel új sornak számít; amelyik sorra egyik tétel sem hivatkozik, az töröltnek. Ha egyetlen tételen sincs eredetiSorszam, a szerver pozíció szerint párosít, és ezt a válasz figyelmeztetes elemében jelzi."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "eredetiSzamlaszam",
"t": "string(26)",
"r": 1,
"d": "A helyesbítendő bizonylat sorszáma."
},
{
"k": "indoklas",
"t": "string(200)",
"d": "A helyesbítés oka."
},
{
"k": "tetel",
"t": "bizonylatTetelType[]",
"r": 1,
"d": "A bizonylat kívánt végállapota.",
"gy": [
{
"k": "eredetiSorszam",
"t": "int",
"d": "A módosított sor sorszáma — párosításhoz (az első helyesbítőnél az eredeti tétel sorszáma, utána az aktuális állapoté)."
},
{
"k": "megnevezes",
"t": "string(100)",
"r": 1,
"d": "Tétel megnevezése."
},
{
"k": "mennyiseg",
"t": "double",
"r": 1,
"d": "Helyes mennyiség."
},
{
"k": "nettoEgysegar",
"t": "double",
"d": "Helyes nettó egységár."
},
{
"k": "afaSzazalek",
"t": "string(4)",
"r": 1,
"d": "ÁFA-kulcs."
},
{
"k": "cikkszam",
"t": "string",
"d": "Cikkszám."
},
{
"k": "vtszSzj",
"t": "string",
"d": "VTSZ / SZJ / TESZOR besorolás."
},
{
"k": "egyseg",
"t": "string",
"d": "Mennyiségi egység."
},
{
"k": "bruttoEgysegar",
"t": "decimal",
"d": "Bruttó egységár — a nettoEgysegar helyett is megadható, de a kettő együtt validációs hiba."
},
{
"k": "afaKod",
"t": "string",
"d": "A NAV ÁFA-kódja; elhagyva a szerver az ÁFA-százalékból vezeti le."
},
{
"k": "afaMentessegKod",
"t": "string",
"d": "A tétel választott jogcíme (mentes / áfakörön kívüli kulcson); üres, ha a kulcs alapértelmezése érvényes (AM → AAM, EX → KBAET, AK → ATK)."
},
{
"k": "kedvezmenySzazalek",
"t": "decimal",
"d": "A soron érvényesítendő kedvezmény százaléka."
},
{
"k": "szolgaltatas",
"t": "IGEN|NEM",
"d": "IGEN, ha a tétel szolgáltatás."
},
{
"k": "tetelMegjegyzes",
"t": "string",
"d": "A tételsorhoz tartozó megjegyzés."
}
]
},
{
"k": "eredetiSzamlaId",
"t": "int",
"d": "A helyesbítendő bizonylat belső azonosítója; az eredetiSzamlaszam helyett is használható."
}
],
"valasz": [
{
"k": "szamlaszam",
"t": "string(26)",
"d": "A helyesbítő bizonylat sorszáma."
},
{
"k": "jelleg",
"t": "bizonylatJellegType",
"d": "HELYESBITO."
},
{
"k": "modositasSorszam",
"t": "int",
"d": "A helyesbítési lánc indexe (NAV modificationIndex)."
},
{
"k": "bruttoOsszeg",
"t": "decimal",
"d": "A különbözet bruttó összege."
},
{
"k": "figyelmeztetes",
"t": "string",
"d": "Pozíció szerinti párosítás esetén jelzés."
}
],
"hibak": [
"NINCS_VALTOZAS",
"ALLAPOT_HIBA",
"NEM_TALALHATO",
"VALIDACIO"
],
"peldaKeres": "ALLAPOT_HIBA — azt sztornózni kell."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "szamlaId",
"t": "int",
"r": 1,
"d": "A piszkozat azonosítója."
}
],
"valasz": [
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres törlés."
},
{
"k": "uzenet",
"t": "string",
"d": "Tájékoztató üzenet (iktatás, keret, e-mail) — nem hibajelzés."
}
],
"hibak": [
"ALLAPOT_HIBA",
"NEM_TALALHATO"
],
"peldaKeres": "fizetettOsszeg és a fizetettseg a rögzített kiegyenlítésekből számított érték — készpénzes bizonylatnál mindig FIZETVE."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "szures",
"t": "szuresType",
"d": "Szűrők — mind elhagyható.",
"gy": [
{
"k": "keltTol",
"t": "date",
"d": "Kelte-tartomány kezdete."
},
{
"k": "keltIg",
"t": "date",
"d": "Kelte-tartomány vége."
},
{
"k": "bizonylatTipusKod",
"t": "string(3)",
"d": "Csak az adott típus."
},
{
"k": "statusz",
"t": "bizonylatStatuszType",
"d": "Állapot-szűrő."
},
{
"k": "jelleg",
"t": "bizonylatJellegType",
"d": "Normál / sztornó / helyesbítő."
},
{
"k": "vevoAdoszam",
"t": "string(13)",
"d": "Adószám-előtag is elég (8 jegy)."
},
{
"k": "vevoNev",
"t": "string",
"d": "Részleges név-egyezés a vevő nevében."
},
{
"k": "szamlaszam",
"t": "string",
"d": "Részleges egyezés a sorszámban."
},
{
"k": "kulsoAzonosito",
"t": "string",
"d": "A hívó rendszer azonosítója (pl. rendelésszám) — pontos egyezés. A 3. fázistól él."
},
{
"k": "csakKiegyenlitetlen",
"t": "IGEN|NEM",
"d": "Csak a nem teljesen fizetett bizonylatok. Készpénzes bizonylat automatikusan fizetettnek számít, ezért kimarad."
}
]
},
{
"k": "oldal",
"t": "int",
"d": "1-től. Alapérték 1."
},
{
"k": "oldalMeret",
"t": "int",
"d": "5–200, alapérték 50."
}
],
"valasz": [
{
"k": "osszesTalalat",
"t": "int",
"d": "A szűrőnek megfelelő összes bizonylat száma."
},
{
"k": "oldal",
"t": "int",
"d": "A visszaadott oldal száma."
},
{
"k": "osszesOldal",
"t": "int",
"d": "Oldalak száma."
},
{
"k": "szamla",
"t": "szamlaFejType[]",
"d": "A bizonylat-fejek, sorszám szerint csökkenő sorrendben.",
"gy": [
{
"k": "szamlaId",
"t": "int",
"d": "Belső azonosító — a további műveletekhez."
},
{
"k": "szamlaszam",
"t": "string(26)",
"d": "Sorszám. Piszkozatnál üres (a sorszámot a kiállítás adja)."
},
{
"k": "bizonylatTipusKod",
"t": "string(3)",
"d": "A bizonylattípus kódja."
},
{
"k": "bizonylatTipus",
"t": "string(50)",
"d": "A bizonylattípus megnevezése."
},
{
"k": "jelleg",
"t": "bizonylatJellegType",
"enum": [
"NORMAL",
"SZTORNO",
"HELYESBITO"
],
"d": "A bizonylat jellege."
},
{
"k": "statusz",
"t": "bizonylatStatuszType",
"enum": [
"PISZKOZAT",
"KIALLITVA",
"SZTORNOZVA"
],
"d": "Állapot."
},
{
"k": "vevoNev",
"t": "string(50)",
"d": "Vevő neve (pillanatkép)."
},
{
"k": "vevoAdoszam",
"t": "string(13)",
"d": "Vevő adószáma."
},
{
"k": "kelte",
"t": "date",
"d": "Bizonylat kelte."
},
{
"k": "teljesites",
"t": "date",
"d": "Teljesítés kelte."
},
{
"k": "fizHatarido",
"t": "date",
"d": "Fizetési határidő."
},
{
"k": "fizetesiMod",
"t": "fizetesiModType",
"d": "Fizetési mód."
},
{
"k": "nettoOsszeg",
"t": "decimal",
"d": "Nettó összérték."
},
{
"k": "afaOsszeg",
"t": "decimal",
"d": "ÁFA összesen."
},
{
"k": "bruttoOsszeg",
"t": "decimal",
"d": "Bruttó összérték."
},
{
"k": "deviza",
"t": "string(3)",
"d": "Devizanem."
},
{
"k": "fizetettOsszeg",
"t": "decimal",
"d": "A rögzített kiegyenlítések összege."
},
{
"k": "fizetettseg",
"t": "fizetettsegType",
"enum": [
"NINCS",
"RESZBEN",
"FIZETVE"
],
"d": "Számított érték, nem tárolt státusz. Készpénzes fizetési módnál mindig FIZETVE."
},
{
"k": "navStatusz",
"t": "navStatuszType",
"enum": [
"NINCS",
"KULDES_ALATT",
"SIKERES",
"HIBA"
],
"d": "Az adatszolgáltatás állapota."
},
{
"k": "eredetiSzamlaszam",
"t": "string(26)",
"d": "Sztornónál/helyesbítőnél az eredeti bizonylat sorszáma."
},
{
"k": "elolegSzamlaszam",
"t": "string",
"d": "A kapcsolt előlegszámla sorszáma; sztornónál és helyesbítőnél üres. Az eredetiSzamlaszam ennek a párja: az mindig csak sztornón/helyesbítőn van kitöltve."
},
{
"k": "iktatoszam",
"t": "string",
"d": "A Kimenő számla iktatóba átvezetett tétel iktatószáma."
},
{
"k": "kulsoAzonosito",
"t": "string(50)",
"d": "A hívó rendszer azonosítója. A 3. fázistól él."
}
]
},
{
"k": "oldalMeret",
"t": "int",
"d": "A ténylegesen alkalmazott lapméret."
}
],
"hibak": [
"VALIDACIO",
"HITELESITES"
],
"peldaKeres": "szamlaId is adható."
},
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója. A szamlaszam helyett is használható — elég az egyik."
}
],
"valasz": [
{
"k": "fej",
"t": "bizonylatFejType",
"d": "A bizonylat feje a kibocsátó és a vevő pillanatképével, összegekkel.",
"gy": [
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója."
},
{
"k": "szamlaszam",
"t": "string",
"d": "A bizonylat sorszáma."
},
{
"k": "bizonylatTipusKod",
"t": "string",
"d": "A bizonylattípus rövid kódja."
},
{
"k": "bizonylatTipus",
"t": "string",
"d": "A bizonylattípus megnevezése."
},
{
"k": "jelleg",
"t": "bizonylatJellegType",
"d": "NORMAL, SZTORNO vagy HELYESBITO."
},
{
"k": "statusz",
"t": "bizonylatStatuszType",
"d": "PISZKOZAT, KIALLITVA vagy SZTORNOZVA."
},
{
"k": "kibocsatoNev",
"t": "string",
"d": "A kibocsátó neve a kiállítás pillanatában. Pillanatkép: a cégadat későbbi módosítása a kiállított bizonylatot nem írja át."
},
{
"k": "kibocsatoAdoszam",
"t": "string",
"d": "A kibocsátó adószáma a kiállítás pillanatában."
},
{
"k": "kibocsatoIrsz",
"t": "string",
"d": "A kibocsátó irányítószáma."
},
{
"k": "kibocsatoVaros",
"t": "string",
"d": "A kibocsátó települése."
},
{
"k": "kibocsatoCim",
"t": "string",
"d": "A kibocsátó közterülete és házszáma."
},
{
"k": "bankszamla",
"t": "string",
"d": "A bizonylatra nyomtatott bankszámlaszám."
},
{
"k": "vevoNev",
"t": "string",
"d": "A vevő neve a kiállítás pillanatában."
},
{
"k": "vevoAdoszam",
"t": "string",
"d": "A vevő adószáma."
},
{
"k": "vevoEuAdoszam",
"t": "string",
"d": "A vevő közösségi adószáma."
},
{
"k": "vevoIrsz",
"t": "string",
"d": "A vevő irányítószáma."
},
{
"k": "vevoVaros",
"t": "string",
"d": "A vevő települése."
},
{
"k": "vevoCim",
"t": "string",
"d": "A vevő közterülete és házszáma."
},
{
"k": "vevoOrszag",
"t": "string",
"d": "A vevő országa."
},
{
"k": "vevoEmail",
"t": "string",
"d": "A vevő e-mail címe — a szamlaEmail alapból ide küld."
},
{
"k": "maganszemely",
"t": "IGEN|NEM",
"d": "IGEN, ha a vevő magánszemély (nincs adószám, a NAV felé sem megy vevő-adószám)."
},
{
"k": "kelte",
"t": "string",
"d": "A bizonylat kelte."
},
{
"k": "teljesites",
"t": "string",
"d": "A teljesítés dátuma."
},
{
"k": "fizHatarido",
"t": "string",
"d": "Fizetési határidő."
},
{
"k": "fizetesiMod",
"t": "string",
"d": "A fizetési mód kódja."
},
{
"k": "deviza",
"t": "string",
"d": "Devizanem."
},
{
"k": "arfolyam",
"t": "decimal",
"d": "Devizás bizonylatnál az alkalmazott árfolyam."
},
{
"k": "nyelv",
"t": "string",
"d": "A bizonylat nyelve."
},
{
"k": "nettoOsszeg",
"t": "decimal",
"d": "A bizonylat nettó végösszege."
},
{
"k": "afaOsszeg",
"t": "decimal",
"d": "A bizonylat ÁFA-összege."
},
{
"k": "bruttoOsszeg",
"t": "decimal",
"d": "A bizonylat bruttó végösszege."
},
{
"k": "fizetettOsszeg",
"t": "decimal",
"d": "A rögzített kiegyenlítések összege."
},
{
"k": "fizetettseg",
"t": "fizetettsegType",
"d": "NINCS, RESZBEN vagy FIZETVE. Nem tárolt állapot: a kiegyenlítésekből számolt érték, készpénzes bizonylat pedig mindig FIZETVE."
},
{
"k": "hatralek",
"t": "decimal",
"d": "A bruttó összeg és a kiegyenlítések különbözete."
},
{
"k": "megjegyzes",
"t": "string",
"d": "A bizonylat fejlécébe nyomtatott megjegyzés."
},
{
"k": "lablecMegjegyzes",
"t": "string",
"d": "A bizonylat aljára nyomtatott megjegyzés."
},
{
"k": "eredetiSzamlaszam",
"t": "string",
"d": "Sztornónál és helyesbítőnél az eredeti bizonylat sorszáma."
},
{
"k": "elolegSzamlaszam",
"t": "string",
"d": "A kapcsolt előlegszámla sorszáma; sztornónál és helyesbítőnél üres. Az eredetiSzamlaszam ennek a párja: az mindig csak sztornón/helyesbítőn van kitöltve."
},
{
"k": "elolegFelhasznalva",
"t": "string",
"d": "Csak előlegszámlán: annak a bizonylatnak a sorszáma, amelyik felhasználta ezt az előleget. Üres, ha az előlegszámla még szabad, tehát kapcsolható egy végszámlához. A végszámla sztornózása felszabadítja."
},
{
"k": "modositasSorszam",
"t": "int",
"d": "A módosítási lánc indexe (NAV modificationIndex). A sztornó is módosító bizonylat, tehát ő is növeli."
},
{
"k": "iktatoszam",
"t": "string",
"d": "Az iktatóban kapott azonosító, ha a bizonylat iktatásra került."
},
{
"k": "kulsoAzonosito",
"t": "string",
"d": "A hívó saját azonosítója (pl. webshop rendelésszám), amivel a bizonylat készült."
},
{
"k": "veglegesitesDatum",
"t": "string",
"d": "A kiállítás (véglegesítés) időpontja."
}
]
},
{
"k": "tetel",
"t": "tetelEredmenyType[]",
"d": "A tételek számolt összegekkel, sorszam-mal (helyesbítés párosításához).",
"gy": [
{
"k": "sorszam",
"t": "int",
"d": "A tétel sorszáma a bizonylaton. Helyesbítéskor erre kell hivatkozni az eredetiSorszam mezőben."
},
{
"k": "megnevezes",
"t": "string",
"d": "A tétel megnevezése."
},
{
"k": "cikkszam",
"t": "string",
"d": "Cikkszám, ha volt megadva."
},
{
"k": "vtszSzj",
"t": "string",
"d": "VTSZ / SZJ / TESZOR besorolás."
},
{
"k": "mennyiseg",
"t": "decimal",
"d": "Mennyiség."
},
{
"k": "egyseg",
"t": "string",
"d": "Mennyiségi egység."
},
{
"k": "nettoEgysegar",
"t": "decimal",
"d": "Nettó egységár, 3 tizedesjegyre."
},
{
"k": "bruttoEgysegar",
"t": "decimal",
"d": "Bruttó egységár, 3 tizedesjegyre — az árképzés ebből indul (ld. Kerekítés és árképzés)."
},
{
"k": "kedvezmenySzazalek",
"t": "decimal",
"d": "A soron érvényesített kedvezmény százaléka."
},
{
"k": "afaSzazalek",
"t": "string",
"d": "Az alkalmazott ÁFA-kulcs."
},
{
"k": "afaKod",
"t": "string",
"d": "A NAV ÁFA-kódja."
},
{
"k": "afaMentessegKod",
"t": "string",
"d": "A tétel választott jogcíme (mentes / áfakörön kívüli kulcson); üres, ha a kulcs alapértelmezése érvényes (AM → AAM, EX → KBAET, AK → ATK)."
},
{
"k": "nettoErtek",
"t": "decimal",
"d": "A sor nettó értéke. Szerveroldalon számolt érték — ezt tekintsd hitelesnek, ne a sajátodat."
},
{
"k": "afaErtek",
"t": "decimal",
"d": "A sor ÁFA-értéke, szerveroldalon számolva."
},
{
"k": "bruttoErtek",
"t": "decimal",
"d": "A sor bruttó értéke, szerveroldalon számolva."
},
{
"k": "szolgaltatas",
"t": "IGEN|NEM",
"d": "IGEN, ha a tétel szolgáltatás (nem termék)."
},
{
"k": "tetelMegjegyzes",
"t": "string",
"d": "A tételsorhoz tartozó megjegyzés."
}
]
},
{
"k": "navStatusz",
"t": "navStatuszType",
"d": "Az adatszolgáltatás állapota."
},
{
"k": "navTranzakcioId",
"t": "string",
"d": "A NAV tranzakcióazonosítója."
},
{
"k": "navHibaSzoveg",
"t": "string",
"d": "Hiba esetén a NAV üzenete."
},
{
"k": "navSzamlaszam",
"t": "string",
"d": "A NAV felé tényleges beküldött bizonylatszám. Sandbox (DEMO) cégnél időbélyeges teszt-szám; élesben üres, mert ott a valódi sorszám megy be."
}
],
"hibak": [
"NEM_TALALHATO",
"HITELESITES"
],
"peldaKeres": "szamlaId."
},
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója. A szamlaszam helyett is használható — elég az egyik."
}
],
"valasz": [
{
"k": "fajlnev",
"t": "string",
"d": "Javasolt fájlnév."
},
{
"k": "pdf",
"t": "base64",
"d": "A PDF tartalma base64-ben (data: előtag nélkül)."
},
{
"k": "vizjel",
"t": "string",
"d": "Ha a képen vízjel van: PISZKOZAT vagy DEMO; egyébként üres. Sandbox (DEMO) cégnél mindig DEMO."
}
],
"hibak": [
"NEM_TALALHATO",
"ALLAPOT_HIBA"
],
"peldaKeres": "NAV30: a NAV Online Számla 3.0 invoiceData XML-je, XSD-validáltan — ugyanaz, amit a rendszer beküld. SAJAT: a teljes bizonylat-adat a QSugyfelkapu séma szerint.",
"A tartalom base64-ben jön, hogy a beágyazás ne igényeljen escape-elést."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "szamlaszam",
"t": "string(26)",
"r": 1,
"d": "Sorszám vagy szamlaId."
},
{
"k": "formatum",
"t": "string",
"enum": [
"NAV30",
"SAJAT"
],
"d": "Alapérték NAV30."
},
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója. A szamlaszam helyett is használható — elég az egyik."
}
],
"valasz": [
{
"k": "formatum",
"t": "string",
"d": "A visszaadott formátum."
},
{
"k": "xml",
"t": "base64",
"d": "Az XML base64-ben."
}
],
"hibak": [
"NEM_TALALHATO",
"VALIDACIO"
],
"peldaKeres": "teljesKiegyenlites=IGEN esetén a szerver a hátralékot könyveli be — nem kell összeget számolnod. Készpénzes bizonylat automatikusan fizetettnek számít, arra nem rögzíthető kiegyenlítés."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "kiegyenlites",
"t": "kiegyenlitesType[]",
"r": 1,
"d": "1–500 elem.",
"gy": [
{
"k": "szamlaszam",
"t": "string(26)",
"r": 1,
"d": "A bizonylat sorszáma."
},
{
"k": "datum",
"t": "date",
"r": 1,
"d": "A befizetés napja."
},
{
"k": "osszeg",
"t": "decimal",
"d": "A befizetett összeg. teljesKiegyenlites=IGEN mellett elhagyható."
},
{
"k": "teljesKiegyenlites",
"t": "IGEN|NEM",
"d": "A teljes hátralék befizetése."
},
{
"k": "fizetesiMod",
"t": "fizetesiModType",
"d": "A befizetés módja."
},
{
"k": "megjegyzes",
"t": "string(50)",
"d": "Pl. bankszámla-kivonat száma."
},
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója; a szamlaszam helyett is használható."
}
]
}
],
"valasz": [
{
"k": "eredmeny",
"t": "eredmenyType[]",
"d": "Elemenkénti eredmény, a kérés sorrendjében.",
"gy": [
{
"k": "szamlaszam",
"t": "string(26)",
"d": "A bizonylat sorszáma."
},
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres rögzítés."
},
{
"k": "hibaKod",
"t": "string",
"d": "Sikertelenségnél a hibakód."
},
{
"k": "hibaSzoveg",
"t": "string",
"d": "Sikertelenségnél magyar üzenet."
},
{
"k": "kiegyenlitve",
"t": "decimal",
"d": "A bizonylatra rögzített összes befizetés."
},
{
"k": "hatralek",
"t": "decimal",
"d": "A még nyitott összeg."
},
{
"k": "szamlaId",
"t": "int",
"d": "Az érintett bizonylat belső azonosítója."
}
]
}
],
"hibak": [
"ALLAPOT_HIBA",
"VALIDACIO",
"NEM_TALALHATO"
],
"peldaKeres": "[TESZT] jelzést kap."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "szamlaszam",
"t": "string(26)",
"r": 1,
"d": "A bizonylat sorszáma."
},
{
"k": "cimzett",
"t": "string[]",
"d": "Címzettek. Elhagyva a bizonylat vevő-e-mail címe."
},
{
"k": "masolat",
"t": "string[]",
"d": "Másolatot kapók."
},
{
"k": "szamlaId",
"t": "int",
"d": "A bizonylat belső azonosítója. A szamlaszam helyett is használható — elég az egyik."
}
],
"valasz": [
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres kiküldés."
},
{
"k": "kikuldve",
"t": "dateTime",
"d": "A küldés időpontja."
},
{
"k": "cimzett",
"t": "string[]",
"d": "A tényleges címzettek."
},
{
"k": "uzenet",
"t": "string",
"d": "Tájékoztató üzenet (iktatás, keret, e-mail) — nem hibajelzés."
}
],
"hibak": [
"ALLAPOT_HIBA",
"VALIDACIO",
"NEM_TALALHATO"
],
"peldaKeres": "IGEN."
}
],
"valasz": [
{
"k": "bizonylatTipus",
"t": "bizonylatTipusType[]",
"d": "A típusok.",
"gy": [
{
"k": "id",
"t": "int",
"d": "Belső azonosító."
},
{
"k": "azonos",
"t": "string(3)",
"d": "Típuskód — ezt add a kiállításnál."
},
{
"k": "megnevezes",
"t": "string(50)",
"d": "Megnevezés."
},
{
"k": "prefix",
"t": "string(4)",
"d": "Sorszám-előtag."
},
{
"k": "maszk",
"t": "string(20)",
"d": "Sorszám-maszk: P=prefix, É=év, H=hónap, S=sorszám."
},
{
"k": "navKuldes",
"t": "IGEN|NEM",
"d": "NAV-köteles-e a típus."
},
{
"k": "kiegyenlitesKovetes",
"t": "IGEN|NEM",
"d": "Folyószámlán követett-e."
},
{
"k": "alapFizetesiMod",
"t": "fizetesiModType",
"d": "Alapértelmezett fizetési mód."
},
{
"k": "alapFizHataridoNap",
"t": "int",
"d": "Alapértelmezett fizetési határidő napban."
},
{
"k": "alapertelmezett",
"t": "IGEN|NEM",
"d": "A cég alapértelmezett típusa."
},
{
"k": "rovidNev",
"t": "string",
"d": "A típus rövid neve — ez kerül a bizonylatképre."
},
{
"k": "jovahagyasKell",
"t": "IGEN|NEM",
"d": "IGEN, ha a típusnál a felületen jóváhagyási lépés van. Az API-t nem befolyásolja."
},
{
"k": "haviUjrakezdes",
"t": "IGEN|NEM",
"d": "IGEN, ha a sorszámlálás minden hónapban 1-ről indul."
},
{
"k": "aktiv",
"t": "IGEN|NEM",
"d": "IGEN, ha a típus használható. Csak aktív típusra állítható ki bizonylat."
}
]
}
],
"hibak": [
"HITELESITES"
],
"peldaKeres": "afaSzazalek mezőbe adható érték."
},
{
"k": "megnevezes",
"t": "string",
"d": "Emberi megnevezés."
},
{
"k": "afaKod",
"t": "string(4)",
"d": "A hozzá tartozó ÁFA-típuskód."
},
{
"k": "szazalek",
"t": "double",
"d": "Százalékos érték, ha van."
},
{
"k": "navKezeles",
"t": "string",
"d": "A NAV felé alkalmazott kezelésmód (normál adómérték, mentesség vagy hatályon kívüli)."
}
]
},
{
"k": "fizetesiMod",
"t": "kodMegnevezesType[]",
"d": "Fizetési módok.",
"gy": [
{
"k": "kod",
"t": "string",
"d": "A kérésben használandó kód."
},
{
"k": "megnevezes",
"t": "string",
"d": "Emberi megnevezés."
},
{
"k": "navKod",
"t": "string",
"d": "A NAV adatszolgáltatásban használt megfelelő."
}
]
},
{
"k": "deviza",
"t": "kodMegnevezesType[]",
"d": "Devizanemek.",
"gy": [
{
"k": "kod",
"t": "string",
"d": "A kérésben használandó devizakód."
},
{
"k": "megnevezes",
"t": "string",
"d": "A devizanem megnevezése."
}
]
},
{
"k": "egyseg",
"t": "kodMegnevezesType[]",
"d": "Mennyiségi egységek és NAV-megfelelőik.",
"gy": [
{
"k": "kod",
"t": "string",
"d": "A kérésben használandó egység."
},
{
"k": "megnevezes",
"t": "string",
"d": "Az egység megnevezése."
},
{
"k": "navKod",
"t": "string",
"d": "A NAV adatszolgáltatásban használt megfelelő; ha üres, a NAV felé OWN típusú egységként megy."
}
]
},
{
"k": "nyelv",
"t": "kodMegnevezesType[]",
"d": "Bizonylat-nyelvek.",
"gy": [
{
"k": "kod",
"t": "string",
"d": "A kérésben használandó nyelvkód."
},
{
"k": "megnevezes",
"t": "string",
"d": "A nyelv megnevezése."
}
]
},
{
"k": "afaMentessegKod",
"t": "kodType[]",
"d": "A mentességi / áfakörön kívüli jogcímek listája (11 db) — a tétel afaMentessegKod mezőjébe ezek adhatók, a kulcshoz illő listából (ld. a tétel afaMentessegKod mezőjét).",
"gy": [
{
"k": "kod",
"t": "string",
"d": "A NAV mentességi kódja."
},
{
"k": "megnevezes",
"t": "string",
"d": "A mentesség megnevezése."
}
]
}
],
"hibak": [
"HITELESITES"
],
"peldaKeres": "<tns:partnerek> a művelet névterében — korábban <parameters> volt, névtér nélkül. Ez volt az egyetlen művelet, ami kilógott a mintából. Régebbi integrációt frissíteni kell: a régi alakra a kiszolgáló Procedure … not present hibát ad.",
"Partnerek létrehozása vagy frissítése kötegelten. A párosítás az adószám első 8 jegye alapján történik: ha már van ilyen partner a cégnél, a rendszer frissíti, egyébként új partnert vesz fel."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "partner",
"t": "partnerType[]",
"r": 1,
"d": "A partnerek.",
"gy": [
{
"k": "partnerName",
"t": "string",
"r": 1,
"d": "Partner neve."
},
{
"k": "taxNumber",
"t": "string(13)",
"d": "Adószám — a párosítás kulcsa."
},
{
"k": "country",
"t": "string",
"d": "Ország."
},
{
"k": "zipCode",
"t": "string(8)",
"d": "Irányítószám."
},
{
"k": "city",
"t": "string(30)",
"d": "Település."
},
{
"k": "address",
"t": "string(40)",
"d": "Utca, házszám."
}
]
}
],
"valasz": [
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres feldolgozás."
}
],
"hibak": [
"HITELESITES",
"VALIDACIO"
],
"peldaKeres": "partnerek mintájára: cikkek kötegelt létrehozása vagy frissítése cikkszám (vagy megnevezés) alapján. A cikktörzsből a bizonylat-tételek előtölthetők."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "cikk",
"t": "cikkType[]",
"r": 1,
"d": "A cikkek.",
"gy": [
{
"k": "cikkszam",
"t": "string(11)",
"d": "Cikkszám — a párosítás kulcsa. Elhagyva a megnevezés párosít."
},
{
"k": "megnevezes",
"t": "string(100)",
"r": 1,
"d": "Cikk megnevezése."
},
{
"k": "egyseg",
"t": "string(6)",
"d": "Mennyiségi egység."
},
{
"k": "bruttoEgysegar",
"t": "double",
"d": "Bruttó egységár."
},
{
"k": "afaSzazalek",
"t": "string(4)",
"d": "ÁFA-kulcs."
},
{
"k": "vtszSzj",
"t": "string(10)",
"d": "VTSZ / SZJ."
},
{
"k": "szolgaltatas",
"t": "IGEN|NEM",
"d": "Szolgáltatás-e."
},
{
"k": "nettoEgysegar",
"t": "decimal",
"d": "Nettó egységár. A bruttoEgysegar helyett is megadható."
}
]
}
],
"valasz": [
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres feldolgozás."
},
{
"k": "felvett",
"t": "int",
"d": "Új cikkek száma."
},
{
"k": "frissitett",
"t": "int",
"d": "Frissített cikkek száma."
},
{
"k": "eredmeny",
"t": "cikkEredmenyType[]",
"d": "Elemenkénti eredmény — a köteg egy hibás eleme nem buktatja el a többit.",
"gy": [
{
"k": "megnevezes",
"t": "string",
"d": "A feldolgozott cikk megnevezése."
},
{
"k": "cikkszam",
"t": "string",
"d": "A feldolgozott cikk cikkszáma."
},
{
"k": "muvelet",
"t": "string",
"d": "LETREHOZVA, MODOSITVA vagy HIBA."
},
{
"k": "hibaSzoveg",
"t": "string",
"d": "Hiba esetén az elem hibaüzenete."
}
]
}
],
"hibak": [
"HITELESITES",
"VALIDACIO"
],
"peldaKeres": "NINCS_JOG."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "API-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"d": "Iroda-kulcsnál kötelező."
},
{
"k": "adoszam",
"t": "string(13)",
"r": 1,
"d": "8, 11 vagy 13 jegyű adószám — a törzsszám elég."
}
],
"valasz": [
{
"k": "ervenyes",
"t": "IGEN|NEM",
"d": "Létező és érvényes adószám-e. NEM esetén a megjegyzes mondja meg, hogy a NAV nem találta, vagy megtalálta de nem érvényesnek jelöli."
},
{
"k": "adoszam",
"t": "string(13)",
"d": "A teljes, formázott adószám."
},
{
"k": "afaKod",
"t": "string(1)",
"d": "Az adóalanyiság kódja (az adószám 9. jegye)."
},
{
"k": "megyeKod",
"t": "string(2)",
"d": "Megyekód (az adószám utolsó két jegye)."
},
{
"k": "nev",
"t": "string",
"d": "Hivatalos név."
},
{
"k": "rovidNev",
"t": "string",
"d": "Rövidített név."
},
{
"k": "gazdasagiTipus",
"t": "string",
"d": "ORGANIZATION vagy SELF_EMPLOYED."
},
{
"k": "csoportTagAdoszam",
"t": "string(13)",
"d": "ÁFA-csoport tagjánál a csoport adószáma."
},
{
"k": "irsz",
"t": "string(8)",
"d": "A székhely irányítószáma."
},
{
"k": "varos",
"t": "string(30)",
"d": "A székhely települése."
},
{
"k": "cim",
"t": "string(40)",
"d": "A székhely közterülete és házszáma."
},
{
"k": "megjegyzes",
"t": "string",
"d": "Tájékoztató szöveg — a NAV válaszát tükrözi, ha az adószám nem érvényes."
}
],
"hibak": [
"NINCS_JOG",
"VALIDACIO",
"NAV_HIBA"
],
"peldaKeres": "iktatottBejovo művelettel."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "honapSzama",
"t": "int",
"d": "1–12: csak az adott hónapra kiválasztott sorok. 0 vagy elhagyva: nincs hónap-szűrés."
},
{
"k": "uresekIsKellenek",
"t": "boolean",
"d": "true: a hónap nélküli („Nincs kiválasztva”) sorok is kellenek."
}
],
"valasz": [
{
"k": "element",
"t": "idListType[]",
"d": "Iktatószámok.",
"gy": [
{
"k": "iktatoszam",
"t": "string",
"d": "Egy iktatószám."
}
]
}
],
"hibak": [
"HITELESITES"
],
"peldaKeres": "ATADVA lesz."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "szamla",
"t": "invoiceType[]",
"r": 1,
"d": "A visszaírt számlák — ugyanaz a mezőkészlet, mint az iktatottBejovo válaszában, pdf nélkül, iktatoszam-mal.",
"gy": [
{
"k": "Status",
"t": "string",
"d": "A tétel állapota: IKTATVA, ELLENORIZVE, ATADVA, KONYVELVE, NAV_3_0_NEM_TALALHATO, FUGGO vagy NEM_KONYVELHETO."
},
{
"k": "IKT_DATE",
"t": "date",
"d": "Az iktatás dátuma."
},
{
"k": "KONYV_DATE",
"t": "date",
"d": "A könyvelés dátuma."
},
{
"k": "DOKUID",
"t": "string",
"d": "A bizonylat száma (a kibocsátó által adott számlaszám)."
},
{
"k": "GROSVAL",
"t": "double",
"d": "A bizonylat bruttó végösszege."
},
{
"k": "CURRENC",
"t": "string",
"d": "Devizanem: HUF, EUR vagy USD."
},
{
"k": "FIZMOD",
"t": "string",
"d": "Fizetési mód."
},
{
"k": "DATUM",
"t": "date",
"d": "A bizonylat kelte."
},
{
"k": "TELJESIT",
"t": "date",
"d": "A teljesítés dátuma."
},
{
"k": "HATIDO",
"t": "string",
"d": "Fizetési határidő."
},
{
"k": "AFATELJ",
"t": "date",
"d": "Az ÁFA-teljesítés dátuma."
},
{
"k": "SZALLITO",
"t": "string",
"d": "A szállító (kibocsátó) neve."
},
{
"k": "SZALADO",
"t": "string",
"d": "A szállító adószáma."
},
{
"k": "SZALIRSZ",
"t": "string",
"d": "A szállító irányítószáma."
},
{
"k": "SZALCITY",
"t": "string",
"d": "A szállító települése."
},
{
"k": "SZALUTCA",
"t": "string",
"d": "A szállító közterülete és házszáma."
},
{
"k": "AFAMENT",
"t": "double",
"d": "Az ÁFA-mentes (adó nélküli) rész összege."
},
{
"k": "AFAKULC1",
"t": "double",
"d": "Az 1. ÁFA-sáv kulcsa (27, 18 vagy 5). A bizonylat összegei három sávra bontva jönnek — ez a desktop iktató szerkezete."
},
{
"k": "AFAKULC2",
"t": "double",
"d": "A 2. ÁFA-sáv kulcsa (27, 18 vagy 5)."
},
{
"k": "AFAKULC3",
"t": "double",
"d": "A 3. ÁFA-sáv kulcsa (27, 18 vagy 5)."
},
{
"k": "TETELNE1",
"t": "double",
"d": "Az 1. ÁFA-sáv nettó összege."
},
{
"k": "TETELNE2",
"t": "double",
"d": "A 2. ÁFA-sáv nettó összege."
},
{
"k": "TETELNE3",
"t": "double",
"d": "A 3. ÁFA-sáv nettó összege."
},
{
"k": "TETELBR1",
"t": "double",
"d": "Az 1. ÁFA-sáv bruttó összege."
},
{
"k": "TETELBR2",
"t": "double",
"d": "A 2. ÁFA-sáv bruttó összege."
},
{
"k": "TETELBR3",
"t": "double",
"d": "A 3. ÁFA-sáv bruttó összege."
},
{
"k": "TETELAFA1",
"t": "double",
"d": "Az 1. ÁFA-sáv adóösszege."
},
{
"k": "TETELAFA2",
"t": "double",
"d": "A 2. ÁFA-sáv adóösszege."
},
{
"k": "TETELAFA3",
"t": "double",
"d": "A 3. ÁFA-sáv adóösszege."
},
{
"k": "exchangeRate",
"t": "double",
"d": "Devizás bizonylatnál az alkalmazott árfolyam."
},
{
"k": "FORDAFA",
"t": "string",
"d": "Fordított ÁFA: IGEN vagy NEM."
},
{
"k": "eredetiSzamla",
"t": "string",
"d": "Módosító bizonylatnál az eredeti bizonylat száma."
},
{
"k": "MEGJEGYZ",
"t": "string",
"d": "Megjegyzés."
},
{
"k": "munkaszam",
"t": "string",
"d": "Munkaszám."
},
{
"k": "munkaszamReszletek",
"t": "string",
"d": "A munkaszám bontása (több munkaszám esetén)."
},
{
"k": "iktatoszam",
"t": "int",
"d": "Az iktatószám — ez azonosítja a bizonylatot a további hívásokban."
}
]
}
],
"valasz": [
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres feldolgozás."
}
],
"hibak": [
"HITELESITES",
"VALIDACIO"
],
"peldaKeres": "iktatottBejovo mezőkészletével.",
"A letöltés átadásnak számít: a számla „Átadva” állapotba kerül — a csak megtekintésre megosztott cégnél is (ld. iktatottBejovo)."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "iktatoszam",
"t": "string",
"r": 1,
"d": "Az iktatószám."
}
],
"valasz": [
{
"k": "szamla",
"t": "szamlaType",
"d": "A számla adatai, pdf tartalommal.",
"gy": [
{
"k": "iktatoszam",
"t": "int",
"d": "Az iktatószám — ez azonosítja a bizonylatot a további hívásokban."
},
{
"k": "FILENEVE",
"t": "string",
"d": "A bizonylathoz tárolt fájl neve."
},
{
"k": "Status",
"t": "string",
"d": "A tétel állapota: IKTATVA, ELLENORIZVE, ATADVA, KONYVELVE, NAV_3_0_NEM_TALALHATO, FUGGO vagy NEM_KONYVELHETO."
},
{
"k": "EGYEDIAZ",
"t": "string",
"d": "A tétel egyedi azonosítója az iktatóban."
},
{
"k": "IKT_DATE",
"t": "date",
"d": "Az iktatás dátuma."
},
{
"k": "KONYV_DATE",
"t": "date",
"d": "A könyvelés dátuma."
},
{
"k": "DOKUID",
"t": "string",
"d": "A bizonylat száma (a kibocsátó által adott számlaszám)."
},
{
"k": "GROSVAL",
"t": "double",
"d": "A bizonylat bruttó végösszege."
},
{
"k": "CURRENC",
"t": "string",
"d": "Devizanem: HUF, EUR vagy USD."
},
{
"k": "FIZMOD",
"t": "string",
"d": "Fizetési mód."
},
{
"k": "DATUM",
"t": "date",
"d": "A bizonylat kelte."
},
{
"k": "TELJESIT",
"t": "date",
"d": "A teljesítés dátuma."
},
{
"k": "HATIDO",
"t": "date",
"d": "Fizetési határidő."
},
{
"k": "AFATELJ",
"t": "date",
"d": "Az ÁFA-teljesítés dátuma."
},
{
"k": "SZALLITO",
"t": "string",
"d": "A szállító (kibocsátó) neve."
},
{
"k": "SZALADO",
"t": "string",
"d": "A szállító adószáma."
},
{
"k": "SZALIRSZ",
"t": "string",
"d": "A szállító irányítószáma."
},
{
"k": "SZALCITY",
"t": "string",
"d": "A szállító települése."
},
{
"k": "SZALUTCA",
"t": "string",
"d": "A szállító közterülete és házszáma."
},
{
"k": "AFAMENT",
"t": "double",
"d": "Az ÁFA-mentes (adó nélküli) rész összege."
},
{
"k": "AFAKULC1",
"t": "double",
"d": "Az 1. ÁFA-sáv kulcsa (27, 18 vagy 5). A bizonylat összegei három sávra bontva jönnek — ez a desktop iktató szerkezete."
},
{
"k": "AFAKULC2",
"t": "double",
"d": "A 2. ÁFA-sáv kulcsa (27, 18 vagy 5)."
},
{
"k": "AFAKULC3",
"t": "double",
"d": "A 3. ÁFA-sáv kulcsa (27, 18 vagy 5)."
},
{
"k": "TETELNE1",
"t": "double",
"d": "Az 1. ÁFA-sáv nettó összege."
},
{
"k": "TETELNE2",
"t": "double",
"d": "A 2. ÁFA-sáv nettó összege."
},
{
"k": "TETELNE3",
"t": "double",
"d": "A 3. ÁFA-sáv nettó összege."
},
{
"k": "TETELBR1",
"t": "double",
"d": "Az 1. ÁFA-sáv bruttó összege."
},
{
"k": "TETELBR2",
"t": "double",
"d": "A 2. ÁFA-sáv bruttó összege."
},
{
"k": "TETELBR3",
"t": "double",
"d": "A 3. ÁFA-sáv bruttó összege."
},
{
"k": "TETELAFA1",
"t": "double",
"d": "Az 1. ÁFA-sáv adóösszege."
},
{
"k": "TETELAFA2",
"t": "double",
"d": "A 2. ÁFA-sáv adóösszege."
},
{
"k": "TETELAFA3",
"t": "double",
"d": "A 3. ÁFA-sáv adóösszege."
},
{
"k": "exchangeRate",
"t": "double",
"d": "Devizás bizonylatnál az alkalmazott árfolyam."
},
{
"k": "pdf",
"t": "string",
"d": "A bizonylat PDF-je base64-ben kódolva."
},
{
"k": "FORDAFA",
"t": "string",
"d": "Fordított ÁFA: IGEN vagy NEM."
},
{
"k": "eredetiSzamla",
"t": "string",
"d": "Módosító bizonylatnál az eredeti bizonylat száma."
},
{
"k": "MEGJEGYZ",
"t": "string",
"d": "Megjegyzés."
},
{
"k": "munkaszam",
"t": "string",
"d": "Munkaszám."
},
{
"k": "munkaszamReszletek",
"t": "string",
"d": "A munkaszám bontása (több munkaszám esetén)."
},
{
"k": "selectedMonth",
"t": "int",
"enum": [
"0",
"1",
"2",
"3",
"4",
"5",
"6",
"7",
"8",
"9",
"10",
"11",
"12"
],
"d": "A bizonylathoz rendelt könyvelési hónap sorszáma (1 = január … 12 = december). 0 = nincs kiválasztva."
}
]
}
],
"hibak": [
"NEM_TALALHATO",
"HITELESITES"
],
"peldaKeres": "IKTATVA, ELLENORIZVE, ATADVA, KONYVELVE, NAV_3_0_NEM_TALALHATO, FUGGO vagy NEM_KONYVELHETO."
},
{
"k": "IKT_DATE",
"t": "date",
"d": "Az iktatás dátuma."
},
{
"k": "KONYV_DATE",
"t": "date",
"d": "A könyvelés dátuma."
},
{
"k": "DOKUID",
"t": "string",
"d": "A bizonylat száma (a kibocsátó által adott számlaszám)."
},
{
"k": "GROSVAL",
"t": "double",
"d": "A bizonylat bruttó végösszege."
},
{
"k": "CURRENC",
"t": "string",
"d": "Devizanem: HUF, EUR vagy USD."
},
{
"k": "FIZMOD",
"t": "string",
"d": "Fizetési mód."
},
{
"k": "DATUM",
"t": "date",
"d": "A bizonylat kelte."
},
{
"k": "TELJESIT",
"t": "date",
"d": "A teljesítés dátuma."
},
{
"k": "HATIDO",
"t": "string",
"d": "Fizetési határidő."
},
{
"k": "AFATELJ",
"t": "date",
"d": "Az ÁFA-teljesítés dátuma."
},
{
"k": "SZALLITO",
"t": "string",
"d": "A szállító (kibocsátó) neve."
},
{
"k": "SZALADO",
"t": "string",
"d": "A szállító adószáma."
},
{
"k": "SZALIRSZ",
"t": "string",
"d": "A szállító irányítószáma."
},
{
"k": "SZALCITY",
"t": "string",
"d": "A szállító települése."
},
{
"k": "SZALUTCA",
"t": "string",
"d": "A szállító közterülete és házszáma."
},
{
"k": "AFAMENT",
"t": "double",
"d": "Az ÁFA-mentes (adó nélküli) rész összege."
},
{
"k": "AFAKULC1",
"t": "double",
"d": "Az 1. ÁFA-sáv kulcsa (27, 18 vagy 5). A bizonylat összegei három sávra bontva jönnek — ez a desktop iktató szerkezete."
},
{
"k": "AFAKULC2",
"t": "double",
"d": "A 2. ÁFA-sáv kulcsa (27, 18 vagy 5)."
},
{
"k": "AFAKULC3",
"t": "double",
"d": "A 3. ÁFA-sáv kulcsa (27, 18 vagy 5)."
},
{
"k": "TETELNE1",
"t": "double",
"d": "Az 1. ÁFA-sáv nettó összege."
},
{
"k": "TETELNE2",
"t": "double",
"d": "A 2. ÁFA-sáv nettó összege."
},
{
"k": "TETELNE3",
"t": "double",
"d": "A 3. ÁFA-sáv nettó összege."
},
{
"k": "TETELBR1",
"t": "double",
"d": "Az 1. ÁFA-sáv bruttó összege."
},
{
"k": "TETELBR2",
"t": "double",
"d": "A 2. ÁFA-sáv bruttó összege."
},
{
"k": "TETELBR3",
"t": "double",
"d": "A 3. ÁFA-sáv bruttó összege."
},
{
"k": "TETELAFA1",
"t": "double",
"d": "Az 1. ÁFA-sáv adóösszege."
},
{
"k": "TETELAFA2",
"t": "double",
"d": "A 2. ÁFA-sáv adóösszege."
},
{
"k": "TETELAFA3",
"t": "double",
"d": "A 3. ÁFA-sáv adóösszege."
},
{
"k": "exchangeRate",
"t": "double",
"d": "Devizás bizonylatnál az alkalmazott árfolyam."
},
{
"k": "FORDAFA",
"t": "string",
"d": "Fordított ÁFA: IGEN vagy NEM."
},
{
"k": "eredetiSzamla",
"t": "string",
"d": "Módosító bizonylatnál az eredeti bizonylat száma."
},
{
"k": "MEGJEGYZ",
"t": "string",
"d": "Megjegyzés."
},
{
"k": "munkaszam",
"t": "string",
"d": "Munkaszám."
},
{
"k": "munkaszamReszletek",
"t": "string",
"d": "A munkaszám bontása (több munkaszám esetén)."
},
{
"k": "iktatoszam",
"t": "int",
"d": "Az iktatószám — ez azonosítja a bizonylatot a további hívásokban."
}
]
}
],
"valasz": [
{
"k": "success",
"t": "TRUE|FALSE",
"d": "Sikeres feldolgozás."
}
],
"hibak": [
"HITELESITES",
"VALIDACIO"
],
"peldaKeres": "iktatottKimenoXmlFile."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
}
],
"valasz": [
{
"k": "szamla",
"t": "KimenoSzamla[]",
"d": "A fájlok.",
"gy": [
{
"k": "id",
"t": "int",
"d": "Azonosító."
},
{
"k": "filename",
"t": "string",
"d": "Fájlnév."
},
{
"k": "iktatasDatuma",
"t": "date",
"d": "Iktatás dátuma."
},
{
"k": "atvetelDatuma",
"t": "date",
"d": "Átvétel dátuma."
},
{
"k": "statusz",
"t": "string",
"d": "Állapot."
},
{
"k": "fileExtension",
"t": "string",
"d": "Kiterjesztés."
}
]
}
],
"hibak": [
"HITELESITES"
],
"peldaKeres": "kiegyenlitetlenOsszeg jön, a kiegyenlített összeg a bruttó és a kiegyenlítetlen különbsége; dátum nélkül a mai nap.",
"Ismételhető: ugyanaz kétszer beküldve ugyanaz az eredmény. Csak megtekintésre megosztott cégre nem hívható (NINCS_JOG)."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "iktatoszam",
"t": "string",
"d": "A bejövő számla iktatószáma (az iktatottBejovoIdList adja)."
},
{
"k": "kiegyenlitesDatuma",
"t": "date",
"d": "A kiegyenlítés dátuma. Elhagyva a mai nap."
},
{
"k": "kiegyenlitettOsszeg",
"t": "double",
"d": "A számla kiegyenlített összege összesen — ez lesz az egyetlen kiegyenlítés-tétel."
},
{
"k": "kiegyenlitetlenOsszeg",
"t": "double",
"d": "A még nyitott összeg — csak akkor számít, ha a kiegyenlitettOsszeg hiányzik (a kiegyenlített összeg ilyenkor: bruttó − nyitott)."
}
],
"valasz": [
{
"k": "out",
"t": "string",
"d": "SUCCESS."
}
],
"hibak": [
"HITELESITES",
"NEM_TALALHATO",
"NINCS_JOG"
],
"peldaKeres": "request elembe csomagolva jönnek."
],
"keres": [
{
"k": "request",
"t": "requestType",
"r": 1,
"d": "A kérés paraméterei.",
"gy": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "iktatoszam",
"t": "string",
"r": 1,
"d": "Az iktatószám."
}
]
}
],
"valasz": [
{
"k": "pdf",
"t": "base64",
"d": "A számlakép."
}
],
"hibak": [
"NEM_TALALHATO",
"HITELESITES"
],
"peldaKeres": "feltoltes, nem iktatottPdfFeltoltes — a végpont fájlneve és a művelet neve történetileg eltér. A példa a helyes elemet mutatja.",
"A feltöltött PDF-ből új iktatott tétel lesz („Iktatva” állapotban, új iktatószámmal) a megadott irányban — nem egy meglévő tételhez csatol. A fájlnév cégenként és irányonként egyedi: ugyanaz a név másodszor FAIL („Nem egyedi a fájl neve.”), így egy megismételt kérés nem hoz létre dupla tételt.",
"Passzív cégre és csak megtekintésre megosztott cégre nem hívható."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "fileName",
"t": "string",
"d": "A feltöltendő fájl neve. Csak .pdf kiterjesztés fogadható el."
},
{
"k": "base64File",
"t": "string",
"d": "A PDF tartalma base64-ben kódolva."
},
{
"k": "invoiceDirection",
"t": "string",
"d": "A bizonylat iránya: INBOUND (bejövő) vagy OUTBOUND (kimenő)."
}
],
"valasz": [
{
"k": "invoiceDirection",
"t": "string",
"d": "A bizonylat iránya: INBOUND (bejövő) vagy OUTBOUND (kimenő)."
},
{
"k": "id",
"t": "int",
"d": "A létrejött iktató-rekord azonosítója. Hibánál -."
},
{
"k": "iktatoszam",
"t": "int",
"d": "Az iktatószám — ez azonosítja a bizonylatot a további hívásokban."
},
{
"k": "result",
"t": "string",
"d": "SUCCESS vagy FAIL."
},
{
"k": "message",
"t": "string",
"d": "Az eredmény szöveges magyarázata — hibánál ez mondja meg, mi a baj."
}
],
"hibak": [
"NEM_TALALHATO",
"VALIDACIO"
],
"peldaKeres": "upload, nem invoicePhotoUpload, és a mezők egy document blokkba vannak csomagolva (a docStore mintája szerint). A példa a helyes szerkezetet mutatja.",
"A művelet ÚJ iktató-rekordot hoz létre a számlaképpel (státusz: Iktatva, iktatás dátuma: a hívás napja), és visszaadja a rekord azonosítóját — erre hivatkozva küldhető fel később a többi számlaadat (iktatottBejovoAtvetel / iktatottSzamlaKimenoAtvetel).",
"Eltérés az iktatottPdfFeltoltes-től: az utólagos csatolás helyett ÚJ iktatást nyit, és fotót is elfogad (JPG/PNG), amit szerveroldalon PDF-be alakít.",
"A kép→PDF átalakítás A4 álló lapra teszi a képet 10 mm margóval, arányosan, felnagyítás nélkül, középre — a fekvő fotó is álló lapra kerül. A hibakódok neve (FAIL_JSPDF_*) történeti: az átalakítást ma az mPDF végzi, nem jsPDF."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "document",
"t": "documentType",
"r": 1,
"d": "A feltöltendő számlakép és a hozzá tartozó adatok.",
"gy": [
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "file",
"t": "string",
"r": 1,
"d": "A fájl tartalma data URI alakban: data:application/pdf;base64,…, data:image/jpeg;base64,… vagy data:image/png;base64,…. Kép esetén a szerver PDF-be alakítja, és a fájlnév kiterjesztését .pdf-re írja."
},
{
"k": "fileName",
"t": "string",
"r": 1,
"d": "A fájl neve. A cégen és az iránynál belül egyedinek kell lennie, különben FAIL_FILENAME_EXISTS."
},
{
"k": "invoiceDirection",
"t": "string",
"r": 1,
"d": "A bizonylat iránya: INBOUND (bejövő) vagy OUTBOUND (kimenő)."
}
]
}
],
"valasz": [
{
"k": "out",
"t": "string",
"d": "SUCCESS, vagy a hiba kódja: FAIL, FAIL_INVALID_DIRECTION, FAIL_COMPANY_NOT_FOUND, FAIL_FILENAME_EXISTS, FAIL_BASE64_DECODE, FAIL_JSPDF_CONVERT, FAIL_JSPDF_EMPTY_OUTPUT, FAIL_DB_PREPARE, FAIL_DB_EXECUTE, FAIL_DB_ERROR."
},
{
"k": "lastInsertId",
"t": "string",
"d": "A létrejött iktató-rekord azonosítója (konyvelesTetel.id) — erre hivatkozva szinkronizálható a többi számlaadat. Hibánál 0."
}
],
"hibak": [
"VALIDACIO",
"NEM_TALALHATO"
],
"peldaKeres": "upload, nem docStore — a végpont fájlneve és a művelet neve történetileg eltér. A példa a helyes elemet mutatja.",
"Bármilyen dokumentum feltöltése a cég dokumentumtárába: base64 tartalom, fájlnév, megjegyzés és a láthatóságot szabályozó sharedDoc jelző."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "document",
"t": "documentType",
"r": 1,
"d": "A dokumentum.",
"gy": [
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "file",
"t": "base64",
"r": 1,
"d": "A fájl tartalma."
},
{
"k": "fileName",
"t": "string",
"r": 1,
"d": "Fájlnév kiterjesztéssel."
},
{
"k": "sharedDoc",
"t": "boolean",
"d": "Megosztott-e a könyvelővel."
},
{
"k": "docComment",
"t": "string",
"d": "Megjegyzés."
}
]
}
],
"valasz": [
{
"k": "out",
"t": "string",
"d": "A feltöltés eredménye: SUCCESS, vagy hiba esetén magyar szöveg."
}
],
"hibak": [
"HITELESITES",
"VALIDACIO"
],
"peldaKeres": "upload, nem docOther — a végpont fájlneve és a művelet neve történetileg eltér. A példa a helyes elemet mutatja.",
"Mint a docStore, de irattípussal — pl. pénztárbizonylat, szállítólevél. A típus vezérli, hova kerül az irat a rendszerben."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "document",
"t": "documentType",
"r": 1,
"d": "A dokumentum.",
"gy": [
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "file",
"t": "base64",
"r": 1,
"d": "A fájl tartalma."
},
{
"k": "fileName",
"t": "string",
"r": 1,
"d": "Fájlnév."
},
{
"k": "type",
"t": "string",
"r": 1,
"d": "Irattípus, pl. PENZTARBIZONYLAT."
},
{
"k": "sharedDoc",
"t": "boolean",
"d": "Megosztott-e."
}
]
}
],
"valasz": [
{
"k": "out",
"t": "string",
"d": "A feltöltés eredménye: SUCCESS, vagy hiba esetén magyar szöveg."
}
],
"hibak": [
"HITELESITES",
"VALIDACIO"
],
"peldaKeres": "type = PENZTARBIZONYLAT esetén a pénztárgép-nyilvántartás is.",
"A letöltés átadásnak számít: a visszaadott új iratok „Átadva” jelölést kapnak, és a következő hívásban már nem jönnek — a csak megtekintésre megosztott cégnél is."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string",
"d": "A cég 8 karakteres azonosítója."
}
],
"valasz": [
{
"k": "docOther",
"t": "docListElementType[]",
"d": "A dokumentumok.",
"gy": [
{
"k": "id",
"t": "int",
"d": "Azonosító."
},
{
"k": "fileName",
"t": "string",
"d": "Fájlnév."
},
{
"k": "file",
"t": "base64",
"d": "A tartalom."
},
{
"k": "iktatasDatuma",
"t": "date",
"d": "Iktatás dátuma."
},
{
"k": "atvetelDatuma",
"t": "date",
"d": "Átvétel dátuma."
},
{
"k": "statusz",
"t": "string",
"d": "Állapot."
},
{
"k": "type",
"t": "string",
"d": "Irattípus."
},
{
"k": "docComment",
"t": "string",
"d": "Megjegyzés."
},
{
"k": "fileExtension",
"t": "string",
"d": "A dokumentum kiterjesztése."
},
{
"k": "sharedDoc",
"t": "string",
"d": "IGEN, ha a dokumentum meg van osztva."
}
]
}
],
"hibak": [
"HITELESITES"
],
"peldaKeres": "create, nem queryInvoiceDigest — a végpont fájlneve és a művelet neve történetileg eltér. A példa a helyes elemet mutatja.",
"A NAV Online Számla lekérdezésből kapott számla-összesítő adatok feltöltése. Így a webes iktatóban is megjelennek a NAV-ból ismert, de még fel nem dolgozott számlák. Elemenkénti hibalistát ad."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
},
{
"k": "companyId",
"t": "string(8)",
"r": 1,
"d": "Cégazonosító."
},
{
"k": "queryInvoiceDigest",
"t": "queryInvoiceDigestType[]",
"r": 1,
"d": "Az összesítők.",
"gy": [
{
"k": "invoiceNumber",
"t": "string",
"r": 1,
"d": "Számlaszám."
},
{
"k": "invoiceOperation",
"t": "string",
"enum": [
"CREATE",
"MODIFY",
"STORNO"
],
"d": "NAV-művelet."
},
{
"k": "invoiceCategory",
"t": "string",
"enum": [
"NORMAL",
"SIMPLIFIED",
"AGGREGATE"
],
"d": "Számla-kategória."
},
{
"k": "invoiceDirection",
"t": "string",
"enum": [
"INBOUND",
"OUTBOUND"
],
"d": "Irány."
},
{
"k": "invoiceIssueDate",
"t": "date",
"r": 1,
"d": "Kelte."
},
{
"k": "supplierTaxNumber",
"t": "string",
"d": "Szállító adószáma."
},
{
"k": "supplierName",
"t": "string",
"d": "Szállító neve."
},
{
"k": "customerTaxNumber",
"t": "string",
"d": "Vevő adószáma."
},
{
"k": "customerName",
"t": "string",
"d": "Vevő neve."
},
{
"k": "paymentMethod",
"t": "string",
"d": "Fizetési mód."
},
{
"k": "paymentDate",
"t": "date",
"d": "Fizetési határidő."
},
{
"k": "currency",
"t": "string",
"d": "Devizanem."
},
{
"k": "invoiceNetAmount",
"t": "double",
"d": "Nettó összeg."
},
{
"k": "invoiceVatAmount",
"t": "double",
"d": "ÁFA összeg."
},
{
"k": "invoiceNetAmountHUF",
"t": "double",
"d": "Nettó összeg forintban."
},
{
"k": "invoiceVatAmountHUF",
"t": "double",
"d": "ÁFA forintban."
},
{
"k": "transactionId",
"t": "string",
"d": "NAV tranzakcióazonosító."
},
{
"k": "originalInvoiceNumber",
"t": "string",
"d": "Módosított számla száma."
},
{
"k": "modificationIndex",
"t": "string",
"d": "Módosítási index."
},
{
"k": "supplierGroupMemberTaxNumber",
"t": "string",
"d": "ÁFA-csoport tag esetén a szállító csoporttag-adószáma (NAV mező)."
},
{
"k": "customerGroupMemberTaxNumber",
"t": "string",
"d": "ÁFA-csoport tag esetén a vevő csoporttag-adószáma (NAV mező)."
},
{
"k": "invoiceAppearance",
"t": "string",
"d": "A bizonylat megjelenési formája a NAV szerint (PAPER, ELECTRONIC, EDI, UNKNOWN)."
},
{
"k": "source",
"t": "string",
"d": "Az adatszolgáltatás forrása a NAV szerint (WEB, XML, MGM, OPG)."
},
{
"k": "invoiceDeliveryDate",
"t": "date",
"d": "A teljesítés dátuma a NAV adatszolgáltatásból."
},
{
"k": "insDate",
"t": "dateTime",
"d": "A NAV-hoz beérkezés időpontja."
},
{
"k": "completenessIndicator",
"t": "string",
"d": "IGEN, ha az adatszolgáltatás a bizonylat teljes adattartalmát tartalmazza."
},
{
"k": "used",
"t": "boolean",
"d": "IGEN, ha a tétel már fel van használva (iktatva)."
},
{
"k": "invoiceGrossAmountHUF",
"t": "double",
"d": "A bizonylat bruttó összege forintban."
},
{
"k": "notBookable",
"t": "boolean",
"d": "IGEN, ha a tétel nem könyvelhető."
}
]
}
],
"valasz": [
{
"k": "success",
"t": "boolean",
"d": "Sikeres feldolgozás jelzése."
},
{
"k": "errors",
"t": "message[]",
"d": "Az elemenkénti hibák — egy hibás elem nem buktatja el a köteg többi tételét.",
"gy": [
{
"k": "invoiceNumber",
"t": "string",
"d": "Az érintett bizonylat száma."
},
{
"k": "errorMessage",
"t": "string",
"d": "Az elemhez tartozó hibaüzenet."
}
]
}
],
"hibak": [
"HITELESITES",
"VALIDACIO"
],
"peldaKeres": "companyId értékek. Ugyanezt a listát, a cégnevekkel, a Beállítások → KönyvelőHíd API szekció is mutatja a kulcs megjelenítésekor."
],
"keres": [
{
"k": "apiKey",
"t": "string",
"r": 1,
"d": "Iroda-kulcs."
}
],
"valasz": [
{
"k": "ceg",
"t": "string[]",
"d": "A cégek."
}
],
"hibak": [
"HITELESITES"
],
"peldaKeres": "createUser, nem office — a végpont fájlneve és a művelet neve történetileg eltér. A példa a helyes elemet mutatja.",
"Új könyvelőiroda-felhasználó létrehozása felhasználónévvel és jelszóval; a válasz az irodát azonosító API-kulcs."
],
"keres": [
{
"k": "password",
"t": "string",
"r": 1,
"d": "Jelszó."
},
{
"k": "userName",
"t": "string",
"d": "A létrehozandó könyvelőiroda felhasználóneve."
}
],
"valasz": [
{
"k": "officeApiKey",
"t": "string",
"d": "A létrejött iroda API-kulcsa — ezzel hívható utána a többi művelet."
}
],
"hibak": [
"VALIDACIO"
],
"peldaKeres": "