Minta

Az alábbi példák a sandboxban futottak. A Kód fül a kassza hívást, az Elküldött XML fül a Számla Agentnek küldött xmlszamla dokumentumot, a Válasz fül a szimulált Számlázz.hu választ mutatja. A kód fölé húzva az egeret a típusokat is látod.

B2B számla nettó árakkal#

Vállalkozásnak szóló számla, nettó egységárakkal, 8 napos fizetési határidővel. A vevőnek e-mail címe is van, ezért a Számlázz.hu elküldi neki a számlát.

Számla kiállítása

B2B számla nettó egységárakkal, fizetési határidővel és e-mail értesítővel.

Futtatás a sandboxban

szamla.ts

import {  } from 'kassza'

const  = ()

const  = await ..({
  : 'REND-1001',
  : 'átutalás',
  : 8,
  : {
    : 'Vevő Kft.',
    : '1111',
    : 'Budapest',
    : 'Fő utca 1.',
    : 'vevo@example.hu',
    : '12345676-2-41',
  },
  : [
    { : 'Webfejlesztés', : 10, : 'óra', : 15_000, : 27 },
    { : 'Tárhely, 12 hónap', : 24_000, : 27 },
  ],
})

.(.)
.({ : ., : ., : . })
.(.)
.(.)

Számla létrehozás · action-xmlagentxmlfile

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamla xmlns="http://www.szamlazz.hu/xmlszamla" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamla https://www.szamlazz.hu/szamla/docs/xsds/agent/xmlszamla.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <eszamla>false</eszamla>
    <szamlaLetoltes>true</szamlaLetoltes>
    <valaszVerzio>2</valaszVerzio>
  </beallitasok>
  <fejlec>
    <keltDatum>2026-09-19</keltDatum>
    <teljesitesDatum>2026-09-19</teljesitesDatum>
    <fizetesiHataridoDatum>2026-09-27</fizetesiHataridoDatum>
    <fizmod>átutalás</fizmod>
    <penznem>HUF</penznem>
    <szamlaNyelve>hu</szamlaNyelve>
    <rendelesSzam>REND-1001</rendelesSzam>
  </fejlec>
  <elado></elado>
  <vevo>
    <nev>Vevő Kft.</nev>
    <irsz>1111</irsz>
    <telepules>Budapest</telepules>
    <cim>Fő utca 1.</cim>
    <email>vevo@example.hu</email>
    <sendEmail>true</sendEmail>
    <adoszam>12345676-2-41</adoszam>
  </vevo>
  <tetelek>
    <tetel>
      <megnevezes>Webfejlesztés</megnevezes>
      <mennyiseg>10</mennyiseg>
      <mennyisegiEgyseg>óra</mennyisegiEgyseg>
      <nettoEgysegar>15000</nettoEgysegar>
      <afakulcs>27</afakulcs>
      <nettoErtek>150000</nettoErtek>
      <afaErtek>40500</afaErtek>
      <bruttoErtek>190500</bruttoErtek>
    </tetel>
    <tetel>
      <megnevezes>Tárhely, 12 hónap</megnevezes>
      <mennyiseg>1</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>24000</nettoEgysegar>
      <afakulcs>27</afakulcs>
      <nettoErtek>24000</nettoErtek>
      <afaErtek>6480</afaErtek>
      <bruttoErtek>30480</bruttoErtek>
    </tetel>
  </tetelek>
</xmlszamla>

Számla létrehozás · válasz, HTTP 200

content-type: application/xml; charset=UTF-8
szlahu_szamlaszam: KASSZA-2026-1
szlahu_nettovegosszeg: 174000
szlahu_bruttovegosszeg: 220980
szlahu_kintlevoseg: 220980
set-cookie: JSESSIONID=7CABE61BB77FC3F62A4633EB; Path=/szamla; Secure; HttpOnly

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlavalasz xmlns="http://www.szamlazz.hu/xmlszamlavalasz">
  <sikeres>true</sikeres>
  <szamlaszam>KASSZA-2026-1</szamlaszam>
  <szamlanetto>174000</szamlanetto>
  <szamlabrutto>220980</szamlabrutto>
  <kintlevoseg>220980</kintlevoseg>
  <pdf>JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5k… (base64 PDF, rövidítve)</pdf>
</xmlszamlavalasz>

Konzol

KASSZA-2026-1
{ netto: 174000, brutto: 220980, hatralek: 220980 }
[
  {
    name: 'Webfejlesztés',
    quantity: 10,
    vat: 27,
    netUnitPrice: 15000,
    netAmount: 150000,
    vatAmount: 40500,
    grossAmount: 190500
  },
  {
    name: 'Tárhely, 12 hónap',
    quantity: 1,
    vat: 27,
    netUnitPrice: 24000,
    netAmount: 24000,
    vatAmount: 6480,
    grossAmount: 30480
  }
]
Uint8Array(2846) [PDF]

Webshop számla bruttó árakkal#

Magánszemélynek szóló, kártyával kifizetett rendelés. Bruttó egységárak, két különböző áfakulcs, a kliens alapbeállításaiban megadott előtaggal és e-mail szöveggel.

Webshop számla bruttó árakkal

Kártyával fizetett rendelés, bruttó egységárak, több áfakulcs, alapbeállítások.

Futtatás a sandboxban

szamla-brutto.ts

import {  } from 'kassza'

const  = ({
  : {
    : {
      : 'WEB',
      : { : 'penzugy@example.hu', : 'Elkészült a számlád' },
    },
  },
})

const  = await ..({
  : 'WEB-58213',
  : 'bankkártya',
  : true,
  : {
    : 'Szabó Júlia',
    : '6720',
    : 'Szeged',
    : 'Kárász utca 5.',
    : 'julia@example.hu',
  },
  : [
    { : 'Póló, M', : 2, : 5_990, : 27 },
    { : 'Szakácskönyv', : 3_500, : 5 },
    { : 'Házhoz szállítás', : 1_490, : 27 },
  ],
})

.(., 'bruttó:', ., 'hátralék:', .)

for (const  of .) {
  .(
    `${.}: nettó ${.}, áfa ${.}, bruttó ${.}`,
  )
}

Számla létrehozás · action-xmlagentxmlfile

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamla xmlns="http://www.szamlazz.hu/xmlszamla" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamla https://www.szamlazz.hu/szamla/docs/xsds/agent/xmlszamla.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <eszamla>false</eszamla>
    <szamlaLetoltes>true</szamlaLetoltes>
    <valaszVerzio>2</valaszVerzio>
  </beallitasok>
  <fejlec>
    <keltDatum>2026-09-19</keltDatum>
    <teljesitesDatum>2026-09-19</teljesitesDatum>
    <fizetesiHataridoDatum>2026-09-19</fizetesiHataridoDatum>
    <fizmod>bankkártya</fizmod>
    <penznem>HUF</penznem>
    <szamlaNyelve>hu</szamlaNyelve>
    <rendelesSzam>WEB-58213</rendelesSzam>
    <szamlaszamElotag>WEB</szamlaszamElotag>
    <fizetve>true</fizetve>
  </fejlec>
  <elado>
    <emailReplyto>penzugy@example.hu</emailReplyto>
    <emailTargy>Elkészült a számlád</emailTargy>
  </elado>
  <vevo>
    <nev>Szabó Júlia</nev>
    <irsz>6720</irsz>
    <telepules>Szeged</telepules>
    <cim>Kárász utca 5.</cim>
    <email>julia@example.hu</email>
    <sendEmail>true</sendEmail>
  </vevo>
  <tetelek>
    <tetel>
      <megnevezes>Póló, M</megnevezes>
      <mennyiseg>2</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>4716.5</nettoEgysegar>
      <afakulcs>27</afakulcs>
      <nettoErtek>9433</nettoErtek>
      <afaErtek>2547</afaErtek>
      <bruttoErtek>11980</bruttoErtek>
    </tetel>
    <tetel>
      <megnevezes>Szakácskönyv</megnevezes>
      <mennyiseg>1</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>3333</nettoEgysegar>
      <afakulcs>5</afakulcs>
      <nettoErtek>3333</nettoErtek>
      <afaErtek>167</afaErtek>
      <bruttoErtek>3500</bruttoErtek>
    </tetel>
    <tetel>
      <megnevezes>Házhoz szállítás</megnevezes>
      <mennyiseg>1</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>1173</nettoEgysegar>
      <afakulcs>27</afakulcs>
      <nettoErtek>1173</nettoErtek>
      <afaErtek>317</afaErtek>
      <bruttoErtek>1490</bruttoErtek>
    </tetel>
  </tetelek>
</xmlszamla>

Számla létrehozás · válasz, HTTP 200

content-type: application/xml; charset=UTF-8
szlahu_szamlaszam: WEB-2026-1
szlahu_nettovegosszeg: 13939
szlahu_bruttovegosszeg: 16970
szlahu_kintlevoseg: 0
set-cookie: JSESSIONID=ED08664A819044E9151A4774; Path=/szamla; Secure; HttpOnly

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlavalasz xmlns="http://www.szamlazz.hu/xmlszamlavalasz">
  <sikeres>true</sikeres>
  <szamlaszam>WEB-2026-1</szamlaszam>
  <szamlanetto>13939</szamlanetto>
  <szamlabrutto>16970</szamlabrutto>
  <kintlevoseg>0</kintlevoseg>
  <pdf>JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5k… (base64 PDF, rövidítve)</pdf>
</xmlszamlavalasz>

Konzol

WEB-2026-1 bruttó: 16970 hátralék: 0
Póló, M: nettó 9433, áfa 2547, bruttó 11980
Szakácskönyv: nettó 3333, áfa 167, bruttó 3500
Házhoz szállítás: nettó 1173, áfa 317, bruttó 1490

XSD séma#

A kassza az XML-t a Számlázz.hu xmlszamla.xsd sémája szerint, kötött elemsorrendben építi fel. A séma itt érhető el:

https://www.szamlazz.hu/szamla/docs/xsds/agent/xmlszamla.xsd

A kassza tesztjei a generált XML-t a hivatalos XSD sémákkal is összevetik, ezért a sémával neked nem kell foglalkoznod. Ha a hivatalos dokumentációban olyan mezőt találsz, amely a kasszában még nincs meg, nyiss egy issue-t.

További példák#

Díjbekérő, majd számla

Díjbekérő kiállítása és a befizetés utáni végleges számla.

Előleg- és végszámla

Előlegszámla, majd végszámla az előleg levonásával.

Devizás számla

Euróban kiállított angol nyelvű számla EU-s vevőnek.

Idempotens számlázás

Webhookból indított számlázás dupla számla nélkül.