Feature: Complete Peppol e-invoicing integration with multi-format support and comprehensive API coverage

Modules/Clients/Database/Migrations/2025_10_01_002042_add_peppol_fields_to_relations_table.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('relations', function (Blueprint $table) {
+            $table->string('peppol_id', 100)->nullable()->after('vat_number')
+                ->comment('Peppol participant identifier (e.g., BE:0123456789)');
+
+            $table->string('peppol_format', 20)->nullable()->after('peppol_id')
+                ->default('ubl')
+                ->comment('Preferred Peppol document format (ubl or cii)');
+
+            $table->boolean('enable_e_invoicing')->default(false)->after('peppol_format')
+                ->comment('Whether e-invoicing via Peppol is enabled for this customer');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('relations', function (Blueprint $table) {
+            $table->dropColumn(['peppol_id', 'peppol_format', 'enable_e_invoicing']);
+        });
+    }
+};

Modules/Clients/Models/Relation.php

@@ -36,6 +36,9 @@
  * @property string|null          $id_number
  * @property string|null          $coc_number
  * @property string|null          $vat_number
+ * @property string|null          $peppol_id
+ * @property string|null          $peppol_format
+ * @property bool                 $enable_e_invoicing
  * @property Carbon               $registered_at
  * @property mixed                $created_at
  * @property mixed                $updated_at
@@ -62,8 +65,9 @@ class Relation extends Model
     protected $table = 'relations';
 
     protected $casts = [
-        'relation_type'   => RelationType::class,
-        'relation_status' => RelationStatus::class,
+        'relation_type'      => RelationType::class,
+        'relation_status'    => RelationStatus::class,
+        'enable_e_invoicing' => 'boolean',
     ];
 
     protected $guarded = [];

Modules/Invoices/Actions/SendInvoiceToPeppolAction.php

@@ -0,0 +1,111 @@
+<?php
+
+namespace Modules\Invoices\Actions;
+
+use Illuminate\Http\Client\RequestException;
+use Modules\Invoices\Models\Invoice;
+use Modules\Invoices\Peppol\Services\PeppolService;
+
+/**
+ * SendInvoiceToPeppolAction - Action for sending invoices to Peppol network.
+ *
+ * This action handles the process of gathering invoice information and
+ * sending it to the Peppol network through the PeppolService. It provides
+ * a clean interface for both the EditInvoice page and the ListInvoices table.
+ *
+ * @package Modules\Invoices\Actions
+ */
+class SendInvoiceToPeppolAction
+{
+    /**
+     * The Peppol service instance.
+     *
+     * @var PeppolService
+     */
+    protected PeppolService $peppolService;
+
+    /**
+     * Constructor.
+     *
+     * @param PeppolService $peppolService The Peppol service
+     */
+    public function __construct(PeppolService $peppolService)
+    {
+        $this->peppolService = $peppolService;
+    }
+
+    /**
+     * Execute the action to send an invoice to Peppol.
+     *
+     * This method gathers all necessary information from the invoice and
+     * submits it to the Peppol network. It returns the result of the operation.
+     *
+     * @param Invoice $invoice The invoice to send
+     * @param array<string, mixed> $additionalData Optional additional data (e.g., Peppol ID)
+     * @return array<string, mixed> The result of the operation
+     *
+     * @throws RequestException If the Peppol API request fails
+     * @throws \InvalidArgumentException If the invoice data is invalid
+     */
+    public function execute(Invoice $invoice, array $additionalData = []): array
+    {
+        // Load necessary relationships
+        $invoice->load(['customer', 'invoiceItems']);
+
+        // Validate that invoice is in a state that can be sent
+        $this->validateInvoiceState($invoice);
+
+        // Send to Peppol
+        $result = $this->peppolService->sendInvoiceToPeppol($invoice, $additionalData);
+
+        // Optionally, you could update the invoice record here
+        // to track that it was sent to Peppol (e.g., add a peppol_document_id field)
+        // $invoice->update(['peppol_document_id' => $result['document_id']]);
+
+        return $result;
+    }
+
+    /**
+     * Validate that the invoice is in a valid state for Peppol transmission.
+     *
+     * @param Invoice $invoice The invoice to validate
+     * @return void
+     *
+     * @throws \InvalidArgumentException If validation fails
+     */
+    protected function validateInvoiceState(Invoice $invoice): void
+    {
+        // Check if invoice is in draft status - drafts should not be sent
+        if ($invoice->invoice_status === 'draft') {
+            throw new \InvalidArgumentException('Cannot send draft invoices to Peppol');
+        }
+
+        // Additional business logic validation can be added here
+    }
+
+    /**
+     * Get the status of a previously sent invoice from Peppol.
+     *
+     * @param string $documentId The Peppol document ID
+     * @return array<string, mixed> Status information
+     *
+     * @throws RequestException If the API request fails
+     */
+    public function getStatus(string $documentId): array
+    {
+        return $this->peppolService->getDocumentStatus($documentId);
+    }
+
+    /**
+     * Cancel a Peppol document transmission.
+     *
+     * @param string $documentId The Peppol document ID
+     * @return bool True if cancellation was successful
+     *
+     * @throws RequestException If the API request fails
+     */
+    public function cancel(string $documentId): bool
+    {
+        return $this->peppolService->cancelDocument($documentId);
+    }
+}

Modules/Invoices/Config/config.php

@@ -0,0 +1,68 @@
+<?php
+
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | Peppol Configuration
+    |--------------------------------------------------------------------------
+    |
+    | Configuration for Peppol e-invoicing integration.
+    | Different providers can be configured here.
+    |
+    */
+
+    'peppol' => [
+        /*
+        |--------------------------------------------------------------------------
+        | Default Peppol Provider
+        |--------------------------------------------------------------------------
+        |
+        | The default Peppol access point provider to use.
+        | Supported: "e_invoice_be", "storecove", "custom"
+        |
+        */
+        'default_provider' => env('PEPPOL_PROVIDER', 'e_invoice_be'),
+
+        /*
+        |--------------------------------------------------------------------------
+        | E-Invoice.be Configuration
+        |--------------------------------------------------------------------------
+        |
+        | Configuration for the e-invoice.be Peppol access point.
+        | See: https://api.e-invoice.be/docs
+        |
+        */
+        'e_invoice_be' => [
+            'api_key' => env('PEPPOL_E_INVOICE_BE_API_KEY', ''),
+            'base_url' => env('PEPPOL_E_INVOICE_BE_BASE_URL', 'https://api.e-invoice.be'),
+        ],
+
+        /*
+        |--------------------------------------------------------------------------
+        | Peppol Document Settings
+        |--------------------------------------------------------------------------
+        |
+        | Default settings for Peppol documents.
+        |
+        */
+        'document' => [
+            'currency_code' => env('PEPPOL_CURRENCY_CODE', 'EUR'),
+            'default_unit_code' => 'C62', // Unit (piece)
+            'default_endpoint_scheme' => 'BE:CBE', // Belgian company number scheme
+        ],
+
+        /*
+        |--------------------------------------------------------------------------
+        | Validation Settings
+        |--------------------------------------------------------------------------
+        |
+        | Settings for validating invoices before sending to Peppol.
+        |
+        */
+        'validation' => [
+            'require_customer_peppol_id' => true,
+            'require_vat_number' => false,
+            'min_invoice_amount' => 0,
+        ],
+    ],
+];

Modules/Invoices/Filament/Company/Resources/Invoices/Pages/EditInvoice.php

@@ -2,9 +2,13 @@
 
 namespace Modules\Invoices\Filament\Company\Resources\Invoices\Pages;
 
+use Filament\Actions\Action;
 use Filament\Actions\DeleteAction;
+use Filament\Forms\Components\TextInput;
+use Filament\Notifications\Notification;
 use Filament\Resources\Pages\EditRecord;
 use Illuminate\Database\Eloquent\Model;
+use Modules\Invoices\Actions\SendInvoiceToPeppolAction;
 use Modules\Invoices\Filament\Company\Resources\Invoices\InvoiceResource;
 use Modules\Invoices\Services\InvoiceService;
 
@@ -49,6 +53,38 @@ protected function handleRecordUpdate(Model $record, array $data): Model
     protected function getHeaderActions(): array
     {
         return [
+            Action::make('send_to_peppol')
+                ->label(trans('ip.send_to_peppol'))
+                ->icon('heroicon-o-paper-airplane')
+                ->color('success')
+                ->requiresConfirmation()
+                ->form([
+                    TextInput::make('customer_peppol_id')
+                        ->label(trans('ip.customer_peppol_id'))
+                        ->helperText(trans('ip.customer_peppol_id_helper'))
+                        ->placeholder('BE:0123456789')
+                        ->required(),
+                ])
+                ->action(function (array $data) {
+                    try {
+                        $action = app(SendInvoiceToPeppolAction::class);
+                        $result = $action->execute($this->getRecord(), $data);
+
+                        Notification::make()
+                            ->title(trans('ip.peppol_success_title'))
+                            ->body(trans('ip.peppol_success_body', [
+                                'document_id' => $result['document_id'] ?? 'N/A',
+                            ]))
+                            ->success()
+                            ->send();
+                    } catch (\Exception $e) {
+                        Notification::make()
+                            ->title(trans('ip.peppol_error_title'))
+                            ->body(trans('ip.peppol_error_body', ['error' => $e->getMessage()]))
+                            ->danger()
+                            ->send();
+                    }
+                }),
             DeleteAction::make(),
         ];
     }

Modules/Invoices/Filament/Company/Resources/Invoices/Tables/InvoicesTable.php

@@ -8,9 +8,11 @@
 use Filament\Actions\DeleteAction;
 use Filament\Actions\DeleteBulkAction;
 use Filament\Actions\EditAction;
+use Filament\Forms\Components\TextInput;
 use Filament\Tables\Columns\TextColumn;
 use Filament\Tables\Table;
 use Modules\Core\Support\DateHelpers;
+use Modules\Invoices\Actions\SendInvoiceToPeppolAction;
 use Modules\Invoices\Enums\InvoiceStatus;
 use Modules\Invoices\Models\Invoice;
 use Modules\Invoices\Services\InvoiceService;
@@ -121,6 +123,38 @@ public static function configure(Table $table): Table
                                 ->success()
                                 ->send();
                         }),
+                    Action::make('send_to_peppol')
+                        ->label(trans('ip.send_to_peppol'))
+                        ->icon('heroicon-o-paper-airplane')
+                        ->color('success')
+                        ->requiresConfirmation()
+                        ->form([
+                            TextInput::make('customer_peppol_id')
+                                ->label(trans('ip.customer_peppol_id'))
+                                ->helperText(trans('ip.customer_peppol_id_helper'))
+                                ->placeholder('BE:0123456789')
+                                ->required(),
+                        ])
+                        ->action(function (Invoice $record, array $data): void {
+                            try {
+                                $action = app(SendInvoiceToPeppolAction::class);
+                                $result = $action->execute($record, $data);
+
+                                \Filament\Notifications\Notification::make()
+                                    ->title(trans('ip.peppol_success_title'))
+                                    ->body(trans('ip.peppol_success_body', [
+                                        'document_id' => $result['document_id'] ?? 'N/A',
+                                    ]))
+                                    ->success()
+                                    ->send();
+                            } catch (\Exception $e) {
+                                \Filament\Notifications\Notification::make()
+                                    ->title(trans('ip.peppol_error_title'))
+                                    ->body(trans('ip.peppol_error_body', ['error' => $e->getMessage()]))
+                                    ->danger()
+                                    ->send();
+                            }
+                        }),
                     DeleteAction::make('delete')
                         ->action(function (Invoice $record, array $data) {
                             app(InvoiceService::class)->deleteInvoice($record);