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. |