mirror of
https://github.com/invoiceninja/invoiceninja.git
synced 2025-10-31 03:57:29 -04:00
543 lines
16 KiB
PHP
543 lines
16 KiB
PHP
<?php
|
|
/**
|
|
* Invoice Ninja (https://invoiceninja.com).
|
|
*
|
|
* @link https://github.com/invoiceninja/invoiceninja source repository
|
|
*
|
|
* @copyright Copyright (c) 2021. Invoice Ninja LLC (https://invoiceninja.com)
|
|
*
|
|
* @license https://www.elastic.co/licensing/elastic-license
|
|
*/
|
|
|
|
namespace App\Services\Invoice;
|
|
|
|
use App\Jobs\Entity\CreateEntityPdf;
|
|
use App\Jobs\Invoice\InvoiceWorkflowSettings;
|
|
use App\Jobs\Util\UnlinkFile;
|
|
use App\Libraries\Currency\Conversion\CurrencyApi;
|
|
use App\Models\CompanyGateway;
|
|
use App\Models\Expense;
|
|
use App\Models\Invoice;
|
|
use App\Models\Payment;
|
|
use App\Models\Task;
|
|
use App\Repositories\BaseRepository;
|
|
use App\Services\Client\ClientService;
|
|
use App\Services\Invoice\ApplyPaymentAmount;
|
|
use App\Services\Invoice\UpdateReminder;
|
|
use App\Utils\Ninja;
|
|
use App\Utils\Traits\MakesHash;
|
|
use Illuminate\Support\Carbon;
|
|
use Illuminate\Support\Facades\Storage;
|
|
|
|
class InvoiceService
|
|
{
|
|
use MakesHash;
|
|
|
|
public $invoice;
|
|
|
|
public function __construct($invoice)
|
|
{
|
|
$this->invoice = $invoice;
|
|
}
|
|
|
|
/**
|
|
* Marks as invoice as paid
|
|
* and executes child sub functions.
|
|
* @return $this InvoiceService object
|
|
*/
|
|
public function markPaid()
|
|
{
|
|
$this->removeUnpaidGatewayFees();
|
|
|
|
$this->invoice = (new MarkPaid($this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function applyPaymentAmount($amount)
|
|
{
|
|
$this->invoice = (new ApplyPaymentAmount($this->invoice, $amount))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Applies the invoice number.
|
|
* @return $this InvoiceService object
|
|
*/
|
|
public function applyNumber()
|
|
{
|
|
$this->invoice = (new ApplyNumber($this->invoice->client, $this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Sets the exchange rate on the invoice if the client currency
|
|
* is different to the company currency.
|
|
*/
|
|
public function setExchangeRate()
|
|
{
|
|
|
|
$client_currency = $this->invoice->client->getSetting('currency_id');
|
|
$company_currency = $this->invoice->company->settings->currency_id;
|
|
|
|
if ($company_currency != $client_currency) {
|
|
|
|
$exchange_rate = new CurrencyApi();
|
|
|
|
$this->invoice->exchange_rate = $exchange_rate->exchangeRate($client_currency, $company_currency, now());
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
/**
|
|
* Applies the recurring invoice number.
|
|
* @return $this InvoiceService object
|
|
*/
|
|
public function applyRecurringNumber()
|
|
{
|
|
$this->invoice = (new ApplyRecurringNumber($this->invoice->client, $this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Apply a payment amount to an invoice.
|
|
* @param Payment $payment The Payment
|
|
* @param float $payment_amount The Payment amount
|
|
* @return InvoiceService Parent class object
|
|
*/
|
|
public function applyPayment(Payment $payment, float $payment_amount)
|
|
{
|
|
$this->deletePdf();
|
|
|
|
$this->invoice = (new ApplyPayment($this->invoice, $payment, $payment_amount))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function addGatewayFee(CompanyGateway $company_gateway, $gateway_type_id, float $amount)
|
|
{
|
|
|
|
$this->invoice = (new AddGatewayFee($company_gateway, $gateway_type_id, $this->invoice, $amount))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Update an invoice balance.
|
|
*
|
|
* @param float $balance_adjustment The amount to adjust the invoice by
|
|
* a negative amount will REDUCE the invoice balance, a positive amount will INCREASE
|
|
* the invoice balance
|
|
*
|
|
* @return InvoiceService Parent class object
|
|
*/
|
|
public function updateBalance($balance_adjustment, bool $is_draft = false)
|
|
{
|
|
// $this->invoice = (new UpdateBalance($this->invoice, $balance_adjustment, $is_draft))->run();
|
|
|
|
if ((bool)$this->invoice->is_deleted !== false) {
|
|
nlog($this->invoice->number . " is deleted returning");
|
|
return $this;
|
|
}
|
|
|
|
$this->invoice->balance += $balance_adjustment;
|
|
|
|
if ($this->invoice->balance == 0 && !$is_draft) {
|
|
$this->invoice->status_id = Invoice::STATUS_PAID;
|
|
}
|
|
|
|
if ((int)$this->invoice->balance == 0) {
|
|
$this->invoice->next_send_date = null;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function updatePaidToDate($adjustment)
|
|
{
|
|
$this->invoice->paid_to_date += $adjustment;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function createInvitations()
|
|
{
|
|
$this->invoice = (new CreateInvitations($this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function markSent()
|
|
{
|
|
$this->invoice = (new MarkSent($this->invoice->client, $this->invoice))->run();
|
|
|
|
$this->setExchangeRate();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getInvoicePdf($contact = null)
|
|
{
|
|
return (new GetInvoicePdf($this->invoice, $contact))->run();
|
|
}
|
|
|
|
public function getInvoiceDeliveryNote(\App\Models\Invoice $invoice, \App\Models\ClientContact $contact = null)
|
|
{
|
|
return (new GenerateDeliveryNote($invoice, $contact))->run();
|
|
}
|
|
|
|
public function sendEmail($contact = null)
|
|
{
|
|
$send_email = new SendEmail($this->invoice, null, $contact);
|
|
|
|
return $send_email->run();
|
|
}
|
|
|
|
public function handleReversal()
|
|
{
|
|
$this->invoice = (new HandleReversal($this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function handleCancellation()
|
|
{
|
|
$this->removeUnpaidGatewayFees();
|
|
|
|
$this->invoice = (new HandleCancellation($this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function markDeleted()
|
|
{
|
|
$this->removeUnpaidGatewayFees();
|
|
|
|
$this->invoice = (new MarkInvoiceDeleted($this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function handleRestore()
|
|
{
|
|
$this->invoice = (new HandleRestore($this->invoice))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function reverseCancellation()
|
|
{
|
|
$this->removeUnpaidGatewayFees();
|
|
|
|
$this->invoice = (new HandleCancellation($this->invoice))->reverse();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function triggeredActions($request)
|
|
{
|
|
$this->invoice = (new TriggeredActions($this->invoice, $request))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function autoBill()
|
|
{
|
|
(new AutoBillInvoice($this->invoice, $this->invoice->company->db))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function markViewed()
|
|
{
|
|
$this->invoice->last_viewed = Carbon::now()->format('Y-m-d H:i');
|
|
|
|
return $this;
|
|
}
|
|
|
|
/* One liners */
|
|
public function setDueDate()
|
|
{
|
|
if ($this->invoice->due_date != '' || $this->invoice->client->getSetting('payment_terms') == '') {
|
|
return $this;
|
|
}
|
|
|
|
$this->invoice->due_date = Carbon::parse($this->invoice->date)->addDays($this->invoice->client->getSetting('payment_terms'));
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function setReminder($settings = null)
|
|
{
|
|
$this->invoice = (new UpdateReminder($this->invoice, $settings))->run();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function setStatus($status)
|
|
{
|
|
$this->invoice->status_id = $status;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function setCalculatedStatus()
|
|
{
|
|
if ((int)$this->invoice->balance == 0) {
|
|
$this->setStatus(Invoice::STATUS_PAID);
|
|
} elseif ($this->invoice->balance > 0 && $this->invoice->balance < $this->invoice->amount) {
|
|
$this->setStatus(Invoice::STATUS_PARTIAL);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function updateStatus()
|
|
{
|
|
if($this->invoice->status_id == Invoice::STATUS_DRAFT)
|
|
return $this;
|
|
|
|
// if ((int)$this->invoice->balance == 0) {
|
|
|
|
// $this->setStatus(Invoice::STATUS_PAID)->workFlow();
|
|
|
|
// }
|
|
|
|
if ($this->invoice->balance > 0 && $this->invoice->balance < $this->invoice->amount) {
|
|
$this->setStatus(Invoice::STATUS_PARTIAL);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function toggleFeesPaid()
|
|
{
|
|
$this->invoice->line_items = collect($this->invoice->line_items)
|
|
->map(function ($item) {
|
|
if ($item->type_id == '3') {
|
|
$item->type_id = '4';
|
|
}
|
|
|
|
return $item;
|
|
})->toArray();
|
|
|
|
//$this->invoice = $this->invoice->calc()->getInvoice();
|
|
|
|
$this->deletePdf();
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function deletePdf()
|
|
{
|
|
$this->invoice->load('invitations');
|
|
|
|
$this->invoice->invitations->each(function ($invitation){
|
|
|
|
Storage::disk(config('filesystems.default'))->delete($this->invoice->client->invoice_filepath($invitation) . $this->invoice->numberFormatter().'.pdf');
|
|
|
|
if(Ninja::isHosted()) {
|
|
Storage::disk('public')->delete($this->invoice->client->invoice_filepath($invitation) . $this->invoice->numberFormatter().'.pdf');
|
|
}
|
|
|
|
});
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function removeUnpaidGatewayFees()
|
|
{
|
|
//return early if type three does not exist.
|
|
if(!collect($this->invoice->line_items)->contains('type_id', 3))
|
|
return $this;
|
|
|
|
$this->invoice->line_items = collect($this->invoice->line_items)
|
|
->reject(function ($item) {
|
|
return $item->type_id == '3';
|
|
})->toArray();
|
|
|
|
$this->invoice = $this->invoice->calc()->getInvoice();
|
|
|
|
return $this;
|
|
}
|
|
|
|
/*Set partial value and due date to null*/
|
|
public function clearPartial()
|
|
{
|
|
$this->invoice->partial = null;
|
|
$this->invoice->partial_due_date = null;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/*Update the partial amount of a invoice*/
|
|
public function updatePartial($amount)
|
|
{
|
|
$this->invoice->partial += $amount;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Sometimes we need to refresh the
|
|
* PDF when it is updated etc.
|
|
* @return InvoiceService
|
|
*/
|
|
public function touchPdf($force = false)
|
|
{
|
|
if($force){
|
|
|
|
$this->invoice->invitations->each(function ($invitation) {
|
|
CreateEntityPdf::dispatchNow($invitation);
|
|
});
|
|
|
|
return $this;
|
|
}
|
|
|
|
$this->invoice->invitations->each(function ($invitation) {
|
|
CreateEntityPdf::dispatch($invitation);
|
|
});
|
|
|
|
return $this;
|
|
}
|
|
|
|
/*When a reminder is sent we want to touch the dates they were sent*/
|
|
public function touchReminder(string $reminder_template)
|
|
{
|
|
switch ($reminder_template) {
|
|
case 'reminder1':
|
|
$this->invoice->reminder1_sent = now();
|
|
$this->invoice->reminder_last_sent = now();
|
|
$this->invoice->last_sent_date = now();
|
|
break;
|
|
case 'reminder2':
|
|
$this->invoice->reminder2_sent = now();
|
|
$this->invoice->reminder_last_sent = now();
|
|
$this->invoice->last_sent_date = now();
|
|
break;
|
|
case 'reminder3':
|
|
$this->invoice->reminder3_sent = now();
|
|
$this->invoice->reminder_last_sent = now();
|
|
$this->invoice->last_sent_date = now();
|
|
break;
|
|
case 'endless_reminder':
|
|
$this->invoice->reminder_last_sent = now();
|
|
$this->invoice->last_sent_date = now();
|
|
break;
|
|
default:
|
|
$this->invoice->reminder1_sent = now();
|
|
$this->invoice->reminder_last_sent = now();
|
|
$this->invoice->last_sent_date = now();
|
|
break;
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function linkEntities()
|
|
{
|
|
//set all task.invoice_ids = 0
|
|
$this->invoice->tasks()->update(['invoice_id' => null]);
|
|
|
|
//set all tasks.invoice_ids = x with the current line_items
|
|
$tasks = collect($this->invoice->line_items)->map(function ($item) {
|
|
if (isset($item->task_id)) {
|
|
$item->task_id = $this->decodePrimaryKey($item->task_id);
|
|
}
|
|
|
|
if (isset($item->expense_id)) {
|
|
$item->expense_id = $this->decodePrimaryKey($item->expense_id);
|
|
}
|
|
|
|
return $item;
|
|
});
|
|
|
|
Task::whereIn('id', $tasks->pluck('task_id'))->update(['invoice_id' => $this->invoice->id]);
|
|
Expense::whereIn('id', $tasks->pluck('expense_id'))->update(['invoice_id' => $this->invoice->id]);
|
|
|
|
return $this;
|
|
}
|
|
|
|
|
|
public function fillDefaults()
|
|
{
|
|
$this->invoice->load('client.company');
|
|
|
|
$settings = $this->invoice->client->getMergedSettings();
|
|
|
|
if (! $this->invoice->design_id)
|
|
$this->invoice->design_id = $this->decodePrimaryKey($settings->invoice_design_id);
|
|
|
|
if (!isset($this->invoice->footer) || empty($this->invoice->footer))
|
|
$this->invoice->footer = $settings->invoice_footer;
|
|
|
|
if (!isset($this->invoice->terms) || empty($this->invoice->terms))
|
|
$this->invoice->terms = $settings->invoice_terms;
|
|
|
|
if (!isset($this->invoice->public_notes) || empty($this->invoice->public_notes))
|
|
$this->invoice->public_notes = $this->invoice->client->public_notes;
|
|
|
|
/* If client currency differs from the company default currency, then insert the client exchange rate on the model.*/
|
|
if(!isset($this->invoice->exchange_rate) && $this->invoice->client->currency()->id != (int) $this->invoice->company->settings->currency_id)
|
|
$this->invoice->exchange_rate = $this->invoice->client->currency()->exchange_rate;
|
|
|
|
if($settings->counter_number_applied == 'when_saved'){
|
|
$this->invoice->service()->applyNumber()->save();
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function workFlow()
|
|
{
|
|
|
|
if ($this->invoice->status_id == Invoice::STATUS_PAID && $this->invoice->client->getSetting('auto_archive_invoice')) {
|
|
/* Throws: Payment amount xxx does not match invoice totals. */
|
|
|
|
$base_repository = new BaseRepository();
|
|
$base_repository->archive($this->invoice);
|
|
|
|
}
|
|
|
|
/*
|
|
//if paid invoice is attached to a recurring invoice - check if we need to unpause the recurring invoice
|
|
|
|
if ($this->invoice->status_id == Invoice::STATUS_PAID &&
|
|
$this->invoice->recurring_id &&
|
|
$this->invoice->company->pause_recurring_until_paid &&
|
|
($this->invoice->recurring_invoice->status_id != RecurringInvoice::STATUS_ACTIVE || $this->invoice->recurring_invoice->status_id != RecurringInvoice::STATUS_COMPLETED))
|
|
{
|
|
$recurring_invoice = $this->invoice->recurring_invoice;
|
|
|
|
// Check next_send_date if it is in the past - calculate
|
|
$next_send_date = Carbon::parse($recurring_invoice->next_send_date)->startOfDay();
|
|
|
|
if(next_send_date->lt(now())){
|
|
$recurring_invoice->next_send_date = $recurring_invoice->nextDateByFrequency(now()->format('Y-m-d'));
|
|
$recurring_invoice->save();
|
|
}
|
|
|
|
// Start the recurring invoice
|
|
$recurring_invoice->service()
|
|
->start();
|
|
|
|
}
|
|
*/
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* Saves the invoice.
|
|
* @return Invoice object
|
|
*/
|
|
public function save() :?Invoice
|
|
{
|
|
$this->invoice->saveQuietly();
|
|
|
|
return $this->invoice->fresh();
|
|
}
|
|
}
|