Válasz

A lekérdezés válasza ugyanolyan, mint a nyugta létrehozásáé: a get() egy Receipt objektumot ad vissza, a find() pedig Receipt-et vagy null-t. A mezők a Számlázz.hu xmlnyugtavalasz válaszának nyugta blokkjából jönnek, a PDF a nyugtaPdf elemből.

const nyugta = await kassza.receipts.find({ orderNumber: 'PENZTAR-2026-0212' })

if (nyugta && !nyugta.isReversed) {
  console.log(nyugta.number, nyugta.totals.grossAmount)
}

Receipt#

Ha egy nem opcionális mező hiányzik a válaszból, a kassza alapértéket ad neki: szövegnél üres szöveget, számnál 0-t, logikai mezőnél false-t. Ha a válaszból a nyugta blokk vagy a nyugtaszám hiányzik, a kassza unexpected_response hibát dob.

ReceiptItem#

ReceiptPayment#

ReceiptTotals#

Ha a válaszban nincs totalossz, a kassza a végösszegeket a tételekből adja össze, két tizedesre kerekítve.

A PDF mentése#

A pdf egy Uint8Array, amit közvetlenül fájlba írhatsz:

import { writeFile } from 'node:fs/promises'

const nyugta = await kassza.receipts.get('NYGT-2026-1')

if (nyugta.pdf) await writeFile(`nyugtak/${nyugta.number}.pdf`, nyugta.pdf)

Ha csak az adatokra van szükséged, add meg a downloadPdf: false opciót, így a válasz is kisebb.

Hibák#

A find() minden not_found kategóriájú hibánál null-t ad, minden más hibát továbbdob. Az összes kódot a Hibakezelés, hibakódok oldal sorolja fel.

Elkészült már a nyugta?#

Ha a receipts.create() duplicate (338), network vagy timeout hibával áll le, a nyugta már létezhet. Mielőtt újra kiállítanád, keresd meg a rendelésszám alapján:

import { type CreateReceiptInput, isSzamlazzError } from 'kassza'

const BIZONYTALAN = ['duplicate', 'network', 'timeout']

async function nyugtaRendeleshez(adatok: CreateReceiptInput & { orderNumber: string }) {
  try {
    return await kassza.receipts.create(adatok)
  } catch (error) {
    if (isSzamlazzError(error) && BIZONYTALAN.includes(error.category)) {
      const meglevo = await kassza.receipts.find({ orderNumber: adatok.orderNumber })
      if (meglevo) return meglevo
    }
    throw error
  }
}