'date', 'due_date' => 'date', 'approved_at' => 'datetime', 'paid_at' => 'datetime', 'last_sent_at' => 'datetime', 'last_viewed_at' => 'datetime', 'status' => InvoiceStatus::class, 'discount_method' => DocumentDiscountMethod::class, 'discount_computation' => AdjustmentComputation::class, 'discount_rate' => RateCast::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 estimate(): BelongsTo { return $this->belongsTo(Estimate::class); } public function recurringInvoice(): BelongsTo { return $this->belongsTo(RecurringInvoice::class); } 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 sourceType(): Attribute { return Attribute::get(function () { return match (true) { $this->estimate_id !== null => DocumentType::Estimate, $this->recurring_invoice_id !== null => DocumentType::RecurringInvoice, default => null, }; }); } public static function documentType(): DocumentType { return DocumentType::Invoice; } public function documentNumber(): ?string { return $this->invoice_number; } public function documentDate(): ?string { return $this->date?->toDefaultDateFormat(); } public function dueDate(): ?string { return $this->due_date?->toDefaultDateFormat(); } public function referenceNumber(): ?string { return $this->order_number; } public function amountDue(): ?string { return $this->amount_due; } public function scopeUnpaid(Builder $query): Builder { return $query->whereNotIn('status', [ InvoiceStatus::Paid, InvoiceStatus::Void, InvoiceStatus::Draft, InvoiceStatus::Overpaid, ]); } public function scopeOverdue(Builder $query): Builder { return $query ->unpaid() ->where('status', InvoiceStatus::Overdue); } 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 wasApproved(): bool { return $this->approved_at !== null; } public function isPaid(): bool { return $this->paid_at !== null; } public function hasBeenSent(): bool { return $this->last_sent_at !== null; } public function hasBeenViewed(): bool { return $this->last_viewed_at !== null; } 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, ]) && $this->currency_code === CurrencyAccessor::getDefaultCurrency(); } public function canBeOverdue(): bool { return in_array($this->status, InvoiceStatus::canBeOverdue()); } public function canBeApproved(): bool { return $this->isDraft() && ! $this->wasApproved(); } public function canBeMarkedAsSent(): bool { return ! $this->hasBeenSent(); } public function hasPayments(): bool { return $this->payments()->exists(); } public static function getNextDocumentNumber(?Company $company = null): 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 ?? ''; $latestDocument = static::query() ->whereNotNull('invoice_number') ->latest('invoice_number') ->first(); $lastNumberNumericPart = $latestDocument ? (int) substr($latestDocument->invoice_number, strlen($numberPrefix)) : DocumentDefault::getBaseNumber(); $numberNext = $lastNumberNumericPart + 1; return $defaultInvoiceSettings->getNumberNext( prefix: $numberPrefix, next: $numberNext ); } public function recordPayment(array $data): void { $isRefund = $this->status === InvoiceStatus::Overpaid; if ($isRefund) { $transactionType = TransactionType::Withdrawal; $transactionDescription = "Invoice #{$this->invoice_number}: Refund to {$this->client->name}"; } else { $transactionType = TransactionType::Deposit; $transactionDescription = "Invoice #{$this->invoice_number}: Payment from {$this->client->name}"; } $bankAccount = BankAccount::findOrFail($data['bank_account_id']); $bankAccountCurrency = $bankAccount->account->currency_code ?? CurrencyAccessor::getDefaultCurrency(); $invoiceCurrency = $this->currency_code; $requiresConversion = $invoiceCurrency !== $bankAccountCurrency; if ($requiresConversion) { $amountInInvoiceCurrencyCents = CurrencyConverter::convertToCents($data['amount'], $invoiceCurrency); $amountInBankCurrencyCents = CurrencyConverter::convertBalance( $amountInInvoiceCurrencyCents, $invoiceCurrency, $bankAccountCurrency ); $formattedAmountForBankCurrency = CurrencyConverter::convertCentsToFormatSimple( $amountInBankCurrencyCents, $bankAccountCurrency ); } else { $formattedAmountForBankCurrency = $data['amount']; // Already in simple format } // Create transaction $this->transactions()->create([ 'company_id' => $this->company_id, 'type' => $transactionType, 'is_payment' => true, 'posted_at' => $data['posted_at'], 'amount' => $formattedAmountForBankCurrency, '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.'); } $this->createApprovalTransaction(); $approvedAt ??= now(); $this->update([ 'approved_at' => $approvedAt, 'status' => InvoiceStatus::Unsent, ]); } public function createApprovalTransaction(): void { $total = $this->formatAmountToDefaultCurrency($this->getRawOriginal('total')); $transaction = $this->transactions()->create([ 'company_id' => $this->company_id, 'type' => TransactionType::Journal, 'posted_at' => $this->date, 'amount' => $total, 'description' => 'Invoice Approval for Invoice #' . $this->invoice_number, ]); $baseDescription = "{$this->client->name}: Invoice #{$this->invoice_number}"; $transaction->journalEntries()->create([ 'company_id' => $this->company_id, 'type' => JournalEntryType::Debit, 'account_id' => Account::getAccountsReceivableAccount()->id, 'amount' => $total, 'description' => $baseDescription, ]); $totalLineItemSubtotalCents = $this->convertAmountToDefaultCurrency((int) $this->lineItems()->sum('subtotal')); $invoiceDiscountTotalCents = $this->convertAmountToDefaultCurrency((int) $this->getRawOriginal('discount_total')); $remainingDiscountCents = $invoiceDiscountTotalCents; foreach ($this->lineItems as $index => $lineItem) { $lineItemDescription = "{$baseDescription} › {$lineItem->offering->name}"; $lineItemSubtotal = $this->formatAmountToDefaultCurrency($lineItem->getRawOriginal('subtotal')); $transaction->journalEntries()->create([ 'company_id' => $this->company_id, 'type' => JournalEntryType::Credit, 'account_id' => $lineItem->offering->income_account_id, 'amount' => $lineItemSubtotal, 'description' => $lineItemDescription, ]); foreach ($lineItem->adjustments as $adjustment) { $adjustmentAmount = $this->formatAmountToDefaultCurrency($lineItem->calculateAdjustmentTotalAmount($adjustment)); $transaction->journalEntries()->create([ 'company_id' => $this->company_id, 'type' => $adjustment->category->isDiscount() ? JournalEntryType::Debit : JournalEntryType::Credit, 'account_id' => $adjustment->account_id, 'amount' => $adjustmentAmount, 'description' => $lineItemDescription, ]); } if ($this->discount_method->isPerDocument() && $totalLineItemSubtotalCents > 0) { $lineItemSubtotalCents = $this->convertAmountToDefaultCurrency((int) $lineItem->getRawOriginal('subtotal')); if ($index === $this->lineItems->count() - 1) { $lineItemDiscount = $remainingDiscountCents; } else { $lineItemDiscount = (int) round( ($lineItemSubtotalCents / $totalLineItemSubtotalCents) * $invoiceDiscountTotalCents ); $remainingDiscountCents -= $lineItemDiscount; } if ($lineItemDiscount > 0) { $transaction->journalEntries()->create([ 'company_id' => $this->company_id, 'type' => JournalEntryType::Debit, 'account_id' => Account::getSalesDiscountAccount()->id, 'amount' => CurrencyConverter::convertCentsToFormatSimple($lineItemDiscount), 'description' => "{$lineItemDescription} (Proportional Discount)", ]); } } } } public function updateApprovalTransaction(): void { $transaction = $this->approvalTransaction; if ($transaction) { $transaction->delete(); } $this->createApprovalTransaction(); } public function convertAmountToDefaultCurrency(int $amountCents): int { $defaultCurrency = CurrencyAccessor::getDefaultCurrency(); $needsConversion = $this->currency_code !== $defaultCurrency; if ($needsConversion) { return CurrencyConverter::convertBalance($amountCents, $this->currency_code, $defaultCurrency); } return $amountCents; } public function formatAmountToDefaultCurrency(int $amountCents): string { $convertedCents = $this->convertAmountToDefaultCurrency($amountCents); return CurrencyConverter::convertCentsToFormatSimple($convertedCents); } public function hasInactiveAdjustments(): bool { return $this->lineItems->contains(function (DocumentLineItem $lineItem) { return $lineItem->adjustments->contains(function (Adjustment $adjustment) { return $adjustment->isInactive(); }); }); } // TODO: Potentially handle this another way public static function getBlockedApproveAction(string $action = Action::class): MountableAction { return $action::make('blockedApprove') ->label('Approve') ->icon('heroicon-m-check-circle') ->visible(fn (self $record) => $record->canBeApproved() && $record->hasInactiveAdjustments()) ->requiresConfirmation() ->modalAlignment(Alignment::Start) ->modalIconColor('danger') ->modalDescription(function (self $record) { $inactiveAdjustments = collect(); foreach ($record->lineItems as $lineItem) { foreach ($lineItem->adjustments as $adjustment) { if ($adjustment->isInactive() && $inactiveAdjustments->doesntContain($adjustment->name)) { $inactiveAdjustments->push($adjustment->name); } } } $output = "

This invoice contains inactive adjustments that need to be addressed before approval:

"; $output .= "'; $output .= "

Please update these adjustments before approving the invoice.

"; return new HtmlString($output); }) ->modalSubmitAction(function (StaticAction $action, self $record) { $action->label('Edit Invoice') ->url(InvoiceResource\Pages\EditInvoice::getUrl(['record' => $record->id])); }); } public static function getApproveDraftAction(string $action = Action::class): MountableAction { return $action::make('approveDraft') ->label('Approve') ->icon('heroicon-m-check-circle') ->visible(function (self $record) { return $record->canBeApproved() && ! $record->hasInactiveAdjustments(); }) ->requiresConfirmation() ->databaseTransaction() ->successNotificationTitle('Invoice approved') ->action(function (self $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-m-paper-airplane') ->visible(static function (self $record) { return $record->canBeMarkedAsSent(); }) ->successNotificationTitle('Invoice sent') ->action(function (self $record, MountableAction $action) { $record->markAsSent(); $action->success(); }); } public function markAsSent(?Carbon $sentAt = null): void { $sentAt ??= now(); $this->update([ 'status' => InvoiceStatus::Sent, 'last_sent_at' => $sentAt, ]); } public function markAsViewed(?Carbon $viewedAt = null): void { $viewedAt ??= now(); $this->update([ 'status' => InvoiceStatus::Viewed, 'last_viewed_at' => $viewedAt, ]); } 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', 'approved_at', 'paid_at', 'last_sent_at', 'last_viewed_at', ]) ->modal(false) ->beforeReplicaSaved(function (self $original, self $replica) { $replica->status = InvoiceStatus::Draft; $replica->invoice_number = self::getNextDocumentNumber(); $replica->date = now(); $replica->due_date = now()->addDays($original->company->defaultInvoice->payment_terms->getDays()); }) ->databaseTransaction() ->after(function (self $original, self $replica) { $original->replicateLineItems($replica); }) ->successRedirectUrl(static function (self $replica) { return InvoiceResource::getUrl('edit', ['record' => $replica]); }); } public function replicateLineItems(Model $target): void { $this->lineItems->each(function (DocumentLineItem $lineItem) use ($target) { $replica = $lineItem->replicate([ 'documentable_id', 'documentable_type', 'subtotal', 'total', 'created_by', 'updated_by', 'created_at', 'updated_at', ]); $replica->documentable_id = $target->id; $replica->documentable_type = $target->getMorphClass(); $replica->save(); $replica->adjustments()->sync($lineItem->adjustments->pluck('id')); }); } }