'date', 'due_date' => 'date', 'approved_at' => 'datetime', 'paid_at' => 'datetime', 'last_sent' => 'datetime', 'status' => InvoiceStatus::class, 'subtotal' => MoneyCast::class, 'tax_total' => MoneyCast::class, 'discount_total' => MoneyCast::class, 'total' => MoneyCast::class, 'amount_paid' => MoneyCast::class, 'amount_due' => MoneyCast::class, ]; public function client(): BelongsTo { return $this->belongsTo(Client::class); } public function lineItems(): MorphMany { return $this->morphMany(DocumentLineItem::class, 'documentable'); } public function transactions(): MorphMany { return $this->morphMany(Transaction::class, 'transactionable'); } public function payments(): MorphMany { return $this->transactions()->where('is_payment', true); } public function deposits(): MorphMany { return $this->transactions()->where('type', TransactionType::Deposit)->where('is_payment', true); } public function withdrawals(): MorphMany { return $this->transactions()->where('type', TransactionType::Withdrawal)->where('is_payment', true); } public function approvalTransaction(): MorphOne { return $this->morphOne(Transaction::class, 'transactionable') ->where('type', TransactionType::Journal); } protected function isCurrentlyOverdue(): Attribute { return Attribute::get(function () { return $this->due_date->isBefore(today()) && $this->canBeOverdue(); }); } public function isDraft(): bool { return $this->status === InvoiceStatus::Draft; } public function canRecordPayment(): bool { return ! in_array($this->status, [ InvoiceStatus::Draft, InvoiceStatus::Paid, InvoiceStatus::Void, ]); } public function canBulkRecordPayment(): bool { return ! in_array($this->status, [ InvoiceStatus::Draft, InvoiceStatus::Paid, InvoiceStatus::Void, InvoiceStatus::Overpaid, ]); } public function canBeOverdue(): bool { return in_array($this->status, InvoiceStatus::canBeOverdue()); } public static function getNextDocumentNumber(): string { $company = auth()->user()->currentCompany; if (! $company) { throw new \RuntimeException('No current company is set for the user.'); } $defaultInvoiceSettings = $company->defaultInvoice; $numberPrefix = $defaultInvoiceSettings->number_prefix; $numberDigits = $defaultInvoiceSettings->number_digits; $latestDocument = static::query() ->whereNotNull('invoice_number') ->latest('invoice_number') ->first(); $lastNumberNumericPart = $latestDocument ? (int) substr($latestDocument->invoice_number, strlen($numberPrefix)) : 0; $numberNext = $lastNumberNumericPart + 1; return $defaultInvoiceSettings->getNumberNext( padded: true, format: true, prefix: $numberPrefix, digits: $numberDigits, next: $numberNext ); } public function recordPayment(array $data): void { $isRefund = $this->status === InvoiceStatus::Overpaid; if ($isRefund) { $transactionType = TransactionType::Withdrawal; $transactionDescription = 'Refund for Overpayment on Invoice #' . $this->invoice_number; } else { $transactionType = TransactionType::Deposit; $transactionDescription = 'Payment for Invoice #' . $this->invoice_number; } // Create transaction $this->transactions()->create([ 'company_id' => $this->company_id, 'type' => $transactionType, 'is_payment' => true, 'posted_at' => $data['posted_at'], 'amount' => $data['amount'], 'payment_method' => $data['payment_method'], 'bank_account_id' => $data['bank_account_id'], 'account_id' => Account::getAccountsReceivableAccount()->id, 'description' => $transactionDescription, 'notes' => $data['notes'] ?? null, ]); } public function approveDraft(?Carbon $approvedAt = null): void { if (! $this->isDraft()) { throw new \RuntimeException('Invoice is not in draft status.'); } $approvedAt ??= now(); $transaction = $this->transactions()->create([ 'company_id' => $this->company_id, 'type' => TransactionType::Journal, 'posted_at' => $approvedAt, 'amount' => $this->total, 'description' => 'Invoice Approval for Invoice #' . $this->invoice_number, ]); $transaction->journalEntries()->create([ 'company_id' => $this->company_id, 'type' => JournalEntryType::Debit, 'account_id' => Account::getAccountsReceivableAccount()->id, 'amount' => $this->total, 'description' => $transaction->description, ]); foreach ($this->lineItems as $lineItem) { $transaction->journalEntries()->create([ 'company_id' => $this->company_id, 'type' => JournalEntryType::Credit, 'account_id' => $lineItem->offering->income_account_id, 'amount' => $lineItem->subtotal, 'description' => $transaction->description, ]); foreach ($lineItem->adjustments as $adjustment) { $transaction->journalEntries()->create([ 'company_id' => $this->company_id, 'type' => $adjustment->category->isDiscount() ? JournalEntryType::Debit : JournalEntryType::Credit, 'account_id' => $adjustment->account_id, 'amount' => $lineItem->calculateAdjustmentTotal($adjustment)->getAmount(), 'description' => $transaction->description, ]); } } $this->update([ 'approved_at' => $approvedAt, 'status' => InvoiceStatus::Unsent, ]); } public static function getApproveDraftAction(string $action = Action::class): MountableAction { return $action::make('approveDraft') ->label('Approve') ->icon('heroicon-o-check-circle') ->visible(function (Invoice $record) { return $record->isDraft(); }) ->databaseTransaction() ->successNotificationTitle('Invoice Approved') ->action(function (Invoice $record, MountableAction $action) { $record->approveDraft(); $action->success(); }); } public static function getMarkAsSentAction(string $action = Action::class): MountableAction { return $action::make('markAsSent') ->label('Mark as Sent') ->icon('heroicon-o-paper-airplane') ->visible(function (Invoice $record) { return ! $record->last_sent; }) ->successNotificationTitle('Invoice Sent') ->action(function (Invoice $record, MountableAction $action) { $record->update([ 'status' => InvoiceStatus::Sent, 'last_sent' => now(), ]); $action->success(); }); } public static function getReplicateAction(string $action = ReplicateAction::class): MountableAction { return $action::make() ->excludeAttributes(['status', 'amount_paid', 'amount_due', 'created_by', 'updated_by', 'created_at', 'updated_at', 'invoice_number', 'date', 'due_date']) ->modal(false) ->beforeReplicaSaved(function (Invoice $original, Invoice $replica) { $replica->status = InvoiceStatus::Draft; $replica->invoice_number = Invoice::getNextDocumentNumber(); $replica->date = now(); $replica->due_date = now()->addDays($original->company->defaultInvoice->payment_terms->getDays()); }) ->databaseTransaction() ->after(function (Invoice $original, Invoice $replica) { $original->lineItems->each(function (DocumentLineItem $lineItem) use ($replica) { $replicaLineItem = $lineItem->replicate([ 'documentable_id', 'documentable_type', 'subtotal', 'total', 'created_by', 'updated_by', 'created_at', 'updated_at', ]); $replicaLineItem->documentable_id = $replica->id; $replicaLineItem->documentable_type = $replica->getMorphClass(); $replicaLineItem->save(); $replicaLineItem->adjustments()->sync($lineItem->adjustments->pluck('id')); }); }) ->successRedirectUrl(function (Invoice $replica) { return InvoiceResource::getUrl('edit', ['record' => $replica]); }); } }