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ás | action-xmlagentxmlfile |
Számla sztornó | action-szamla_agent_st |
Befizetés rögzítés | action-szamla_agent_kifiz |
Számla PDF lekérés | action-szamla_agent_pdf |
Számla XML lekérés | action-szamla_agent_xml |
Díjbekérő törlés | action-szamla_agent_dijbekero_torlese |
Nyugta létrehozás | action-szamla_agent_nyugta_create |
Nyugta sztornó | action-szamla_agent_nyugta_storno |
Nyugta lekérdezés | action-szamla_agent_nyugta_get |
Nyugta kiküldés | action-szamla_agent_nyugta_send |
Adószám lekérdezés | action-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ípus | Kötelező | Példa | Leírás/Megjegyzés |
---|
nev | string | igen | "Egy Vevő Bt." | A vevő neve. |
orszag | string | nem | "HU" | Az ország, ahol a vevő található. |
irsz | string | igen | "1626" | A vevő irányítószáma. |
telepules | string | igen | "Budapest" | A vevő települése. |
cim | string | igen | "Sólyomszigeti út 67." | A vevő címe. |
email | string | nem | "példa@vevő.hu" | A vevő email címe. |
sendEmail | boolean | nem | true | Az email küldésének állapota. |
adoalany | int | nem | 1 | Adóalany státusz; lehetséges értékek: 7, 6, 1, 0, -1. |
adoszam | string | nem | "12345678-1-42" | Adószám. |
csoportazonosito | string | nem | "GRP12345" | Csoport azonosító. |
adoszamEU | string | nem | "HU12345678" | EU adószám. |
postazasiNev | string | nem | "Egy Vevő Bt. postafiókja" | Postázási név. |
postazasiOrszag | string | nem | "HU" | Postázási ország. |
postazasiIrsz | string | nem | "1626" | Postázási irányítószám. |
postazasiTelepules | string | nem | "Budapest" | Postázási település. |
postazasiCim | string | nem | "Sólyomszigeti út 67." | Postázási cím. |
vevoFokonyv | Típus | Kötelező | Példa | Leírás/Megjegyzés |
---|
azonosito | string | nem | "VEVO123" | Azonosító a vevőhöz. |
alairoNeve | string | nem | "Vevő Margit" | Vevő neve. |
telefonszam | string | nem | "+36 (1) 234-5678" | Vevő telefonszáma. |
megjegyzes | string | nem | "Külön megjegyzés a vevőhöz." | Megjegyzések, további információk. |
vevoFokonyvTipus | Típus | Kötelező | Példa | Leírás/Megjegyzés |
---|
konyvelesDatum | date | nem | "2024-08-01" | Könyvelés dátuma. |
vevoAzonosito | string | nem | "FG456" | Vevő azonosító a főkönyv számára. |
vevoFokonyviSzam | string | nem | "45612378" | Főkönyvi számlaszám a vevő számára. |
folyamatosTelj | boolean | nem | false | Folyamatos teljesítés. |
elszDatumTol | date | nem | "2024-08-01" | Elszámolási dátum kezdete. |
elszDatumIg | date | nem | "2024-08-31" | Elszámolási dátum vége. |
eladoTipus | Típus | Kötelező | Példa | Leírás/Megjegyzés |
---|
bank | string | nem | "Egy Bank" | Bank neve. |
bankszamlaszam | string | nem | "99993101-12345678-00000000" | Bankszámlaszám. |
emailReplyto | string | nem | "info@eladojozsef.hu" | Visszajelzési email cím. |
emailTargy | string | nem | "Példa Kft. Számla" | Email tárgy szöveg. |
emailSzoveg | string | nem | "Tisztelt Vásárló, itt a számla." | Email szöveg. |
alairoNeve | string | nem | "Eladó József" | Aláíró neve. |
beallitasokTipus | Típus | Kötelező | Példa | Leírás/Megjegyzés |
---|
felhasznalo | string | nem | "eladojozsef" | Agent kulcs használatánál üresen hagyható. |
jelszo | string | nem | "********" | Agent kulcs használatánál üresen hagyható. |
szamlaagentkulcs | string | nem | "AGENT123456" | Számla Agent (API) kulcs. |
eszamla | boolean | igen | true | Elektronikus számlázási beállítás. |
szamlaLetoltes | boolean | igen | true | Számla letöltési beállítás. |
szamlaLetoltesPld | int | nem | 1 | Letöltött számla példányszám. |
valaszVerzio | int | nem | 2 | Válasz verziószám. |
aggregator | string | nem | "AggregatorX" | Aggregátor beállítás. |
guardian | boolean | nem | false | - |
cikkazoninvoice | boolean | nem | true | Cikk azonosító a számlán. |
szamlaKulsoAzon | string | nem | "SZAMLA123" | Külső számlaszám azonosító. |
tetelTipus | Típus | Kötelező | Példa | Leírás/Megjegyzés |
---|
megnevezes | string | igen | "Szolgáltatás A" | Tétel neve. |
azonosito | string | nem | "ITEM123" | Tétel azonosító. |
mennyiseg | double | igen | 10.0 | Mennyiség. |
mennyisegiEgyseg | string | igen | "kg" | Mennyiségi egység. |
nettoEgysegar | double | igen | 1000.0 | Nettó egységár. |
afakulcs | string | igen | "27" | Ha százalékos, akkor % jel nélkül kell megadni. |
arresAfaAlap | double | nem | 200.0 | Árrés áfa alap. |
nettoErtek | double | igen | 10000.0 | Nettó érték. |
afaErtek | double | igen | 2700.0 | Áfa érték. |
bruttoErtek | double | igen | 12700.0 | Bruttó érték. |
megjegyzes | string | nem | "Megjegyzem." | Megjegyzések a tételhez. |
tetelekTipus | Típus | Kötelező | Példa | Leírás/Megjegyzés |
---|
tetel | tns:tetelTipus | igen | | Tétel elem, több előfordulás lehetséges. |
azonosito | string | nem | "12345" | Azonosító, ötjegyű szám a TOF-tól. |
shipmentID | string | nem | "SHIP123" | Szállítmány azonosító. |
csomagszam | int | nem | 5 | Csomagok száma. |
countryCode | string | nem | "HU" | Országkód. |
zip | string | nem | "1051" | Irányítószám. |
service | string | nem | "Standard" | Szolgáltatás típusa. |
tetelFokonyv | Típus | Kötelező | Példa | Leírás/Megjegyzés |
---|
torloKod | int | nem | 0 | Törléskód. |