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
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 a megfelelő műveleti oldalakon ismertetjük.
A POST kérés tartalomtípusa: multipart/form-data.
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.
Tesztelés
A tesztelési fázis során a tesztkörnyezetben óránkénti számlalimit érvényes. A limitre és a tesztfiók használatára (a felhasználó be- és kikapcsolhatja) a Hibakezelés 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.