Jingga/oms-Billing
1
0
Fork 0
mirror of https://github.com/Karaka-Management/oms-Billing.git synced 2026-01-16 01:28:42 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
773bb2a574
oms-Billing/Models/Bill.php

1220 lines
20 KiB
PHP
Raw Blame History

<?php
/**
* Orange Management
*
* PHP Version 7.4
*
* @package Modules\Billing\Models
* @copyright Dennis Eichhorn
* @license OMS License 1.0
* @version 1.0.0
* @link https://orange-management.org
*/
declare(strict_types=1);
namespace Modules\Billing\Models;
use Modules\Admin\Models\Account;
use Modules\Admin\Models\NullAccount;
use phpOMS\Localization\ISO4217CharEnum;
use phpOMS\Localization\Money;
/**
* Bill class.
*
* @package Modules\Billing\Models
* @license OMS License 1.0
* @link https://orange-management.org
* @since 1.0.0
*/
class Bill implements \JsonSerializable
{
/**
* ID.
*
* @var int
* @since 1.0.0
*/
protected int $id = 0;
/**
* Number ID.
*
* @var string
* @since 1.0.0
*/
public string $number = '';
/**
* Bill type.
*
* @var int|BillType
* @since 1.0.0
*/
public int|BillType $type = 0;
/**
* Bill status.
*
* @var int
* @since 1.0.0
*/
private int $status = BillStatus::DRAFT;
/**
* Bill created at.
*
* @var \DateTime
* @since 1.0.0
*/
public \DateTimeImmutable $createdAt;
/**
* Bill created at.
*
* @var \DateTime
* @since 1.0.0
*/
public \DateTime $performanceDate;
/**
* Bill send at.
*
* @var null|\DateTime
* @since 1.0.0
*/
private ?\DateTime $send = null;
/**
* Creator.
*
* @var Account
* @since 1.0.0
*/
public Account $createdBy;
public $client = 0;
/**
* Receiver.
*
* @var string
* @since 1.0.0
*/
public string $shipTo = '';
/**
* For the attention of.
*
* @var string
* @since 1.0.0
*/
private $shipFAO = '';
/**
* Shipping address.
*
* @var string
* @since 1.0.0
*/
private $shipAddress = '';
/**
* Shipping city.
*
* @var string
* @since 1.0.0
*/
private $shipCity = '';
/**
* Shipping zip.
*
* @var string
* @since 1.0.0
*/
private $shipZip = '';
/**
* Shipping country.
*
* @var string
* @since 1.0.0
*/
private $shipCountry = '';
/**
* Billing.
*
* @var string
* @since 1.0.0
*/
public string $billTo = '';
/**
* Billing for the attention of.
*
* @var string
* @since 1.0.0
*/
private $billFAO = '';
/**
* Billing address.
*
* @var string
* @since 1.0.0
*/
private $billAddress = '';
/**
* Billing city.
*
* @var string
* @since 1.0.0
*/
private $billCity = '';
/**
* Billing zip.
*
* @var string
* @since 1.0.0
*/
private $billZip = '';
/**
* Billing country.
*
* @var string
* @since 1.0.0
*/
public string $billCountry = '';
/**
* Person refering for this order.
*
* @var int
* @since 1.0.0
*/
private $referral;
private $referralName = '';
public Money $net;
public Money $gross;
public Money $costs;
public Money $profit;
private $currency = ISO4217CharEnum::_EUR;
private $info = '';
private $payment = 0;
private $paymentText = '';
private $terms = 0;
private $termsText = '';
private $shipping = 0;
private $shippingText = '';
private $vouchers = [];
private $trackings = [];
private $elements = [];
/**
* Reference to other Bill (delivery note/credit note etc).
*
* @var int
* @since 1.0.0
*/
private int $reference = 0;
/**
* Constructor.
*
* @since 1.0.0
*/
public function __construct()
{
$this->net = new Money(0);
$this->gross = new Money(0);
$this->costs = new Money(0);
$this->profit = new Money(0);
$this->createdAt = new \DateTimeImmutable();
$this->performanceDate = new \DateTime();
$this->createdBy = new NullAccount();
$this->referer = new NullAccount();
}
/**
* Get created by
*
* @return Account
*
* @since 1.0.0
*/
public function getCreatedBy() : Account
{
return $this->createdBy;
}
/**
* Set created by
*
* @param Account $account Created by
*
* @return void
*
* @since 1.0.0
*/
public function setCreatedBy(Account $account) : void
{
$this->createdBy = $account;
}
/**
* Get id.
*
* @return int Model id
*
* @since 1.0.0
*/
public function getId() : int
{
return $this->id;
}
/**
* Get Bill number.
*
* @return string
*
* @since 1.0.0
*/
public function getNumber() : string
{
$number = $this->number;
return \str_replace(
[
'{y}',
'{m}',
'{d}',
'{id}',
'{type}',
],
[
$this->createdAt->format('Y'),
$this->createdAt->format('m'),
$this->createdAt->format('d'),
$this->id,
$this->type->getId(),
],
$number
);
}
/**
* Set Bill number.
*
* @param string $number Bill number
*
* @return void
*
* @since 1.0.0
*/
public function setNumber(string $number) : void
{
$this->number = $number;
}
/**
* Get type
*
* @return int
*
* @since 1.0.0
*/
public function getType() : int
{
return $this->type;
}
/**
* Set type
*
* @param int $type Type
*
* @return void
*
* @since 1.0.0
*/
public function setType(int $type) : void
{
$this->type = $type;
}
/**
* Get status
*
* @return int
*
* @since 1.0.0
*/
public function getStatus() : int
{
return $this->status;
}
/**
* Set status
*
* @param int $status Status
*
* @return void
*
* @since 1.0.0
*/
public function setStatus(int $status) : void
{
$this->status = $status;
}
/**
* Get created at date time
*
* @return \DateTime
*
* @since 1.0.0
*/
public function getCreatedAt() : \DateTime
{
return $this->createdAt;
}
/**
* Set shipping date.
*
* @param \DateTime $send Shipping date
*
* @return void
*
* @since 1.0.0
*/
public function setSend(\DateTime $send) : void
{
$this->send = $send;
}
/**
* Get shipping date.
*
* @return null|\DateTime
*
* @since 1.0.0
*/
public function getSend() : ?\DateTime
{
return $this->send;
}
/**
* Get client.
*
* @return mixed
*
* @since 1.0.0
*/
public function getClient()
{
return $this->client;
}
/**
* Set client.
*
* @param mixed $client client
*
* @return void
*
* @since 1.0.0
*/
public function setClient($client) : void
{
$this->client = $client;
}
/**
* Set shipping receiver.
*
* @param string $ship Shipping receiver
*
* @return void
*
* @since 1.0.0
*/
public function setShipTo(string $ship) : void
{
$this->shipTo = $ship;
}
/**
* Get shipping receiver.
*
* @return string
*
* @since 1.0.0
*/
public function getShipTo() : string
{
return $this->shipTo;
}
/**
* Set shipping fao.
*
* @param string $ship FAO
*
* @return void
*
* @since 1.0.0
*/
public function setShipFAO(string $ship) : void
{
$this->shipFAO = $ship;
}
/**
* Get shipping fao.
*
* @return string
*
* @since 1.0.0
*/
public function getShipFAO() : string
{
return $this->shipFAO;
}
/**
* Set shipping address.
*
* @param string $ship Shipping address
*
* @return void
*
* @since 1.0.0
*/
public function setShipAddress(string $ship) : void
{
$this->shipAddress = $ship;
}
/**
* Get shipping address.
*
* @return string
*
* @since 1.0.0
*/
public function getShipAddress() : string
{
return $this->shipAddress;
}
/**
* Set shipping city.
*
* @param string $ship City
*
* @return void
*
* @since 1.0.0
*/
public function setShipCity(string $ship) : void
{
$this->shipCity = $ship;
}
/**
* Get shipping city.
*
* @return string
*
* @since 1.0.0
*/
public function getShipCity() : string
{
return $this->shipCity;
}
/**
* Set shipping zip.
*
* @param string $ship Zip
*
* @return void
*
* @since 1.0.0
*/
public function setShipZip(string $ship) : void
{
$this->shipZip = $ship;
}
/**
* Get shipping zip.
*
* @return string
*
* @since 1.0.0
*/
public function getShipZip() : string
{
return $this->shipZip;
}
/**
* Set shipping country.
*
* @param string $ship Country
*
* @return void
*
* @since 1.0.0
*/
public function setShipCountry(string $ship) : void
{
$this->shipCountry = $ship;
}
/**
* Get shipping country.
*
* @return string
*
* @since 1.0.0
*/
public function getShipCountry() : string
{
return $this->shipCountry;
}
/**
* Set billing receiver.
*
* @param string $bill Billing receiver
*
* @return void
*
* @since 1.0.0
*/
public function setBillTo(string $bill) : void
{
$this->billTo = $bill;
}
/**
* Get billing receiver.
*
* @return string
*
* @since 1.0.0
*/
public function getBillTo() : string
{
return $this->billTo;
}
/**
* Set billing fao.
*
* @param string $bill FAO
*
* @return void
*
* @since 1.0.0
*/
public function setBillFAO(string $bill) : void
{
$this->billFAO = $bill;
}
/**
* Get billing fao.
*
* @return string
*
* @since 1.0.0
*/
public function getBillFAO() : string
{
return $this->billFAO;
}
/**
* Set billing address.
*
* @param string $bill Billing address
*
* @return void
*
* @since 1.0.0
*/
public function setBillAddress(string $bill) : void
{
$this->billAddress = $bill;
}
/**
* Get billing address.
*
* @return string
*
* @since 1.0.0
*/
public function getBillAddress() : string
{
return $this->billAddress;
}
/**
* Set billing city.
*
* @param string $bill City
*
* @return void
*
* @since 1.0.0
*/
public function setBillCity(string $bill) : void
{
$this->billCity = $bill;
}
/**
* Get billing city.
*
* @return string
*
* @since 1.0.0
*/
public function getBillCity() : string
{
return $this->billCity;
}
/**
* Set billing zip.
*
* @param string $bill Zip
*
* @return void
*
* @since 1.0.0
*/
public function setBillZip(string $bill) : void
{
$this->billZip = $bill;
}
/**
* Get billing zip.
*
* @return string
*
* @since 1.0.0
*/
public function getBillZip() : string
{
return $this->billZip;
}
/**
* Set billing country.
*
* @param string $bill Country
*
* @return void
*
* @since 1.0.0
*/
public function setBillCountry(string $bill) : void
{
$this->billCountry = $bill;
}
/**
* Get billing country.
*
* @return string
*
* @since 1.0.0
*/
public function getBillCountry() : string
{
return $this->billCountry;
}
/**
* Set referer.
*
* @param int $referer Referer
*
* @return void
*
* @since 1.0.0
*/
public function setReferer(int $referer) : void
{
$this->referer = $referer;
}
/**
* Get referer.
*
* @return int
*
* @since 1.0.0
*/
public function getReferer() : int
{
return $this->referer;
}
/**
* Set referer name.
*
* @param string $refererName Referer name
*
* @return void
*
* @since 1.0.0
*/
public function setRefererName(string $refererName) : void
{
$this->refererName = $refererName;
}
/**
* Get referer name.
*
* @return string
*
* @since 1.0.0
*/
public function getRefererName() : string
{
return $this->refererName;
}
/**
* Set tax id.
*
* @param string $tax Tax id
*
* @return void
*
* @since 1.0.0
*/
public function setTaxId(string $tax) : void
{
$this->taxId = $tax;
}
/**
* Get tax id.
*
* @return string
*
* @since 1.0.0
*/
public function getTaxId() : string
{
return $this->taxId;
}
/**
* Set insurance.
*
* @param Money $insurance Insurance fee
*
* @return void
*
* @since 1.0.0
*/
public function setInsurance(Money $insurance) : void
{
$this->insurance = $insurance;
}
/**
* Get insurance.
*
* @return Money
*
* @since 1.0.0
*/
public function getInsurance() : Money
{
return $this->insurance;
}
/**
* Set freight.
*
* @param Money $freight Freight fee
*
* @return void
*
* @since 1.0.0
*/
public function setFreight(Money $freight) : void
{
$this->freight = $freight;
}
/**
* Get freight.
*
* @return Money
*
* @since 1.0.0
*/
public function getFreight() : Money
{
return $this->freight;
}
/**
* Get net amount.
*
* @return Money
*
* @since 1.0.0
*/
public function getNet() : Money
{
return $this->net;
}
/**
* Get gross amount.
*
* @return Money
*
* @since 1.0.0
*/
public function getGross() : Money
{
return $this->gross;
}
/**
* Set currency.
*
* @param string $currency Currency
*
* @return void
*
* @since 1.0.0
*/
public function setCurrency(string $currency) : void
{
$this->currency = $currency;
}
/**
* Get currency.
*
* @return string
*
* @since 1.0.0
*/
public function getCurrency() : string
{
return $this->currency;
}
/**
* Set info.
*
* @param string $info Info
*
* @return void
*
* @since 1.0.0
*/
public function setInfo(string $info) : void
{
$this->info = $info;
}
/**
* Get info.
*
* @return string
*
* @since 1.0.0
*/
public function getInfo() : string
{
return $this->info;
}
/**
* Set payment term.
*
* @param int $payment Payment term
*
* @return void
*
* @since 1.0.0
*/
public function setPayment(int $payment) : void
{
$this->payment = $payment;
}
/**
* Get payment term.
*
* @return null|int
*
* @since 1.0.0
*/
public function getPayment() : ?int
{
return $this->payment;
}
/**
* Set payment text.
*
* @param string $payment Payment text
*
* @return void
*
* @since 1.0.0
*/
public function setPaymentText(string $payment) : void
{
$this->paymentText = $payment;
}
/**
* Get payment text.
*
* @return string
*
* @since 1.0.0
*/
public function getPaymentText() : string
{
return $this->paymentText;
}
/**
* Set shipping terms (e.g. inco).
*
* @param int $terms Terms
*
* @return void
*
* @since 1.0.0
*/
public function setTerms(int $terms) : void
{
$this->terms = $terms;
}
/**
* Get terms.
*
* @return int
*
* @since 1.0.0
*/
public function getTerms() : ?int
{
return $this->terms;
}
/**
* Set terms text.
*
* @param string $terms Terms text
*
* @return void
*
* @since 1.0.0
*/
public function setTermsText(string $terms) : void
{
$this->termsText = $terms;
}
/**
* Get terms text.
*
* @return string
*
* @since 1.0.0
*/
public function getTermsText() : string
{
return $this->termsText;
}
/**
* Set shipping.
*
* @param int $shipping Shipping (e.g. incoterm)
*
* @return void
*
* @since 1.0.0
*/
public function setShipping(int $shipping) : void
{
$this->shipping = $shipping;
}
/**
* Get shipping.
*
* @return int
*
* @since 1.0.0
*/
public function getShipping() : ?int
{
return $this->shipping;
}
/**
* Set shipping text.
*
* @param string $shipping Shipping text
*
* @return void
*
* @since 1.0.0
*/
public function setShippingText(string $shipping) : void
{
$this->shippingText = $shipping;
}
/**
* Get shipping text.
*
* @return string
*
* @since 1.0.0
*/
public function getShippingText() : string
{
return $this->shippingText;
}
/**
* Get vouchers.
*
* @return array
*
* @since 1.0.0
*/
public function getVouchers() : array
{
return $this->vouchers;
}
/**
* Add voucher.
*
* @param string $voucher Voucher code
*
* @return void
*
* @since 1.0.0
*/
public function addVoucher(string $voucher) : void
{
$this->vouchers[] = $voucher;
}
/**
* Get tracking ids for shipment.
*
* @return array
*
* @since 1.0.0
*/
public function getTrackings() : array
{
return $this->trackings;
}
/**
* Add tracking id.
*
* @param string $tracking Tracking id
*
* @return void
*
* @todo do same for actual tracking information per trackign id
*
* @since 1.0.0
*/
public function addTracking(string $tracking) : void
{
$this->trackings[] = $tracking;
}
/**
* Get Bill elements.
*
* @return array
*
* @since 1.0.0
*/
public function getElements() : array
{
return $this->elements;
}
/**
* Add Bill element.
*
* @param mixed $element Bill element
*
* @return void
*
* @since 1.0.0
*/
public function addElement($element) : void
{
$this->elements[] = $element;
}
/**
* {@inheritdoc}
*/
public function jsonSerialize()
{
return [];
}
}
Reference in New Issue View Git Blame Copy Permalink