Automatikus számlázás külső rendszerből Számla Agenttel
A Számla Agenttel webshopodból vagy üzleti alkalmazásodból is kiállíthatsz számlát automatikusan vagy egy kattintással, API kapcsolaton keresztül.
Mire használható a Számla Agent?
A Számla Agent automatikus számlázási megoldás, amellyel webshopból, üzleti alkalmazásból vagy egyedi fejlesztésű rendszerből is kiállíthatsz bizonylatot anélkül, hogy belépnél a Számlázz.hu fiókodba.
A külső rendszer HTTP POST API kapcsolaton keresztül XML vagy JSON formátumban tud kommunikálni a Számlázz.hu-val. A rendszer feldolgozza a kérést, létrehozza a kívánt bizonylatot, majd válaszban visszaküldi a bizonylat adatait az általad kért formátumban, XML-ben vagy PDF-ben.
Többek között lehetőséged van:
- számla készítésére, helyesbítésére és sztornózására, előlegszámla készítésére, valamint az előlegszámlából végszámla készítésére,
- befizetés rögzítésére,
- számlák PDF vagy XML formátumú lekérésére,
- díjbekérő létrehozására és törlésére,
- szállítólevél készítésére,
- nyugták kiállítására, sztornózására, kiküldésére és adataik lekérdezésére,
- számlaértesítő küldésére,
- adózói adatok lekérdezésére.
A Számla Agentet használhatod például webshophoz, CRM rendszerhez, ügyviteli rendszerhez, előfizetéskezelő rendszerhez, egyedi fejlesztésű alkalmazáshoz vagy bármilyen olyan rendszerhez, amelyhez kialakítható a Számlázz.hu API kapcsolat.
Honnan tudom, hogy használhatom-e a Számla Agentet?
A Számla Agent használatához nincs szükség külön aktiválásra vagy bekapcsolásra. Ha van Számlázz.hu fiókod, akkor létre tudsz hozni API kulcsot (Számla Agent kulcsot), amelyre a Számla Agent használatához szükség van.
A Számla Agent bármely Számlázz.hu szolgáltatáscsomag mellett elérhető, akár #free csomag használata esetén is. Fontos azonban, hogy nem része a szolgáltatáscsomagoknak, hanem külön díjazású szolgáltatás. A díjazás részleteiről a cikk további részében írunk.
Hogyan kapcsolhatom össze a Számla Agentet egy külső rendszerrel?
A külső rendszer API kapcsolaton keresztül tud kommunikálni a Számlázz.hu-val.
Ha kész integrációval rendelkező külső rendszert használsz, akkor a kapcsolat kialakításához létre kell hoznod egy Számla Agent API kulcsot a Számlázz.hu fiókodban, majd ezt kell rögzítened a külső rendszer beállításaiban.
Ha saját fejlesztésű rendszert használsz, egyeztess a fejlesztőddel arról, hogy az API kulcsot hol kell megadni, és milyen további beállításokra van szükség az összekapcsoláshoz.
Ha a külső rendszer beállításaiban számlatömb jelet vagy számlaszám előtagot kell megadni, azt a Számlázz.hu fiókodban a Beállítások / Előtagok menüpontban találod meg.
Előfizetéssel több előtag is rögzíthető, így az automatikusan készülő számlákat akár külön számlatömbben is kezelheted.
Ha nem érkezik előtag adat az API hívásban, akkor a bizonylatok automatikusan a fiókban elsőként létrehozott előtaggal készülnek el.
Ha a külső rendszer olyan előtag adatot küld, amely nincs rögzítve a Számlázz.hu fiókban, akkor a számlakészítési kérést hibaüzenettel elutasítjuk.
Hol találom a Számla Agent API kulcsot?
Az API kulcsot a Számlázz.hu fiókodban, a Vezérlőpulton tudod létrehozni és kezelni.
A kulcs létrehozásának részletes lépéseit ebben a cikkben találod:
Mi a Számla agent kulcs (API kulcs)?
Mennyibe kerül a Számla Agent használata?
A Számla Agent nem része a Számlázz.hu szolgáltatáscsomagjainak, hanem külön díjazású, használat alapú szolgáltatás.
A díjtáblázatot eléred az alábbi linkre kattintva:
Számla Agent szolgáltatás
A Számla Agent használata nem függ attól, hogy milyen szolgáltatáscsomaggal rendelkezel, mert akár #free csomag használata mellett is elérhető. A díja a létrehozott bizonylatok darabszáma alapján, sávosan kerül számlázásra.
Automatikus számlázás során is csak azokat a funkciókat használhatod, amelyeket a szolgáltatáscsomagod a manuális számlázásnál is biztosít. Például #free csomag esetén Számla Agenttel sem tudsz e-számlát kiállítani vagy befizetéseket kezelni.
A Számla Agent fizetendő díjáról minden hónap első napján e-mailes tájékoztatót, díjbekérőt küldünk az előző hónapban automatikusan készülét bizonylatok száma alapján.
Hogyan tudom tesztelni az automatikus számlázást?
Az automatikus számlázás tesztelése kizárólag teszt fiókban történhet.
Az éles rendszerben történő tesztelés díjfizetési kötelezettséggel jár, mert ilyenkor a Számla Agent használata megkezdődik.
A teszteléshez kapcsolódó részletes tudnivalókat ezekben a cikkekben találod:
- Hogyan lehet létrehozni teszt API hozzáférést?
- Számla Agent illesztéséhez használhatom-e meglevő, de még „szűz” számlázási fiókom?
- Melyek a kezdeti lépések a Számla Agent tesztelésénél?
- Teszt fiók működése
Hol találom a fejlesztői dokumentációt?
A Számla Agent fejlesztői dokumentációját itt találod: https://docs.szamlazz.hu/
A dokumentáció részletes technikai leírást, API példákat és fejlesztői segédleteket tartalmaz.
Hol olvashatok még többet a Számla Agent szolgáltatásról?
Tudástárunkban több olyan cikket is találsz, amely a Számla Agent működésével, használatával vagy tesztelésével foglalkozik. Ezeketide kattintva, egy helyen összegyűjtve éred el.
