'object',
'updated_at' => 'timestamp',
'created_at' => 'timestamp',
'deleted_at' => 'timestamp',
];
protected $with = [
// 'company',
// 'client',
];
protected $appends = [
'hashed_id',
'status'
];
protected $dates = [
'date',
];
const STATUS_DRAFT = 1;
const STATUS_SENT = 2;
const STATUS_PARTIAL = 3;
const STATUS_PAID = 4;
const STATUS_CANCELLED = 5;
const STATUS_OVERDUE = -1;
const STATUS_UNPAID = -2;
const STATUS_REVERSED = -3;
public function getDateAttribute($value) {
if (!$value) {
return (new Carbon($value))->format('Y-m-d');
}
return $value;
}
public function getDueDateAttribute($value) {
if (!$value) {
return (new Carbon($value))->format('Y-m-d');
}
return $value;
}
public function getPartialDueDateAttribute($value) {
if (!$value) {
return (new Carbon($value))->format('Y-m-d');
}
return $value;
}
public function company()
{
return $this->belongsTo(Company::class);
}
public function user()
{
return $this->belongsTo(User::class)->withTrashed();
}
public function assigned_user()
{
return $this->belongsTo(User::class, 'assigned_user_id', 'id')->withTrashed();
}
public function invitations()
{
return $this->hasMany(InvoiceInvitation::class);
}
public function client()
{
return $this->belongsTo(Client::class)->withTrashed();
}
public function documents()
{
return $this->morphMany(Document::class, 'documentable');
}
public function payments()
{
return $this->morphToMany(Payment::class, 'paymentable')->withPivot('amount', 'refunded')->withTimestamps();
;
}
public function company_ledger()
{
return $this->morphMany(CompanyLedger::class, 'company_ledgerable');
}
public function credits()
{
return $this->belongsToMany(Credit::class)->using(Paymentable::class)->withPivot(
'amount',
'refunded'
)->withTimestamps();
;
}
/**
* Service entry points
*/
public function service() :InvoiceService
{
return new InvoiceService($this);
}
public function ledger()
{
return new LedgerService($this);
}
/* ---------------- */
/* Settings getters */
/* ---------------- */
public function getStatusAttribute()
{
if ($this->status_id == Invoice::STATUS_SENT && $this->due_date > Carbon::now()) {
return Invoice::STATUS_UNPAID;
} elseif ($this->status_id == Invoice::STATUS_PARTIAL && $this->partial_due_date > Carbon::now()) {
return Invoice::STATUS_UNPAID;
} elseif ($this->status_id == Invoice::STATUS_SENT && $this->due_date < Carbon::now()) {
return Invoice::STATUS_OVERDUE;
} elseif ($this->status_id == Invoice::STATUS_PARTIAL && $this->partial_due_date < Carbon::now()) {
return Invoice::STATUS_OVERDUE;
} else {
return $this->status_id;
}
}
/**
* If True, prevents an invoice from being
* modified once it has been marked as sent
*
* @return boolean isLocked
*/
public function isLocked(): bool
{
return $this->client->getSetting('lock_sent_invoices');
}
public function isPayable(): bool
{
if ($this->status_id == Invoice::STATUS_SENT && $this->is_deleted == false) {
return true;
} elseif ($this->status_id == Invoice::STATUS_PARTIAL && $this->is_deleted == false) {
return true;
} elseif ($this->status_id == Invoice::STATUS_SENT && $this->is_deleted == false) {
return true;
} elseif ($this->status_id == Invoice::STATUS_DRAFT && $this->is_deleted == false) {
return true;
} else {
return false;
}
}
public function isRefundable(): bool
{
if ($this->is_deleted) {
return false;
}
if (($this->amount - $this->balance) == 0) {
return false;
}
return true;
}
/**
* @return bool
*/
public function isPartial(): bool
{
return $this->status_id >= self::STATUS_PARTIAL;
}
/**
* @return bool
*/
public function hasPartial(): bool
{
return ($this->partial && $this->partial > 0) === true;
}
public static function badgeForStatus(int $status)
{
switch ($status) {
case Invoice::STATUS_DRAFT:
return '
' . ctrans('texts.draft') . '
';
break;
case Invoice::STATUS_SENT:
return '' . ctrans('texts.sent') . '
';
break;
case Invoice::STATUS_PARTIAL:
return '' . ctrans('texts.partial') . '
';
break;
case Invoice::STATUS_PAID:
return '' . ctrans('texts.paid') . '
';
break;
case Invoice::STATUS_CANCELLED:
return '' . ctrans('texts.cancelled') . '
';
break;
case Invoice::STATUS_OVERDUE:
return '' . ctrans('texts.overdue') . '
';
break;
case Invoice::STATUS_UNPAID:
return '' . ctrans('texts.unpaid') . '
';
break;
case Invoice::STATUS_REVERSED:
return '' . ctrans('texts.reversed') . '
';
break;
default:
# code...
break;
}
}
public static function stringStatus(int $status)
{
switch ($status) {
case Invoice::STATUS_DRAFT:
return ctrans('texts.draft');
break;
case Invoice::STATUS_SENT:
return ctrans('texts.sent');
break;
case Invoice::STATUS_PARTIAL:
return ctrans('texts.partial');
break;
case Invoice::STATUS_PAID:
return ctrans('texts.paid');
break;
case Invoice::STATUS_CANCELLED:
return ctrans('texts.cancelled');
break;
case Invoice::STATUS_OVERDUE:
return ctrans('texts.overdue');
break;
case Invoice::STATUS_UNPAID:
return ctrans('texts.unpaid');
break;
case Invoice::STATUS_REVERSED:
return ctrans('texts.reversed');
break;
default:
# code...
break;
}
}
/**
* Returns the template for the invoice
*
* @return string Either the template view, OR the template HTML string
* @todo this needs attention, invoice->settings needs clarification
*/
public function design(): string
{
if ($this->client->getSetting('design')) {
return File::exists(resource_path($this->client->getSetting('design'))) ? File::get(resource_path($this->client->getSetting('design'))) : File::get(resource_path('views/pdf/design1.blade.php'));
} else {
return File::get(resource_path('views/pdf/design1.blade.php'));
}
}
/**
* Access the invoice calculator object
*
* @return object The invoice calculator object getters
*/
public function calc()
{
$invoice_calc = null;
if ($this->uses_inclusive_taxes) {
$invoice_calc = new InvoiceSumInclusive($this);
} else {
$invoice_calc = new InvoiceSum($this);
}
return $invoice_calc->build();
}
/** TODO// DOCUMENT THIS FUNCTIONALITY */
public function pdf_url()
{
// $public_path = 'storage/' . $this->client->invoice_filepath() . $this->number . '.pdf';
// $storage_path = 'public/' . $this->client->invoice_filepath() . $this->number . '.pdf';
$public_path = $this->client->invoice_filepath() . $this->number . '.pdf';
$storage_path = 'storage/' . $this->client->invoice_filepath() . $this->number . '.pdf';
$disk = config('filesystems.default');
if (!Storage::disk($disk)->exists($public_path)) {
event(new InvoiceWasUpdated($this, $this->company));
CreateInvoicePdf::dispatch($this, $this->company, $this->client->primary_contact()->first());
}
return $storage_path;
}
public function pdf_file_path()
{
$storage_path = 'storage/' . $this->client->invoice_filepath() . $this->number . '.pdf';
if (!Storage::exists($storage_path)) {
CreateInvoicePdf::dispatchNow($this, $this->company, $this->client->primary_contact()->first());
}
return $storage_path;
}
/**
* Updates Invites to SENT
*
*/
public function markInvitationsSent()
{
$this->invitations->each(function ($invitation) {
if (!isset($invitation->sent_date)) {
$invitation->sent_date = Carbon::now();
$invitation->save();
}
});
}
/* Graveyard */
// /**
// * Determines if invoice overdue.
// *
// * @param float $balance The balance
// * @param date. $due_date The due date
// *
// * @return boolean True if overdue, False otherwise.
// */
// public static function isOverdue($balance, $due_date)
// {
// if (! $this->formatValue($balance,2) > 0 || ! $due_date) {
// return false;
// }
//
// // it isn't considered overdue until the end of the day
// return strtotime($this->createClientDate(date(), $this->client->timezone()->name)) > (strtotime($due_date) + (60 * 60 * 24));
// }
/**
* @param bool $save
*
* Has this been dragged from V1?
*/
// public function updatePaidStatus($paid = false, $save = true) : bool
// {
// $status_id = false;
// if ($paid && $this->balance == 0) {
// $status_id = self::STATUS_PAID;
// } elseif ($paid && $this->balance > 0 && $this->balance < $this->amount) {
// $status_id = self::STATUS_PARTIAL;
// } elseif ($this->hasPartial() && $this->balance > 0) {
// $status_id = ($this->balance == $this->amount ? self::STATUS_SENT : self::STATUS_PARTIAL);
// }
// if ($status_id && $status_id != $this->status_id) {
// $this->status_id = $status_id;
// if ($save) {
// $this->save();
// }
// }
// }
}