Fontos tudnivalók

E-számla vs papírszámla

A Számla Agent mind elektronikus, mind pedig hagyományos, papír alapú számla kiállítására képes. Az, hogy az Agent papíralapú vagy elektronikus számlát készít-e, az átküldött XML eszamla mezőjének értékétől függ. true esetén e-számla készül, false esetén hagyományos papír alapú számla.

Az e-számlák kiállításához saját tanúsítványra van szükséged, vagy használhatod a Számlázz.hu által biztosított tanúsítványt (ez az alapértelmezett lehetőség).

Díjbekérőre hivatkozás

Számlát meglévő díjbekérőre hivatkozva is kiállíthatsz. Ehhez a számlakérés <fejlec> blokkjában add meg a díjbekérő számlaszámát a <dijbekeroSzamlaszam></dijbekeroSzamlaszam> mezőben.

Javasolt menet:

1. Ellenőrizd, hogy a hivatkozni kívánt díjbekérő számlaszáma pontosan megvan.
2. Készítsd elő a számlakiállítási XML-t.
3. A <fejlec> blokkban töltsd ki a <dijbekeroSzamlaszam> mezőt a díjbekérő számlaszámával.
4. Küldd be a számlakiállítási kérést a Számla létrehozás > Minta XML oldalon leírt minta alapján.
5. Az Agent a megadott számlaszám alapján a díjbekérőhöz kapcsolva készíti el a számlát.

Bizonylat típusok

Ez az interfész a következő típusú bizonylatokat tudja létrehozni:

• számla
• sztornó számla
• előlegszámla
• végszámla
• helyesbítő számla
• díjbekérő
• szállítólevél

Számlaértesítő küldés

Abban az esetben, ha meg van adva és érvényes a vevő e-mail címe <email> és a <sendEmail> paraméterben true értéket kapunk az XML-ben. A levélszöveg formázására az alábbi BB kódok állnak rendelkezésre.

Tesztfiók esetén a rendszer számlajegyzéket küld; a címzett nem az XML-ben megadott e-mail cím, hanem a beállítások oldalon beállított e-mail cím (az „Email cím” értéke ebben a formában: https://www.szamlazz.hu/szamla/?action=directlogin&targetpage=beallitasokstep1). Ha megadsz egy e-mail címet a vásárló adatai között, a rendszer erre a címre küldi a számlát. Ha nem adtál meg e-mail címet, a rendszer nem küldi el a számlát. Az XML-ben meghatározhatod a vásárló e-mail címét, és kérheted, hogy a Számla Agent NE küldje el a számlát a vásárlónak: ebben az esetben az e-mail cím után add hozzá a <sendEmail>false</sendEmail> sort.

• [b], [/b]
• [i], [/i]
• [u], [/u]
• [h1], [/h1]...[h6], [/h6]
• [center], [/center]

További dinamikus mezőket is használhaszt az e-mail szövegben, erről itt írunk részletesen. Sortörést nem BB kóddal tudsz a levél szövegében elhelyezni, hanem egyszerűen használj kézi sortörést az emailSzoveg mezőben.

    <emailSzoveg>első sor
      második sor
      enter
      enter
    </emailSzoveg>

Lehetőséged van értesítő email mellé maximum öt darab fájlt csatolni. Ehhez a kérésben, a fő XML fájl mellett, attachfile1 ... attachfile5 néven lehet küldeni a csatolni kívánt fájlokat. A beküldött fájlok mérete nem haladhatja meg a 2MB méretet. Ha valamelyik beküldött fájl csatolása valamilyen okból sikertelen, akkor a nem megfelelő csatolmányokról a rendszer figyelmeztető emailt küld a beküldőnek, minden rossz fájlról külön-külön. Hibás csatolmány esetén is kiküldésre kerül az értesítő email úgy, hogy a megfelelő fájlok csatolva lesznek. Ha nem érkezik kérés értesítő email kiküldésére, akkor a beküldött csatolmányok nem kerülnek feldolgozásra.

információ

Ha több e-mail címet szeretnél megadni az XML fájl e-mail mezőjében, azokat vesszővel (",") válaszd el.

Számla- és nyugtasablonok

Többféle számla- és nyugtasablon használható. Ezekről itt olvashatsz többet és találsz mintákat. A számlagenerálási kérésben a <fejlec>-en belül a szamlaSablon változóban add meg a sablont; nyugtageneráláskor a <fejlec>-ben a pdfTemplate mezőben add meg, melyik sablonnal készüljön a bizonylat.

Nyelvek

Jelenleg 15 nyelven lehet bizonylatot kiállítani. A bizonylat nyelvének megfelelő alapértelmezett számlaértesítő és vevői fiók fog kimenni, illetve megjelenni. A nyelvet a számlageneráláskor a <fejlec>-en belüli szamlaNyelve mezőben add meg. Támogatott értékek: magyar (hu), angol (en), német (de), olasz (it), román (ro), szlovák (sk), horvát (hr), francia (fr), spanyol (es), cseh (cz), lengyel (pl), bolgár (bg), holland (nl), orosz (ru), szlovén (si).

Adattörlőkód (torloKod)

A számlakészítési kérésben tételenként opcionálisan megadható a törlőkód. Hol: A tételek (tetelek / tetel) blokkban, minden egyes tetel elemben. XSD: A tetelTipus típus tartalmazza a torloKod elemet: opcionális (minOccurs="0"), típusa int, értéke ≥ 0.

További információ

Az adattörlőkód API-n keresztüli használatáról és tömeges számlageneráláskor való alkalmazásáról a tudástárban olvashatsz.

Példa egy tételre:

<tetel>
    <megnevezes>Minta termék</megnevezes>
    <mennyiseg>2.0</mennyiseg>
    <mennyisegiEgyseg>db</mennyisegiEgyseg>
    <nettoEgysegar>10000</nettoEgysegar>
    <afakulcs>27</afakulcs>
    <nettoErtek>20000.0</nettoErtek>
    <afaErtek>5400.0</afaErtek>
    <bruttoErtek>25400.0</bruttoErtek>
    <torloKod>123</torloKod>
</tetel>

fontos

A Számlázz.hu fiókban a Beállítások menüben be kell kapcsolni az adattörlőkód használatát. Ha ki van kapcsolva, 539 hibakódot kapsz. Tételenként legfeljebb 400 adattörlőkód adható; ha túlléped, 537 hibakódot kapsz. A hibakódok részlete: Hibakezelés.