📄️ Mi a Számla Agent?
A Számla Agent a Számlázz.hu régi és jól bevált API interfésze, amely 2010. óta folyamatosan működik. Célja a számlák, nyugták és egyéb bizonylatok létrehozása, lekérdezése, kiküldése és kifizetettségük kezelése. Az API interfész gyakorlatilag XML-eket fogad más rendszerekből, mely alapján tud:
📄️ Hogy működik a Számla Agent?
A lenti ábrával egy klasszikus webshop vásárláson próbáljuk bemutatni, hogyan integrálható számla vagy nyugta létrehozására és kiküldésére a Számla Agent.
📄️ Agent felhasználó
A felhasználó és jelszó helyett használj Agent (API) kulcsot. Ha megbízott számlakibocsátásra használod a Számla Agent szolgáltatásunkat, akkor látogass el erre a linkre.
📄️ Agent kulcs
Lehetőség van egy generált Agent kulcs használatára a felhasználónév és jelszó helyett. Ez azt jelenti, hogy már nem kötelező a felhasználónév és jelszó mező használata, helyette egyszerűen használhatod a `` mezőt. (Kivételt képez az önszámlázás és a megbízott számlakibocsátás.)
📄️ Hibakezelés
Fontos! Előfordult már, hogy néhány ügyfelünknél a Számla Agent-nek küldött kéréseket úgy programozták, hogy ha a számla vagy nyugta készítése sikertelen volt, akkor a kód folyamatosan újrapróbálkozott, amíg valaki le nem állította. Ez nem megfelelő megoldás. Ha éjszaka hiba történik, a szerverek sebességétől függően reggelre 30 000 - 50 000 email érkezhet a megadott email fiókba. Az Agent több okból kifolyólag nem készít el egy számlát, és ugyanazokkal az adatokkal történő ismételt próbálkozás sem vezet célra.
📄️ Hibakódok
Az első oszlopban a hibakód, mellette a hibaüzenet tartalma látható, ez mindig magyar nyelvű. A harmadik oszlopban olvasható ezek magyarázata.
📄️ Session cookie-k
A Számla Agent úgy van optimalizálva, hogy a hívó fél felelőssége a "session cookie", vagyis munkameneti süti tárolása és a hívások során az Agent felé küldése. A webáruházak általában szerveren futó kliens/szerver felépítésű rendszerek, vagyis a vásárlóknál csak egy vékony "kliens" program fut (ami a böngésző), de minden egyéb folyamat a szerveren történik. Amikor a webáruház úgy dönt, hogy számlát készít, akkor indít egy hívást az Agent felé. A webáruház az Agent felől nézve egyetlen egy "felhasználónak" kell, hogy látszódjon.
📄️ 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.
📄️ Egyéb részletek
Számla Agent tesztelése