Minta

A példa kiállít egy 127 000 bruttó végösszegű számlát, és három lépésben kezeli a befizetéseit:

rögzít egy 50 000 összegű első részletet átutalással,
egy kérésben hozzáad két további befizetést (20 000 készpénzben és 57 000 bankkártyával), így a befizetések összege eléri a végösszeget,
a clearPayments() hívással törli a számla összes befizetését.

Minden lépés után a konzolon a hátralék (outstanding) látszik. Az Elküldött XML fülön az összes kérést megtalálod, köztük a három xmlszamlakifiz dokumentumot. A törlő kérésben nincs kifizetes elem, és az additiv értéke false.

Befizetések rögzítése

Egy befizetés, több részlet egyszerre, majd a befizetések törlése.

Futtatás a sandboxban

befizetes.ts

import {  } from 'kassza'

const  = ()

const  = await ..({
  : 'REND-2001',
  : { : 'Vevő Kft.', : '1111', : 'Budapest', : 'Fő utca 1.' },
  : [{ : 'Tanácsadás', : 4, : 'óra', : 25_000, : 27 }],
})
.('Bruttó végösszeg:', .)

const  = await ..({
  : .,
  : 50_000,
  : 'átutalás',
  : 'Első részlet',
})
.('Hátralék az első befizetés után:', .)

const  = await ..({
  : .,
  : [
    { : 'készpénz', : 20_000 },
    { : 'bankkártya', : 57_000 },
  ],
})
.('Hátralék a részletek után:', .)

const  = await ..(.)
.('Hátralék a befizetések törlése után:', .)

1. 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>Átutalás</fizmod>
    <penznem>HUF</penznem>
    <szamlaNyelve>hu</szamlaNyelve>
    <rendelesSzam>REND-2001</rendelesSzam>
  </fejlec>
  <elado></elado>
  <vevo>
    <nev>Vevő Kft.</nev>
    <irsz>1111</irsz>
    <telepules>Budapest</telepules>
    <cim>Fő utca 1.</cim>
    <sendEmail>false</sendEmail>
  </vevo>
  <tetelek>
    <tetel>
      <megnevezes>Tanácsadás</megnevezes>
      <mennyiseg>4</mennyiseg>
      <mennyisegiEgyseg>óra</mennyisegiEgyseg>
      <nettoEgysegar>25000</nettoEgysegar>
      <afakulcs>27</afakulcs>
      <nettoErtek>100000</nettoErtek>
      <afaErtek>27000</afaErtek>
      <bruttoErtek>127000</bruttoErtek>
    </tetel>
  </tetelek>
</xmlszamla>

2. Befizetés rögzítése · action-szamla_agent_kifiz

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlakifiz xmlns="http://www.szamlazz.hu/xmlszamlakifiz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamlakifiz https://www.szamlazz.hu/szamla/docs/xsds/agentkifiz/xmlszamlakifiz.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <szamlaszam>KASSZA-2026-1</szamlaszam>
    <additiv>true</additiv>
    <valaszVerzio>2</valaszVerzio>
  </beallitasok>
  <kifizetes>
    <datum>2026-09-19</datum>
    <jogcim>átutalás</jogcim>
    <osszeg>50000</osszeg>
    <leiras>Első részlet</leiras>
  </kifizetes>
</xmlszamlakifiz>

3. Befizetés rögzítése · action-szamla_agent_kifiz

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlakifiz xmlns="http://www.szamlazz.hu/xmlszamlakifiz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamlakifiz https://www.szamlazz.hu/szamla/docs/xsds/agentkifiz/xmlszamlakifiz.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <szamlaszam>KASSZA-2026-1</szamlaszam>
    <additiv>true</additiv>
    <valaszVerzio>2</valaszVerzio>
  </beallitasok>
  <kifizetes>
    <datum>2026-09-19</datum>
    <jogcim>készpénz</jogcim>
    <osszeg>20000</osszeg>
  </kifizetes>
  <kifizetes>
    <datum>2026-09-19</datum>
    <jogcim>bankkártya</jogcim>
    <osszeg>57000</osszeg>
  </kifizetes>
</xmlszamlakifiz>

4. Befizetés rögzítése · action-szamla_agent_kifiz

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlakifiz xmlns="http://www.szamlazz.hu/xmlszamlakifiz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamlakifiz https://www.szamlazz.hu/szamla/docs/xsds/agentkifiz/xmlszamlakifiz.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <szamlaszam>KASSZA-2026-1</szamlaszam>
    <additiv>false</additiv>
    <valaszVerzio>2</valaszVerzio>
  </beallitasok>
</xmlszamlakifiz>

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

content-type: application/xml; charset=UTF-8
szlahu_szamlaszam: KASSZA-2026-1
szlahu_nettovegosszeg: 100000
szlahu_bruttovegosszeg: 127000
szlahu_kintlevoseg: 127000
set-cookie: JSESSIONID=B053487474C0C97ADAEC2020; 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>100000</szamlanetto>
  <szamlabrutto>127000</szamlabrutto>
  <kintlevoseg>127000</kintlevoseg>
  <pdf>JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5k… (base64 PDF, rövidítve)</pdf>
</xmlszamlavalasz>

2. Befizetés rögzítése · válasz, HTTP 200

content-type: application/xml; charset=UTF-8
szlahu_szamlaszam: KASSZA-2026-1
szlahu_nettovegosszeg: 100000
szlahu_bruttovegosszeg: 127000
szlahu_kintlevoseg: 77000

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlavalasz xmlns="http://www.szamlazz.hu/xmlszamlavalasz">
  <sikeres>true</sikeres>
  <szamlaszam>KASSZA-2026-1</szamlaszam>
  <szamlanetto>100000</szamlanetto>
  <szamlabrutto>127000</szamlabrutto>
  <kintlevoseg>77000</kintlevoseg>
</xmlszamlavalasz>

3. Befizetés rögzítése · válasz, HTTP 200

content-type: application/xml; charset=UTF-8
szlahu_szamlaszam: KASSZA-2026-1
szlahu_nettovegosszeg: 100000
szlahu_bruttovegosszeg: 127000
szlahu_kintlevoseg: 0

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlavalasz xmlns="http://www.szamlazz.hu/xmlszamlavalasz">
  <sikeres>true</sikeres>
  <szamlaszam>KASSZA-2026-1</szamlaszam>
  <szamlanetto>100000</szamlanetto>
  <szamlabrutto>127000</szamlabrutto>
  <kintlevoseg>0</kintlevoseg>
</xmlszamlavalasz>

4. Befizetés rögzítése · válasz, HTTP 200

content-type: application/xml; charset=UTF-8
szlahu_szamlaszam: KASSZA-2026-1
szlahu_nettovegosszeg: 100000
szlahu_bruttovegosszeg: 127000
szlahu_kintlevoseg: 127000

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlavalasz xmlns="http://www.szamlazz.hu/xmlszamlavalasz">
  <sikeres>true</sikeres>
  <szamlaszam>KASSZA-2026-1</szamlaszam>
  <szamlanetto>100000</szamlanetto>
  <szamlabrutto>127000</szamlabrutto>
  <kintlevoseg>127000</kintlevoseg>
</xmlszamlavalasz>

Konzol

Bruttó végösszeg: 127000
Hátralék az első befizetés után: 77000
Hátralék a részletek után: 0
Hátralék a befizetések törlése után: 127000

XSD séma#

A kassza az XML-t a Számlázz.hu xmlszamlakifiz.xsd sémája szerint, kötött elemsorrendben építi fel, és a tesztjei a generált kéréseket ezzel a sémával ellenőrzik:

https://www.szamlazz.hu/szamla/docs/xsds/agentkifiz/xmlszamlakifiz.xsd

A sémában szereplő aggregator elemet a kassza nem tölti ki.