Számlázz.hu for Laravel
Számla, nyugta, díjbekérő, szállítólevél és sztornó közvetlenül a Laravel-alkalmazásból, PDF-letöltéssel és adószám-lekérdezéssel. A Számlázz.hu hivatalos PHP SDK-jának (v2.12.3) Laravel-portja, modern nyelvi elemekkel: enumokkal, típusos tulajdonságokkal és nevesített argumentumokkal.
$ composer require netipar/szamlazzhu
$client = app(Client::class);
$invoice = new Invoice();
$invoice->getHeader()->setPaymentMethod(PaymentMethod::BankTransfer);
$invoice->setBuyer(new Buyer(
name: 'Customer Kft.',
zipCode: '1234',
city: 'Budapest',
address: 'Main Street 1.',
));
$item = new InvoiceItem();
$item->setName('Product name')
->setNetUnitPrice(10000.0)->setQuantity(2.0)
->setVat('27')->setNetPrice(20000.0)
->setVatAmount(5400.0)->setGrossAmount(25400.0);
$invoice->addItem($item);
$result = $client->generateInvoice($invoice);
$result->getDocumentNumber(); // 'E-PREFIX-2026-001'- Legújabb verzió
- v2.0.1
- 2026. július 6.
- Követelmények
- PHP 8.3+
- Laravel 10, 11, 12 és 13
- Licenc
- MIT
- üzleti célra is szabadon
- Letöltések
- 6 681
- Packagist, összesen
Mire jó?
A számlázás, amit nem kell kézzel intézni
A rendelésből, a fizetésből vagy az előfizetésből automatikusan lesz bizonylat, a Számlázz.hu Számla Agent API-ján keresztül.
-
Kilencféle bizonylat
Számla, előleg- és végszámla, helyesbítő számla, nyugta, díjbekérő, szállítólevél, valamint a számla és a nyugta sztornója.
Így működik:
$client->generateInvoice() -
PDF azonnal vagy később
A számla PDF-je a válaszban érkezik, később pedig számlaszám, rendelésszám vagy külső azonosító alapján is letölthető.
Így működik:
$client->getInvoicePdf() -
Kifizetés rögzítése
A beérkezett utalást vagy befizetést a számlán is jóváírhatod, így a Számlázz.hu-ban is naprakész, mi van kifizetve.
Így működik:
$client->payInvoice() -
Adószám-ellenőrzés
Az adószám első nyolc számjegyéből lekérdezhetők az adózó adatai, még a számla kiállítása előtt.
Így működik:
$client->getTaxPayer() -
Több nyelv, több pénznem
15 számlanyelv és 30+ pénznem, köztük az euró, a dollár, a font és a svájci frank.
Így működik:
Language::English -
Kiszámítható hibakezelés
Hálózati, API-, validációs és XML-hibára külön kivételt kapsz, a válasz pedig mindig ugyanúgy kezelhető.
Így működik:
ResponseException
Kilenc bizonylattípus, egy kliens:
-
Számla
Invoice -
Előlegszámla
PrePaymentInvoice -
Végszámla
FinalInvoice -
Helyesbítő számla
CorrectiveInvoice -
Sztornószámla
ReverseInvoice -
Nyugta
Receipt -
Nyugtasztornó
ReverseReceipt -
Díjbekérő
Proforma -
Szállítólevél
DeliveryNote
Így működik
A bizonylat útja az összeállítástól a PDF-ig
-
1
Összeállítás
A bizonylatot objektumokból rakod össze, nyers XML nélkül.
new Invoice() -
2
Küldés
A kliens a Számlázz.hu sémája szerinti XML-t küld a Számla Agent API-nak.
generateInvoice() -
3
Kiállítás
A Számlázz.hu kiállítja a bizonylatot, a válaszban a szám és a PDF is megérkezik.
getDocumentNumber() -
4
Mentés
A PDF a Laravel Storage-ba menthető, az adatok később is lekérdezhetők.
SZAMLAZZHU_SAVE_PDF -
5
Kifizetés
A befizetés rögzíthető a számlán. Online fizetéshez a SimplePay-csomag adja az eseményt.
SimplePay for Laravel
A Számlázz.hu-munkamenetet a csomag kezeli: cache, fájl vagy adatbázis driverrel, tesztekhez pedig null driverrel.
Kódpéldák
Minden bizonylat ugyanazzal a klienssel
$receipt = new Receipt();
$receipt->getHeader()->setPrefix('NYGTA');
$receipt->getHeader()->setPaymentMethod(PaymentMethod::Cash);
$receipt->getHeader()->setCurrency(Currency::HUF);
$receipt->setBuyer(new Buyer(name: 'Customer Name'));
$item = new ReceiptItem();
$item->setName('Item name')
->setNetUnitPrice(10000.0)->setQuantity(1.0)->setQuantityUnit('db')
->setVat('27')->setNetPrice(10000.0)
->setVatAmount(2700.0)->setGrossAmount(12700.0);
$receipt->addItem($item);
$result = $client->generateReceipt($receipt);Minőség
Tesztelve, verziózva, dokumentálva
Kompatibilitás
Minden változtatás után mind a hét párosításon lefut a tesztcsomag (GitHub Actions).
| PHP | Laravel 10 | Laravel 11 | Laravel 12 | Laravel 13 |
|---|---|---|---|---|
| 8.3 | ||||
| 8.4 | – |
Amire számíthatsz
- 113 automatizált teszt (Pest)
- A hivatalos Számlázz.hu PHP SDK v2.12.3 alapján
- Laravel Boost skill az AI-kódasszisztensnek
- Angol és magyar példák a tárolóban
- Munkamenet-kezelés cache, fájl vagy adatbázis driverrel
- MIT-licenc: üzleti projektben is szabadon használható
Verziótörténet
Teljes CHANGELOG (új lapon nyílik)-
v2.0.1
Tesztjavítás a Laravel 10-es CI-hez, a futó kód nem változott.
-
v2.0.0
Laravel 13-támogatás, PHP 8.3 minimum és a hivatalos SDK 2.12.3-ig tartó változásai: nyugta rendelésszámmal, lekérdezés külső azonosítóval, négy új számlanyelv.
-
v1.0.2
A Guzzle kifejezett függőség lett a Laravel 10 miatt, CI-javítások.
-
v1.0.1
GitHub Actions CI és Pint-kódstílus.
-
v1.0.0
Első kiadás a hivatalos Számlázz.hu PHP SDK v2.10.23 alapján.
Élesben
DermaSoul
A témakörök online megvásárlása után minden sikeres SimplePay-fizetésnél automatikusan elkészül a Számlázz.hu-számla.
A DermaSoul-referencia</Számlázás>
Automatikus számlázás kellene a webshopba vagy az ügyviteli rendszerbe?
Összekötjük a rendeléseket, a fizetést és a Számlázz.hu-t, hogy a bizonylat magától elkészüljön.
Beszéljünk a projektedrőlNem szükséges kész specifikáció. Elég, ha leírod, mit szeretnétek megoldani.
Ügyfeleink mondták rólunk
Büszkék vagyunk arra, hogy ügyfeleink hosszú távon is elégedettek a közös munkával. Íme néhány visszajelzés, ami igazán számít.
5,0 átlag az 5-ből, 8 Google-értékelés- Megbízható partner Valódi eredmények, hosszú távú együttműködések
- Szakértő csapat Komplex projektek, átlátható folyamatok
- Ügyfélközpontú szemlélet Mindig a közös célokra fókuszálunk
Az alábbi vélemények ügyfeleinktől származó, valós visszajelzések. Ez csak egy kis ízelítő, a teljes listát Google-értékeléseinknél találod.
