$activities * @property int|null $activities_count * @property \App\Models\User|null $assigned_user * @property \App\Models\Client $client * @property \App\Models\Company $company * @property \App\Models\CreditInvitation $invitation * @property \Illuminate\Database\Eloquent\Collection $company_ledger * @property int|null $company_ledger_count * @property \Illuminate\Database\Eloquent\Collection $documents * @property int|null $documents_count * @property mixed $hashed_id * @property \Illuminate\Database\Eloquent\Collection $history * @property int|null $history_count * @property \Illuminate\Database\Eloquent\Collection $invitations * @property int|null $invitations_count * @property \App\Models\Invoice|null $invoice * @property \Illuminate\Database\Eloquent\Collection $invoices * @property int|null $invoices_count * @property \Illuminate\Database\Eloquent\Collection $payments * @property int|null $payments_count * @property \App\Models\Project|null $project * @property \App\Models\User $user * @property \App\Models\Client $client * @property \App\Models\Vendor|null $vendor * @property-read mixed $pivot * @property-read \Illuminate\Database\Eloquent\Collection $activities * @property-read \Illuminate\Database\Eloquent\Collection $company_ledger * @property-read \Illuminate\Database\Eloquent\Collection $documents * @property-read \Illuminate\Database\Eloquent\Collection $history * @property-read \Illuminate\Database\Eloquent\Collection $invitations * @property-read \Illuminate\Database\Eloquent\Collection $invoices * @property-read \Illuminate\Database\Eloquent\Collection $payments * * @mixin \Eloquent */ class Credit extends BaseModel { use MakesHash; use Filterable; use MakesDates; use SoftDeletes; use PresentableTrait; use MakesInvoiceValues; use MakesReminders; protected $presenter = CreditPresenter::class; protected $fillable = [ 'number', 'discount', 'po_number', 'date', 'due_date', 'terms', 'public_notes', 'private_notes', 'tax_name1', 'tax_rate1', 'tax_name2', 'tax_rate2', 'tax_name3', 'tax_rate3', 'is_amount_discount', 'partial', 'partial_due_date', 'project_id', 'custom_value1', 'custom_value2', 'custom_value3', 'custom_value4', 'line_items', 'client_id', 'footer', 'custom_surcharge1', 'custom_surcharge2', 'custom_surcharge3', 'custom_surcharge4', 'design_id', 'assigned_user_id', 'exchange_rate', 'subscription_id', 'vendor_id', ]; protected $casts = [ 'line_items' => 'object', 'backup' => 'object', 'updated_at' => 'timestamp', 'created_at' => 'timestamp', 'deleted_at' => 'timestamp', 'is_amount_discount' => 'bool', ]; protected $touches = []; public const STATUS_DRAFT = 1; public const STATUS_SENT = 2; public const STATUS_PARTIAL = 3; public const STATUS_APPLIED = 4; public function getEntityType() { return self::class; } public function getDateAttribute($value) { return $this->dateMutator($value); } public function getDueDateAttribute($value) { return $this->dateMutator($value); } public function getPartialDueDateAttribute($value) { return $this->dateMutator($value); } public function assigned_user(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(User::class, 'assigned_user_id', 'id')->withTrashed(); } public function vendor(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(Vendor::class); } public function history(): \Illuminate\Database\Eloquent\Relations\HasManyThrough { return $this->hasManyThrough(Backup::class, Activity::class); } public function activities(): \Illuminate\Database\Eloquent\Relations\HasMany { return $this->hasMany(Activity::class)->orderBy('id', 'DESC')->take(50); } public function company(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(Company::class); } public function user(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(User::class)->withTrashed(); } public function client(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(Client::class)->withTrashed(); } public function invitations(): \Illuminate\Database\Eloquent\Relations\HasMany { return $this->hasMany(CreditInvitation::class); } public function project(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(Project::class)->withTrashed(); } /** * The invoice which the credit has been created from. */ public function invoice(): \Illuminate\Database\Eloquent\Relations\BelongsTo { return $this->belongsTo(Invoice::class); } /** * @return \Illuminate\Database\Eloquent\Relations\MorphMany */ public function company_ledger(): \Illuminate\Database\Eloquent\Relations\MorphMany { return $this->morphMany(CompanyLedger::class, 'company_ledgerable'); } public function ledger(): \App\Services\Ledger\LedgerService { return new LedgerService($this); } /** * The invoice/s which the credit has * been applied to. */ public function invoices(): \Illuminate\Database\Eloquent\Relations\BelongsToMany { return $this->belongsToMany(Invoice::class)->using(Paymentable::class); } /** * @return \Illuminate\Database\Eloquent\Relations\MorphToMany */ public function payments(): \Illuminate\Database\Eloquent\Relations\MorphToMany { return $this->morphToMany(Payment::class, 'paymentable'); } /** * @return \Illuminate\Database\Eloquent\Relations\MorphMany */ public function documents(): \Illuminate\Database\Eloquent\Relations\MorphMany { return $this->morphMany(Document::class, 'documentable'); } /** * Access the invoice calculator object. * * @return InvoiceSumInclusive | InvoiceSum The invoice calculator object getters */ public function calc(): InvoiceSumInclusive | InvoiceSum { $credit_calc = null; if ($this->uses_inclusive_taxes) { $credit_calc = new InvoiceSumInclusive($this); } else { $credit_calc = new InvoiceSum($this); } return $credit_calc->build(); } public function service(): \App\Services\Credit\CreditService { return new CreditService($this); } /** * @param float $balance_adjustment */ public function updateBalance($balance_adjustment) { if ($this->is_deleted) { return; } $balance_adjustment = floatval($balance_adjustment); $this->balance = $this->balance + $balance_adjustment; if ($this->balance == 0) { $this->status_id = self::STATUS_APPLIED; $this->saveQuietly(); return; } $this->saveQuietly(); } public function setStatus($status) { $this->status_id = $status; $this->saveQuietly(); } public function markInvitationsSent() { $this->invitations->each(function ($invitation) { if (! isset($invitation->sent_date)) { $invitation->sent_date = Carbon::now(); $invitation->saveQuietly(); } }); } public function transaction_event() { $credit = $this->fresh(); return [ 'credit_id' => $credit->id, 'credit_amount' => $credit->amount ?: 0, 'credit_balance' => $credit->balance ?: 0, 'credit_status' => $credit->status_id ?: 1, ]; } public function translate_entity(): string { return ctrans('texts.credit'); } public static function stringStatus(int $status): string { switch ($status) { case self::STATUS_DRAFT: return ctrans('texts.draft'); case self::STATUS_SENT: return ctrans('texts.sent'); case self::STATUS_PARTIAL: return ctrans('texts.partial'); case self::STATUS_APPLIED: return ctrans('texts.applied'); default: return ctrans('texts.sent'); } } }