Minta

A példa a sandboxban fut. Kiállít egy nyugtát rendelésszámmal, lekérdezi a nyugtaszám alapján, majd a rendelésszám alapján PDF nélkül. Végül a find() egy nem létező nyugtaszámot keres, amire null jön. Az Elküldött XML fülön az xmlnyugtaget kéréseket is látod.

Nyugta lekérdezése

Lekérdezés nyugtaszám és rendelésszám alapján, find nem létező nyugtára.

Futtatás a sandboxban

nyugta-lekerdezes.ts

import {  } from 'kassza'

const  = ({
  : { : { : 'NYGT', : 'készpénz' } },
})

const  = await ..({
  : 'PENZTAR-2026-0212',
  : 'PENZTAR-2026-0212',
  : [{ : 'Napijegy', : 4_500, : 27 }],
})

const  = await ..(.)
const  = await ..({
  : 'PENZTAR-2026-0212',
  : false,
})

.(. === .)
.(., .)

const  = await ..({ : 'NYGT-2026-999' })
.('Nem létező nyugta:', )

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-0212</hivasAzonosito>
    <elotag>NYGT</elotag>
    <fizmod>készpénz</fizmod>
    <penznem>HUF</penznem>
    <rendelesSzam>PENZTAR-2026-0212</rendelesSzam>
  </fejlec>
  <tetelek>
    <tetel>
      <megnevezes>Napijegy</megnevezes>
      <mennyiseg>1</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>3543.31</nettoEgysegar>
      <afakulcs>27</afakulcs>
      <netto>3543.31</netto>
      <afa>956.69</afa>
      <brutto>4500</brutto>
    </tetel>
  </tetelek>
</xmlnyugtacreate>

2. Nyugta lekérdezés · action-szamla_agent_nyugta_get

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

3. Nyugta lekérdezés · action-szamla_agent_nyugta_get

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtaget xmlns="http://www.szamlazz.hu/xmlnyugtaget" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlnyugtaget https://www.szamlazz.hu/szamla/docs/xsds/nyugtaget/xmlnyugtaget.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
    <pdfLetoltes>false</pdfLetoltes>
  </beallitasok>
  <fejlec>
    <rendelesSzam>PENZTAR-2026-0212</rendelesSzam>
  </fejlec>
</xmlnyugtaget>

4. Nyugta lekérdezés · action-szamla_agent_nyugta_get

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

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

content-type: application/xml; charset=UTF-8
set-cookie: JSESSIONID=E1D16377288BA53295586A95; 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-0212</hivasAzonosito>
      <nyugtaszam>NYGT-2026-1</nyugtaszam>
      <tipus>NY</tipus>
      <stornozott>false</stornozott>
      <kelt>2026-09-19</kelt>
      <fizmod>készpénz</fizmod>
      <penznem>HUF</penznem>
      <teszt>true</teszt>
      <rendelesSzam>PENZTAR-2026-0212</rendelesSzam>
    </alap>
    <tetelek>
      <tetel>
        <megnevezes>Napijegy</megnevezes>
        <mennyiseg>1</mennyiseg>
        <mennyisegiEgyseg>db</mennyisegiEgyseg>
        <nettoEgysegar>3543.31</nettoEgysegar>
        <netto>3543.31</netto>
        <afakulcs>27</afakulcs>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </tetel>
    </tetelek>
    <osszegek>
      <afakulcsossz>
        <afakulcs>27</afakulcs>
        <netto>3543.31</netto>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </afakulcsossz>
      <totalossz>
        <netto>3543.31</netto>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </totalossz>
    </osszegek>
  </nyugta>
</xmlnyugtavalasz>

2. Nyugta lekérdezés · 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>1001</id>
      <hivasAzonosito>PENZTAR-2026-0212</hivasAzonosito>
      <nyugtaszam>NYGT-2026-1</nyugtaszam>
      <tipus>NY</tipus>
      <stornozott>false</stornozott>
      <kelt>2026-09-19</kelt>
      <fizmod>készpénz</fizmod>
      <penznem>HUF</penznem>
      <teszt>true</teszt>
      <rendelesSzam>PENZTAR-2026-0212</rendelesSzam>
    </alap>
    <tetelek>
      <tetel>
        <megnevezes>Napijegy</megnevezes>
        <mennyiseg>1</mennyiseg>
        <mennyisegiEgyseg>db</mennyisegiEgyseg>
        <nettoEgysegar>3543.31</nettoEgysegar>
        <netto>3543.31</netto>
        <afakulcs>27</afakulcs>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </tetel>
    </tetelek>
    <osszegek>
      <afakulcsossz>
        <afakulcs>27</afakulcs>
        <netto>3543.31</netto>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </afakulcsossz>
      <totalossz>
        <netto>3543.31</netto>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </totalossz>
    </osszegek>
  </nyugta>
</xmlnyugtavalasz>

3. Nyugta lekérdezés · 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>
  <nyugta>
    <alap>
      <id>1001</id>
      <hivasAzonosito>PENZTAR-2026-0212</hivasAzonosito>
      <nyugtaszam>NYGT-2026-1</nyugtaszam>
      <tipus>NY</tipus>
      <stornozott>false</stornozott>
      <kelt>2026-09-19</kelt>
      <fizmod>készpénz</fizmod>
      <penznem>HUF</penznem>
      <teszt>true</teszt>
      <rendelesSzam>PENZTAR-2026-0212</rendelesSzam>
    </alap>
    <tetelek>
      <tetel>
        <megnevezes>Napijegy</megnevezes>
        <mennyiseg>1</mennyiseg>
        <mennyisegiEgyseg>db</mennyisegiEgyseg>
        <nettoEgysegar>3543.31</nettoEgysegar>
        <netto>3543.31</netto>
        <afakulcs>27</afakulcs>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </tetel>
    </tetelek>
    <osszegek>
      <afakulcsossz>
        <afakulcs>27</afakulcs>
        <netto>3543.31</netto>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </afakulcsossz>
      <totalossz>
        <netto>3543.31</netto>
        <afa>956.69</afa>
        <brutto>4500</brutto>
      </totalossz>
    </osszegek>
  </nyugta>
</xmlnyugtavalasz>

4. Nyugta lekérdezés · válasz, HTTP 200

content-type: application/xml; charset=UTF-8
szlahu_error: A%20nyugtasz%C3%A1m%20nem%20l%C3%A9tezik.
szlahu_error_code: 339

<?xml version="1.0" encoding="UTF-8"?>
<xmlnyugtavalasz xmlns="http://www.szamlazz.hu/xmlnyugtavalasz">
  <sikeres>false</sikeres>
  <hibakod>339</hibakod>
  <hibauzenet>A nyugtaszám nem létezik.</hibauzenet>
</xmlnyugtavalasz>

Konzol

true
{
  netAmount: 3543.31,
  vatAmount: 956.69,
  grossAmount: 4500,
  byVat: [
    {
      vat: 27,
      vatPercentage: 27,
      netAmount: 3543.31,
      vatAmount: 956.69,
      grossAmount: 4500
    }
  ]
} undefined
Nem létező nyugta: null

XSD séma#

A kassza az XML-t a Számlázz.hu xmlnyugtaget.xsd sémája szerint építi fel:

https://www.szamlazz.hu/szamla/docs/xsds/nyugtaget/xmlnyugtaget.xsd

A letölthető sémában a rendelesSzam elem még nem szerepel, a hivatalos dokumentáció sémájában viszont igen. A kassza a dokumentáció szerint küldi, ezért a rendelésszámos kérés a letölthető XSD-vel validálva hibát jelezne.