Számlázz.hu integráció

Mi az a Számlázz.hu?

A Számlázz.hu egy magyar online számlázóprogram. Az általa kiállított számlák automatikusan bekerülnek a NAV Online Számla rendszerébe. A Számla Agent a Számlázz.hu programozható felülete: ezen keresztül egy külső alkalmazás is ki tud állítani számlát a te Számlázz.hu-fiókodban.

Mire használhatod a Suarában?

Ha összekötöd a Számlázz.hu-t, az appod számlát tud kiállítani, például vásárlás vagy foglalás után. Néhány példa:

• Webshop: rendelés után az app automatikusan számlát állít ki, és elküldi a vevőnek.

• Foglalási rendszer: a kifizetett foglalásról számla készül.

• Szolgáltatási portál: az ügyfél a portálon kéri a számláját, vagy letölti a korábbit PDF-ben.

• Díjbekérő: az app a fizetés előtt díjbekérőt küld, a befizetés után pedig a végleges számlát állítja ki.

Az AI az alábbi műveleteket használja:

• Számla kiállítása: számlát készít a vevő adataival és a tételekkel (mennyiség, nettó egységár, ÁFA-kulcs). Kérhető elektronikus számla, e-mailes kiküldés és PDF-letöltés is.

• Díjbekérő kiállítása: díjbekérőt készít, és abból később végleges számla is kiállítható.

• Nyugta kiállítása: nyugtát készít, megkereshető, e-mailben elküldhető és sztornózható.

• Számla PDF letöltése: egy már kiállított számla PDF-jét adja vissza.

• Számla adatainak lekérdezése: egy ismert számlaszámhoz visszaadja a számla adatait.

• Sztornózás: a számlát egy sztornószámlával érvényteleníti.

• Díjbekérő törlése: a még ki nem fizetett díjbekérőt törli.

• Adózó adatainak lekérdezése: egy adószám első 8 számjegye alapján lekérdezi az adózó adatait.

Mit nem tud az integráció?

A Számla Agentnek nincs „számlák listázása” művelete. Az AI egy-egy számlát tud lekérdezni, ha ismeri a számlaszámot, rendelésszámot vagy külső azonosítót. Ezért egy számlalista vagy dashboard csak azokat a számlákat mutathatja, amelyeknek a számlaszámát az app már ismeri, például mert maga állította ki és eltárolta őket. A teljes fiók összes számláját nem lehet kilistázni. Csak a Számlázz.hu-ban kiállított, kimenő számlákat lehet lekérdezni.

Fontos tudnivaló: a számla a NAV-hoz kerül

A kiállított számlát a rendszer jelenti a NAV felé, és nem lehet törölni. Hiba esetén csak sztornózni lehet, a sztornó pedig maga is végleges dokumentum. Ezért:

• Minden írási művelet (számla, díjbekérő, nyugta kiállítása, sztornó) minden alkalommal a jóváhagyásodat kéri a chatben. Ehhez a kapcsolathoz nincs „mindig engedélyezem” beállítás.

• Az AI nem állít ki „próba” számlát a chatből. A kiállítás előtt egyeztet veled a részletekről.

• Az app fejlesztése közben érdemes a Számlázz.hu-ban külön tesztelésre használt fiókkal kipróbálni a folyamatot, mielőtt éles fiókkal kötöd be.

Biztonság

A Számla Agent kulcs titkosítva, a Suara szerverén marad. A generált app sosem látja, és a böngészőbe sem kerül. Az app a Suara gatewayen keresztül hívja a Számlázz.hu-t, a gateway pedig a háttérben beilleszti a kulcsot a kérésbe. A kapcsolatot a láthatóság beállításával korlátozhatod: Csak én, Csak kiválasztott tagok vagy Az egész munkaterület.

Beállítás lépésről lépésre

1. Szerezd meg a Számla Agent kulcsot a Számlázz.hu-ban

1. Jelentkezz be a Számlázz.hu-fiókodba abba a számlázási fiókba, amelyből a számlákat ki szeretnéd állítani.

2. Nyisd meg a Beállítások oldalt, ezen belül a Számla Agent kulcsok részt: https://www.szamlazz.hu/szamla/main?action=agentkulcsok

3. Kattints az Új kulcs (kulcs ikon) gombra. A kulcs azonnal létrejön, és rögtön használható.

4. Másold ki a kulcsot.

2. Kösd be a Suarában

1. A Suara oldalsávjában nyisd meg az Integrációk oldalt.

2. A Katalógusban keresd meg a Számlázz.hu-t. A Számlázás kategóriában találod, vagy használhatod a keresőt (Integráció keresése…).

3. Kattints a Csatlakoztatás gombra. Megnyílik a „Számlázz.hu csatlakoztatása” ablak.

4. Illeszd be a másolt kulcsot a Számla Agent kulcs mezőbe. A beillesztett érték a Kulcs megjelenítése ikonnal ellenőrizhető. A Hol találom? hivatkozás a Számlázz.hu kulcsok oldalára visz.

5. Válaszd ki, ki használhatja a kapcsolatot (Csak én vagy Az egész munkaterület). Ha a teljes munkaterületnek engedélyezed, a Suara figyelmeztet, hogy minden tag használhatja a kapcsolatot a saját projektjeiben. Ennél az integrációnál ez azt jelenti, hogy az ő appjaik is állíthatnak ki számlát a te nevedben.

6. Kattints a Mentés és ellenőrzés gombra. A Suara a kulccsal egy ártalmatlan adózói lekérdezést futtat, és ha a kulcs érvényes, a kapcsolat Számlázz.hu néven megjelenik a Kapcsolataid között.

3. Használd a projektedben

Három módon használhatod a kapcsolatot:

• A chatben kérve: írd le az AI-nak, mit szeretnél, például „Sikeres fizetés után állíts ki számlát a vevőnek, és küldd el neki e-mailben.” Ha még nincs kapcsolat, az AI felkínálja a csatlakoztatást.

• Az Integrációk oldalról: a Kapcsolataid között a Számlázz.hu mellett a Bekötés az appba gombbal kötheted be a kapcsolatot egy projektbe.

• A projekt Kapcsolatok oldaláról: nyisd meg a projekt Kapcsolatok részét, és kattints a Kapcsolat gombra. Ott a Munkaterület kapcsolatai közül választhatsz egy meglévőt, vagy az Új bekötése gombbal újat hozhatsz létre.

A bekötés után az AI a Számlázz.hu-hívásokat az app szerveroldali (edge function) részében generálja. A kulcs így nem kerül a kódba, és a kapcsolatot szükség esetén a projekt Kapcsolatok oldaláról bármikor leválaszthatod.

Számlázási szabályok, amelyeket érdemes tudni

• Az összegeket az AI számolja ki, nem a Számlázz.hu. A Számla Agent csak ellenőrzi a tételek nettó, ÁFA és bruttó összegét, és eltérés esetén elutasítja a számlát.

• A vevő adatait az app adja meg a számlán. Nincs külön partnerlista: a vevő neve, irányítószáma, települése és címe kötelező.

• A hibákat a Számlázz.hu külön jelzi. Egy kérés akkor is lehet sikertelen, ha a technikai válasz rendben érkezik. A Suara a hibakódot és a hibaüzenetet minden híváskor ellenőrzi.

Kapcsolat kezelése

Az Integrációk → Kapcsolataid alatt a Számlázz.hu kapcsolatra kattintva elérhető:

• Alapadatok: az elnevezés és a láthatóság módosítása.

• Kulcsok frissítése: új Számla Agent kulcs mentése, ha lecserélted vagy törölted a régit.

• Kapcsolt projektek: itt látod, mely projektek használják a kapcsolatot.

• Utolsó hívások: itt látod a legutóbbi hívásokat (metódus, útvonal, státusz, időtartam, forrás: alkalmazás vagy chat).

• Leválasztás (Veszélyzóna): megszünteti a kapcsolatot. A hozzá kötött projektek ezután nem tudnak számlát kiállítani.

A státusz lehet Aktív, Hiba vagy Visszavonva. Ha Újracsatlakozás szükséges üzenetet látsz, mentsd újra a kulcsot.

Hibaelhárítás

• „Mentés és ellenőrzés” hibával áll meg: Ellenőrizd, hogy a kulcs helyesen lett kimásolva (szóköz nélkül), és hogy a Számlázz.hu-ban nincs törölve.

• A kapcsolat „Hiba” vagy „Visszavonva” státuszú: A kulcsot törölték vagy elutasította a Számlázz.hu. Hozz létre újat a Számla Agent kulcsok oldalon, és mentsd el a Kulcsok frissítése résznél.

• Az app nem állít ki számlát: Ellenőrizd, hogy a kapcsolat be van-e kötve a projektbe, és hogy a Suara Cloud be van-e kapcsolva.

• A számlát elutasítja a Számlázz.hu összegek miatt: A tételek nettó, ÁFA és bruttó összegének pontosan egyeznie kell a mennyiséggel, az egységárral és az ÁFA-kulccsal. Kérd meg az AI-t, hogy ellenőrizze a számítást.

• Hibás számlát állítottam ki: A számla nem törölhető, csak sztornózható. Kérd meg az AI-t a sztornóra, majd állítsd ki a helyes számlát.

• Nem látom az összes számlámat az appban: A Számla Agent nem tud számlát listázni. Az app csak azokat a számlákat mutatja, amelyeknek a számlaszámát eltárolta.