osb/app/Models/Invoice.php

450 lines
9.8 KiB
PHP
Raw Normal View History

2018-05-20 12:53:14 +00:00
<?php
namespace App\Models;
2020-04-01 12:35:06 +00:00
use Carbon\Carbon;
2020-05-25 07:45:17 +00:00
use Clarkeash\Doorman\Facades\Doorman;
use Clarkeash\Doorman\Models\Invite;
2018-05-20 12:53:14 +00:00
use Illuminate\Database\Eloquent\Model;
2020-05-25 07:45:17 +00:00
use Illuminate\Support\Arr;
2024-07-09 10:17:30 +00:00
use Illuminate\Support\Collection;
use Leenooks\Casts\LeenooksCarbon;
2021-06-29 06:36:34 +00:00
use Leenooks\Traits\ScopeActive;
use App\Casts\CollectionOrNull;
2021-06-29 06:36:34 +00:00
use App\Interfaces\IDs;
use App\Traits\PushNew;
2020-04-01 12:35:06 +00:00
2021-06-29 06:36:34 +00:00
/**
* Class Invoice
* Invoices that belong to an Account
*
* Attributes for services:
2024-07-09 10:17:30 +00:00
* + created_at : Date the invoice was created
2021-06-29 06:36:34 +00:00
* + due : Balance due on an invoice
2024-07-09 10:17:30 +00:00
* + due_at : Date the invoice is due
2021-06-29 06:36:34 +00:00
* + lid : Local ID for invoice
* + paid : Total of payments received (excluding pending)
* + paid_date : Date the invoice was paid in full
* + paid_pending : Total of pending payments received
* + sid : System ID for invoice
* + sub_total : Invoice sub-total before taxes
2024-07-09 10:17:30 +00:00
* + tax_total : Invoices total of taxes
2021-06-29 06:36:34 +00:00
* + total : Invoice total
*
* @package App\Models
*/
class Invoice extends Model implements IDs
2018-05-20 12:53:14 +00:00
{
use PushNew,ScopeActive;
2021-06-29 06:36:34 +00:00
2022-06-13 09:58:53 +00:00
protected $casts = [
2024-07-05 06:38:31 +00:00
'created_at' => 'datetime:Y-m-d',
'due_at' => LeenooksCarbon::class,
'reminders' => CollectionOrNull::class,
2024-07-05 06:38:31 +00:00
'_paid_at' => 'datetime:Y-m-d',
];
public const BILL_WEEKLY = 0;
public const BILL_MONTHLY = 1;
public const BILL_QUARTERLY = 2;
public const BILL_SEMI_YEARLY = 3;
public const BILL_YEARLY = 4;
public const BILL_TWOYEARS = 5;
public const BILL_THREEYEARS = 6;
public const BILL_FOURYEARS = 7;
public const BILL_FIVEYEARS = 8;
/* Our available billing periods */
public const billing_periods = [
self::BILL_WEEKLY => [
'name' => 'Weekly',
'interval' => 0.25,
],
self::BILL_MONTHLY => [
'name' => 'Monthly',
'interval' => 1,
],
self::BILL_QUARTERLY => [
'name' => 'Quarterly',
'interval' => 3,
],
self::BILL_SEMI_YEARLY => [
'name' => 'Semi-Annually',
'interval' => 6,
],
self::BILL_YEARLY => [
'name' => 'Annually',
'interval' => 12,
],
self::BILL_TWOYEARS => [
'name' => 'Two years',
'interval' => 24,
],
self::BILL_THREEYEARS => [
'name' => 'Three Years',
'interval' => 36,
],
self::BILL_FOURYEARS => [
'name' => 'Four Years',
'interval' => 48,
],
SELF::BILL_FIVEYEARS => [
'name' => 'Five Years',
'interval' => 60,
],
];
// Array of items that can be updated with PushNew
protected $pushable = ['items'];
2020-02-10 11:07:46 +00:00
protected $with = [
2024-07-09 10:17:30 +00:00
'items_active:id,start_at,stop_at,quantity,price_base,discount_amt,item_type,product_id,service_id,invoice_id',
'items_active.taxes:id,invoice_item_id,amount,tax_id',
'items_active.product:id',
'items_active.product.translate:id,product_id,name_short,name_detail',
'payment_items_active:id,amount,payment_id,invoice_id',
2020-02-10 11:07:46 +00:00
];
/* STATIC METHODS */
/**
* This works out what multiplier to use to change billing periods
*
* @param int $source
* @param int $target
* @return float
*/
public static function billing_change(int $source,int $target): float
{
return Arr::get(self::billing_periods,$target.'.interval')/Arr::get(self::billing_periods,$source.'.interval');
}
/**
* Return the name for the billing interval
*
* @param int $interval
* @return string
*/
public static function billing_name(int $interval): string
{
$interval = collect(self::billing_periods)->get($interval);
return Arr::get($interval,'name','Unknown');
}
/**
* Return the number of months in the billing interval
*
* @param int $interval
* @return int
*/
public static function billing_period(int $interval): int
{
$interval = collect(self::billing_periods)->get($interval);
return Arr::get($interval,'interval',0);
}
/**
* Given a contract in months, this will calculate the number of billing intervals required
*
* @param int $contract_term
* @param int $source
* @return int
*/
public static function billing_term(int $contract_term,int $source): int
{
return ceil(($contract_term ?: 1)/(Arr::get(self::billing_periods,$source.'.interval') ?: 1));
}
/* INTERFACES */
/**
* Invoice Local ID
*
* @return string
*/
public function getLIDAttribute(): string
{
return sprintf('%06s',$this->id);
}
/**
* Invoice System ID
*
* @return string
*/
public function getSIDAttribute(): string
{
return sprintf('%02s-%04s-%s',$this->site_id,$this->account_id,$this->getLIDAttribute());
}
2021-06-29 06:36:34 +00:00
/* RELATIONS */
2018-05-20 12:53:14 +00:00
2024-07-09 10:17:30 +00:00
/**
* Account this invoice belongs to
*/
2018-05-20 12:53:14 +00:00
public function account()
{
2018-07-13 04:53:44 +00:00
return $this->belongsTo(Account::class);
2018-05-20 12:53:14 +00:00
}
2024-07-09 10:17:30 +00:00
/**
* Items on this invoice belongs to
*/
public function items()
2018-05-20 12:53:14 +00:00
{
2021-06-29 06:36:34 +00:00
return $this->hasMany(InvoiceItem::class)
2022-04-19 07:07:39 +00:00
->with(['taxes','product']);
2021-06-29 06:36:34 +00:00
}
2024-07-09 10:17:30 +00:00
/**
* Active items on this invoice belongs to
*/
public function items_active()
{
return $this->items()
->where('active',TRUE);
}
/**
* Payments applied to this invoice
*/
2021-06-29 06:36:34 +00:00
public function payments()
{
return $this->hasManyThrough(Payment::class,PaymentItem::class,NULL,'id',NULL,'payment_id')
2024-07-09 10:17:30 +00:00
->where('active',TRUE);
2018-05-20 12:53:14 +00:00
}
2024-07-09 10:17:30 +00:00
/**
* Payment items attached to this invoice
*/
public function payment_items()
2018-05-20 12:53:14 +00:00
{
return $this->hasMany(PaymentItem::class);
}
2024-07-09 10:17:30 +00:00
public function payment_items_active()
{
return $this->payment_items()
->where('payment_items.active',TRUE);
}
/**
* 3rd party provider details to this invoice (eg: accounting providers)
*/
public function providers()
{
return $this->belongsToMany(ProviderOauth::class,'invoice__provider')
->where('invoice__provider.site_id',$this->site_id)
->withPivot('ref','synctoken','created_at','updated_at');
}
2021-06-29 06:36:34 +00:00
/* SCOPES */
/**
* Search for a record
*
* @param $query
* @param string $term
2021-06-29 06:36:34 +00:00
* @return mixed
*/
public function scopeSearch($query,string $term)
{
return $query->where('id','like','%'.$term.'%');
}
2021-06-29 06:36:34 +00:00
/* ATTRIBUTES */
2021-06-29 06:36:34 +00:00
/**
* Balance due on an invoice
* @return float
2021-06-29 06:36:34 +00:00
*/
public function getDueAttribute(): float
2018-05-20 12:53:14 +00:00
{
return sprintf('%3.2f',$this->getTotalAttribute()-$this->getPaidAttribute());
2018-05-20 12:53:14 +00:00
}
2021-06-29 06:36:34 +00:00
/**
* Total of payments received for this invoice
* excluding pending payments
*
* @return float
*/
public function getPaidAttribute(): float
{
2024-07-09 10:17:30 +00:00
return $this->payment_items_active->sum('amount');
2021-06-29 06:36:34 +00:00
}
/**
* Get the date that the invoice was paid in full.
* We assume the last payment received pays it in full, if its fully paid.
2021-06-29 06:36:34 +00:00
*
* @return Carbon|null
*/
public function getPaidDateAttribute(): ?Carbon
{
2024-07-09 10:17:30 +00:00
// If the invoice still has a due balance, its not paid
if ($this->getDueAttribute())
return NULL;
2024-07-09 10:17:30 +00:00
$o = $this
->payments
->filter(fn($item)=>(! $item->pending_status))
2021-06-29 06:36:34 +00:00
->last();
2022-06-13 05:46:38 +00:00
return $o?->paid_at;
2021-06-29 06:36:34 +00:00
}
/**
* Total of pending payments received for this invoice
*
* @return mixed
*/
public function getPaidPendingAttribute(): float
2020-07-27 04:49:59 +00:00
{
2024-07-09 10:17:30 +00:00
return $this->payment_items
->filter(fn($item)=>$item->payment->pending_status)
2022-04-22 05:23:08 +00:00
->sum('amount');
2018-05-20 12:53:14 +00:00
}
2021-06-29 06:36:34 +00:00
/**
* Get invoice subtotal before taxes
*
* @return float
*/
public function getSubTotalAttribute(): float
2018-08-01 07:09:38 +00:00
{
2024-07-09 10:17:30 +00:00
return $this->items_active->sum('sub_total');
2018-08-01 07:09:38 +00:00
}
2021-06-29 06:36:34 +00:00
/**
* Get the invoices taxes total
*
* @return float
*/
public function getTaxTotalAttribute(): float
{
2024-07-09 10:17:30 +00:00
return $this->items_active->sum('tax');
2018-08-01 07:09:38 +00:00
}
2021-06-29 06:36:34 +00:00
/**
* Invoice total due
*
* @return float
2021-06-29 06:36:34 +00:00
*/
public function getTotalAttribute(): float
2018-05-20 12:53:14 +00:00
{
2024-07-09 10:17:30 +00:00
return $this->getSubTotalAttribute()+$this->getTaxTotalAttribute();
2018-05-20 12:53:14 +00:00
}
/* METHODS */
2020-05-25 07:45:17 +00:00
/**
* Return a download link for non-auth downloads
*
* @return string
*/
public function download_link(): string
{
// Re-use an existing code
$io = Invite::where('for',$this->account->user->email)->first();
$tokendate = ($x=Carbon::now()->addDays(21)) > ($y=$this->due_at->addDays(21)) ? $x : $y;
2020-05-25 07:45:17 +00:00
// Extend the expire date
2024-07-09 10:17:30 +00:00
if ($io && ($tokendate > $io->valid_until)) {
2020-05-25 07:45:17 +00:00
$io->valid_until = $tokendate;
$io->save();
}
2024-07-09 10:17:30 +00:00
$code = (! $io)
? Doorman::generate()
->for($this->account->user->email)
->uses(0)
->expiresOn($tokendate)
->make()
->first()
->code
: $io->code;
2020-05-25 07:45:17 +00:00
return url('u/invoice',[$this->id,'email',$code]);
}
2024-07-09 10:17:30 +00:00
/**
* Return all the items on an invoice for a particular service and product
*
* @param Product $po
* @param Service $so
* @return Collection
*/
public function product_service_items(Product $po,Service $so): Collection
2018-08-01 07:09:38 +00:00
{
2024-07-09 10:17:30 +00:00
return $this
->items_active
->filter(fn($item)=>($item->product_id === $po->id) && ($item->service_id === $so->id))
->sortBy('item_type');
2018-08-01 07:09:38 +00:00
}
2020-04-01 12:35:06 +00:00
2020-05-25 07:45:17 +00:00
/**
* @param string $key
2022-06-13 09:58:53 +00:00
* @return array
2020-05-25 07:45:17 +00:00
* @todo Ugly hack to update reminders
*/
2022-06-13 09:58:53 +00:00
public function reminders(string $key): array
{
$r = $this->reminders;
2020-05-25 07:45:17 +00:00
if (! Arr::get($r,$key)) {
$r[$key] = time();
}
2022-06-13 09:58:53 +00:00
return $r;
2020-05-25 07:45:17 +00:00
}
2020-04-01 12:35:06 +00:00
/**
* Automatically set our due_at at save time.
2020-04-01 12:35:06 +00:00
*
* @param array $options
* @return bool
2024-07-09 10:17:30 +00:00
* @todo Change this to a saving event
2020-04-01 12:35:06 +00:00
*/
2022-06-13 09:58:53 +00:00
public function save(array $options = [])
{
2020-04-01 12:35:06 +00:00
// Automatically set the date_due attribute for new records.
if (! $this->exists AND ! $this->due_at) {
$this->due_at = $this->items->min('start_at');
2020-04-01 12:35:06 +00:00
// @todo This 7 days should be sysetm configurable
if (($x=Carbon::now()->addDay(7)) > $this->due_at)
$this->due_at = $x;
2020-04-01 12:35:06 +00:00
}
return parent::save($options);
}
2024-07-09 10:17:30 +00:00
/**
* Group the invoice items by product ID, returning the number of products and total
*
* @return Collection
*/
public function summary_products(): Collection
{
$return = collect();
foreach ($this->items_active->groupBy('product_id') as $o) {
$po = $o->first()->product;
$po->count = count($o->pluck('service_id')->unique());
$return->push([
'product' => $o->first()->product,
'services' => $o->pluck('service_id')->unique(),
'sub_total' => $o->sum('sub_total'),
'tax_total' => $o->sum('tax'),
'total' => $o->sum('total'),
]);
}
return $return->sortBy('product.name');
}
2018-05-20 12:53:14 +00:00
}