Minta

A példa a kassza/validators modullal ellenőrzi a beírt adószámot, lekérdezi a NAV-tól, és a válaszból összerakja a számla vevőjét. Utána egy ismeretlen törzsszámot is lekérdez, amelyre valid: false jön. Az Elküldött XML fülön mindkét xmltaxpayer kérést látod, a Válasz fülön a QueryTaxpayerResponse XML-t.

Adószám lekérdezése

Cégadatok a NAV-tól, és a vevő adatainak kitöltése a válaszból.

Futtatás a sandboxban

adoszam.ts

import { , type InvoiceBuyer } from 'kassza'
import {  } from 'kassza/validators'

const  = ()

const  = '12345676-2-41'
if (!()) throw new ('Érvénytelen adószám')

const  = await ..()
.()

if (. && .) {
  const : InvoiceBuyer = {
    : . ?? . ?? '',
    : ..,
    : ..,
    : ...(', ').(1).(', '),
    : .?.,
  }
  .('A számla vevője:', )
}

const  = await ..('87654321')
.('Ismeretlen törzsszám érvényes?', .)

1. Adószám lekérdezés · action-szamla_agent_taxpayer

<?xml version="1.0" encoding="UTF-8"?>
<xmltaxpayer xmlns="http://www.szamlazz.hu/xmltaxpayer" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmltaxpayer http://www.szamlazz.hu/docs/xsds/agent/xmltaxpayer.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
  </beallitasok>
  <torzsszam>12345676</torzsszam>
</xmltaxpayer>

2. Adószám lekérdezés · action-szamla_agent_taxpayer

<?xml version="1.0" encoding="UTF-8"?>
<xmltaxpayer xmlns="http://www.szamlazz.hu/xmltaxpayer" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.szamlazz.hu/xmltaxpayer http://www.szamlazz.hu/docs/xsds/agent/xmltaxpayer.xsd">
  <beallitasok>
    <szamlaagentkulcs>••••••••</szamlaagentkulcs>
  </beallitasok>
  <torzsszam>87654321</torzsszam>
</xmltaxpayer>

1. Adószám lekérdezés · válasz, HTTP 200

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

<?xml version="1.0" encoding="UTF-8"?>
<QueryTaxpayerResponse xmlns="http://schemas.nav.gov.hu/OSA/3.0/api" xmlns:common="http://schemas.nav.gov.hu/NTCA/1.0/common" xmlns:base="http://schemas.nav.gov.hu/OSA/3.0/base">
  <common:header>
    <common:requestId>KASSZAMU87525E</common:requestId>
    <common:timestamp>2026-09-19T09:40:02.978Z</common:timestamp>
    <common:requestVersion>3.0</common:requestVersion>
    <common:headerVersion>1.0</common:headerVersion>
  </common:header>
  <common:result>
    <common:funcCode>OK</common:funcCode>
  </common:result>
  <infoDate>2026-09-19T09:40:02.978Z</infoDate>
  <taxpayerValidity>true</taxpayerValidity>
  <taxpayerData>
    <taxpayerName>MINTA KERESKEDELMI KORLÁTOLT FELELŐSSÉGŰ TÁRSASÁG</taxpayerName>
    <taxpayerShortName>MINTA KERESKEDELMI KFT.</taxpayerShortName>
    <taxNumberDetail><base:taxpayerId>12345676</base:taxpayerId><base:vatCode>2</base:vatCode><base:countyCode>41</base:countyCode></taxNumberDetail>
    <incorporation>ORGANIZATION</incorporation>
    <taxpayerAddressList>
      <taxpayerAddressItem>
        <taxpayerAddressType>HQ</taxpayerAddressType>
        <taxpayerAddress><base:countryCode>HU</base:countryCode><base:postalCode>1111</base:postalCode><base:city>BUDAPEST</base:city><base:streetName>MINTA</base:streetName><base:publicPlaceCategory>UTCA</base:publicPlaceCategory><base:number>1</base:number></taxpayerAddress>
      </taxpayerAddressItem>
    </taxpayerAddressList>
  </taxpayerData>
</QueryTaxpayerResponse>

2. Adószám lekérdezés · válasz, HTTP 200

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

<?xml version="1.0" encoding="UTF-8"?>
<QueryTaxpayerResponse xmlns="http://schemas.nav.gov.hu/OSA/3.0/api" xmlns:common="http://schemas.nav.gov.hu/NTCA/1.0/common" xmlns:base="http://schemas.nav.gov.hu/OSA/3.0/base">
  <common:header>
    <common:requestId>KASSZAMU87525G</common:requestId>
    <common:timestamp>2026-09-19T09:40:02.980Z</common:timestamp>
    <common:requestVersion>3.0</common:requestVersion>
    <common:headerVersion>1.0</common:headerVersion>
  </common:header>
  <common:result>
    <common:funcCode>OK</common:funcCode>
  </common:result>
  <infoDate>2026-09-19T09:40:02.980Z</infoDate>
  <taxpayerValidity>false</taxpayerValidity>
</QueryTaxpayerResponse>

Konzol

{
  valid: true,
  name: 'MINTA KERESKEDELMI KORLÁTOLT FELELŐSSÉGŰ TÁRSASÁG',
  shortName: 'MINTA KERESKEDELMI KFT.',
  taxNumber: {
    taxpayerId: '12345676',
    vatCode: '2',
    countyCode: '41',
    formatted: '12345676-2-41'
  },
  address: {
    type: 'HQ',
    countryCode: 'HU',
    region: undefined,
    postalCode: '1111',
    city: 'Budapest',
    street: 'Minta',
    publicPlaceCategory: 'utca',
    number: '1',
    building: undefined,
    staircase: undefined,
    floor: undefined,
    door: undefined,
    lotNumber: undefined,
    formatted: '1111 Budapest, Minta utca 1.',
    raw: {
      countryCode: 'HU',
      region: undefined,
      postalCode: '1111',
      city: 'BUDAPEST',
      streetName: 'MINTA',
      publicPlaceCategory: 'UTCA',
      number: '1',
      building: undefined,
      staircase: undefined,
      floor: undefined,
      door: undefined,
      lotNumber: undefined
    }
  },
  addresses: [
    {
      type: 'HQ',
      countryCode: 'HU',
      region: undefined,
      postalCode: '1111',
      city: 'Budapest',
      street: 'Minta',
      publicPlaceCategory: 'utca',
      number: '1',
      building: undefined,
      staircase: undefined,
      floor: undefined,
      door: undefined,
      lotNumber: undefined,
      formatted: '1111 Budapest, Minta utca 1.',
      raw: {
        countryCode: 'HU',
        region: undefined,
        postalCode: '1111',
        city: 'BUDAPEST',
        streetName: 'MINTA',
        publicPlaceCategory: 'UTCA',
        number: '1',
        building: undefined,
        staircase: undefined,
        floor: undefined,
        door: undefined,
        lotNumber: undefined
      }
    }
  ],
  incorporation: 'ORGANIZATION',
  vatGroupMembership: undefined,
  infoDate: '2026-09-19T09:40:02.978Z',
  requestId: 'KASSZAMU87525E'
}
A számla vevője: {
  name: 'MINTA KERESKEDELMI KFT.',
  zip: '1111',
  city: 'Budapest',
  address: 'Minta utca 1.',
  taxNumber: '12345676-2-41'
}
Ismeretlen törzsszám érvényes? false

Kitalált adózók a sandboxban#

A sandbox nem hívja a NAV-ot. Ezt a három kitalált törzsszámot ismeri, minden más 8 jegyű törzsszámra valid: false választ ad:

Adószám	`shortName`	`incorporation`
`12345676-2-41`	`MINTA KERESKEDELMI KFT.`	`'ORGANIZATION'`
`23456787-2-13`	`MINTA WEBÁRUHÁZ KFT.`	`'ORGANIZATION'`
`11111111-1-06`	`TESZT ELEK E.V.`	`'SELF_EMPLOYED'`

Mindhárom átmegy a parseHungarianTaxNumber ellenőrzésén, így a sandboxban a bevitt számot bármelyikre átírhatod.

XSD séma#

A kérés sémája:

http://www.szamlazz.hu/docs/xsds/agent/xmltaxpayer.xsd

A válasz a NAV Online Számla QueryTaxpayerResponse szerkezetét követi, ennek sémáját a NAV Online Számla interfész dokumentációja tartalmazza.