Nyugtagenerálás

Alapok

Egy nyugta generálásának teljes példáját a következő fájl szemlélteti: ./examples/document/receipt/create_receipt_with_custom_data.php

A nyugta generálásához a következő lépések szükségesek:

// 1. Nyugta létrehozása
// (készpénzzel fizetett magyar nyelvű (Ft) nyugta kiállítása)
$receipt = new Receipt();

// 2. Fejléc inicializálása
$receipt->setHeader(new ReceiptHeader());

// 3. Előtag beállítása
$receipt->getHeader()->setPrefix('NYGTA');

// 4. Rendelésszám (opcionális) – tipikusan webáruházas rendelésazonosító
$receipt->getHeader()->setOrderNumber('ORD-2026-0042');

// 5. Nyugta tétel összeállítása alapértelmezett adatokkal
// (1 db eladó tétel 27%-os ÁFA tartalommal)
$item = new ReceiptItem('Eladó tétel', 10000.0);

// a) Tétel nettó értékének beállítása
$item->setNetPrice(10000.0);

// b) Tétel ÁFA értékének beállítása
$item->setVatAmount(2700.0);

// c) Tétel bruttó értékének beállítása
$item->setGrossAmount(12700.0);

// d) Tétel adatainak hozzáadása a nyugtához
$receipt->addItem($item);

// 6. Nyugta elkészítése (generálás)
$result = $agent->generateReceipt($receipt);

Ha generáláskor megadsz rendelésszámot (setOrderNumber), ugyanazzal az azonosítóval később lekérheted a nyugta adatait és a PDF-jét is: Nyugtaadatok lekérdezése, Nyugta PDF letöltés.

információ

A rendelésszám a nyugta fejlécében generáláskor már a 2.12.1 verziótól megadható. A nyugta adatainak és PDF-jének lekérdezése rendelésszámmal a 2.12.2 verziótól érhető el (lásd a changelogot).

Elvárt és opcionális bemenetek

Nyugtafejléc adatok

Megnevezés	Mező	Típus	Kötelező	Alapérték
hívás azonosító	callId	string
előtag	prefix	string	igen
fizetési mód	paymentMethod	string	igen	készpénz
pénznem	currency	string	igen	Ft
bank név	exchangeBank	string
banki árfolyam	exchangeRate	string
megjegyzés	comment	string
pdf sablon	pdfTemplate	string
főkönyvi azonosító	buyerLedgerId	string
rendelésszám	orderNumber	string

Nyugtatétel adatok

Megnevezés	Mező	Típus	Kötelező	Alapérték
azonosító	id	string
mennyiség	quantity	double	igen
mennyiségi egység	quantityUnit	string	igen
nettó egységár	netUnitPrice	double	igen
ÁFA kulcs	vat	string	igen
nettó érték	netPrice	double	igen
ÁFA érték	vatAmount	double	igen
bruttó érték	grossAmount	double	igen
főkönyvi adatok	ledgerData	ReceiptItemLedger
tétel megjegyzés	comment	string
adattörlő kód darabszáma	dataDeletionCode	integer

Nyugtatétel főkönyvi adatok

Megnevezés	Mező	Típus	Kötelező	Alapérték
Árbevétel főkönyvi szám	revenueLedgerNumber	string
ÁFA főkönyvi szám	vatLedgerNumber	string

Jóváírás adatok (kifizetés)

Megnevezés	Mező	Típus	Kötelező	Alapérték
jogcím (fizető eszköz)	paymentMethod	string	igen	készpénz
összeg	amount	double	igen
leírás	description	string