Válasz

Sikeres lekérés után a getPdf() egy InvoicePdf objektumot ad vissza. A pdf mező mindig ki van töltve: ha a Számlázz.hu válaszában nincs PDF, a kassza hibát dob. A többi mező a válasz XML-jéből jön, és ha ott hiányzik, a kassza a szlahu_* fejlécekből pótolja.

InvoicePdf#

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

const peldany = await kassza.invoices.getPdf({ orderNumber: 'REND-1001' })

await writeFile(`szamlak/${peldany.number}.pdf`, peldany.pdf)

Letöltés Next.js route-ból#

Az alábbi route a bejelentkezett vevőnek letöltésként adja vissza a rendeléséhez tartozó számlát. Az auth() és a db a saját alkalmazásod moduljai, a számlaszámot a kiállításkor mentetted el a rendelés mellé.

import { isSzamlazzError } from 'kassza'
import { auth } from '@/lib/auth'
import { db } from '@/lib/db'
import { kassza } from '@/lib/kassza'

export async function GET(_request: Request, { params }: RouteContext<'/rendelesek/[id]/szamla'>) {
  const session = await auth()
  if (!session) return new Response('Bejelentkezés szükséges.', { status: 401 })

  const { id } = await params
  const rendeles = await db.rendeles.findUnique({ where: { id } })
  if (!rendeles?.szamlaszam || rendeles.userId !== session.user.id) {
    return new Response('Nincs ilyen számla.', { status: 404 })
  }

  try {
    const { pdf } = await kassza.invoices.getPdf(rendeles.szamlaszam)
    return new Response(new Uint8Array(pdf), {
      headers: {
        'Content-Type': 'application/pdf',
        'Content-Disposition': `attachment; filename="${rendeles.szamlaszam}.pdf"`,
        'Cache-Control': 'private, no-store',
      },
    })
  } catch (error) {
    if (isSzamlazzError(error) && error.isNotFound) {
      return new Response('Nincs ilyen számla.', { status: 404 })
    }
    throw error
  }
}

• Más vevő rendelésére is 404-et ad, így a válaszból nem derül ki, hogy a rendelés létezik.
• A new Uint8Array(pdf) csak a TypeScript miatt kell: a DOM típusok a Response törzsénél ArrayBuffer alapú tömböt várnak, a pdf típusa pedig ennél általánosabb.
• Ha a PDF a böngészőben nyíljon meg, az attachment helyett inline értéket adj.
• Minden letöltés egy Számla Agent hívás. Ha a vevők gyakran töltik le a számlát, mentsd el egyszer tárhelyre, és onnan szolgáld ki.

Mentés tárhelyre#

Ha a számlát downloadPdf: false beállítással állítottad ki, vagy a PDF mentése a kiállításkor nem sikerült, egy háttérfeladat később is letöltheti és elmentheti. A kassza/storage modul S3-ba, Cloudflare R2-be és más tárhelyekre ment:

import { invoicePdfKey, s3FetchStorage, storePdf } from 'kassza/storage'
import { kassza } from '@/lib/kassza'

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

export async function szamlaPdfMentese(szamlaszam: string, kelte: string) {
  const { pdf } = await kassza.invoices.getPdf(szamlaszam)
  const fajl = await storePdf(tarhely, invoicePdfKey({ number: szamlaszam, date: kelte }), pdf)
  return fajl.key
}

• Az invoicePdfKey() a számlaszámból és a dátumból képez kulcsot, például szamlak/2026/09/WEB-2026-128.pdf. A date nélkül a mai budapesti dátumot használja. A type mezővel ('storno', 'proforma' stb.) a bizonylat külön mappába kerül.
• A storePdf() feltöltés előtt ellenőrzi, hogy a tartalom valóban PDF, és ha nem, StorageError-t dob. A visszaadott StoredFile a key, size, contentType és, ha a tárhely ad ilyet, az url mezőt tartalmazza.
• A többi tárhely (AWS SDK, R2 binding, Vercel Blob, UploadThing, Supabase, fájlrendszer, memória) ugyanígy használható, lásd PDF mentése tárhelyre.

Hibák#

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

A kulcs ellenőrzése is ezt használja#

A kassza.verifyCredentials() egy biztosan nem létező számlaszám PDF-jét kéri le. Ha a Számlázz.hu 7-es hibát ad, a kulcs jó, csak a számla nincs meg, ezért az eredmény true. auth hibánál false, minden más hibát továbbdob.

const kulcsRendben = await kassza.verifyCredentials()

Lásd A kulcs ellenőrzése.