Ugrás a fő tartalomhoz

Egyéb részletek

Számla Agent tesztelése​

A tesztelési fázis során ügyelni kell arra, hogy ne generálj túl sok számlát a tesztkörnyezetben (maximum 100 számla óránként). A tesztfiókot a felhasználó be- és kikapcsolhatja.

XML validálása XSD segítségével​

A beküldendő XML fájl tartalma XSD fájl segítségével validálható. Az XSD fájlban található egy leírás, amely ismerteti az adott fájl tartalmát. Használd ezt az online validáló eszközt, vagy ágyazz be bármilyen ellenőrzőt a kódodba, a lényeg, hogy generált kódod megfeleljen az XSD-ben szereplő elvárásoknak.

Biztonság​

A szamlazz.hu domain elérhető az alábbi fix IP címeken:​

  • 18.153.1.171
  • 3.73.114.72
  • 52.59.28.5

Ezek azok az IP címek ahova a böngészők és a Számla Agent kliensek küldhetik a HTTPS kéréseiket.

A fix IP címek amiről a Számlázz.hu hívja a partnereit:​

  • 3.73.214.98
  • 3.76.149.232
  • 18.153.156.51

Ezek azok az IP címek, amelyekről a külső rendszered a tőlünk küldött adatokat fogadja.

HTTPS tanúsítvány​

Számla Agent szolgáltatás esetén a LET'S ENCRYPT a tanúsítvány kibocsátónk. Ez csak a nagyon régi rendszereket érintheti, ahol kézzel kell telepíteni a hiányzó root CA-t.

A https://certtest.szamlazz.hu oldalon elérhető az SSL tanúsítvány, amit 3 havonta újítunk meg. A kapcsolat 256 bites titkosított SSL kapcsolaton alapul.

Követelmények​

Rendszerednek XML fájlt kell küldenie egy HTTPS POST kérésben a Számlázz.hu felé. Az XML fájlnak tartalmaznia kell az irányító paramétereket és az adatokat, amelyek szükségesek az adott Számla Agent funkció végrehajtásához. Ne feledd kezelni a session cookie-kat.

Az adott Számla Agent hívástípusok (új számla, sztornó számla, pdf lekérdezés stb.) kérés/válasz párjait később ismertetjük.

Tartalmazhat-e egy XML fájl más számlák adatait is?​

Nem. Minden XML fájl csak egyetlen számla adatait tartalmazza.

Mi szükséges az e-számlák kiállításához?​

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

Hogyan adhatok meg több e-mail címet?​

Ha több e-mail címet szeretnél megadni az XML fájl e-mail mezőjében, azokat "," (vessző) elválasztóval kell megadni.

Milyen esetben küld valójában e-mail értesítéseket a Számlázz.hu?​

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. Nyilvánvalóan, ha nem adott meg e-mail címet, a rendszer nem küldi el a számlát. Ez az alapértelmezett viselkedés.

Az XML-ben meghatározhatod a vásárló e-mail címét, és kérheted a Számla Agent-et, hogy NE küldje el a számlát a vásárlónak. Ebben az esetben ezt a sort kell hozzáadnod közvetlenül az e-mail cím után: <sendEmail>false</sendEmail>

Használat több webáruházban​

Ha a Számla Agentet több webáruházhoz is használnád és szeretnéd elválasztani a bizonylatokat webáruházak szerint, használj külön számlaszám előtagot (<szamlaszamElotag>) mindegyikhez.

Számla- és nyugtaképek​

Többféle számla- és nyugtaképet használhatsz. Ezekről itt olvashatsz többet és itt találsz mintákat is. A számlagenerálási kérésben a <fejlec> -en belül <szamlaSablon> változóban, nyugtageneráláskor szintén a <fejlec>-ben a <pdfSablon> mezőben kell megadnod, melyik sablonnal hozzuk létre az adott bizonylatot.

Nyelvek​

Jelenleg 15 nyelven lehet bizonylatot kiállítani. A bizonylat nyelvének megfelelő alapértelmezett számlaértesítő levélszöveg és vevői fiók fog kimenni, illetve megjelenni. Az alábbi nyelveket lehet számlageneráláskor a <fejlec>-en belül a <szamlaNyelve> mezőben megadni:

  • 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)
  • bulgár (bg)
  • holland (nl)
  • orosz (ru)
  • szlovén (si)