Minta

A példa kiállít egy kártyával kifizetett számlát két tétellel, majd a rendelésszám alapján lekéri az adatait, és kiírja a fejlécet, az összegeket és a befizetéseket. Végül a find() egy nem létező rendelésszámra null-t ad hiba helyett. Az Elküldött XML fülön a számlakészítés mellett mindkét xmlszamlaxml kérést látod, a Válasz fülön pedig a szamla XML-t és a nem létező rendelésre kapott 7-es hibát.

Számla adatainak lekérése

Fejléc, összegek és befizetések lekérése; find nem létező rendelésre.

Futtatás a sandboxban

szamla-adatai.ts

import {  } from 'kassza'

const  = ()

await ..({
  : 'REND-4001',
  : 'bankkártya',
  : true,
  : {
    : 'Vevő Kft.',
    : '1111',
    : 'Budapest',
    : 'Fő utca 1.',
    : 'vevo@example.hu',
  },
  : [
    { : 'Laptop tok', : 8_990, : 27 },
    { : 'E-könyv', : 2_490, : 5 },
  ],
})

const  = await ..({ : 'REND-4001' })
.(.)
.(.)
.(.)

const  = await ..({ : 'REND-9999' })
.('Nem létező rendelés:', )

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>bankkártya</fizmod>
    <penznem>HUF</penznem>
    <szamlaNyelve>hu</szamlaNyelve>
    <rendelesSzam>REND-4001</rendelesSzam>
    <fizetve>true</fizetve>
  </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>
  </vevo>
  <tetelek>
    <tetel>
      <megnevezes>Laptop tok</megnevezes>
      <mennyiseg>1</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>7079</nettoEgysegar>
      <afakulcs>27</afakulcs>
      <nettoErtek>7079</nettoErtek>
      <afaErtek>1911</afaErtek>
      <bruttoErtek>8990</bruttoErtek>
    </tetel>
    <tetel>
      <megnevezes>E-könyv</megnevezes>
      <mennyiseg>1</mennyiseg>
      <mennyisegiEgyseg>db</mennyisegiEgyseg>
      <nettoEgysegar>2371</nettoEgysegar>
      <afakulcs>5</afakulcs>
      <nettoErtek>2371</nettoErtek>
      <afaErtek>119</afaErtek>
      <bruttoErtek>2490</bruttoErtek>
    </tetel>
  </tetelek>
</xmlszamla>

2. Számla adatai · action-szamla_agent_xml

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlaxml xmlns="http://www.szamlazz.hu/xmlszamlaxml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamlaxml https://www.szamlazz.hu/szamla/docs/xsds/agentxml/xmlszamlaxml.xsd">
  <szamlaagentkulcs>••••••••</szamlaagentkulcs>
  <rendelesSzam>REND-4001</rendelesSzam>
</xmlszamlaxml>

3. Számla adatai · action-szamla_agent_xml

<?xml version="1.0" encoding="UTF-8"?>
<xmlszamlaxml xmlns="http://www.szamlazz.hu/xmlszamlaxml" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmlszamlaxml https://www.szamlazz.hu/szamla/docs/xsds/agentxml/xmlszamlaxml.xsd">
  <szamlaagentkulcs>••••••••</szamlaagentkulcs>
  <rendelesSzam>REND-9999</rendelesSzam>
</xmlszamlaxml>

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

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

2. Számla adatai · válasz, HTTP 200

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

<?xml version="1.0" encoding="UTF-8"?>
<szamla xmlns="http://www.szamlazz.hu/szamla">
  <szallito>
    <id>1</id>
    <nev>Minta Webáruház Kft.</nev>
    <cim>
      <orszag>Magyarország</orszag>
      <irsz>1111</irsz>
      <telepules>Budapest</telepules>
      <cim>Minta utca 12.</cim>
    </cim>
    <adoszam>23456787-2-13</adoszam>
    <bank>
      <nev>Minta Bank Zrt.</nev>
      <bankszamla>11773016-11111018</bankszamla>
    </bank>
  </szallito>
  <alap>
    <id>1001</id>
    <szamlaszam>KASSZA-2026-1</szamlaszam>
    <forras>1</forras>
    <tipus>SZ</tipus>
    <eszamla>0</eszamla>
    <kelt>2026-09-19</kelt>
    <telj>2026-09-19</telj>
    <fizh>2026-09-19</fizh>
    <fizmod>bankkártya</fizmod>
    <keszpenz>false</keszpenz>
    <rendelesszam>REND-4001</rendelesszam>
    <nyelv>hu</nyelv>
    <devizanem>HUF</devizanem>
    <penzforg>false</penzforg>
    <kata>false</kata>
    <email>vevo@example.hu</email>
    <teszt>true</teszt>
    <sztornozott>false</sztornozott>
  </alap>
  <vevo>
    <id>51001</id>
    <nev>Vevő Kft.</nev>
    <cim>
      <orszag>Magyarország</orszag>
      <irsz>1111</irsz>
      <telepules>Budapest</telepules>
      <cim>Fő utca 1.</cim>
    </cim>
    <email>vevo@example.hu</email>
  </vevo>
  <tetelek>
    <tetel>
      <nev>Laptop tok</nev>
      <mennyiseg>1</mennyiseg>
      <mennyisegiegyseg>db</mennyisegiegyseg>
      <nettoegysegar>7079</nettoegysegar>
      <afakulcs>27</afakulcs>
      <netto>7079</netto>
      <afa>1911</afa>
      <brutto>8990</brutto>
      <sztetordering>1</sztetordering>
    </tetel>
    <tetel>
      <nev>E-könyv</nev>
      <mennyiseg>1</mennyiseg>
      <mennyisegiegyseg>db</mennyisegiegyseg>
      <nettoegysegar>2371</nettoegysegar>
      <afakulcs>5</afakulcs>
      <netto>2371</netto>
      <afa>119</afa>
      <brutto>2490</brutto>
      <sztetordering>2</sztetordering>
    </tetel>
  </tetelek>
  <osszegek>
    <afakulcsossz>
      <afakulcs>27</afakulcs>
      <netto>7079</netto>
      <afa>1911</afa>
      <brutto>8990</brutto>
    </afakulcsossz>
    <afakulcsossz>
      <afakulcs>5</afakulcs>
      <netto>2371</netto>
      <afa>119</afa>
      <brutto>2490</brutto>
    </afakulcsossz>
    <totalossz>
      <netto>9450</netto>
      <afa>2030</afa>
      <brutto>11480</brutto>
    </totalossz>
  </osszegek>
  <kifizetesek>
    <kifizetes>
      <datum>2026-09-19</datum>
      <jogcim>bankkártya</jogcim>
      <osszeg>11480</osszeg>
    </kifizetes>
  </kifizetesek>
</szamla>

3. Számla adatai · válasz, HTTP 200

content-type: text/plain; charset=UTF-8
szlahu_error: Hi%C3%A1nyz%C3%B3%20adat%3A%20ismeretlen%20sz%C3%A1mlasz%C3%A1m%2C%20rendel%C3%A9ssz%C3%A1m%20vagy%20k%C3%BCls%C5%91%20azonos%C3%ADt%C3%B3.
szlahu_error_code: 7

[ERR] [7] Hiányzó adat: ismeretlen számlaszám, rendelésszám vagy külső azonosító.

Konzol

{
  id: 1001,
  number: 'KASSZA-2026-1',
  economicEventId: undefined,
  sourceSystem: 1,
  registrationNumber: undefined,
  type: 'invoice',
  typeCode: 'SZ',
  eInvoice: false,
  appearanceCode: 0,
  referencedInvoiceNumber: undefined,
  referencedProformaNumber: undefined,
  issueDate: '2026-09-19',
  fulfillmentDate: '2026-09-19',
  dueDate: '2026-09-19',
  paymentMethod: 'bankkártya',
  unifiedPaymentMethod: undefined,
  cash: false,
  orderNumber: 'REND-4001',
  language: 'hu',
  currency: 'HUF',
  exchangeBank: undefined,
  exchangeRate: undefined,
  comment: undefined,
  vatType: undefined,
  cashAccounting: false,
  kata: false,
  kataLedger: undefined,
  email: 'vevo@example.hu',
  test: true,
  reversed: false
}
{
  netAmount: 9450,
  vatAmount: 2030,
  grossAmount: 11480,
  byVat: [
    {
      vat: 27,
      vatCode: undefined,
      netAmount: 7079,
      vatAmount: 1911,
      grossAmount: 8990
    },
    {
      vat: 5,
      vatCode: undefined,
      netAmount: 2371,
      vatAmount: 119,
      grossAmount: 2490
    }
  ]
}
[
  {
    date: '2026-09-19',
    method: 'bankkártya',
    amount: 11480,
    comment: undefined,
    bankAccountNumber: undefined,
    bankTransactionId: undefined,
    exchangeRate: undefined
  }
]
Nem létező rendelés: null

XSD séma#

A kérés XML sémája, a mezők sorrendje kötött:

https://www.szamlazz.hu/szamla/docs/xsds/agentxml/xmlszamlaxml.xsd

A kassza a szamlaszam, rendelesSzam, pdf és szamlaKulsoAzon elemet ebben a sorrendben írja ki, és csak azt, amelyiket megadtad. A válasz szerkezetét a Válasz oldal írja le mezőről mezőre.