mirror of
https://github.com/invoiceninja/invoiceninja.git
synced 2024-11-15 07:33:04 +01:00
90d132ad20
Signed-off-by: Kristián Feldsam <feldsam@gmail.com>
1704 lines
45 KiB
PHP
1704 lines
45 KiB
PHP
<?php
|
|
|
|
namespace App\Models;
|
|
|
|
use App\Events\InvoiceWasCreated;
|
|
use App\Events\InvoiceWasUpdated;
|
|
use App\Events\QuoteWasCreated;
|
|
use App\Events\QuoteWasUpdated;
|
|
use App\Events\InvoiceInvitationWasEmailed;
|
|
use App\Events\QuoteInvitationWasEmailed;
|
|
use App\Libraries\CurlUtils;
|
|
use App\Models\Activity;
|
|
use App\Models\Credit;
|
|
use App\Models\Traits\ChargesFees;
|
|
use App\Models\Traits\HasRecurrence;
|
|
use DateTime;
|
|
use Illuminate\Database\Eloquent\SoftDeletes;
|
|
use Laracasts\Presenter\PresentableTrait;
|
|
use Utils;
|
|
|
|
/**
|
|
* Class Invoice.
|
|
*/
|
|
class Invoice extends EntityModel implements BalanceAffecting
|
|
{
|
|
use PresentableTrait;
|
|
use OwnedByClientTrait;
|
|
use ChargesFees;
|
|
use HasRecurrence;
|
|
use SoftDeletes {
|
|
SoftDeletes::trashed as parentTrashed;
|
|
}
|
|
|
|
/**
|
|
* @var string
|
|
*/
|
|
protected $presenter = 'App\Ninja\Presenters\InvoicePresenter';
|
|
/**
|
|
* @var array
|
|
*/
|
|
protected $dates = ['deleted_at'];
|
|
|
|
/**
|
|
* @var array
|
|
*/
|
|
protected $fillable = [
|
|
'tax_name1',
|
|
'tax_rate1',
|
|
'tax_name2',
|
|
'tax_rate2',
|
|
'private_notes',
|
|
'last_sent_date',
|
|
'invoice_design_id',
|
|
];
|
|
|
|
/**
|
|
* @var array
|
|
*/
|
|
protected $casts = [
|
|
'is_recurring' => 'boolean',
|
|
'has_tasks' => 'boolean',
|
|
'client_enable_auto_bill' => 'boolean',
|
|
'has_expenses' => 'boolean',
|
|
];
|
|
|
|
// used for custom invoice numbers
|
|
/**
|
|
* @var array
|
|
*/
|
|
public static $patternFields = [
|
|
'counter',
|
|
'clientCounter',
|
|
'clientIdNumber',
|
|
'clientCustom1',
|
|
'clientCustom2',
|
|
'userId',
|
|
'year',
|
|
'date:',
|
|
];
|
|
|
|
/**
|
|
* @var array
|
|
*/
|
|
public static $requestFields = [
|
|
'invoice_number',
|
|
'invoice_date',
|
|
'due_date',
|
|
'po_number',
|
|
'discount',
|
|
'partial',
|
|
];
|
|
|
|
public static $statusClasses = [
|
|
INVOICE_STATUS_SENT => 'info',
|
|
INVOICE_STATUS_VIEWED => 'warning',
|
|
INVOICE_STATUS_APPROVED => 'success',
|
|
INVOICE_STATUS_PARTIAL => 'primary',
|
|
INVOICE_STATUS_PAID => 'success',
|
|
];
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
public static function getImportColumns()
|
|
{
|
|
return [
|
|
'name',
|
|
'email',
|
|
'invoice_number',
|
|
'po_number',
|
|
'invoice_date',
|
|
'due_date',
|
|
'paid',
|
|
'terms',
|
|
'public_notes',
|
|
'private_notes',
|
|
'item_product',
|
|
'item_notes',
|
|
'item_quantity',
|
|
'item_cost',
|
|
'item_tax1',
|
|
'item_tax2',
|
|
'payment_date',
|
|
'payment_reference',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @return array
|
|
*/
|
|
public static function getImportMap()
|
|
{
|
|
return [
|
|
'number^po' => 'invoice_number',
|
|
'client|organization' => 'name',
|
|
'email' => 'email',
|
|
'paid^date' => 'paid',
|
|
'invoice date|create date' => 'invoice_date',
|
|
'po number' => 'po_number',
|
|
'due date' => 'due_date',
|
|
'terms' => 'terms',
|
|
'public notes' => 'public_notes',
|
|
'private notes' => 'private_notes',
|
|
'description' => 'item_notes',
|
|
'quantity|qty' => 'item_quantity',
|
|
'amount|cost' => 'item_cost',
|
|
'product' => 'item_product',
|
|
'tax' => 'item_tax1',
|
|
'payment date' => 'payment_date',
|
|
'transaction' => 'payment_reference',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getRoute()
|
|
{
|
|
if ($this->is_recurring) {
|
|
$entityType = $this->isType(INVOICE_TYPE_STANDARD) ? ENTITY_RECURRING_INVOICE : ENTITY_RECURRING_QUOTE;
|
|
} else {
|
|
$entityType = $this->getEntityType();
|
|
}
|
|
|
|
return "/{$entityType}s/{$this->public_id}/edit";
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function getDisplayName()
|
|
{
|
|
return $this->is_recurring ? trans('texts.recurring') : $this->invoice_number;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function affectsBalance()
|
|
{
|
|
return $this->isType(INVOICE_TYPE_STANDARD) && ! $this->is_recurring && $this->is_public;
|
|
}
|
|
|
|
/**
|
|
* @return float|int
|
|
*/
|
|
public function getAdjustment()
|
|
{
|
|
if (! $this->affectsBalance()) {
|
|
return 0;
|
|
}
|
|
|
|
return $this->getRawAdjustment();
|
|
}
|
|
|
|
/**
|
|
* @return float
|
|
*/
|
|
private function getRawAdjustment()
|
|
{
|
|
// if we've just made the invoice public then apply the full amount
|
|
if ($this->is_public && ! $this->getOriginal('is_public')) {
|
|
return $this->amount;
|
|
}
|
|
|
|
return floatval($this->amount) - floatval($this->getOriginal('amount'));
|
|
}
|
|
|
|
public function isChanged()
|
|
{
|
|
if (Utils::isNinja()) {
|
|
if ($this->getRawAdjustment() != 0) {
|
|
return true;
|
|
}
|
|
|
|
foreach ([
|
|
'invoice_number',
|
|
'po_number',
|
|
'invoice_date',
|
|
'due_date',
|
|
'terms',
|
|
'public_notes',
|
|
'invoice_footer',
|
|
'partial',
|
|
'partial_due_date',
|
|
] as $field) {
|
|
if ($this->$field != $this->getOriginal($field)) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
} else {
|
|
$dirty = $this->getDirty();
|
|
|
|
unset($dirty['invoice_status_id']);
|
|
unset($dirty['client_enable_auto_bill']);
|
|
unset($dirty['quote_invoice_id']);
|
|
|
|
return count($dirty) > 0;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param bool $calculate
|
|
*
|
|
* @return int|mixed
|
|
*/
|
|
public function getAmountPaid($calculate = false)
|
|
{
|
|
if ($this->isType(INVOICE_TYPE_QUOTE) || $this->is_recurring) {
|
|
return 0;
|
|
}
|
|
|
|
if ($calculate) {
|
|
$amount = 0;
|
|
foreach ($this->payments as $payment) {
|
|
if ($payment->payment_status_id == PAYMENT_STATUS_VOIDED || $payment->payment_status_id == PAYMENT_STATUS_FAILED) {
|
|
continue;
|
|
}
|
|
$amount += $payment->getCompletedAmount();
|
|
}
|
|
|
|
return $amount;
|
|
} else {
|
|
return $this->amount - $this->balance;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function trashed()
|
|
{
|
|
if ($this->client && $this->client->trashed()) {
|
|
return true;
|
|
}
|
|
|
|
return self::parentTrashed();
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
|
|
*/
|
|
public function account()
|
|
{
|
|
return $this->belongsTo('App\Models\Account');
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function user()
|
|
{
|
|
return $this->belongsTo('App\Models\User')->withTrashed();
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function client()
|
|
{
|
|
return $this->belongsTo('App\Models\Client')->withTrashed();
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function invoice_items()
|
|
{
|
|
return $this->hasMany('App\Models\InvoiceItem')->orderBy('id');
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function documents()
|
|
{
|
|
return $this->hasMany('App\Models\Document')->orderBy('id');
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function allDocuments()
|
|
{
|
|
$documents = $this->documents;
|
|
$documents = $documents->merge($this->account->defaultDocuments);
|
|
|
|
foreach ($this->expenses as $expense) {
|
|
if ($expense->invoice_documents) {
|
|
$documents = $documents->merge($expense->documents);
|
|
}
|
|
}
|
|
|
|
return $documents;
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
|
|
*/
|
|
public function invoice_status()
|
|
{
|
|
return $this->belongsTo('App\Models\InvoiceStatus');
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
|
|
*/
|
|
public function invoice_design()
|
|
{
|
|
return $this->belongsTo('App\Models\InvoiceDesign');
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\HasMany
|
|
*/
|
|
public function payments()
|
|
{
|
|
return $this->hasMany('App\Models\Payment', 'invoice_id', 'id');
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
|
|
*/
|
|
public function recurring_invoice()
|
|
{
|
|
return $this->belongsTo('App\Models\Invoice');
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
|
|
*/
|
|
public function recurring_quote()
|
|
{
|
|
return $this->belongsTo('App\Models\Invoice');
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
|
|
*/
|
|
public function quote()
|
|
{
|
|
return $this->belongsTo('App\Models\Invoice')->withTrashed();
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\HasMany
|
|
*/
|
|
public function recurring_invoices()
|
|
{
|
|
return $this->hasMany('App\Models\Invoice', 'recurring_invoice_id');
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\HasMany
|
|
*/
|
|
public function recurring_quotes()
|
|
{
|
|
return $this->hasMany('App\Models\Invoice', 'recurring_invoice_id');
|
|
}
|
|
|
|
/**
|
|
* @return \Illuminate\Database\Eloquent\Relations\BelongsTo
|
|
*/
|
|
public function frequency()
|
|
{
|
|
return $this->belongsTo('App\Models\Frequency');
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function invitations()
|
|
{
|
|
return $this->hasMany('App\Models\Invitation')->orderBy('invitations.contact_id');
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function expenses()
|
|
{
|
|
return $this->hasMany('App\Models\Expense', 'invoice_id', 'id')->withTrashed();
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeInvoices($query)
|
|
{
|
|
return $query->where('invoice_type_id', '=', INVOICE_TYPE_STANDARD)
|
|
->where('is_recurring', '=', false);
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeRecurring($query)
|
|
{
|
|
return $query->where('invoice_type_id', '=', INVOICE_TYPE_STANDARD)
|
|
->where('is_recurring', '=', true);
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeRecurringQuote($query)
|
|
{
|
|
return $query->where('invoice_type_id', '=', INVOICE_TYPE_QUOTE)
|
|
->where('is_recurring', '=', true);
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeDateRange($query, $startDate, $endDate)
|
|
{
|
|
return $query->where(function ($query) use ($startDate, $endDate) {
|
|
$query->whereBetween('invoice_date', [$startDate, $endDate]);
|
|
})->orWhere(function ($query) use ($startDate, $endDate) {
|
|
$query->whereBetween('due_date', [$startDate, $endDate]);
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeQuotes($query)
|
|
{
|
|
return $query->where('invoice_type_id', '=', INVOICE_TYPE_QUOTE)
|
|
->where('is_recurring', '=', false);
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeUnapprovedQuotes($query, $includeInvoiceId = false)
|
|
{
|
|
return $query->quotes()
|
|
->where(function ($query) use ($includeInvoiceId) {
|
|
$query->whereId($includeInvoiceId)
|
|
->orWhere(function ($query) {
|
|
$query->where('invoice_status_id', '<', INVOICE_STATUS_APPROVED)
|
|
->whereNull('quote_invoice_id');
|
|
});
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
* @param $typeId
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeInvoiceType($query, $typeId)
|
|
{
|
|
return $query->where('invoice_type_id', '=', $typeId);
|
|
}
|
|
|
|
/**
|
|
* @param $query
|
|
* @param $typeId
|
|
*
|
|
* @return mixed
|
|
*/
|
|
public function scopeStatusIds($query, $statusIds)
|
|
{
|
|
if (! $statusIds || (is_array($statusIds) && ! count($statusIds))) {
|
|
return $query;
|
|
}
|
|
|
|
return $query->where(function ($query) use ($statusIds) {
|
|
foreach ($statusIds as $statusId) {
|
|
$query->orWhere('invoice_status_id', '=', $statusId);
|
|
}
|
|
if (in_array(INVOICE_STATUS_UNPAID, $statusIds)) {
|
|
$query->orWhere(function ($query) {
|
|
$query->where('balance', '>', 0)
|
|
->where('is_public', '=', true);
|
|
});
|
|
}
|
|
if (in_array(INVOICE_STATUS_OVERDUE, $statusIds)) {
|
|
$query->orWhere(function ($query) {
|
|
$query->where('balance', '>', 0)
|
|
->where('due_date', '<', date('Y-m-d'))
|
|
->where('is_public', '=', true);
|
|
});
|
|
}
|
|
});
|
|
}
|
|
|
|
/**
|
|
* @return Invitation|null
|
|
*/
|
|
public function invitationByContactId(int $contactId)
|
|
{
|
|
foreach ($this->invitations as $invitation) {
|
|
if ($invitation->contact_id === $contactId) {
|
|
return $invitation;
|
|
}
|
|
}
|
|
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* @param $typeId
|
|
*
|
|
* @return bool
|
|
*/
|
|
public function isType($typeId)
|
|
{
|
|
return $this->invoice_type_id == $typeId;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isQuote()
|
|
{
|
|
return $this->isType(INVOICE_TYPE_QUOTE) && ! $this->is_recurring;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getCustomMessageType()
|
|
{
|
|
if ($this->isQuote()) {
|
|
return $this->quote_invoice_id ? CUSTOM_MESSAGE_APPROVED_QUOTE : CUSTOM_MESSAGE_UNAPPROVED_QUOTE;
|
|
} else {
|
|
return $this->balance > 0 ? CUSTOM_MESSAGE_UNPAID_INVOICE : CUSTOM_MESSAGE_PAID_INVOICE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isStandard()
|
|
{
|
|
return $this->isType(INVOICE_TYPE_STANDARD) && ! $this->is_recurring;
|
|
}
|
|
|
|
public function markSentIfUnsent()
|
|
{
|
|
if (! $this->isSent()) {
|
|
$this->markSent();
|
|
}
|
|
}
|
|
|
|
public function markSent()
|
|
{
|
|
if ($this->is_deleted) {
|
|
return;
|
|
}
|
|
|
|
if (! $this->isSent()) {
|
|
$this->invoice_status_id = INVOICE_STATUS_SENT;
|
|
}
|
|
|
|
$this->is_public = true;
|
|
$this->save();
|
|
|
|
$this->markInvitationsSent();
|
|
}
|
|
|
|
/**
|
|
* @param bool $notify
|
|
* @param mixed $reminder
|
|
*/
|
|
public function markInvitationsSent($notify = false, $reminder = false)
|
|
{
|
|
if ($this->is_deleted) {
|
|
return;
|
|
}
|
|
|
|
if (! $this->relationLoaded('invitations')) {
|
|
$this->load('invitations');
|
|
}
|
|
|
|
foreach ($this->invitations as $invitation) {
|
|
$this->markInvitationSent($invitation, false, $notify, $reminder);
|
|
}
|
|
}
|
|
|
|
public function areInvitationsSent()
|
|
{
|
|
if (! $this->relationLoaded('invitations')) {
|
|
$this->load('invitations');
|
|
}
|
|
|
|
foreach ($this->invitations as $invitation) {
|
|
if (! $invitation->isSent()) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* @param $invitation
|
|
* @param bool $messageId
|
|
* @param bool $notify
|
|
* @param mixed $notes
|
|
*/
|
|
public function markInvitationSent($invitation, $messageId = false, $notify = true, $notes = false)
|
|
{
|
|
if ($this->is_deleted) {
|
|
return;
|
|
}
|
|
|
|
if (! $this->isSent()) {
|
|
$this->is_public = true;
|
|
$this->invoice_status_id = INVOICE_STATUS_SENT;
|
|
$this->save();
|
|
}
|
|
|
|
$invitation->markSent($messageId);
|
|
|
|
// if the user marks it as sent rather than acually sending it
|
|
// then we won't track it in the activity log
|
|
if (! $notify) {
|
|
return;
|
|
}
|
|
|
|
if ($this->isType(INVOICE_TYPE_QUOTE)) {
|
|
event(new QuoteInvitationWasEmailed($invitation, $notes));
|
|
} else {
|
|
event(new InvoiceInvitationWasEmailed($invitation, $notes));
|
|
}
|
|
}
|
|
|
|
public function markViewed()
|
|
{
|
|
if (! $this->isViewed()) {
|
|
$this->invoice_status_id = INVOICE_STATUS_VIEWED;
|
|
$this->save();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param bool $save
|
|
*/
|
|
public function updatePaidStatus($paid = false, $save = true)
|
|
{
|
|
$statusId = false;
|
|
if ($paid && $this->balance == 0) {
|
|
$statusId = INVOICE_STATUS_PAID;
|
|
} elseif ($paid && $this->balance > 0 && $this->balance < $this->amount) {
|
|
$statusId = INVOICE_STATUS_PARTIAL;
|
|
} elseif ($this->isPartial() && $this->balance > 0) {
|
|
$statusId = ($this->balance == $this->amount ? INVOICE_STATUS_SENT : INVOICE_STATUS_PARTIAL);
|
|
}
|
|
|
|
if ($statusId && $statusId != $this->invoice_status_id) {
|
|
$this->invoice_status_id = $statusId;
|
|
if ($save) {
|
|
$this->save();
|
|
}
|
|
}
|
|
}
|
|
|
|
public function markApproved()
|
|
{
|
|
if ($this->isType(INVOICE_TYPE_QUOTE)) {
|
|
$this->invoice_status_id = INVOICE_STATUS_APPROVED;
|
|
$this->save();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param $balanceAdjustment
|
|
* @param int $partial
|
|
*/
|
|
public function updateBalances($balanceAdjustment, $partial = 0)
|
|
{
|
|
if ($this->is_deleted) {
|
|
return;
|
|
}
|
|
|
|
$balanceAdjustment = floatval($balanceAdjustment);
|
|
$partial = floatval($partial);
|
|
|
|
if (! $balanceAdjustment && $this->partial == $partial) {
|
|
return;
|
|
}
|
|
|
|
$this->balance = $this->balance + $balanceAdjustment;
|
|
|
|
if ($this->partial > 0) {
|
|
$this->partial = $partial;
|
|
|
|
// clear the partial due date and set the due date
|
|
// using payment terms if it's blank
|
|
if (! $this->partial && $this->partial_due_date) {
|
|
$this->partial_due_date = null;
|
|
if (! $this->due_date) {
|
|
$this->due_date = $this->account->defaultDueDate($this->client);
|
|
}
|
|
}
|
|
}
|
|
|
|
$this->save();
|
|
|
|
// mark fees as paid
|
|
if ($balanceAdjustment != 0 && $this->account->gateway_fee_enabled) {
|
|
if ($invoiceItem = $this->getGatewayFeeItem()) {
|
|
$invoiceItem->markFeePaid();
|
|
}
|
|
}
|
|
}
|
|
|
|
public function activeUser()
|
|
{
|
|
if (! $this->user->trashed()) {
|
|
return $this->user;
|
|
}
|
|
|
|
return $this->account->users->first();
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function getName()
|
|
{
|
|
return $this->is_recurring ? trans('texts.recurring') : $this->invoice_number;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getFileName($extension = 'pdf')
|
|
{
|
|
$entityType = $this->getEntityType();
|
|
|
|
return trans("texts.$entityType") . '_' . $this->invoice_number . '.' . $extension;
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getPDFPath()
|
|
{
|
|
return storage_path() . '/pdfcache/cache-' . $this->id . '.pdf';
|
|
}
|
|
|
|
public function canBePaid()
|
|
{
|
|
// already paid or deleted
|
|
if ($this->isPaid() || $this->is_deleted) return false;
|
|
|
|
// if quote approve is required, them only standard invoices can be paid
|
|
if ($this->account->require_approve_quote) {
|
|
return $this->isStandard();
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
public static function calcStatusLabel($status, $class, $entityType, $quoteInvoiceId)
|
|
{
|
|
if ($quoteInvoiceId) {
|
|
$label = 'converted';
|
|
} elseif ($class == 'danger') {
|
|
$label = $entityType == ENTITY_INVOICE ? 'past_due' : 'expired';
|
|
} else {
|
|
$label = 'status_' . strtolower($status);
|
|
}
|
|
|
|
return trans("texts.{$label}");
|
|
}
|
|
|
|
public static function calcStatusClass($statusId, $balance, $dueDate, $isRecurring)
|
|
{
|
|
if ($statusId >= INVOICE_STATUS_SENT && ! $isRecurring && static::calcIsOverdue($balance, $dueDate)) {
|
|
return 'danger';
|
|
}
|
|
|
|
if (isset(static::$statusClasses[$statusId])) {
|
|
return static::$statusClasses[$statusId];
|
|
}
|
|
|
|
return 'default';
|
|
}
|
|
|
|
public static function calcIsOverdue($balance, $dueDate)
|
|
{
|
|
if (! Utils::parseFloat($balance) > 0) {
|
|
return false;
|
|
}
|
|
|
|
if (! $dueDate || $dueDate == '0000-00-00') {
|
|
return false;
|
|
}
|
|
|
|
// it isn't considered overdue until the end of the day
|
|
return time() > (strtotime($dueDate) + (60 * 60 * 24));
|
|
}
|
|
|
|
public function statusClass()
|
|
{
|
|
$dueDate = $this->getOriginal('partial_due_date') ?: $this->getOriginal('due_date');
|
|
return static::calcStatusClass($this->invoice_status_id, $this->balance, $dueDate, $this->is_recurring);
|
|
}
|
|
|
|
public function statusLabel()
|
|
{
|
|
return static::calcStatusLabel($this->invoice_status->name, $this->statusClass(), $this->getEntityType(), $this->quote_invoice_id);
|
|
}
|
|
|
|
/**
|
|
* @param $invoice
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function calcLink($invoice)
|
|
{
|
|
if(isset($invoice->invoice_type_id))
|
|
$linkPrefix = ($invoice->invoice_type_id == INVOICE_TYPE_QUOTE) ? 'quotes/' : 'invoices/';
|
|
else
|
|
$linkPrefix = 'invoices/';
|
|
|
|
return link_to($linkPrefix . $invoice->public_id, $invoice->invoice_number);
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getLink()
|
|
{
|
|
return self::calcLink($this);
|
|
}
|
|
|
|
public function getInvitationLink($type = 'view', $forceOnsite = false, $forcePlain = false)
|
|
{
|
|
if (! $this->relationLoaded('invitations')) {
|
|
$this->load('invitations');
|
|
}
|
|
|
|
return $this->invitations[0]->getLink($type, $forceOnsite, $forcePlain);
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function getEntityType()
|
|
{
|
|
return $this->isType(INVOICE_TYPE_QUOTE) ? ENTITY_QUOTE : ENTITY_INVOICE;
|
|
}
|
|
|
|
public function subEntityType()
|
|
{
|
|
if ($this->is_recurring) {
|
|
return $this->isType(INVOICE_TYPE_STANDARD) ? ENTITY_RECURRING_INVOICE : ENTITY_RECURRING_QUOTE;
|
|
} else {
|
|
return $this->getEntityType();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isSent()
|
|
{
|
|
return $this->invoice_status_id >= INVOICE_STATUS_SENT && $this->getOriginal('is_public');
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isViewed()
|
|
{
|
|
return $this->invoice_status_id >= INVOICE_STATUS_VIEWED;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isApproved()
|
|
{
|
|
return $this->invoice_status_id >= INVOICE_STATUS_APPROVED || $this->quote_invoice_id;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isPartial()
|
|
{
|
|
return $this->invoice_status_id >= INVOICE_STATUS_PARTIAL;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isPaid()
|
|
{
|
|
return $this->invoice_status_id >= INVOICE_STATUS_PAID;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function isOverdue()
|
|
{
|
|
return static::calcIsOverdue($this->balance, $this->partial_due_date ?: $this->due_date);
|
|
}
|
|
|
|
/**
|
|
* @return mixed
|
|
*/
|
|
public function getRequestedAmount()
|
|
{
|
|
$fee = 0;
|
|
if ($this->account->gateway_fee_enabled) {
|
|
$fee = $this->getGatewayFee();
|
|
}
|
|
|
|
if ($this->partial > 0) {
|
|
return $this->partial + $fee;
|
|
} else {
|
|
return $this->balance;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return string
|
|
*/
|
|
public function getCurrencyCode()
|
|
{
|
|
if ($this->client->currency) {
|
|
return $this->client->currency->code;
|
|
} elseif ($this->account->currency) {
|
|
return $this->account->currency->code;
|
|
} else {
|
|
return 'USD';
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @return $this
|
|
*/
|
|
public function hidePrivateFields()
|
|
{
|
|
$this->setVisible([
|
|
'invoice_number',
|
|
'discount',
|
|
'is_amount_discount',
|
|
'po_number',
|
|
'invoice_date',
|
|
'due_date',
|
|
'terms',
|
|
'invoice_footer',
|
|
'public_notes',
|
|
'amount',
|
|
'balance',
|
|
'invoice_items',
|
|
'documents',
|
|
'expenses',
|
|
'client',
|
|
'invitations',
|
|
'tax_name1',
|
|
'tax_rate1',
|
|
'tax_name2',
|
|
'tax_rate2',
|
|
'account',
|
|
'invoice_design',
|
|
'invoice_design_id',
|
|
'invoice_fonts',
|
|
'features',
|
|
'invoice_type_id',
|
|
'custom_value1',
|
|
'custom_value2',
|
|
'custom_taxes1',
|
|
'custom_taxes2',
|
|
'partial',
|
|
'partial_due_date',
|
|
'has_tasks',
|
|
'custom_text_value1',
|
|
'custom_text_value2',
|
|
'has_expenses',
|
|
]);
|
|
|
|
$this->client->setVisible([
|
|
'name',
|
|
'balance',
|
|
'id_number',
|
|
'vat_number',
|
|
'address1',
|
|
'address2',
|
|
'city',
|
|
'state',
|
|
'postal_code',
|
|
'work_phone',
|
|
'payment_terms',
|
|
'website',
|
|
'contacts',
|
|
'country',
|
|
'currency_id',
|
|
'country_id',
|
|
'custom_value1',
|
|
'custom_value2',
|
|
]);
|
|
|
|
$this->account->setVisible([
|
|
'name',
|
|
'website',
|
|
'id_number',
|
|
'vat_number',
|
|
'address1',
|
|
'address2',
|
|
'city',
|
|
'state',
|
|
'postal_code',
|
|
'work_phone',
|
|
'work_email',
|
|
'country',
|
|
'country_id',
|
|
'currency_id',
|
|
'custom_fields',
|
|
'custom_value1',
|
|
'custom_value2',
|
|
'primary_color',
|
|
'secondary_color',
|
|
'hide_quantity',
|
|
'hide_paid_to_date',
|
|
'all_pages_header',
|
|
'all_pages_footer',
|
|
'pdf_email_attachment',
|
|
'show_item_taxes',
|
|
'invoice_embed_documents',
|
|
'page_size',
|
|
'include_item_taxes_inline',
|
|
'invoice_fields',
|
|
'show_currency_code',
|
|
'inclusive_taxes',
|
|
'date_format',
|
|
'datetime_format',
|
|
'timezone',
|
|
'signature_on_pdf',
|
|
]);
|
|
|
|
foreach ($this->invitations as $invitation) {
|
|
$invitation->setVisible([
|
|
'signature_base64',
|
|
'signature_date',
|
|
]);
|
|
}
|
|
|
|
foreach ($this->invoice_items as $invoiceItem) {
|
|
$invoiceItem->setVisible([
|
|
'product_key',
|
|
'notes',
|
|
'custom_value1',
|
|
'custom_value2',
|
|
'cost',
|
|
'qty',
|
|
'tax_name1',
|
|
'tax_rate1',
|
|
'tax_name2',
|
|
'tax_rate2',
|
|
'invoice_item_type_id',
|
|
'discount',
|
|
]);
|
|
}
|
|
|
|
foreach ($this->client->contacts as $contact) {
|
|
$contact->setVisible([
|
|
'first_name',
|
|
'last_name',
|
|
'email',
|
|
'phone',
|
|
'custom_value1',
|
|
'custom_value2',
|
|
]);
|
|
}
|
|
|
|
foreach ($this->documents as $document) {
|
|
$document->setVisible([
|
|
'public_id',
|
|
'name',
|
|
]);
|
|
}
|
|
|
|
foreach ($this->expenses as $expense) {
|
|
$expense->setVisible([
|
|
'documents',
|
|
]);
|
|
|
|
foreach ($expense->documents as $document) {
|
|
$document->setVisible([
|
|
'public_id',
|
|
'name',
|
|
]);
|
|
}
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* @param null $invoice_date
|
|
*
|
|
* @return mixed|null
|
|
*/
|
|
public function getDueDate($invoice_date = null)
|
|
{
|
|
if (! $this->is_recurring) {
|
|
return $this->due_date ? $this->due_date : null;
|
|
} else {
|
|
$now = time();
|
|
if ($invoice_date) {
|
|
// If $invoice_date is specified, all calculations are based on that date
|
|
if (is_numeric($invoice_date)) {
|
|
$now = $invoice_date;
|
|
} elseif (is_string($invoice_date)) {
|
|
$now = strtotime($invoice_date);
|
|
} elseif ($invoice_date instanceof \DateTime) {
|
|
$now = $invoice_date->getTimestamp();
|
|
}
|
|
}
|
|
|
|
if ($this->due_date && $this->due_date != '0000-00-00') {
|
|
// This is a recurring invoice; we're using a custom format here.
|
|
// The year is always 1998; January is 1st, 2nd, last day of the month.
|
|
// February is 1st Sunday after, 1st Monday after, ..., through 4th Saturday after.
|
|
$dueDateVal = strtotime($this->due_date);
|
|
$monthVal = (int) date('n', $dueDateVal);
|
|
$dayVal = (int) date('j', $dueDateVal);
|
|
$dueDate = false;
|
|
|
|
if ($monthVal == 1) {// January; day of month
|
|
$currentDay = (int) date('j', $now);
|
|
$lastDayOfMonth = (int) date('t', $now);
|
|
|
|
$dueYear = (int) date('Y', $now); // This year
|
|
$dueMonth = (int) date('n', $now); // This month
|
|
$dueDay = $dayVal; // The day specified for the invoice
|
|
|
|
if ($dueDay > $lastDayOfMonth) {
|
|
// No later than the end of the month
|
|
$dueDay = $lastDayOfMonth;
|
|
}
|
|
|
|
if ($currentDay >= $dueDay) {
|
|
// Wait until next month
|
|
// We don't need to handle the December->January wraparaound, since PHP handles month 13 as January of next year
|
|
$dueMonth++;
|
|
|
|
// Reset the due day
|
|
$dueDay = $dayVal;
|
|
$lastDayOfMonth = (int) date('t', mktime(0, 0, 0, $dueMonth, 1, $dueYear)); // The number of days in next month
|
|
|
|
// Check against the last day again
|
|
if ($dueDay > $lastDayOfMonth) {
|
|
// No later than the end of the month
|
|
$dueDay = $lastDayOfMonth;
|
|
}
|
|
}
|
|
|
|
$dueDate = mktime(0, 0, 0, $dueMonth, $dueDay, $dueYear);
|
|
} elseif ($monthVal == 2) {// February; day of week
|
|
$ordinals = ['first', 'second', 'third', 'fourth'];
|
|
$daysOfWeek = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];
|
|
|
|
$ordinalIndex = ceil($dayVal / 7) - 1; // 1-7 are "first"; 8-14 are "second", etc.
|
|
$dayOfWeekIndex = ($dayVal - 1) % 7; // 1,8,15,22 are Sunday, 2,9,16,23 are Monday, etc.
|
|
$dayStr = $ordinals[$ordinalIndex] . ' ' . $daysOfWeek[$dayOfWeekIndex]; // "first sunday", "first monday", etc.
|
|
|
|
$dueDate = strtotime($dayStr, $now);
|
|
}
|
|
|
|
if ($dueDate) {
|
|
return date('Y-m-d', $dueDate); // SQL format
|
|
}
|
|
} elseif ($this->client->payment_terms != 0) {
|
|
// No custom due date set for this invoice; use the client's payment terms
|
|
$days = $this->client->defaultDaysDue();
|
|
|
|
return date('Y-m-d', strtotime('+'.$days.' day', $now));
|
|
} elseif ($this->account->payment_terms != 0) {
|
|
$days = $this->account->defaultDaysDue();
|
|
|
|
return date('Y-m-d', strtotime('+'.$days.' day', $now));
|
|
}
|
|
}
|
|
|
|
// Couldn't calculate one
|
|
return null;
|
|
}
|
|
|
|
/**
|
|
* @param int $min
|
|
* @param int $max
|
|
*
|
|
* @return null
|
|
*/
|
|
public function getPrettySchedule($min = 0, $max = 10)
|
|
{
|
|
if (! $schedule = $this->getSchedule($max)) {
|
|
return null;
|
|
}
|
|
|
|
$dates = [];
|
|
|
|
for ($i = $min; $i < min($max, count($schedule)); $i++) {
|
|
$date = $schedule[$i];
|
|
$dateStart = $date->getStart();
|
|
$date = $this->account->formatDate($dateStart);
|
|
$dueDate = $this->getDueDate($dateStart);
|
|
|
|
if ($dueDate) {
|
|
$date .= ' <small>(' . trans('texts.due') . ' ' . $this->account->formatDate($dueDate) . ')</small>';
|
|
}
|
|
|
|
$dates[] = $date;
|
|
}
|
|
|
|
return implode('<br/>', $dates);
|
|
}
|
|
|
|
/**
|
|
* @return bool|string
|
|
*/
|
|
public function getPDFString($invitation = false, $decode = true)
|
|
{
|
|
if (! env('PHANTOMJS_CLOUD_KEY') && ! env('PHANTOMJS_BIN_PATH')) {
|
|
return false;
|
|
}
|
|
|
|
if (Utils::isTravis()) {
|
|
return false;
|
|
}
|
|
|
|
$invitation = $invitation ?: $this->invitations[0];
|
|
$link = $invitation->getLink('view', true, true);
|
|
$pdfString = false;
|
|
$phantomjsSecret = env('PHANTOMJS_SECRET');
|
|
$phantomjsLink = $link . "?phantomjs=true&phantomjs_secret={$phantomjsSecret}";
|
|
|
|
try {
|
|
if (env('PHANTOMJS_BIN_PATH')) {
|
|
// we see occasional 408 errors
|
|
for ($i=1; $i<=5; $i++) {
|
|
$pdfString = CurlUtils::phantom('GET', $phantomjsLink);
|
|
$pdfString = strip_tags($pdfString);
|
|
if (strpos($pdfString, 'data') === 0) {
|
|
break;
|
|
} else {
|
|
if (Utils::isNinjaDev() || Utils::isTravis()) {
|
|
Utils::logError('Failed to generate: ' . $i);
|
|
}
|
|
$pdfString = false;
|
|
sleep(2);
|
|
}
|
|
}
|
|
}
|
|
|
|
if (! $pdfString && ($key = env('PHANTOMJS_CLOUD_KEY'))) {
|
|
$url = "http://api.phantomjscloud.com/api/browser/v2/{$key}/?request=%7Burl:%22{$link}?phantomjs=true%26phantomjs_secret={$phantomjsSecret}%22,renderType:%22html%22%7D";
|
|
$pdfString = CurlUtils::get($url);
|
|
$pdfString = strip_tags($pdfString);
|
|
}
|
|
} catch (\Exception $exception) {
|
|
Utils::logError("PhantomJS - Failed to load {$phantomjsLink}: {$exception->getMessage()}");
|
|
return false;
|
|
}
|
|
|
|
if (! $pdfString || strlen($pdfString) < 200) {
|
|
Utils::logError("PhantomJS - Invalid response {$phantomjsLink}: {$pdfString}");
|
|
return false;
|
|
}
|
|
|
|
if ($decode) {
|
|
if ($pdf = Utils::decodePDF($pdfString)) {
|
|
return $pdf;
|
|
} else {
|
|
Utils::logError("PhantomJS - Unable to decode {$phantomjsLink}");
|
|
return false;
|
|
}
|
|
} else {
|
|
return $pdfString;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param $invoiceItem
|
|
* @param $invoiceTotal
|
|
*
|
|
* @return float|int
|
|
*/
|
|
public function getItemTaxable($invoiceItem, $invoiceTotal)
|
|
{
|
|
$total = $invoiceItem->qty * $invoiceItem->cost;
|
|
|
|
if ($this->discount != 0) {
|
|
if ($this->is_amount_discount) {
|
|
$total -= $invoiceTotal ? ($total / ($invoiceTotal + $this->discount) * $this->discount) : 0;
|
|
} else {
|
|
$total *= (100 - $this->discount) / 100;
|
|
}
|
|
}
|
|
|
|
if ($invoiceItem->discount != 0) {
|
|
if ($this->is_amount_discount) {
|
|
$total -= $invoiceItem->discount;
|
|
} else {
|
|
$total -= $total * $invoiceItem->discount / 100;
|
|
}
|
|
}
|
|
|
|
return round($total, 2);
|
|
}
|
|
|
|
/**
|
|
* @return float|int|mixed
|
|
*/
|
|
public function getTaxable()
|
|
{
|
|
$total = 0;
|
|
|
|
foreach ($this->invoice_items as $invoiceItem) {
|
|
$lineTotal = $invoiceItem->qty * $invoiceItem->cost;
|
|
|
|
if ($invoiceItem->discount != 0) {
|
|
if ($this->is_amount_discount) {
|
|
$lineTotal -= $invoiceItem->discount;
|
|
} else {
|
|
$lineTotal -= $lineTotal * $invoiceItem->discount / 100;
|
|
}
|
|
}
|
|
|
|
$total += $lineTotal;
|
|
}
|
|
|
|
if ($this->discount > 0) {
|
|
if ($this->is_amount_discount) {
|
|
$total -= $this->discount;
|
|
} else {
|
|
$total *= (100 - $this->discount) / 100;
|
|
$total = round($total, 2);
|
|
}
|
|
}
|
|
|
|
if ($this->custom_value1 && $this->custom_taxes1) {
|
|
$total += $this->custom_value1;
|
|
}
|
|
|
|
if ($this->custom_value2 && $this->custom_taxes2) {
|
|
$total += $this->custom_value2;
|
|
}
|
|
|
|
return $total;
|
|
}
|
|
|
|
// if $calculatePaid is true we'll loop through each payment to
|
|
// determine the sum, otherwise we'll use the cached paid_to_date amount
|
|
|
|
/**
|
|
* @param bool $calculatePaid
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getTaxes($calculatePaid = false)
|
|
{
|
|
$taxes = [];
|
|
$account = $this->account;
|
|
$taxable = $this->getTaxable();
|
|
$paidAmount = $this->getAmountPaid($calculatePaid);
|
|
|
|
if ($this->tax_name1) {
|
|
$invoiceTaxAmount = $this->taxAmount($taxable, $this->tax_rate1);
|
|
$invoicePaidAmount = floatval($this->amount) && $invoiceTaxAmount ? ($paidAmount / $this->amount * $invoiceTaxAmount) : 0;
|
|
$this->calculateTax($taxes, $this->tax_name1, $this->tax_rate1, $invoiceTaxAmount, $invoicePaidAmount);
|
|
}
|
|
if ($this->tax_name2) {
|
|
$invoiceTaxAmount = $this->taxAmount($taxable, $this->tax_rate2);
|
|
$invoicePaidAmount = floatval($this->amount) && $invoiceTaxAmount ? ($paidAmount / $this->amount * $invoiceTaxAmount) : 0;
|
|
$this->calculateTax($taxes, $this->tax_name2, $this->tax_rate2, $invoiceTaxAmount, $invoicePaidAmount);
|
|
}
|
|
|
|
foreach ($this->invoice_items as $invoiceItem) {
|
|
$itemTaxable = $this->getItemTaxable($invoiceItem, $taxable);
|
|
|
|
if ($invoiceItem->tax_name1) {
|
|
$itemTaxAmount = $this->taxAmount($itemTaxable, $invoiceItem->tax_rate1);
|
|
$itemPaidAmount = floatval($this->amount) && $itemTaxAmount ? ($paidAmount / $this->amount * $itemTaxAmount) : 0;
|
|
$this->calculateTax($taxes, $invoiceItem->tax_name1, $invoiceItem->tax_rate1, $itemTaxAmount, $itemPaidAmount);
|
|
}
|
|
if ($invoiceItem->tax_name2) {
|
|
$itemTaxAmount = $this->taxAmount($itemTaxable, $invoiceItem->tax_rate2);
|
|
$itemPaidAmount = floatval($this->amount) && $itemTaxAmount ? ($paidAmount / $this->amount * $itemTaxAmount) : 0;
|
|
$this->calculateTax($taxes, $invoiceItem->tax_name2, $invoiceItem->tax_rate2, $itemTaxAmount, $itemPaidAmount);
|
|
}
|
|
}
|
|
|
|
return $taxes;
|
|
}
|
|
|
|
public function getTaxTotal()
|
|
{
|
|
$total = 0;
|
|
|
|
foreach ($this->getTaxes() as $tax) {
|
|
$total += $tax['amount'];
|
|
}
|
|
|
|
return $total;
|
|
}
|
|
|
|
public function taxAmount($taxable, $rate)
|
|
{
|
|
$account = $this->account;
|
|
|
|
if ($account->inclusive_taxes) {
|
|
return round($taxable - ($taxable / (1 + ($rate / 100))), 2);
|
|
} else {
|
|
return round($taxable * ($rate / 100), 2);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @param $taxes
|
|
* @param $name
|
|
* @param $rate
|
|
* @param $amount
|
|
* @param $paid
|
|
*/
|
|
private function calculateTax(&$taxes, $name, $rate, $amount, $paid)
|
|
{
|
|
if (! $amount) {
|
|
return;
|
|
}
|
|
|
|
$amount = round($amount, 2);
|
|
$paid = round($paid, 2);
|
|
$key = $rate . ' ' . $name;
|
|
|
|
if (! isset($taxes[$key])) {
|
|
$taxes[$key] = [
|
|
'name' => $name,
|
|
'rate' => $rate + 0,
|
|
'amount' => 0,
|
|
'paid' => 0,
|
|
];
|
|
}
|
|
|
|
$taxes[$key]['amount'] += $amount;
|
|
$taxes[$key]['paid'] += $paid;
|
|
}
|
|
|
|
/**
|
|
* @return int
|
|
*/
|
|
public function countDocuments($expenses = false)
|
|
{
|
|
$count = $this->documents->count();
|
|
|
|
foreach ($this->expenses as $expense) {
|
|
if ($expense->invoice_documents) {
|
|
$count += $expense->documents->count();
|
|
}
|
|
}
|
|
|
|
if ($expenses) {
|
|
foreach ($expenses as $expense) {
|
|
if ($expense->invoice_documents) {
|
|
$count += $expense->documents->count();
|
|
}
|
|
}
|
|
}
|
|
|
|
return $count;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function hasDocuments()
|
|
{
|
|
if ($this->documents->count()) {
|
|
return true;
|
|
}
|
|
|
|
if ($this->account->defaultDocuments->count()) {
|
|
return true;
|
|
}
|
|
|
|
return $this->hasExpenseDocuments();
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function hasExpenseDocuments()
|
|
{
|
|
foreach ($this->expenses as $expense) {
|
|
if ($expense->invoice_documents && $expense->documents->count()) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @return bool
|
|
*/
|
|
public function getAutoBillEnabled()
|
|
{
|
|
if (! $this->is_recurring) {
|
|
$recurInvoice = $this->recurring_invoice;
|
|
} else {
|
|
$recurInvoice = $this;
|
|
}
|
|
|
|
if (! $recurInvoice || $this->subEntityType() == ENTITY_RECURRING_QUOTE) {
|
|
return false;
|
|
}
|
|
|
|
return $recurInvoice->auto_bill == AUTO_BILL_ALWAYS || ($recurInvoice->auto_bill != AUTO_BILL_OFF && $recurInvoice->client_enable_auto_bill);
|
|
}
|
|
|
|
public static function getStatuses($entityType = false)
|
|
{
|
|
$statuses = [];
|
|
|
|
if ($entityType == ENTITY_RECURRING_INVOICE || $entityType == ENTITY_RECURRING_QUOTE) {
|
|
return $statuses;
|
|
}
|
|
|
|
foreach (\Cache::get('invoiceStatus') as $status) {
|
|
if ($entityType == ENTITY_QUOTE) {
|
|
if (in_array($status->id, [INVOICE_STATUS_PAID, INVOICE_STATUS_PARTIAL])) {
|
|
continue;
|
|
}
|
|
} elseif ($entityType == ENTITY_INVOICE) {
|
|
if (in_array($status->id, [INVOICE_STATUS_APPROVED])) {
|
|
continue;
|
|
}
|
|
}
|
|
|
|
$statuses[$status->id] = trans('texts.status_' . strtolower($status->name));
|
|
}
|
|
|
|
if ($entityType == ENTITY_INVOICE) {
|
|
$statuses[INVOICE_STATUS_UNPAID] = trans('texts.unpaid');
|
|
$statuses[INVOICE_STATUS_OVERDUE] = trans('texts.past_due');
|
|
}
|
|
|
|
return $statuses;
|
|
}
|
|
|
|
public function emailHistory()
|
|
{
|
|
return Activity::scope()
|
|
->with(['contact'])
|
|
->whereInvoiceId($this->id)
|
|
->whereIn('activity_type_id', [ACTIVITY_TYPE_EMAIL_INVOICE, ACTIVITY_TYPE_EMAIL_QUOTE])
|
|
->orderBy('id', 'desc')
|
|
->get();
|
|
}
|
|
|
|
public function getDueDateLabel()
|
|
{
|
|
return $this->isType(INVOICE_TYPE_QUOTE) ? 'valid_until' : 'due_date';
|
|
}
|
|
|
|
public function onlyHasTasks()
|
|
{
|
|
foreach ($this->invoice_items as $item) {
|
|
if ($item->invoice_item_type_id != INVOICE_ITEM_TYPE_TASK) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
public function hasTaxes()
|
|
{
|
|
if ($this->tax_name1 || $this->tax_rate1) {
|
|
return true;
|
|
}
|
|
|
|
if ($this->tax_name2 || $this->tax_rate2) {
|
|
return false;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
public function isLocked()
|
|
{
|
|
if (! config('ninja.lock_sent_invoices')) {
|
|
return false;
|
|
}
|
|
|
|
return $this->isSent() && ! $this->is_recurring;
|
|
}
|
|
|
|
public function getInvoiceLinkForQuote($contactId)
|
|
{
|
|
if (! $this->quote_invoice_id) {
|
|
return false;
|
|
}
|
|
|
|
$invoice = static::scope($this->quote_invoice_id, $this->account_id)->with('invitations')->first();
|
|
|
|
if (! $invoice) {
|
|
return false;
|
|
}
|
|
|
|
foreach ($invoice->invitations as $invitation) {
|
|
if ($invitation->contact_id == $contactId) {
|
|
return $invitation->getLink();
|
|
}
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|
|
|
|
Invoice::creating(function ($invoice) {
|
|
if (! $invoice->is_recurring) {
|
|
$account = $invoice->account;
|
|
if ($invoice->amount >= 0) {
|
|
$account->incrementCounter($invoice);
|
|
} elseif ($account->credit_number_counter > 0) {
|
|
$account->incrementCounter(new Credit());
|
|
}
|
|
}
|
|
});
|
|
|
|
Invoice::created(function ($invoice) {
|
|
if ($invoice->isType(INVOICE_TYPE_QUOTE)) {
|
|
event(new QuoteWasCreated($invoice));
|
|
} else {
|
|
event(new InvoiceWasCreated($invoice));
|
|
}
|
|
});
|
|
|
|
Invoice::updating(function ($invoice) {
|
|
if ($invoice->isType(INVOICE_TYPE_QUOTE)) {
|
|
event(new QuoteWasUpdated($invoice));
|
|
} else {
|
|
event(new InvoiceWasUpdated($invoice));
|
|
}
|
|
});
|