Adószám lekérdezés

A Számla Agenten keresztül a NAV Online Számla rendszerétől is kérdezhetsz: egy törzsszámról megtudod, hogy érvényes-e az adószám, és ha igen, megkapod az adózó nevét, teljes adószámát és címeit. A kasszában ezt a taxpayer.query() végzi. Akkor hasznos, ha a vevő csak az adószámát írja be, a számla többi adatát pedig a válaszból töltöd ki.

const ceg = await kassza.taxpayer.query('12345676-2-41')

if (ceg.valid) console.log(ceg.name, ceg.address?.formatted)

Kérés

Az elfogadott adószám formátumok, az xmltaxpayer XML és az előellenőrzés.

Válasz

A TaxpayerInfo és a TaxpayerAddress mezői, a vevő kitöltése és a hibák.

Minta

Adószám lekérdezése és a vevő összerakása a sandboxban.

Gyorsítótár#

Egy űrlapon ugyanazt az adószámot sokszor lekérdezheted (gépelés, újratöltés, visszalépés), és minden lekérdezés egy Számla Agent kérés. A taxpayerCache beállítással a kassza egy közös tárolóban megjegyzi az eredményt:

import { upstashRedisStore } from 'kassza/stores'

const kassza = createKassza({
  taxpayerCache: { store: upstashRedisStore(Redis.fromEnv()) },
})

Az érvényes adózót alapból egy napig (ttlSeconds), az érvénytelen adószámot 10 percig (invalidTtlSeconds) őrzi. A hibát (például hálózati hibát) nem jegyzi meg. A kulcs a törzsszám, így a 12345678 és a 12345678-2-42 ugyanazt a bejegyzést használja. Ha a tároló nem érhető el, a kassza a Számlázz.hu-tól kérdez, és figyelmeztet.