Laravel ZUGFeRD / Factur-X
ZUGFeRD 2.x és Factur-X 1.0 Laravelhez: a számla XML beágyazása a PDF/A-3 dokumentumba és minden profil validálása, tiszta PHP-ben.
composer require intragile/laravel-zugferd
ZUGFeRD 2.x és Factur-X 1.0 Laravelhez: a számla XML beágyazása a PDF/A-3 dokumentumba és minden profil validálása, tiszta PHP-ben.
Ez egy vékony metacsomag: nincs saját kódja, csak a intragile/laravel-einvoicing csomagot húzza be a használati esethez szükséges szabálycsomaggal együtt, hogy könnyen megtaláld. A teljes funkcionalitás ott van dokumentálva.
Követelmények
- PHP 8.3+ a
dom,libxmlésmbstringkiterjesztéssel (észliba PDF-hez) - Laravel 12 vagy 13
Telepítés
composer require intragile/laravel-zugferd
Az íráshoz, olvasáshoz és validáláshoz nincs mit beállítani: a Factur-X szabályok a telepített szabálycsomagban vannak. A PDF/A-3 dokumentumot te adod (a PDF megjelenítése nem része a könyvtárnak). A doctor az alapértelmezett validátort is ellenőrzi, amely betölti a Peppol szabályokat, ezért telepítsd őket egyszer. Transportot csak akkor állíts be, ha Peppolon is küldesz (lásd a teljes dokumentációt).
php artisan einvoicing:install-rules
php artisan migrate # létrehozza a két táblát
Ellenőrzés:
php artisan einvoicing:doctor
Használat:
use IntrAgile\EInvoicing\Laravel\Facades\EInvoicing;
use IntrAgile\EInvoicing\Syntax\FacturX\{FacturXPdfWriter, FacturXProfile, FacturXXmlWriter};
use IntrAgile\EInvoicing\Syntax\Ubl\UblReader;
$invoice = (new UblReader)->read(file_get_contents('invoice.xml'))->invoice; // or one you built
$xml = (new FacturXXmlWriter)->write($invoice, FacturXProfile::En16931)->xml;
$report = EInvoicing::facturx()->validate($xml);
if (! $report->isValid()) {
throw new RuntimeException('The Factur-X XML is invalid.');
}
$pdf = (new FacturXPdfWriter)->embed($pdfA3Bytes, $xml)->pdf; // $pdfA3Bytes: the PDF/A-3 you rendered
file_put_contents('invoice.pdf', $pdf);
A könyvtár nem konvertál PDF/A-ra: PDF/A-3 bemenetet kell adni. A profilok: MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED és XRECHNUNG; a formátum a hivatalos fájlokkal és eszközökkel offline ellenőrzött, éles forgalomban nem.
Amit behúz
intragile/laravel-einvoicing (a Laravel-integráció, MIT), amely hozza a intragile/php-einvoicing motort (MIT) és a szabálycsomagokat: intragile/einvoicing-rules-en16931 (EUPL-1.2), intragile/einvoicing-rules-xrechnung (Apache-2.0) és intragile/einvoicing-rules-facturx (Apache-2.0). Az intragile/einvoicing-rules-facturx csomagot közvetlenül is megköveteli.
A metacsomag maga MIT licencű és nem szállít kódot; minden behúzott csomag a saját licencét tartja meg.
Teljes dokumentáció
Teljes dokumentáció: laravel-einvoicing
Licenc
MIT. Lásd: LICENSE.
Fejlesztő és karbantartó: IntrAgile Kft.
Ez az oldal a csomag v1.0.0 verziójának README-jéből készült. Forrás a GitHubonúj lapon nyílik meg