Minta

A példa kiállít egy nyugtát két mozijegyről, majd saját callId-val sztornózza. A konzolon látod az eredeti és a sztornó nyugta számát, a reversal típust, a hivatkozást és a negatív bruttó végösszeget. Az Elküldött XML fülön mindkét kérés ott van, köztük a sztornó xmlnyugtast dokumentuma.

Nyugta sztornózása

Nyugta kiállítása, majd sztornó nyugta a hivatkozással.

Futtatás a sandboxban

nyugta-sztorno.ts

import {  } from 'kassza'

const  = ({
  : { : { : 'NYGT', : 'bankkártya' } },
})

const  = await ..({
  : 'PENZTAR-2026-0107',
  : [{ : 'Mozijegy', : 2, : 2_990, : 5 }],
})

const  = await ..({
  : .,
  : 'PENZTAR-2026-0107-STORNO',
})

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

1. Nyugta létrehozás · action-szamla_agent_nyugta_create

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtacreate xmlns="http://www.szamlazz.hu/xmlnyugtacreate" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlnyugtacreate https://www.szamlazz.hu/szamla/docs/xsds/nyugtacreate/xmlnyugtacreate.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <pdfLetoltes>true</pdfLetoltes>
  </beallitasok>
  <fejlec>
    <hivasAzonosito>PENZTAR-2026-0107</hivasAzonosito>
    <elotag>NYGT</elotag>
    <fizmod>bankkártya</fizmod>
    <penznem>HUF</penznem>
  </fejlec>
  <tetelek>
    <tetel>
      <megnevezes>Mozijegy</megnevezes>
      <mennyiseg>2</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>2847.62</nettoEgysegar>
      <afakulcs>5</afakulcs>
      <netto>5695.24</netto>
      <afa>284.76</afa>
      <brutto>5980</brutto>
    </tetel>
  </tetelek>
</xmlnyugtacreate>

2. Nyugta sztornó · action-szamla_agent_nyugta_storno

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtast xmlns="http://www.szamlazz.hu/xmlnyugtast" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlnyugtast https://www.szamlazz.hu/szamla/docs/xsds/nyugtast/xmlnyugtast.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <pdfLetoltes>true</pdfLetoltes>
  </beallitasok>
  <fejlec>
    <nyugtaszam>NYGT-2026-1</nyugtaszam>
    <hivasAzonosito>PENZTAR-2026-0107-STORNO</hivasAzonosito>
  </fejlec>
</xmlnyugtast>

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

content-type: application/xml; charset=UTF-8
set-cookie: JSESSIONID=29F42681AFD2810B028E0011; Path=/szamla; Secure; HttpOnly

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtavalasz xmlns="http://www.szamlazz.hu/xmlnyugtavalasz">
  <sikeres>true</sikeres>
  <hibakod></hibakod>
  <hibauzenet></hibauzenet>
  <nyugtaPdf>JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5k… (base64 PDF, rövidítve)</nyugtaPdf>
  <nyugta>
    <alap>
      <id>1001</id>
      <hivasAzonosito>PENZTAR-2026-0107</hivasAzonosito>
      <nyugtaszam>NYGT-2026-1</nyugtaszam>
      <tipus>NY</tipus>
      <stornozott>false</stornozott>
      <kelt>2026-09-19</kelt>
      <fizmod>bankkártya</fizmod>
      <penznem>HUF</penznem>
      <teszt>true</teszt>
    </alap>
    <tetelek>
      <tetel>
        <megnevezes>Mozijegy</megnevezes>
        <mennyiseg>2</mennyiseg>
        <mennyisegiEgyseg>db</mennyisegiEgyseg>
        <nettoEgysegar>2847.62</nettoEgysegar>
        <netto>5695.24</netto>
        <afakulcs>5</afakulcs>
        <afa>284.76</afa>
        <brutto>5980</brutto>
      </tetel>
    </tetelek>
    <osszegek>
      <afakulcsossz>
        <afakulcs>5</afakulcs>
        <netto>5695.24</netto>
        <afa>284.76</afa>
        <brutto>5980</brutto>
      </afakulcsossz>
      <totalossz>
        <netto>5695.24</netto>
        <afa>284.76</afa>
        <brutto>5980</brutto>
      </totalossz>
    </osszegek>
  </nyugta>
</xmlnyugtavalasz>

2. Nyugta sztornó · válasz, HTTP 200

content-type: application/xml; charset=UTF-8

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtavalasz xmlns="http://www.szamlazz.hu/xmlnyugtavalasz">
  <sikeres>true</sikeres>
  <hibakod></hibakod>
  <hibauzenet></hibauzenet>
  <nyugtaPdf>JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5k… (base64 PDF, rövidítve)</nyugtaPdf>
  <nyugta>
    <alap>
      <id>1002</id>
      <hivasAzonosito>PENZTAR-2026-0107-STORNO</hivasAzonosito>
      <nyugtaszam>NYGT-2026-2</nyugtaszam>
      <tipus>SN</tipus>
      <stornozott>false</stornozott>
      <stornozottNyugtaszam>NYGT-2026-1</stornozottNyugtaszam>
      <kelt>2026-09-19</kelt>
      <fizmod>bankkártya</fizmod>
      <penznem>HUF</penznem>
      <teszt>true</teszt>
    </alap>
    <tetelek>
      <tetel>
        <megnevezes>Mozijegy</megnevezes>
        <mennyiseg>-2</mennyiseg>
        <mennyisegiEgyseg>db</mennyisegiEgyseg>
        <nettoEgysegar>2847.62</nettoEgysegar>
        <netto>-5695.24</netto>
        <afakulcs>5</afakulcs>
        <afa>-284.76</afa>
        <brutto>-5980</brutto>
      </tetel>
    </tetelek>
    <osszegek>
      <afakulcsossz>
        <afakulcs>5</afakulcs>
        <netto>-5695.24</netto>
        <afa>-284.76</afa>
        <brutto>-5980</brutto>
      </afakulcsossz>
      <totalossz>
        <netto>-5695.24</netto>
        <afa>-284.76</afa>
        <brutto>-5980</brutto>
      </totalossz>
    </osszegek>
  </nyugta>
</xmlnyugtavalasz>

Konzol

{
  eredeti: 'NYGT-2026-1',
  sztorno: 'NYGT-2026-2',
  tipus: 'reversal',
  hivatkozas: 'NYGT-2026-1',
  brutto: -5980
}

XSD séma#

Az XML elemeinek sorrendje kötött, a kassza az XSD sorrendjében írja őket.

https://www.szamlazz.hu/szamla/docs/xsds/nyugtast/xmlnyugtast.xsd