📄️ 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 inkább Agent (API) kulcsot, ha nem megbízott számlakibocsátásra használod a Számla Agent szolgáltatásunkat.
📄️ 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! Sajnos néhány ügyfelünknél már előfordult, hogy úgy készítette el az Agentet hívó kódot, hogy ha azt érzékelte a kód, hogy sikertelen volt a számla/nyugtakészítés, akkor addig próbálkozott az Agent ismételt meghívásával amíg le nem állították. Ez nagyon rossz megoldás. Ennek eredményeképpen egy éjszakai hiba esetén a szerverek sebességétől függően 30000-50000 email várható reggelre a megadott email cím levelesládájában. Ha az Agent nem készít el egy számlát, annak nagyon sok oka lehet, de majdnem mind olyan, hogy változatlan adatokkal történő meghívásra sem fogja.
📄️ Hibakódok
Az első oszlopban a hibakód, mellette a hibaüzenet tartalma látható, ez mindig magyar nyelvű. A harmadik oszlopba olvasható ezek magyarázata.
📄️ Session cookie-k
Számla Agent arra van optimalizálva, hogy a hívó oldal gondoskodik a session cookie tárolásáról és a hívások során az Agent felé történő elküldésről. 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
Tudjon meg többet a Számla Agent működéséről.