HU

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

Verzió
v1.0.0
PHP
8.3+
Packagist
0 letöltés
GitHub
0 csillag

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 és zlib kiterjeszté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