Számlázz.hu integráció jelentése

A Számlázz.hu integráció az a fejlesztési megoldás, amely során a saját weboldalad, webshopod vagy CRM-rendszered közvetlenül kommunikál a Számlázz.hu szolgáltatással — automatikus számla-kiállítás, díjbekérő-küldés, NAV-továbbítás, nyugta-generálás. A Számlázz.hu Magyarország legelterjedtebb online számlázó szolgáltatása, és az API-juk széles körű: minden, amit a webes UI-n meg tudsz csinálni, programozottan is.

Így is ismerheted

Magyarul Számlázz.hu API, Számlázz.hu bekötés, Szamlazz.com integráció (a Számlázz.hu hivatalos angol neve). A „Számlázz.hu Agent” a hivatalos PHP SDK-juk. Versenytársak Magyarországon: Billingo, Számlázz.com (azonos cég), SmallBusiness, MiniCRM beépített számlázó.

Mire jó cégeknek?

A Számlázz.hu integráció ott jelenik meg, ahol manuálisan kéne számlát kiállítani:

Webshop / online szolgáltatás: vásárlás végén automatikus számla az ügyfélnek. Nem kell senkinek kézzel feltöltenie a Számlázz.hu webes felületre.

Periodikus díjak: havi előfizetések, projekt-mérföldkövek, retainer-díjak. Cron-job-ra futó számla-generálás.

CRM-integráció: amikor a sales-csapat „Won” státuszba állít egy deal-t, automatikusan kimegy a számla.

Sales-flow vége: ajánlat → szerződés → számla — minden lépés automatizálható.

Időmegtakarítás: egy 100 számlás hónap manuálisan 4-6 órás munka, automatizálva 0 (csak ellenőrzés).

Hogyan néz ki a Számlázz.hu API?

A Számlázz.hu „Számla Agent” REST/XML-API-t kínál. Kérés:

POST https://www.szamlazz.hu/szamla/

XML-body:
<xmlszamla>
  <beallitasok>
    <szamlaagentkulcs>szla_agent_xxx</szamlaagentkulcs>
    <eszamla>true</eszamla>
  </beallitasok>
  <fejlec>
    <keltDatum>2026-06-02</keltDatum>
    <teljesitesDatum>2026-06-02</teljesitesDatum>
    <fizetesiHataridoDatum>2026-06-16</fizetesiHataridoDatum>
    <fizmod>Átutalás</fizmod>
    <penznem>HUF</penznem>
  </fejlec>
  <vevo>
    <nev>Példa Kft.</nev>
    <cim>...</cim>
  </vevo>
  <tetelek>
    <tetel>
      <megnevezes>Webfejlesztés</megnevezes>
      <mennyiseg>1</mennyiseg>
      <nettoEgysegar>500000</nettoEgysegar>
      <afakulcs>27</afakulcs>
    </tetel>
  </tetelek>
</xmlszamla>

Az API kulcsot a Számlázz.hu fiókodban generálsz. A válasz egy PDF (a kiállított számla), és a fejlécben a számla-szám.

Hivatalos SDK-k

A Számlázz.hu maga ad PHP-SDK-t. Más nyelvekhez community-megoldások:

PHP: szamlaagent/szamla-agent Composer-csomag.
WordPress / WooCommerce: hivatalos „Számlázz.hu WooCommerce” plugin.
Node.js: community-csomagok (pl. szamlazz).
Python: szamlazz-py wrapper.
n8n / Make: HTTP-modul-on át bárhonnan hívható.

Tipikus integrációs scenarios

Néhány klasszikus eset, amit építünk:

WooCommerce + Számlázz.hu: vásárlás után automatikus számla az ügyfélnek e-mailben. Plugin alapból megoldja.
Shopify + Számlázz.hu: webhook → n8n → Számlázz.hu API. Egyedi fejlesztés.
HubSpot „Won” → Számlázz.hu: deal-státusz változás triggereli a számla-kiállítást.
Stripe Subscription → Számlázz.hu: havi automatikus díj fizetés után magyar számla.
SaaS-saját rendszer → Számlázz.hu: minden fizetésnél / előfizetés-megújításnál.

Mire figyelj?

Az első tipp: NAV-megfelelőség. A Számlázz.hu automatikusan továbbít az Online Számla rendszerbe, de a tartalmi pontosság a te felelősséged (ÁFA-kulcs, tételszöveg, adószám).

A második: duplikáció-védelem. Egy hibás retry kétszer is kiállíthat számlát ugyanarra a vásárlásra. Tartsd nyilván a már sikeresen kiállított számlákat (idempotency key).

A harmadik: hibakezelés. Az API néha lassú vagy átmenetileg elérhetetlen. Retry mechanizmus + manual fallback (e-mail az adminnak, ha többször bukik).

A negyedik: storno és módosító. A számlák Magyarországon visszavonhatatlanok kiállítás után — csak storno + új. Az API ezt is támogatja, de gondolj rá az adatmodell-tervezésnél.

Az ötödik: devizás számla. Ha külföldi ügyfelednek számlázol (EUR, USD), az API ezt kezeli, de az árfolyamot a Számlázz.hu az MNB-ből veszi vagy te adod meg.

A hatodik: API-kulcs biztonság. Mint minden API-kulcs: env-fájl, secret manager, soha ne Git-be vagy frontend-kódba.

Ha cégednél Számlázz.hu integrációt szeretnél bevezetni — webshop, sales-folyamat, periodikus díjazás —, az AI és automatizáció szolgáltatásunkból induljunk: workflow-tervezés, API-bekötés, hibakezelés. Egyedi webshop vagy szoftver esetén az egyedi weboldal-fejlesztés csapat dolgozik vele. Hivatalos forrás: szamlazz.hu/integracio.

Számlázz.hu integráció