romix/nav-invoicing

Hungarian NAV Online Számla integration with PDF generation for Laravel (commercial license)

Típus: library · Hozzáférés: Védett · Honlap

Telepítés

Előbb állítsd be a hitelesítést (felhasználónév: romixweb):

composer config http-basic.composer.onlinego.hu romixweb a-jelszo
composer require romix/nav-invoicing

Verziók és függőségek

A Composer a require mező alapján automatikusan telepíti a szükséges csomagokat.

Verzió	Licenc	require	require-dev
`1.0.0`	proprietary	`php`: ^8.3 `dompdf/dompdf`: ^3.0 `illuminate/contracts`: ^12.0\|^13.0 `illuminate/database`: ^12.0\|^13.0 `illuminate/mail`: ^12.0\|^13.0 `illuminate/routing`: ^12.0\|^13.0 `illuminate/support`: ^12.0\|^13.0 `pzs/nav-online-invoice`: ^3.0	—

Telepítési dokumentáció

1. Repository hozzáadása

A célprojekt gyökerében a composer.json fájlba:

{
  "repositories": [
    {
      "type": "composer",
      "url": "https://composer.onlinego.hu"
    }
  ]
}

2. Csomag telepítése

A Composer automatikusan feloldja és telepíti a csomag require mezőjében megadott függőségeket is (pl. Laravel, Filament):

composer require romix/nav-invoicing

3. Védett csomag – hitelesítés

Ez a csomag védett. A felhasználónév: romixweb

composer config http-basic.composer.onlinego.hu romixweb a-jelszo
composer require romix/nav-invoicing

4. Globális repository beállítás (opcionális)

composer config --global repositories.onlinego composer https://composer.onlinego.hu

5. Ellenőrzés

Nyisd meg: https://composer.onlinego.hu/packages.json
Futtasd: composer clear-cache
Telepítés részletes naplóval: composer require romix/nav-invoicing -vvv

6. Függőségek működése

A composer require parancs a csomag require mezőjében szereplő függőségeket is telepíti, ha még nincsenek a projektben.

Licenc

Verzió	Licenc(ek)
`1.0.0`	proprietary

Összesített licenc: proprietary

Használati útmutató

.env file:

NAV_MODE="dev" #dev or prod
NAV_TEST_ADOAZ= #Adószám - előtti első tagja (integer)
NAV_TEST_USER="" #technikai felhasználó neve
NAV_TEST_PASS="" #technikai felhasználó jelszava
NAV_TEST_XML_CHANGE="" #xml cserekulcs
NAV_TEST_XML_SIGN="" #xml aláírókulcs
#PRODUCTION MODE
NAV_PROD_ADOAZ= #Adószám - előtti első tagja (integer)
NAV_PROD_USER="" #tehcnikai felhasználó neve
NAV_PROD_PASS="" #technikai felhasználó jelszava
NAV_PROD_XML_CHANGE="" #xml cserekulcs
NAV_PROD_XML_SIGN="" #xml aláírókulcs
NAV_APP_ID="" #program azonosító

Futtasd le, hogy az adatbázis beálljon.

php artisan migrate

Filament adminba (opcionális | AdminPanelProvider.php):

->discoverResources(
    in: base_path('vendor/romix/nav-invoicing/src/Filament/Resources'),
    for: 'Romix\\NavInvoicing\\Filament\\Resources'
)

Használat (számla kiállítása):

use Romix\NavInvoicing\Data\CreateInvoiceData;
use Romix\NavInvoicing\Data\InvoiceBuyerData;
use Romix\NavInvoicing\Data\InvoiceLineData;
use Romix\NavInvoicing\Services\InvoiceService;

$invoice = app(InvoiceService::class)->issue(
    new CreateInvoiceData(
        buyer: new InvoiceBuyerData(
            name: 'Kovács János',
            email: 'kovacs@example.com',
            taxNumber: null, // magánszemély, ha üres
        ),
        lines: [
            new InvoiceLineData(
                description: 'Előfizetés – Pro csomag',
                grossAmount: 15000,
                quantity: 1,
            ),
        ],
        referenceType: 'order',
        referenceId: 42,
        paymentMethod: 'CARD',
    ),
);

Számla letöltése:

GET /szamla/{invoice}/letoltes

Artisan parancsok:

# Teszt XML generálás és XSD validáció (nem küld be a NAV-nak)
php artisan nav-invoicing:validate-xml

# Prod kiállító beállítással
php artisan nav-invoicing:validate-xml --environment=prod