Kérések küldése
Alap URL és form mező
A kéréseket mindig ugyanarra az URL címre kell küldeni: https://www.szamlazz.hu/szamla/. 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 az egyes funkciók mezőneveit.
| 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 |
| Bizonylat lekérése PDF-ben | action-szamla_agent_pdf |
| Bizonylat lekérése XML-ben | 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 |
Követelmények
Minden kérés egy HTTPS POST formájában érkezik a Számlázz.hu felé, ahol az XML fájl tartalmazza a funkció elvégzéséhez szükséges irányító paramétereket és adatokat. A session cookie kezeléséről ne feledkezz meg.
Az egyes műveletek kérés- és válaszszerkezetét a saját oldalukon találod:
- Számla létrehozás
- Számla sztornózás
- Befizetés rögzítése
- Bizonylat lekérése PDF-ben
- Bizonylat lekérése XML-ben
- Díjbekérő törlése
- Nyugta létrehozás
- Nyugta sztornózás
- Nyugta lekérdezés
- Nyugta kiküldés
- Adószám lekérdezés
Egy XML egy bizonylat
Minden XML fájl csak egyetlen számla vagy nyugta adatait tartalmazza. Egy XML fájlban nem adhatsz meg több számla (vagy nyugta) adatot.
XML-validálás és elgépelt mezőnevek
A beérkező XML-t a rendszer az adott művelet XSD-je alapján dolgozza fel (számlakészítésnél: xmlszamla.xsd).
Az XML elemnevek kis-nagybetű érzékenyek: a <simpleitems> például nem azonos a <simpleItems>-szel. Az elgépelt mezőnevet tartalmazó kérés 57 hibakóddal (XML beolvasási hiba.) hibára futhat, vagy előfordulhat, hogy a bizonylat elkészül, de az elgépelt mezőben kért beállítás nem érvényesül. Küldés előtt ezért mindig validáld az XML-t az XSD alapján, és az integráció tesztfiókos tesztelésekor ellenőrizd az elkészült bizonylatot. Lásd Hibakezelés, hibakódok.
Tesztelés
A tesztelési fázis során a tesztkörnyezetben 10 percenkénti számlalimit érvényes (maximum 500 számla/10 perc). A limitre és a tesztfiók használatára (a felhasználó be- és kikapcsolhatja) a Hibakezelés, hibakódok oldalon találsz részleteket.
Több webáruház (számlaszám előtag)
Ha a Számla Agentet több webáruházhoz is használod és szeretnéd elválasztani a bizonylatokat webáruházak szerint, használj külön számlaszám előtagot (szamlaszamElotag) mindegyikhez.
Következő lépések
- Munkameneti süti: a session cookie-k kezelése a kérésekben
- Hibakezelés: hibák kezelése és hibakódok értelmezése
- Számla létrehozás: az első számla generálása