Ugrás a fő tartalomhoz

XML beküldés

A kéréseket mindig ugyanarra az URL címre kell küldeni, azaz a https://www.szamlazz.hu/szamla/ címre. A Számla Agent a HTTPS-kérésben szereplő XML-fájlt tartalmazó mező neve alapján dönti el, hogy melyik funkciót kell végrehajtania. A következő táblázat tartalmazza azokat a neveket, amelyekkel egy adott funkciót elvégezhet.

FunkcióMezőnév
Számla létrehozásaction-xmlagentxmlfile
Számla sztornóaction-szamla_agent_st
Befizetés rögzítésaction-szamla_agent_kifiz
Számla PDF lekérésaction-szamla_agent_pdf
Számla XML lekérésaction-szamla_agent_xml
Díjbekérő törlésaction-szamla_agent_dijbekero_torlese
Nyugta létrehozásaction-szamla_agent_nyugta_create
Nyugta sztornóaction-szamla_agent_nyugta_storno
Nyugta lekérdezésaction-szamla_agent_nyugta_get
Nyugta kiküldésaction-szamla_agent_nyugta_send
Adószám lekérdezésaction-szamla_agent_taxpayer

XML-ben szereplő adatmezők

A kötelező mezőket kitöltve kell beküldeni és fontos a beküldendő XML-ben feltüntetett sorrendjük is.

vevoTipus mezőTípusKötelezőPéldaLeírás/Megjegyzés
nevstringigen"Egy Vevő Bt."A vevő neve.
orszagstringnem"HU"Az ország, ahol a vevő található.
irszstringigen"1626"A vevő irányítószáma.
telepulesstringigen"Budapest"A vevő települése.
cimstringigen"Sólyomszigeti út 67."A vevő címe.
emailstringnem"példa@vevő.hu"A vevő email címe.
sendEmailbooleannemtrueAz email küldésének állapota.
adoalanyintnem1Adóalany státusz; lehetséges értékek: 7, 6, 1, 0, -1.
adoszamstringnem"12345678-1-42"Adószám.
csoportazonositostringnem"GRP12345"Csoport azonosító.
adoszamEUstringnem"HU12345678"EU adószám.
postazasiNevstringnem"Egy Vevő Bt. postafiókja"Postázási név.
postazasiOrszagstringnem"HU"Postázási ország.
postazasiIrszstringnem"1626"Postázási irányítószám.
postazasiTelepulesstringnem"Budapest"Postázási település.
postazasiCimstringnem"Sólyomszigeti út 67."Postázási cím.
vevoFokonyvTípusKötelezőPéldaLeírás/Megjegyzés
azonositostringnem"VEVO123"Azonosító a vevőhöz.
alairoNevestringnem"Vevő Margit"Vevő neve.
telefonszamstringnem"+36 (1) 234-5678"Vevő telefonszáma.
megjegyzesstringnem"Külön megjegyzés a vevőhöz."Megjegyzések, további információk.
vevoFokonyvTipusTípusKötelezőPéldaLeírás/Megjegyzés
konyvelesDatumdatenem"2024-08-01"Könyvelés dátuma.
vevoAzonositostringnem"FG456"Vevő azonosító a főkönyv számára.
vevoFokonyviSzamstringnem"45612378"Főkönyvi számlaszám a vevő számára.
folyamatosTeljbooleannemfalseFolyamatos teljesítés.
elszDatumToldatenem"2024-08-01"Elszámolási dátum kezdete.
elszDatumIgdatenem"2024-08-31"Elszámolási dátum vége.
eladoTipusTípusKötelezőPéldaLeírás/Megjegyzés
bankstringnem"Egy Bank"Bank neve.
bankszamlaszamstringnem"99993101-12345678-00000000"Bankszámlaszám.
emailReplytostringnem"info@eladojozsef.hu"Visszajelzési email cím.
emailTargystringnem"Példa Kft. Számla"Email tárgy szöveg.
emailSzovegstringnem"Tisztelt Vásárló, itt a számla."Email szöveg.
alairoNevestringnem"Eladó József"Aláíró neve.
beallitasokTipusTípusKötelezőPéldaLeírás/Megjegyzés
felhasznalostringnem"eladojozsef"Agent kulcs használatánál üresen hagyható.
jelszostringnem"********"Agent kulcs használatánál üresen hagyható.
szamlaagentkulcsstringnem"AGENT123456"Számla Agent (API) kulcs.
eszamlabooleanigentrueElektronikus számlázási beállítás.
szamlaLetoltesbooleanigentrueSzámla letöltési beállítás.
szamlaLetoltesPldintnem1Letöltött számla példányszám.
valaszVerziointnem2Válasz verziószám.
aggregatorstringnem"AggregatorX"Aggregátor beállítás.
guardianbooleannemfalse-
cikkazoninvoicebooleannemtrueCikk azonosító a számlán.
szamlaKulsoAzonstringnem"SZAMLA123"Külső számlaszám azonosító.
tetelTipusTípusKötelezőPéldaLeírás/Megjegyzés
megnevezesstringigen"Szolgáltatás A"Tétel neve.
azonositostringnem"ITEM123"Tétel azonosító.
mennyisegdoubleigen10.0Mennyiség.
mennyisegiEgysegstringigen"kg"Mennyiségi egység.
nettoEgysegardoubleigen1000.0Nettó egységár.
afakulcsstringigen"27"Ha százalékos, akkor % jel nélkül kell megadni.
arresAfaAlapdoublenem200.0Árrés áfa alap.
nettoErtekdoubleigen10000.0Nettó érték.
afaErtekdoubleigen2700.0Áfa érték.
bruttoErtekdoubleigen12700.0Bruttó érték.
megjegyzesstringnem"Megjegyzem."Megjegyzések a tételhez.
tetelekTipusTípusKötelezőPéldaLeírás/Megjegyzés
teteltns:tetelTipusigenTétel elem, több előfordulás lehetséges.
azonositostringnem"12345"Azonosító, ötjegyű szám a TOF-tól.
shipmentIDstringnem"SHIP123"Szállítmány azonosító.
csomagszamintnem5Csomagok száma.
countryCodestringnem"HU"Országkód.
zipstringnem"1051"Irányítószám.
servicestringnem"Standard"Szolgáltatás típusa.
tetelFokonyvTípusKötelezőPéldaLeírás/Megjegyzés
torloKodintnem0Törléskód.