Laravel Peppol
Peppol Laravelhez: Peppol BIS Billing 3.0 számlák küldése és fogadása access pointon keresztül, sorba állított küldéssel, aláírt webhookokkal és validációval minden küldés előtt.
composer require intragile/laravel-peppol
Peppol Laravelhez: Peppol BIS Billing 3.0 számlák küldése és fogadása access pointon keresztül, sorba állított küldéssel, aláírt webhookokkal és validációval minden küldés előtt.
Ez egy vékony metacsomag: nincs saját kódja, csak a intragile/laravel-einvoicing csomagot húzza be, hogy könnyen megtaláld; a szabálycsomagokat az integráció hozza. A teljes funkcionalitás ott van dokumentálva.
Követelmények
- PHP 8.3+ a
dom,libxml,mbstringészlibkiterjesztéssel - Laravel 12 vagy 13
Telepítés
composer require intragile/laravel-peppol
Telepítsd a Peppol BIS validációs szabályokat, és add meg az alapértelmezett transport hozzáférési adatait (a Recommand látható; a B2Brouter és az e-invoice.be ugyanígy állítható be, lásd a teljes dokumentációt):
php artisan einvoicing:install-rules
php artisan migrate # létrehozza a két táblát
EINVOICING_TRANSPORT=recommand
RECOMMAND_API_KEY_ID=key_...
RECOMMAND_API_SECRET=secret_...
RECOMMAND_COMPANY_ID=c_...
Ellenőrzés:
php artisan einvoicing:doctor
Használat:
use IntrAgile\EInvoicing\Laravel\Facades\EInvoicing;
$xml = file_get_contents('invoice.xml'); // Peppol BIS Billing 3.0 UBL
// Queued; validated before the send claims the row; one send, never two.
$message = EInvoicing::send($xml, reference: 'INV-2026-0001');
// Use a connection other than the default one:
EInvoicing::send($xml, reference: 'INV-2026-0002', transport: 'b2brouter');
$message->state; // OutboundState: queued, sending, sent, delivered, ...
A számla maga hordozza az útválasztást (feladó, címzett, folyamat), és Peppol BIS Billing 3.0 (vagy Peppolon küldött XRechnung) kell legyen; a send() minden mást elutasít. Egy ismeretlen kimenetelű küldést a csomag soha nem küld újra magától. A számlák fogadása (aláírt webhookok, vagy lekérdezés a php artisan einvoicing:poll-inbound paranccsal) a laravel-einvoicing dokumentációjában van leírva.
Driverek
| Driver | Állapot |
|---|---|
Recommand (recommand) |
élesben tesztelve a Peppol teszthálózaton |
B2Brouter (b2brouter) |
élesben tesztelve a szolgáltatói sandbox ellen (szimulált hálózat) |
e-invoice.be (einvoicebe) |
élesben tesztelve a szolgáltatói sandbox ellen (szimulált hálózat) |
További szolgáltatók tervezettek. A szimulált hálózatú szolgáltatói sandbox elleni teszt a szolgáltató API-szerződését bizonyítja, nem a Peppolon történő kézbesítést; a Peppol teszthálózatot csak a Recommand éri el. A szolgáltatók részletei a teljes dokumentációban vannak.
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).
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