Válasz

Sikeres nyugtakészítés után a create() egy Receipt objektummal tér vissza. Ugyanezt a típust adja a sztornó és a lekérdezés is.

const nyugta = await kassza.receipts.create(adatok)

await db.rendeles.update({
  where: { id: rendelesId },
  data: { nyugtaszam: nyugta.number, brutto: nyugta.totals.grossAmount },
})

Receipt#

A fejléc mezői a válasz <nyugta> blokkjának <alap> eleméből jönnek.

ReceiptItem#

A Számlázz.hu a tételösszegeket hol netto, hol nettoErtek néven adja vissza, a kassza mindkettőt olvassa. A tétel megjegyzése és adattörlő kódja nem szerepel a válaszban.

ReceiptPayment és ReceiptTotals#

A mintában szereplő kéttételes nyugtánál a totals értéke 1639.67 nettó, 390.33 áfa és 2030 bruttó, a byVat pedig egy 27%-os és egy 5%-os sort tartalmaz.

A PDF mentése#

A pdf egy Uint8Array, amit közvetlenül fájlba írhatsz, feltölthetsz tárhelyre, vagy visszaadhatsz HTTP válaszként:

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

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

import { kassza } from '@/lib/kassza'

export async function GET(_request: Request, { params }: RouteContext<'/nyugtak/[szam]'>) {
  const { szam } = await params
  const nyugta = await kassza.receipts.find(szam)
  if (!nyugta?.pdf) return new Response('Nincs ilyen nyugta.', { status: 404 })
  return new Response(nyugta.pdf, {
    headers: {
      'Content-Type': 'application/pdf',
      'Content-Disposition': `inline; filename="${szam}.pdf"`,
    },
  })
}

import { receiptPdfKey, s3FetchStorage, storePdf } from 'kassza/storage'

const tarhely = s3FetchStorage({
  bucket: 'nyugtak',
  region: 'auto',
  endpoint: process.env.R2_ENDPOINT,
  accessKeyId: process.env.R2_ACCESS_KEY_ID ?? '',
  secretAccessKey: process.env.R2_SECRET_ACCESS_KEY ?? '',
})

if (nyugta.pdf) {
  const kulcs = receiptPdfKey({ number: nyugta.number, date: nyugta.issueDate })
  await storePdf(tarhely, kulcs, nyugta.pdf)
}

A receiptPdfKey() nyugtak/ÉÉÉÉ/HH/nyugtaszám.pdf alakú kulcsot képez. A PDF később is lekérhető a kassza.receipts.get() hívással, lásd Nyugta lekérdezés, e-mailben pedig a Nyugta kiküldés művelettel küldheted el.

Hibák#

Ha a nyugta nem készült el, a create() SzamlazzError-t dob. A nyugtakészítésnél leggyakoribb hibák:

Az összes kódot a Hibakezelés, hibakódok oldal sorolja fel.

A 338-as hibánál a kassza a hint mezőben leírja a következő lépést: ha adtál meg rendelésszámot, a lekérdezést javasolja, különben a Számlázz.hu felületére irányít, mert a Számla Agent hívásazonosító alapján nem kérdez le.