1
0
mirror of https://github.com/invoiceninja/invoiceninja.git synced 2024-09-21 17:01:33 +02:00
invoiceninja/app/Models/RecurringInvoice.php

809 lines
34 KiB
PHP
Raw Normal View History

2019-04-23 14:22:13 +02:00
<?php
2019-05-11 05:32:07 +02:00
/**
* Invoice Ninja (https://invoiceninja.com).
2019-05-11 05:32:07 +02:00
*
* @link https://github.com/invoiceninja/invoiceninja source repository
*
2023-01-28 23:21:40 +01:00
* @copyright Copyright (c) 2023. Invoice Ninja LLC (https://invoiceninja.com)
2019-05-11 05:32:07 +02:00
*
2021-06-16 08:58:16 +02:00
* @license https://www.elastic.co/licensing/elastic-license
2019-05-11 05:32:07 +02:00
*/
2019-04-23 14:22:13 +02:00
namespace App\Models;
2020-09-13 12:20:11 +02:00
use App\Helpers\Invoice\InvoiceSum;
use App\Helpers\Invoice\InvoiceSumInclusive;
use App\Models\Presenters\RecurringInvoicePresenter;
2020-09-24 02:57:44 +02:00
use App\Services\Recurring\RecurringService;
use App\Utils\Traits\MakesDates;
2019-04-23 14:22:13 +02:00
use App\Utils\Traits\MakesHash;
2020-09-14 14:13:15 +02:00
use App\Utils\Traits\Recurring\HasRecurrence;
2019-04-23 14:22:13 +02:00
use Illuminate\Database\Eloquent\SoftDeletes;
2019-05-23 08:15:06 +02:00
use Illuminate\Support\Carbon;
use Laracasts\Presenter\PresentableTrait;
2019-04-23 14:22:13 +02:00
2019-05-03 00:29:04 +02:00
/**
* Class for Recurring Invoices.
2023-03-08 08:33:42 +01:00
*
* @property int $id
* @property int $client_id
* @property int $user_id
* @property int|null $assigned_user_id
* @property int $company_id
* @property int|null $project_id
* @property int|null $vendor_id
* @property int $status_id
* @property string|null $number
* @property float $discount
* @property int $is_amount_discount
* @property string|null $po_number
* @property string|null $date
* @property string|null $due_date
* @property int $is_deleted
* @property object|null $line_items
* @property object|null $backup
* @property string|null $footer
* @property string|null $public_notes
* @property string|null $private_notes
* @property string|null $terms
* @property string|null $tax_name1
* @property string $tax_rate1
* @property string|null $tax_name2
* @property string $tax_rate2
* @property string|null $tax_name3
* @property string $tax_rate3
* @property string $total_taxes
* @property string|null $custom_value1
* @property string|null $custom_value2
* @property string|null $custom_value3
* @property string|null $custom_value4
* @property string $amount
* @property string $balance
* @property string|null $partial
* @property string|null $last_viewed
* @property int $frequency_id
* @property string|null $last_sent_date
* @property string|null $next_send_date
* @property int|null $remaining_cycles
* @property int|null $created_at
* @property int|null $updated_at
* @property int|null $deleted_at
* @property string $auto_bill
* @property int $auto_bill_enabled
* @property int|null $design_id
* @property int $uses_inclusive_taxes
* @property string|null $custom_surcharge1
* @property string|null $custom_surcharge2
* @property string|null $custom_surcharge3
* @property string|null $custom_surcharge4
* @property int $custom_surcharge_tax1
* @property int $custom_surcharge_tax2
* @property int $custom_surcharge_tax3
* @property int $custom_surcharge_tax4
* @property string|null $due_date_days
* @property string|null $partial_due_date
* @property string $exchange_rate
* @property string $paid_to_date
* @property int|null $subscription_id
* @property string|null $next_send_date_client
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
* @property-read int|null $activities_count
* @property-read \App\Models\User|null $assigned_user
* @property-read \App\Models\Client $client
* @property-read \App\Models\Company $company
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read int|null $documents_count
* @property-read mixed $hashed_id
* @property-read mixed $status
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read int|null $history_count
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read int|null $invitations_count
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
* @property-read int|null $invoices_count
* @property-read \App\Models\Project|null $project
* @property-read \App\Models\Subscription|null $subscription
* @property-read \App\Models\User $user
* @property-read \App\Models\Vendor|null $vendor
* @method static \Illuminate\Database\Eloquent\Builder|BaseModel company()
* @method static \Illuminate\Database\Eloquent\Builder|BaseModel exclude($columns)
* @method static \Database\Factories\RecurringInvoiceFactory factory($count = null, $state = [])
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice filter(\App\Filters\QueryFilters $filters)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice newModelQuery()
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice newQuery()
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice onlyTrashed()
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice query()
* @method static \Illuminate\Database\Eloquent\Builder|BaseModel scope()
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereAmount($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereAssignedUserId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereAutoBill($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereAutoBillEnabled($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereBackup($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereBalance($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereClientId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCompanyId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCreatedAt($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurcharge1($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurcharge2($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurcharge3($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurcharge4($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurchargeTax1($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurchargeTax2($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurchargeTax3($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomSurchargeTax4($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomValue1($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomValue2($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomValue3($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereCustomValue4($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereDate($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereDeletedAt($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereDesignId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereDiscount($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereDueDate($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereDueDateDays($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereExchangeRate($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereFooter($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereFrequencyId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereIsAmountDiscount($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereIsDeleted($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereLastSentDate($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereLastViewed($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereLineItems($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereNextSendDate($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereNextSendDateClient($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereNumber($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice wherePaidToDate($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice wherePartial($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice wherePartialDueDate($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice wherePoNumber($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice wherePrivateNotes($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereProjectId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice wherePublicNotes($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereRemainingCycles($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereStatusId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereSubscriptionId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTaxName1($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTaxName2($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTaxName3($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTaxRate1($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTaxRate2($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTaxRate3($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTerms($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereTotalTaxes($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereUpdatedAt($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereUserId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereUsesInclusiveTaxes($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereVendorId($value)
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice withTrashed()
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice withoutTrashed()
2023-03-16 05:20:38 +01:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
2023-03-21 12:37:06 +01:00
* @property int $is_proforma
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
* @method static \Illuminate\Database\Eloquent\Builder|RecurringInvoice whereIsProforma($value)
2023-03-24 02:12:12 +01:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
2023-03-24 08:02:34 +01:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
2023-04-10 09:37:40 +02:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
2023-04-13 07:39:12 +02:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
2023-03-29 04:13:50 +02:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
2023-03-29 05:23:06 +02:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
2023-03-24 08:02:34 +01:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
2023-03-27 05:47:01 +02:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
2023-03-27 22:47:07 +02:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Activity> $activities
2023-03-24 02:12:12 +01:00
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Document> $documents
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Backup> $history
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\RecurringInvoiceInvitation> $invitations
* @property-read \Illuminate\Database\Eloquent\Collection<int, \App\Models\Invoice> $invoices
2023-03-08 08:33:42 +01:00
* @mixin \Eloquent
2019-05-03 00:29:04 +02:00
*/
2019-04-23 14:22:13 +02:00
class RecurringInvoice extends BaseModel
{
use MakesHash;
use SoftDeletes;
use Filterable;
use MakesDates;
2020-09-14 14:13:15 +02:00
use HasRecurrence;
use PresentableTrait;
protected $presenter = RecurringInvoicePresenter::class;
2020-09-14 14:13:15 +02:00
2019-05-03 00:29:04 +02:00
/**
* Invoice Statuses.
2019-05-03 00:29:04 +02:00
*/
2020-09-23 02:16:19 +02:00
const STATUS_DRAFT = 1;
2020-09-23 02:16:19 +02:00
const STATUS_ACTIVE = 2;
2020-09-23 02:16:19 +02:00
const STATUS_PAUSED = 3;
2020-09-23 02:16:19 +02:00
const STATUS_COMPLETED = 4;
2019-05-03 09:35:49 +02:00
const STATUS_PENDING = -1;
2019-05-03 00:29:04 +02:00
/**
2020-10-07 02:20:28 +02:00
* Invoice Frequencies.
2019-05-03 00:29:04 +02:00
*/
const FREQUENCY_DAILY = 1;
const FREQUENCY_WEEKLY = 2;
const FREQUENCY_TWO_WEEKS = 3;
const FREQUENCY_FOUR_WEEKS = 4;
const FREQUENCY_MONTHLY = 5;
const FREQUENCY_TWO_MONTHS = 6;
const FREQUENCY_THREE_MONTHS = 7;
const FREQUENCY_FOUR_MONTHS = 8;
const FREQUENCY_SIX_MONTHS = 9;
const FREQUENCY_ANNUALLY = 10;
const FREQUENCY_TWO_YEARS = 11;
const FREQUENCY_THREE_YEARS = 12;
2019-05-03 00:29:04 +02:00
2019-05-05 02:49:01 +02:00
const RECURS_INDEFINITELY = -1;
protected $fillable = [
'client_id',
'project_id',
'number',
2019-07-03 11:58:34 +02:00
'discount',
'is_amount_discount',
'po_number',
'date',
'due_date',
2020-09-13 12:20:11 +02:00
'due_date_days',
'line_items',
'footer',
2019-07-03 11:58:34 +02:00
'public_notes',
'private_notes',
'terms',
'tax_name1',
'tax_name2',
'tax_name3',
'tax_rate1',
'tax_rate2',
'tax_rate3',
'custom_value1',
'custom_value2',
'custom_value3',
'custom_value4',
'amount',
2019-07-03 11:58:34 +02:00
'partial',
'frequency_id',
2020-09-16 12:08:51 +02:00
'next_send_date',
'remaining_cycles',
2020-09-23 02:16:19 +02:00
'auto_bill',
2020-09-24 05:40:13 +02:00
'auto_bill_enabled',
'design_id',
2021-02-23 02:17:46 +01:00
'custom_surcharge1',
'custom_surcharge2',
'custom_surcharge3',
'custom_surcharge4',
'custom_surcharge_tax1',
'custom_surcharge_tax2',
'custom_surcharge_tax3',
'custom_surcharge_tax4',
'design_id',
'assigned_user_id',
'exchange_rate',
'vendor_id',
'next_send_date_client',
'uses_inclusive_taxes',
];
2019-04-23 14:22:13 +02:00
protected $casts = [
'settings' => 'object',
'line_items' => 'object',
'backup' => 'object',
'updated_at' => 'timestamp',
'created_at' => 'timestamp',
'deleted_at' => 'timestamp',
2019-04-23 14:22:13 +02:00
];
2019-08-15 13:10:02 +02:00
protected $appends = [
'hashed_id',
'status',
2019-05-03 00:29:04 +02:00
];
2020-07-23 05:55:11 +02:00
protected $touches = [];
public function getEntityType()
{
return self::class;
}
public function getDateAttribute($value)
{
if (! empty($value)) {
return (new Carbon($value))->format('Y-m-d');
}
return $value;
}
public function getDueDateAttribute($value)
{
if (! empty($value)) {
return (new Carbon($value))->format('Y-m-d');
}
return $value;
}
public function getPartialDueDateAttribute($value)
{
if (! empty($value)) {
return (new Carbon($value))->format('Y-m-d');
}
return $value;
}
public function vendor()
{
return $this->belongsTo(Vendor::class);
}
2021-05-10 10:27:51 +02:00
public function activities()
{
2021-08-22 08:23:00 +02:00
return $this->hasMany(Activity::class)->orderBy('id', 'DESC')->take(50);
2021-05-10 10:27:51 +02:00
}
public function history()
{
return $this->hasManyThrough(Backup::class, Activity::class);
}
2019-04-23 14:22:13 +02:00
public function company()
{
return $this->belongsTo(Company::class);
}
2019-05-03 00:29:04 +02:00
public function client()
{
return $this->belongsTo(Client::class)->withTrashed();
2019-05-03 00:29:04 +02:00
}
public function project()
{
return $this->belongsTo(Project::class)->withTrashed();
}
2019-04-23 14:22:13 +02:00
public function user()
{
return $this->belongsTo(User::class)->withTrashed();
2019-04-23 14:22:13 +02:00
}
public function assigned_user()
{
return $this->belongsTo(User::class, 'assigned_user_id', 'id')->withTrashed();
}
public function invoices()
{
2021-04-13 11:34:59 +02:00
return $this->hasMany(Invoice::class, 'recurring_id', 'id')->withTrashed();
}
2019-04-23 14:22:13 +02:00
public function invitations()
{
2020-09-18 09:04:28 +02:00
return $this->hasMany(RecurringInvoiceInvitation::class);
2019-04-23 14:22:13 +02:00
}
2019-05-23 07:08:31 +02:00
2020-09-17 23:49:22 +02:00
public function documents()
{
return $this->morphMany(Document::class, 'documentable');
}
2019-08-15 13:10:02 +02:00
public function getStatusAttribute()
{
2020-11-25 15:19:52 +01:00
if ($this->status_id == self::STATUS_ACTIVE && Carbon::parse($this->next_send_date)->isFuture()) {
return self::STATUS_PENDING;
2020-11-25 15:19:52 +01:00
} else {
2019-08-15 13:10:02 +02:00
return $this->status_id;
2020-11-25 15:19:52 +01:00
}
2019-08-15 13:10:02 +02:00
}
2019-05-23 08:15:06 +02:00
public function nextSendDate() :?Carbon
2019-05-23 07:08:31 +02:00
{
if (! $this->next_send_date_client) {
return null;
}
2021-11-16 04:14:15 +01:00
2021-06-10 23:34:03 +02:00
$offset = $this->client->timezone_offset();
/* If this setting is enabled, the recurring invoice may be set in the past */
if ($this->company->stop_on_unpaid_recurring) {
2023-02-16 02:36:09 +01:00
/* Lets set the next send date to now so we increment from today, rather than in the past*/
if (Carbon::parse($this->next_send_date)->lt(now()->subDays(3))) {
$this->next_send_date_client = now()->format('Y-m-d');
}
}
switch ($this->frequency_id) {
2021-01-02 00:01:33 +01:00
case self::FREQUENCY_DAILY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addDay()->addSeconds($offset);
case self::FREQUENCY_WEEKLY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addWeek()->addSeconds($offset);
case self::FREQUENCY_TWO_WEEKS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addWeeks(2)->addSeconds($offset);
case self::FREQUENCY_FOUR_WEEKS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addWeeks(4)->addSeconds($offset);
case self::FREQUENCY_MONTHLY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthNoOverflow()->addSeconds($offset);
case self::FREQUENCY_TWO_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(2)->addSeconds($offset);
case self::FREQUENCY_THREE_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(3)->addSeconds($offset);
case self::FREQUENCY_FOUR_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(4)->addSeconds($offset);
case self::FREQUENCY_SIX_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(6)->addSeconds($offset);
case self::FREQUENCY_ANNUALLY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addYear()->addSeconds($offset);
case self::FREQUENCY_TWO_YEARS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addYears(2)->addSeconds($offset);
case self::FREQUENCY_THREE_YEARS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addYears(3)->addSeconds($offset);
2019-05-23 07:08:31 +02:00
default:
2019-05-23 08:15:06 +02:00
return null;
}
2019-05-23 07:08:31 +02:00
}
public function nextSendDateClient() :?Carbon
{
if (! $this->next_send_date_client) {
return null;
}
/* If this setting is enabled, the recurring invoice may be set in the past */
if ($this->company->stop_on_unpaid_recurring) {
2023-02-16 02:36:09 +01:00
/* Lets set the next send date to now so we increment from today, rather than in the past*/
if (Carbon::parse($this->next_send_date)->lt(now()->subDays(3))) {
$this->next_send_date_client = now()->format('Y-m-d');
}
}
switch ($this->frequency_id) {
case self::FREQUENCY_DAILY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addDay();
case self::FREQUENCY_WEEKLY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addWeek();
case self::FREQUENCY_TWO_WEEKS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addWeeks(2);
case self::FREQUENCY_FOUR_WEEKS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addWeeks(4);
case self::FREQUENCY_MONTHLY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthNoOverflow();
case self::FREQUENCY_TWO_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(2);
case self::FREQUENCY_THREE_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(3);
case self::FREQUENCY_FOUR_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(4);
case self::FREQUENCY_SIX_MONTHS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addMonthsNoOverflow(6);
case self::FREQUENCY_ANNUALLY:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addYear();
case self::FREQUENCY_TWO_YEARS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addYears(2);
case self::FREQUENCY_THREE_YEARS:
return Carbon::parse($this->next_send_date_client)->startOfDay()->addYears(3);
default:
return null;
}
}
2020-09-13 12:20:11 +02:00
public function nextDateByFrequency($date)
{
2021-06-11 00:20:46 +02:00
$offset = $this->client->timezone_offset();
2020-09-13 12:20:11 +02:00
switch ($this->frequency_id) {
2021-01-02 00:01:33 +01:00
case self::FREQUENCY_DAILY:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addDay()->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_WEEKLY:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addWeek()->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_TWO_WEEKS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addWeeks(2)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_FOUR_WEEKS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addWeeks(4)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_MONTHLY:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addMonthNoOverflow()->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_TWO_MONTHS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addMonthsNoOverflow(2)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_THREE_MONTHS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addMonthsNoOverflow(3)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_FOUR_MONTHS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addMonthsNoOverflow(4)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_SIX_MONTHS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->addMonthsNoOverflow(6)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_ANNUALLY:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addYear()->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_TWO_YEARS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addYears(2)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
case self::FREQUENCY_THREE_YEARS:
2021-06-11 00:20:46 +02:00
return Carbon::parse($date)->startOfDay()->addYears(3)->addSeconds($offset);
2020-09-13 12:20:11 +02:00
default:
return null;
}
}
2019-05-23 08:15:06 +02:00
public function remainingCycles() : int
2019-05-23 07:08:31 +02:00
{
if ($this->remaining_cycles == 0) {
2019-05-23 07:08:31 +02:00
return 0;
2020-11-25 15:19:52 +01:00
} elseif ($this->remaining_cycles == -1) {
2020-09-12 12:33:12 +02:00
return -1;
2020-11-25 15:19:52 +01:00
} else {
2019-05-23 07:08:31 +02:00
return $this->remaining_cycles - 1;
}
2019-05-23 07:08:31 +02:00
}
2019-05-23 08:15:06 +02:00
public function setCompleted() : void
2019-05-23 07:08:31 +02:00
{
$this->status_id = self::STATUS_COMPLETED;
$this->next_send_date = null;
2019-05-23 08:15:06 +02:00
$this->remaining_cycles = 0;
2019-05-23 07:08:31 +02:00
$this->save();
}
2019-08-15 13:10:02 +02:00
public static function badgeForStatus(int $status)
{
switch ($status) {
case self::STATUS_DRAFT:
2019-08-15 13:10:02 +02:00
return '<h4><span class="badge badge-light">'.ctrans('texts.draft').'</span></h4>';
break;
case self::STATUS_PENDING:
2020-09-23 02:16:19 +02:00
return '<h4><span class="badge badge-primary">'.ctrans('texts.pending').'</span></h4>';
2019-08-15 13:10:02 +02:00
break;
case self::STATUS_ACTIVE:
2020-09-23 02:16:19 +02:00
return '<h4><span class="badge badge-primary">'.ctrans('texts.active').'</span></h4>';
2019-08-15 13:10:02 +02:00
break;
case self::STATUS_COMPLETED:
2019-08-15 13:10:02 +02:00
return '<h4><span class="badge badge-success">'.ctrans('texts.status_completed').'</span></h4>';
break;
2020-09-23 02:16:19 +02:00
case self::STATUS_PAUSED:
return '<h4><span class="badge badge-danger">'.ctrans('texts.paused').'</span></h4>';
break;
2019-08-15 13:10:02 +02:00
default:
// code...
2019-08-15 13:10:02 +02:00
break;
}
}
2022-04-27 09:21:55 +02:00
public static function stringStatus(int $status)
{
switch ($status) {
case self::STATUS_DRAFT:
return ctrans('texts.draft');
break;
case self::STATUS_PENDING:
return ctrans('texts.pending');
break;
case self::STATUS_ACTIVE:
return ctrans('texts.active');
break;
case self::STATUS_COMPLETED:
return ctrans('texts.status_completed');
break;
case self::STATUS_PAUSED:
return ctrans('texts.paused');
break;
default:
// code...
break;
}
}
2019-08-15 13:10:02 +02:00
public static function frequencyForKey(int $frequency_id) :string
{
switch ($frequency_id) {
case self::FREQUENCY_DAILY:
return ctrans('texts.freq_daily');
break;
case self::FREQUENCY_WEEKLY:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_weekly');
break;
case self::FREQUENCY_TWO_WEEKS:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_two_weeks');
break;
case self::FREQUENCY_FOUR_WEEKS:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_four_weeks');
break;
case self::FREQUENCY_MONTHLY:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_monthly');
break;
case self::FREQUENCY_TWO_MONTHS:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_two_months');
break;
case self::FREQUENCY_THREE_MONTHS:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_three_months');
break;
case self::FREQUENCY_FOUR_MONTHS:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_four_months');
break;
case self::FREQUENCY_SIX_MONTHS:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_six_months');
break;
case self::FREQUENCY_ANNUALLY:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_annually');
break;
case self::FREQUENCY_TWO_YEARS:
2019-08-15 13:10:02 +02:00
return ctrans('texts.freq_two_years');
break;
2022-03-28 23:04:04 +02:00
case self::FREQUENCY_THREE_YEARS:
return ctrans('texts.freq_three_years');
break;
2019-08-15 13:10:02 +02:00
default:
2022-03-28 23:04:04 +02:00
return '';
2019-08-15 13:10:02 +02:00
break;
}
}
2020-07-01 13:33:42 +02:00
2020-09-13 12:20:11 +02:00
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();
}
2020-11-25 15:19:52 +01:00
/*
* Important to note when playing with carbon dates - in order
2020-09-13 12:20:11 +02:00
* not to modify the original instance, always use a `->copy()`
2020-11-25 15:19:52 +01:00
*
2020-09-13 12:20:11 +02:00
*/
2020-07-01 13:33:42 +02:00
public function recurringDates()
{
2020-11-25 15:19:52 +01:00
/* Return early if nothing to send back! */
if ($this->status_id == self::STATUS_COMPLETED ||
2020-09-13 12:20:11 +02:00
$this->remaining_cycles == 0 ||
! $this->next_send_date) {
2020-09-12 12:33:12 +02:00
return [];
}
/* Endless - lets send 10 back*/
$iterations = $this->remaining_cycles;
2020-11-25 15:19:52 +01:00
if ($this->remaining_cycles == -1) {
2020-09-12 12:33:12 +02:00
$iterations = 10;
2020-11-25 15:19:52 +01:00
}
$data = [];
if (! Carbon::parse($this->next_send_date_client)) {
return $data;
2021-01-04 13:38:00 +01:00
}
2020-09-12 12:33:12 +02:00
$next_send_date = Carbon::parse($this->next_send_date_client)->copy();
for ($x = 0; $x < $iterations; $x++) {
2020-09-24 13:30:46 +02:00
// we don't add the days... we calc the day of the month!!
$next_due_date = $this->calculateDueDate($next_send_date->copy()->format('Y-m-d'));
2020-10-06 03:36:25 +02:00
$next_due_date_string = $next_due_date ? $next_due_date->format('Y-m-d') : '';
2020-09-13 12:20:11 +02:00
$next_send_date = Carbon::parse($next_send_date);
2020-09-12 12:33:12 +02:00
2020-09-13 12:20:11 +02:00
$data[] = [
2020-11-25 15:19:52 +01:00
'send_date' => $next_send_date->format('Y-m-d'),
'due_date' => $next_due_date_string,
2020-09-13 12:20:11 +02:00
];
2020-09-12 12:33:12 +02:00
/* Fixes the timeshift in case the offset is negative which cause a infinite loop due to UTC +0*/
if ($this->client->timezone_offset() < 0) {
$next_send_date = $this->nextDateByFrequency($next_send_date->addDay()->format('Y-m-d'));
} else {
$next_send_date = $this->nextDateByFrequency($next_send_date->format('Y-m-d'));
}
2020-09-13 12:20:11 +02:00
}
return $data;
2020-07-01 13:33:42 +02:00
}
2020-09-12 12:33:12 +02:00
2020-11-25 15:19:52 +01:00
public function calculateDueDate($date)
2020-09-14 13:11:46 +02:00
{
2020-09-14 14:13:15 +02:00
switch ($this->due_date_days) {
case 'terms':
case '':
case '0':
2020-09-14 13:11:46 +02:00
return $this->calculateDateFromTerms($date);
break;
2023-02-16 02:36:09 +01:00
case 'on_receipt':
return Carbon::parse($date)->copy();
break;
2020-09-14 13:11:46 +02:00
default:
2020-09-14 14:13:15 +02:00
return $this->setDayOfMonth($date, $this->due_date_days);
2020-09-14 13:11:46 +02:00
break;
}
}
/**
* Calculates a date based on the client payment terms.
2020-11-25 15:19:52 +01:00
*
2020-09-14 13:11:46 +02:00
* @param Carbon $date A given date
* @return null|Carbon The date
2020-09-14 13:11:46 +02:00
*/
2020-11-25 15:19:52 +01:00
public function calculateDateFromTerms($date)
2020-09-14 13:11:46 +02:00
{
2020-09-24 13:30:46 +02:00
$new_date = Carbon::parse($date);
2020-09-14 13:11:46 +02:00
$client_payment_terms = $this->client->getSetting('payment_terms');
2020-11-25 15:19:52 +01:00
if ($client_payment_terms == '') {//no due date! return null;
2020-09-14 13:11:46 +02:00
return null;
2020-11-25 15:19:52 +01:00
}
2020-09-14 13:11:46 +02:00
2020-09-24 13:30:46 +02:00
return $new_date->addDays($client_payment_terms); //add the number of days in the payment terms to the date
2020-09-14 13:11:46 +02:00
}
2020-09-24 02:57:44 +02:00
/**
* service
*
* @return RecurringService
2020-09-24 02:57:44 +02:00
*/
public function service() :RecurringService
{
return new RecurringService($this);
}
public function subscription(): \Illuminate\Database\Eloquent\Relations\BelongsTo
{
return $this->belongsTo(Subscription::class);
}
2022-04-06 02:38:01 +02:00
public function translate_entity()
{
return ctrans('texts.recurring_invoice');
}
2019-04-23 14:22:13 +02:00
}