InvoicePlane
diff --git a/‎Modules/Clients/Database/Migrations/2025_10_01_002042_add_peppol_fields_to_relations_table.php‎
Lines changed: 34 additions & 0 deletions b/‎Modules/Clients/Database/Migrations/2025_10_01_002042_add_peppol_fields_to_relations_table.php‎
Lines changed: 34 additions & 0 deletions
diff --git a/‎Modules/Clients/Database/Migrations/2025_10_02_000007_add_peppol_validation_fields_to_relations_table.php‎
Lines changed: 44 additions & 0 deletions b/‎Modules/Clients/Database/Migrations/2025_10_02_000007_add_peppol_validation_fields_to_relations_table.php‎
Lines changed: 44 additions & 0 deletions
diff --git a/‎Modules/Clients/Models/Relation.php‎
Lines changed: 56 additions & 29 deletions b/‎Modules/Clients/Models/Relation.php‎
Lines changed: 56 additions & 29 deletions
diff --git a/‎Modules/Core/Models/Company.php‎
Lines changed: 0 additions & 1 deletion b/‎Modules/Core/Models/Company.php‎
Lines changed: 0 additions & 1 deletion
diff --git a/‎Modules/Core/Tests/Unit/DateFieldAutoPopulationTest.php‎
Lines changed: 2 additions & 2 deletions b/‎Modules/Core/Tests/Unit/DateFieldAutoPopulationTest.php‎
Lines changed: 2 additions & 2 deletions
diff --git a/‎Modules/Expenses/Filament/Company/Widgets/RecentExpensesWidget.php‎
Lines changed: 3 additions & 4 deletions b/‎Modules/Expenses/Filament/Company/Widgets/RecentExpensesWidget.php‎
Lines changed: 3 additions & 4 deletions
diff --git a/‎Modules/Invoices/Actions/SendInvoiceToPeppolAction.php‎
Lines changed: 114 additions & 0 deletions b/‎Modules/Invoices/Actions/SendInvoiceToPeppolAction.php‎
Lines changed: 114 additions & 0 deletions
@@ -0,0 +1,34 @@
+<?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', 50)->nullable()->after('peppol_id')
+                ->comment('Preferred Peppol document format (matches PeppolDocumentFormat values)');
+
+            $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']);
+        });
+    }
+};
@@ -0,0 +1,44 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class () extends Migration {
+    /**
+     * Add Peppol validation columns to the relations table.
+     *
+     * Adds nullable columns: `peppol_scheme` (string(50)) for Peppol endpoint scheme,
+     * `peppol_validation_status` (string(20)) for quick lookup of validation state,
+     * `peppol_validation_message` (text) for the last validation message, and
+     * `peppol_validated_at` (timestamp) for when the Peppol ID was last validated.
+     */
+    public function up(): void
+    {
+        Schema::table('relations', function (Blueprint $table): void {
+            $table->string('peppol_scheme', 50)->nullable()->after('peppol_id')
+                ->comment('Peppol endpoint scheme (e.g., BE:CBE, DE:VAT)');
+
+            $table->string('peppol_validation_status', 20)->nullable()->after('enable_e_invoicing')
+                ->comment('Quick lookup: valid, invalid, not_found, error, null');
+
+            $table->text('peppol_validation_message')->nullable()->after('peppol_validation_status')
+                ->comment('Last validation result message');
+
+            $table->timestamp('peppol_validated_at')->nullable()->after('peppol_validation_message')
+                ->comment('When was the Peppol ID last validated');
+        });
+    }
+
+    /**
+     * Removes Peppol-related columns from the `relations` table.
+     *
+     * Drops the columns: `peppol_scheme`, `peppol_validation_status`, `peppol_validation_message`, and `peppol_validated_at`.
+     */
+    public function down(): void
+    {
+        Schema::table('relations', function (Blueprint $table): void {
+            $table->dropColumn(['peppol_scheme', 'peppol_validation_status', 'peppol_validation_message', 'peppol_validated_at']);
+        });
+    }
+};
@@ -17,40 +17,49 @@
 use Modules\Core\Models\User;
 use Modules\Core\Traits\BelongsToCompany;
 use Modules\Expenses\Models\Expense;
+use Modules\Invoices\Enums\PeppolValidationStatus;
+use Modules\Invoices\Models\CustomerPeppolValidationHistory;
 use Modules\Invoices\Models\Invoice;
 use Modules\Payments\Models\Payment;
 use Modules\Projects\Models\Project;
 use Modules\Projects\Models\Task;
 use Modules\Quotes\Models\Quote;
 
 /**
- * @property int                  $id
- * @property int                  $company_id
- * @property int|null             $primary_contact_id
- * @property string               $relation_type
- * @property string               $relation_status
- * @property string               $relation_number
- * @property string               $company_name
- * @property string|null          $trading_name
- * @property string|null          $unique_name
- * @property string|null          $id_number
- * @property string|null          $coc_number
- * @property string|null          $vat_number
- * @property Carbon               $registered_at
- * @property mixed                $created_at
- * @property mixed                $updated_at
- * @property Invoice[]            $invoices
- * @property Quote[]              $quotes
- * @property Project[]            $projects
- * @property Contact              $contact
- * @property string|null          $currency_code
- * @property string|null          $language
- * @property Company              $company
- * @property Collection|Contact[] $contacts
- * @property Collection|Expense[] $expenses
- * @property Collection|Payment[] $payments
- * @property Collection|User[]    $users
- * @property Task[]               $tasks
+ * @property int                         $id
+ * @property int                         $company_id
+ * @property int|null                    $primary_contact_id
+ * @property string                      $relation_type
+ * @property string                      $relation_status
+ * @property string                      $relation_number
+ * @property string                      $company_name
+ * @property string|null                 $trading_name
+ * @property string|null                 $unique_name
+ * @property string|null                 $id_number
+ * @property string|null                 $coc_number
+ * @property string|null                 $vat_number
+ * @property string|null                 $peppol_id
+ * @property string|null                 $peppol_scheme
+ * @property string|null                 $peppol_format
+ * @property bool                        $enable_e_invoicing
+ * @property PeppolValidationStatus|null $peppol_validation_status
+ * @property string|null                 $peppol_validation_message
+ * @property Carbon|null                 $peppol_validated_at
+ * @property Carbon                      $registered_at
+ * @property mixed                       $created_at
+ * @property mixed                       $updated_at
+ * @property Invoice[]                   $invoices
+ * @property Quote[]                     $quotes
+ * @property Project[]                   $projects
+ * @property Contact                     $contact
+ * @property string|null                 $currency_code
+ * @property string|null                 $language
+ * @property Company                     $company
+ * @property Collection|Contact[]        $contacts
+ * @property Collection|Expense[]        $expenses
+ * @property Collection|Payment[]        $payments
+ * @property Collection|User[]           $users
+ * @property Task[]                      $tasks
  */
 class Relation extends Model
 {
@@ -62,8 +71,11 @@ 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',
+        'peppol_validation_status' => PeppolValidationStatus::class,
+        'peppol_validated_at'      => 'datetime',
     ];
 
     protected $guarded = [];
@@ -157,11 +169,26 @@ public function tasks(): HasMany
         return $this->hasMany(Task::class, 'customer_id');
     }
 
+    /**
+     * Define a one-to-many relationship to User models.
+     *
+     * @return HasMany the has-many relationship for User models
+     */
     public function users(): HasMany
     {
         return $this->hasMany(User::class);
     }
 
+    /**
+     * Get the Peppol validation history records for this relation.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\HasMany collection of CustomerPeppolValidationHistory models related by `customer_id`
+     */
+    public function peppolValidationHistory(): HasMany
+    {
+        return $this->hasMany(CustomerPeppolValidationHistory::class, 'customer_id');
+    }
+
     /*
     |--------------------------------------------------------------------------
     | Accessors
 
@@ -89,7 +89,6 @@ class Company extends Model implements HasName, HasCurrentTenantLabel
     | Relationships
     |--------------------------------------------------------------------------
     */
-    /** @phpstan-ignore-next-line */
     public function customerAdmins(): BelongsToMany
     {
         return $this->users()
 
@@ -33,8 +33,8 @@ protected function setUp(): void
     {
         parent::setUp();
 
-        $this->user    = User::factory()->create();
-        $this->company = Company::factory()->create();
+        $this->user    = User::factory()->create(); /** @var User $user */
+        $this->company = Company::factory()->create(); /** @var Company $company */
         $this->user->companies()->attach($this->company);
     }
 
 
@@ -8,7 +8,6 @@
 use Illuminate\Database\Eloquent\Relations\Relation;
 use Modules\Core\Helpers\EnumHelper;
 use Modules\Expenses\Enums\ExpenseStatus;
-use Modules\Expenses\Models\Expense;
 
 class RecentExpensesWidget extends TableWidget
 {
@@ -18,7 +17,7 @@ class RecentExpensesWidget extends TableWidget
 
     protected function getTableQuery(): Builder|Relation|null
     {
-        return Expense::query()->latest()->limit(10);
+        return \Modules\Expenses\Models\Expense::query()->latest()->limit(10); /** @var Builder $query */
     }
 
     protected function getTableColumns(): array
@@ -27,8 +26,8 @@ protected function getTableColumns(): array
             TextColumn::make('expense_status')
                 ->label(trans('ip.expense_status'))
                 ->badge()
-                ->formatStateUsing(fn ($state) => EnumHelper::safeEnum(ExpenseStatus::class, $state)?->label() ?? '-')
-                ->color(fn ($state) => EnumHelper::safeEnum(ExpenseStatus::class, $state)?->color() ?? 'secondary'),
+                ->formatStateUsing(fn ($state) => (EnumHelper::safeEnum(ExpenseStatus::class, $state) && method_exists(EnumHelper::safeEnum(ExpenseStatus::class, $state), 'label')) ? EnumHelper::safeEnum(ExpenseStatus::class, $state)->label() : '-')
+                ->color(fn ($state) => (EnumHelper::safeEnum(ExpenseStatus::class, $state) && method_exists(EnumHelper::safeEnum(ExpenseStatus::class, $state), 'color')) ? EnumHelper::safeEnum(ExpenseStatus::class, $state)->color() : 'secondary'),
             TextColumn::make('expenseCategory.category_name')->label(trans('ip.expense_category')),
             TextColumn::make('amount')->label(trans('ip.amount')),
         ];
 
@@ -0,0 +1,114 @@
+<?php
+
+namespace Modules\Invoices\Actions;
+
+use Illuminate\Http\Client\RequestException;
+use InvalidArgumentException;
+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.
+ */
+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;
+    }
+
+    /**
+     * 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);
+    }
+
+    /**
+     * 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
+    }
+}
Original file line number	Diff line number	Diff line change
`@@ -89,7 +89,6 @@ class Company extends Model implements HasName, HasCurrentTenantLabel`
`89`	`89`	`\| Relationships`
`90`	`90`	`\|--------------------------------------------------------------------------`
`91`	`91`	`*/`
`92`		`- /** @phpstan-ignore-next-line */`
`93`	`92`	`public function customerAdmins(): BelongsToMany`
`94`	`93`	`{`
`95`	`94`	`return $this->users()`
Original file line number	Diff line number	Diff line change
`@@ -33,8 +33,8 @@ protected function setUp(): void`
`33`	`33`	`{`
`34`	`34`	`parent::setUp();`
`35`	`35`
`36`		`- $this->user = User::factory()->create();`
`37`		`- $this->company = Company::factory()->create();`
	`36`	`+ $this->user = User::factory()->create(); /** @var User $user */`
	`37`	`+ $this->company = Company::factory()->create(); /** @var Company $company */`
`38`	`38`	`$this->user->companies()->attach($this->company);`
`39`	`39`	`}`
`40`	`40`