A Számla Agent PHP API egyszerűbbé és hatékonyabbá teszi a végfelhasználók számára a Számla Agent rendszerével történő adatkommunikációt. A PHP API a Számla Agent egy PHP alapú interfésze, ami elrejti az adatkommunikáció komplexitását (beleértve az XML beküldés logikáját), hogy a felhasználó egyszerű funkciók meghívásán keresztül tudja használni a Számla Agent által kínált funkcionalitást.
A Számla Agent dokumentációban (továbbiakban dokumentáció) elérhető “PHPApiAgent-[verzioszám].zip” fájlban egy „rendszerfüggetlen” modult és annak leírását találod meg (/szamlaagent/docs).
Javasoljuk, hogy a PHP API-val történő automatikus számlázás teszteléséhez hozz létre teszt fiókot, akár a meglévő, éles fiókod mellé. Teszt fiók létrehozásáról az alábbi oldalon írunk:
Számla Agent: teszt kapcsolat kiépítése
👉 Funkciók
Minden Számla Agent funkció rendelkezik PHP API példával.
Ilyen például a számlakiállítás, nyugta kiállítás, kifizetettség kezelés, stb.
A funkciók listája elérhető a dokumentációban, a /szamlaagent/docs/SzamlaAgent_PHP_API_v2 fájl 4. pontjában.
A Számla Agent funkcióit egyszerűen kipróbálhatod a PHP API példáin keresztül.
A kipróbáláshoz:
- töltsd le az API-t tartalmazó zip-et, tömörítsd ki és másold a szerveredre, ahol fut a PHP alkalmazásod
- válassz ki egy példafájlt (pl. számla kiállítás)
- helyettesítsd be az API kulcsodat a példafájlban megjelölt helyre
- ellenőrizd, hogy az API kulcs valóban egy teszt fiókhoz tartozik-e
- futtasd a példafájlt
Az API kulcs létrehozásához ide kattintva találsz segítséget.
Példa a dokumentációban: /szamlaagent/examples/autoload.php
👉 Adatlekérés
Már elkészült bizonylatok adatait külön hívásban is lekérheted.
A bizonylatok adatait tetszőleges formátumban fel tudod dolgozni, tehát a kiállított bizonylatot lekérheted PDF-ben, XML és JSON formátumban a lekérő interface-en.
👉 Hibakeresés és hibakezelés
Minden hiba napi bontásban naplózásra kerül, melyet a /szamlaagent/logs mappában találsz meg. A logolás szintjét tetszőlegesen állíthatod be.
A naplózásról a PHP dokumentáció 3.2.1.1. pontjától írunk.
A PHP API kiterjesztett hibakezeléssel rendelkezik, ami lehetőséget biztosít arra, hogy a bizonylatok kiállítása során keletkezett hibákat a leghatékonyabb módon tudd kezelni.
Például: A számlakiállítás sikeres, de az értesítő e-mail kiküldése sikertelen.
👉 Kompatibilitás
A PHP 5.6-tól kompatibilis.
👉 Session cookie kezelés
A cookie kezelés konfigurálható adatbázisban vagy fájl alapú tároláshoz (akár cégenként).
Bővebben a /szamlaagent/docs/SzamlaAgent_PHP_API_v2 fájl 3.2.1.2 pontban írunk.
👉 Verziókezelés
Verziókezelt API-t biztosítunk, így az egyes verziók között különbség lehet.
A változásnapló (changelog) eléréséhez kattints ide.
A Számlázz.hu rendszerében elérhető automatikus számlázási (Számla Agent) szolgáltatás bármely szolgáltatáscsomag mellett külön díjért vehető igénybe.
A Számla Agentre vonatkozó további információkért, árakért kattints ide.
