2013-10-10 02:44:53 +00:00
|
|
|
<?php defined('SYSPATH') or die('No direct access allowed.');
|
|
|
|
|
|
|
|
/**
|
|
|
|
* This class provides invoice item capabilities.
|
|
|
|
*
|
|
|
|
* @package Invoice
|
|
|
|
* @category Models
|
|
|
|
* @author Deon George
|
|
|
|
* @copyright (c) 2009-2013 Open Source Billing
|
|
|
|
* @license http://dev.osbill.net/license.html
|
|
|
|
*/
|
2013-09-06 05:39:56 +00:00
|
|
|
class Model_Invoice_Item extends ORM_OSB {
|
2013-10-10 02:44:53 +00:00
|
|
|
// Relationships
|
|
|
|
protected $_belongs_to = array(
|
|
|
|
'invoice'=>array(),
|
|
|
|
'service'=>array()
|
|
|
|
);
|
|
|
|
protected $_has_many = array(
|
2013-12-19 23:00:32 +00:00
|
|
|
'tax'=>array('model'=>'Invoice_Item_Tax','far_key'=>'id')
|
2013-10-10 02:44:53 +00:00
|
|
|
);
|
|
|
|
|
|
|
|
protected $_display_filters = array(
|
|
|
|
'date_orig'=>array(
|
2014-08-25 04:41:07 +00:00
|
|
|
array('Site::Date',array(':value')),
|
2013-10-10 02:44:53 +00:00
|
|
|
),
|
|
|
|
'date_start'=>array(
|
2014-08-25 04:41:07 +00:00
|
|
|
array('Site::Date',array(':value')),
|
2013-10-10 02:44:53 +00:00
|
|
|
),
|
|
|
|
'date_stop'=>array(
|
2014-08-25 04:41:07 +00:00
|
|
|
array('Site::Date',array(':value')),
|
2013-10-10 02:44:53 +00:00
|
|
|
),
|
|
|
|
);
|
|
|
|
|
2013-09-06 05:39:56 +00:00
|
|
|
// Items belonging to an invoice item
|
|
|
|
protected $_sub_items_load = array(
|
2016-07-27 06:55:07 +00:00
|
|
|
'tax'=>array(),
|
2013-09-06 05:39:56 +00:00
|
|
|
);
|
|
|
|
|
2016-07-27 06:55:07 +00:00
|
|
|
/**
|
|
|
|
* Add tax to our item
|
|
|
|
*
|
|
|
|
* @param Model_Country the country to get the tax rates
|
|
|
|
* @param Boolean Is this price inc/ex tax
|
|
|
|
*/
|
|
|
|
public function add_sub_item(Model_Country $co,$taxed=FALSE) {
|
|
|
|
$orig = $this->subtotal();
|
|
|
|
$tax = 0;
|
|
|
|
|
|
|
|
foreach ($co->tax->find_all() as $to) {
|
|
|
|
$iito = ORM::factory('Invoice_Item_Tax');
|
|
|
|
|
|
|
|
$iito->tax_id = $to->id;
|
|
|
|
$iito->amount = Currency::round($taxed ? ($orig-$orig/(1+$to->rate)) : $orig*$to->rate);
|
|
|
|
|
|
|
|
$tax += $iito->amount;
|
|
|
|
$this->subitem_add($iito);
|
|
|
|
}
|
|
|
|
|
|
|
|
// If taxed, we need to reduce our base_rate to a pre-tax amount
|
|
|
|
if ($taxed) {
|
|
|
|
$this->price_base -= Currency::round($tax/$this->quantity,1);
|
|
|
|
|
|
|
|
// If there is any rounding, we'll take it off the last IITO
|
|
|
|
$iito->amount += $orig-$this->total();
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
// The total of all discounts
|
|
|
|
public function discount() {
|
|
|
|
return Currency::round($this->discount_amt);
|
2013-09-06 05:39:56 +00:00
|
|
|
}
|
2013-10-10 02:44:53 +00:00
|
|
|
|
2013-12-19 23:00:32 +00:00
|
|
|
/**
|
|
|
|
* The line that will be printed on an invoice
|
|
|
|
*
|
|
|
|
* @todo This method includes some database format validation routines, which can be removed when the database
|
|
|
|
* is completly transformed.
|
|
|
|
*/
|
|
|
|
public function invoice_line() {
|
|
|
|
$ii = NULL;
|
|
|
|
|
|
|
|
// Our module is responsible for rending the invoice line
|
|
|
|
$ii = ($this->module_id AND method_exists($this->module(),'invoice_item')) ? $this->module()->invoice_item($this->item_type) : StaticList_ItemType::get($this->item_type);
|
|
|
|
|
|
|
|
switch ($this->item_type) {
|
|
|
|
// Service Charges
|
|
|
|
case 0:
|
|
|
|
return ((! $this->service_id OR $this->product_id OR $this->charge_id OR $this->product_name OR ! $this->recurring_schedule OR ! $this->date_start OR ! $this->date_stop) ? '+ ' : '').$ii.' '.$this->period();
|
|
|
|
case 1:
|
|
|
|
// @todo
|
2013-12-31 06:18:49 +00:00
|
|
|
return $this->product_name;
|
2013-12-19 23:00:32 +00:00
|
|
|
|
|
|
|
case 2:
|
|
|
|
case 3:
|
|
|
|
case 4:
|
|
|
|
case 5:
|
|
|
|
case 6:
|
|
|
|
return ((! $this->service_id OR $this->product_id OR $this->charge_id OR $this->product_name OR $this->recurring_schedule OR ! $this->date_start OR ! $this->date_stop) ? '+ ' : '').$ii;
|
2013-12-31 06:18:49 +00:00
|
|
|
|
2014-01-08 04:48:42 +00:00
|
|
|
case 7:
|
|
|
|
return ((! $this->service_id OR $this->product_id OR $this->charge_id OR $this->product_name OR ! $this->date_start OR ! $this->date_stop) ? '+ ' : '').$ii.' '.$this->period();
|
|
|
|
|
2013-12-31 06:18:49 +00:00
|
|
|
case 8:
|
|
|
|
return $this->product_name;
|
|
|
|
|
2013-12-19 23:00:32 +00:00
|
|
|
case 124:
|
|
|
|
case 125:
|
|
|
|
case 126:
|
|
|
|
case 127:
|
|
|
|
// @todo
|
|
|
|
return $ii;
|
|
|
|
|
|
|
|
// @todo DB records to fix.
|
|
|
|
default:
|
|
|
|
if ($this->charge_id)
|
|
|
|
return '*'.($ii ? $ii : $this->charge->description).' '.$this->period();
|
|
|
|
else
|
|
|
|
throw HTTP_Exception::factory(501,'Unable to render invoice item :id',array(':id'=>$this->id));
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return an instance of the Model of this charge
|
|
|
|
*/
|
|
|
|
public function module() {
|
|
|
|
$x = ORM::factory('Module',$this->module_id);
|
|
|
|
|
|
|
|
if (! $x->loaded())
|
|
|
|
throw new Kohana_Exception('Module :module doesnt exist?',array(':module'=>$this->module_id));
|
|
|
|
|
|
|
|
return ORM::factory('Module',$this->module_id)->instance($this->module_ref);
|
|
|
|
}
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
// Display the period that a transaction applies
|
|
|
|
public function period() {
|
2014-08-25 04:41:07 +00:00
|
|
|
return ($this->date_start == $this->date_stop) ? Site::Date($this->date_start) : sprintf('%s -> %s',Site::Date($this->date_start),Site::Date($this->date_stop));
|
2013-06-13 13:35:19 +00:00
|
|
|
}
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
public function save(Validation $validation = NULL) {
|
|
|
|
// Our items will be clobbered once we save the object, so we need to save it here.
|
|
|
|
$subitems = $this->subitems();
|
|
|
|
|
|
|
|
// Save the invoice item
|
|
|
|
parent::save($validation);
|
|
|
|
|
|
|
|
// Need to save the associated items and their taxes
|
|
|
|
if ($this->loaded()) {
|
|
|
|
foreach ($subitems as $iito) {
|
|
|
|
$iito->invoice_item_id = $this->id;
|
|
|
|
|
|
|
|
if (! $iito->changed())
|
|
|
|
continue;
|
|
|
|
|
|
|
|
$iito->save();
|
|
|
|
|
|
|
|
if (! $iito->saved()) {
|
2013-12-19 23:00:32 +00:00
|
|
|
$this->void = 1;
|
|
|
|
$this->save();
|
2013-12-05 05:22:23 +00:00
|
|
|
|
2013-12-19 23:00:32 +00:00
|
|
|
break;
|
|
|
|
}
|
2013-12-05 05:22:23 +00:00
|
|
|
}
|
2013-12-19 23:00:32 +00:00
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
} else
|
|
|
|
throw new Kohana_Exception('Couldnt save invoice_item for some reason?');
|
2013-12-31 06:18:49 +00:00
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
return $this;
|
2013-10-10 02:44:53 +00:00
|
|
|
}
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
// This total of this item before discounts and taxes
|
|
|
|
public function subtotal($format=FALSE) {
|
|
|
|
$result = $this->price_base*$this->quantity;
|
|
|
|
|
2013-12-19 23:00:32 +00:00
|
|
|
return $format ? Currency::display($result) : $result;
|
2013-10-10 02:44:53 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
// Sum up the tax that applies to this invoice item
|
2013-06-13 13:35:19 +00:00
|
|
|
public function tax($format=FALSE) {
|
2013-10-10 02:44:53 +00:00
|
|
|
$result = 0;
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
foreach ($this->subitems() as $iito)
|
|
|
|
$result += $iito->amount;
|
2013-10-10 02:44:53 +00:00
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
return $format ? Currency::display($result) : Currency::round($result);
|
2013-10-10 02:44:53 +00:00
|
|
|
}
|
|
|
|
|
2013-05-14 13:53:04 +00:00
|
|
|
public function tax_items() {
|
|
|
|
$result = array();
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
foreach ($this->subitems() as $iito) {
|
2014-01-07 12:29:18 +00:00
|
|
|
if (! isset($result[$iito->tax_id]))
|
|
|
|
$result[$iito->tax_id] = 0;
|
2013-05-14 13:53:04 +00:00
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
$result[$iito->tax_id] += $iito->amount;
|
2013-05-14 13:53:04 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return $result;
|
|
|
|
}
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
/**
|
|
|
|
* The title for invoice items
|
|
|
|
*/
|
|
|
|
public function title() {
|
2013-12-19 23:00:32 +00:00
|
|
|
if ($this->service_id AND $this->module_id AND method_exists($this->module(),'invoice_title'))
|
|
|
|
return $this->module_ref ? sprintf('%s: %s',$this->module()->invoice_title(),$this->service->name()) : $this->service->name();
|
|
|
|
elseif ($x=$this->module() AND ($x instanceof Model_Charge) AND $x->product_id)
|
|
|
|
return $x->product->title().' '.$this->service->name();
|
|
|
|
elseif ($this->product_id)
|
|
|
|
return sprintf('* %s: %s',$this->product->invoice_title(),$this->service->name());
|
2013-12-05 05:22:23 +00:00
|
|
|
else
|
|
|
|
return 'Unknown Item';
|
2013-10-10 02:44:53 +00:00
|
|
|
}
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
public function total($format=FALSE) {
|
|
|
|
$result = $this->void ? 0 : $this->subtotal()+$this->tax()-$this->discount();
|
|
|
|
|
|
|
|
return $format ? Currency::display($result) : Currency::round($result);
|
2013-10-10 02:44:53 +00:00
|
|
|
}
|
|
|
|
|
2013-12-05 05:22:23 +00:00
|
|
|
// Display a transaction number
|
|
|
|
public function trannum() {
|
|
|
|
return sprintf('%03s-%06s',$this->item_type,$this->id);
|
|
|
|
}
|
2013-06-13 13:35:19 +00:00
|
|
|
|
2013-10-10 02:44:53 +00:00
|
|
|
public function invoice_detail_items() {
|
|
|
|
switch ($this->item_type) {
|
|
|
|
case 0:
|
|
|
|
return $this->service->details('invoice_detail_items');
|
|
|
|
case 4:
|
|
|
|
return array('Charge'=>_('Service Connection Fee'));
|
|
|
|
case 5:
|
|
|
|
return $this->charge->details('invoice_detail_items');
|
|
|
|
default:
|
|
|
|
return array('Item'=>$this->item_type);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
?>
|