* @copyright 2007-2011 PrestaShop SA * @version Release: $Revision: 10014 $ * @license http://opensource.org/licenses/osl-3.0.php Open Software License (OSL 3.0) * International Registered Trademark & Property of PrestaShop SA */ /** * @since 1.5.0 */ class SupplyOrderDetailCore extends ObjectModel { /** * @var int Supply order */ public $id_supply_order; /** * @var int Product ordered */ public $id_product; /** * @var int Product attribute ordered */ public $id_product_attribute; /** * @var string Product reference */ public $reference; /** * @var string Product supplier reference */ public $supplier_reference; /** * @var int Product name */ public $name; /** * @var int Product EAN13 */ public $ean13; /** * @var string UPC */ public $upc; /** * @var int Currency used to buy this particular product */ public $id_currency; /** * @var float Exchange rate between $id_currency and SupplyOrder::$id_ref_currency, at the time */ public $exchange_rate; /** * @var float Unit price without discount, without tax */ public $unit_price_te = 0; /** * @var int Quantity ordered */ public $quantity_expected = 0; /** * @var int Quantity received */ public $quantity_received = 0; /** * @var float This defines the price of the product, considering the number of units to buy. * ($unit_price_te * $quantity), without discount, without tax */ public $price_te = 0; /** * @var float Supplier discount rate for a given product */ public $discount_rate = 0; /** * @var float Supplier discount value (($discount_rate / 100) * $price_te), without tax */ public $discount_value_te = 0; /** * @var float ($price_te - $discount_value_te), with discount, without tax */ public $price_with_discount_te = 0; /** * @var int Tax rate for the given product */ public $tax_rate = 0; /** * @var float Tax value for the given product */ public $tax_value = 0; /** * @var float ($price_with_discount_te + $tax_value) */ public $price_ti = 0; /** * @var float Tax value of the given product after applying the global order discount (i.e. if SupplyOrder::discount_rate is set) */ public $tax_value_with_order_discount = 0; /** * @var float This is like $price_with_discount_te, considering the global order discount. * (i.e. if SupplyOrder::discount_rate is set) */ public $price_with_order_discount_te = 0; /** * @see ObjectModel::$definition */ public static $definition = array( 'table' => 'supply_order_detail', 'primary' => 'id_supply_order_detail', 'fields' => array( 'id_supply_order' => array('type' => 'FILL_ME', 'validate' => 'isUnsignedId', 'required' => true), 'id_product' => array('type' => 'FILL_ME', 'validate' => 'isUnsignedId', 'required' => true), 'id_product_attribute' => array('type' => 'FILL_ME', 'validate' => 'isUnsignedId', 'required' => true), 'reference' => array('type' => 'FILL_ME', 'validate' => 'isReference'), 'supplier_reference' => array('type' => 'FILL_ME', 'validate' => 'isReference'), 'name' => array('type' => 'FILL_ME', 'validate' => 'isGenericName', 'required' => true), 'ean13' => array('type' => 'FILL_ME', 'validate' => 'isEan13'), 'upc' => array('type' => 'FILL_ME', 'validate' => 'isUpc'), 'id_currency' => array('type' => 'FILL_ME', 'validate' => 'isUnsignedId', 'required' => true), 'exchange_rate' => array('type' => 'FILL_ME', 'validate' => 'isFloat', 'required' => true), 'unit_price_te' => array('type' => 'FILL_ME', 'validate' => 'isPrice', 'required' => true), 'quantity_expected' => array('type' => 'FILL_ME', 'validate' => 'isUnsignedInt', 'required' => true), 'quantity_received' => array('type' => 'FILL_ME', 'validate' => 'isUnsignedInt'), 'price_te' => array('type' => 'FILL_ME', 'validate' => 'isPrice', 'required' => true), 'discount_rate' => array('type' => 'FILL_ME', 'validate' => 'isFloat', 'required' => true), 'discount_value_te' => array('type' => 'FILL_ME', 'validate' => 'isPrice', 'required' => true), 'price_with_discount_te' => array('type' => 'FILL_ME', 'validate' => 'isPrice', 'required' => true), 'tax_rate' => array('type' => 'FILL_ME', 'validate' => 'isFloat', 'required' => true), 'tax_value' => array('type' => 'FILL_ME', 'validate' => 'isPrice', 'required' => true), 'price_ti' => array('type' => 'FILL_ME', 'validate' => 'isPrice', 'required' => true), 'tax_value_with_order_discount' => array('type' => 'FILL_ME', 'validate' => 'isFloat', 'required' => true), 'price_with_order_discount_te' => array('type' => 'FILL_ME', 'validate' => 'isPrice', 'required' => true), ), ); /** * @see ObjectModel::getFields() */ public function getFields() { $this->validateFields(); $fields['id_supply_order'] = (int)$this->id_supply_order; $fields['id_product'] = (int)$this->id_product; $fields['id_product_attribute'] = (int)$this->id_product_attribute; $fields['reference'] = pSQL($this->reference); $fields['supplier_reference'] = pSQL($this->supplier_reference); $fields['name'] = pSQL($this->name); $fields['ean13'] = pSQL($this->ean13); $fields['upc'] = pSQL($this->upc); $fields['id_currency'] = (int)$this->id_currency; $fields['exchange_rate'] = (float)$this->exchange_rate; $fields['unit_price_te'] = (float)$this->unit_price_te; $fields['quantity_expected'] = (int)$this->quantity_expected; $fields['quantity_received'] = (int)$this->quantity_received; $fields['price_te'] = (float)$this->price_te; $fields['discount_rate'] = (float)$this->discount_rate; $fields['discount_value_te'] = (float)$this->discount_value_te; $fields['price_with_discount_te'] = (float)$this->price_with_discount_te; $fields['tax_rate'] = (float)$this->tax_rate; $fields['tax_value'] = (float)$this->tax_value; $fields['price_ti'] = (float)$this->price_ti; $fields['tax_value_with_order_discount'] = (float)$this->tax_value_with_order_discount; $fields['price_with_order_discount_te'] = (float)$this->price_with_order_discount_te; return $fields; } /** * @see ObjectModel::update() */ public function update($null_values = false) { $this->calculatePrices(); parent::update($null_values); } /** * @see ObjectModel::add() */ public function add($autodate = true, $null_values = false) { $this->calculatePrices(); parent::add($autodate, $null_values); } /** * Determines all prices for this product based on its quantity and unit price * Applies discount if necessary * Calculates tax value in function of tax rate * * @return array */ protected function calculatePrices() { // calculates entry price $this->price_te = Tools::ps_round((float)$this->unit_price_te * (int)$this->quantity_expected, 6); // calculates entry discount value if ($this->discount_rate != null && is_float($this->discount_rate) && $this->discount_rate > 0) $this->discount_value_te = Tools::ps_round((float)$this->price_te * ($this->discount_rate / 100), 6); // calculates entry price with discount $this->price_with_discount_te = Tools::ps_round($this->price_te - $this->discount_value_te, 6); // calculates tax value $this->tax_value = Tools::ps_round($this->price_with_discount_te * ((float)$this->tax_rate / 100), 6); $this->price_ti = Tools::ps_round($this->price_with_discount_te + $this->tax_value, 6); // defines default values for order discount fields $this->tax_value_with_order_discount = Tools::ps_round($this->tax_value, 6); $this->price_with_order_discount_te = Tools::ps_round($this->price_with_discount_te, 6); } /** * Applies a global order discount rate on the current product entity * * @param $discount_rate The discount rate in percent (Ex. 5 for 5 percents) */ public function applyGlobalDiscount($discount_rate) { if ($discount_rate != null && is_numeric($discount_rate) && (float)$discount_rate > 0) { // calculates new price, with global order discount, tax ecluded $discount_value = $this->price_with_discount_te - ($this->price_with_discount_te * ((float)$discount_rate / 100)); $this->price_with_order_discount_te = Tools::ps_round($discount_value, 6); // calculates new tax value, with global order discount $this->tax_value_with_order_discount = Tools::ps_round($this->price_with_order_discount_te * ((float)$this->tax_rate / 100), 6); parent::update(); } } /** * @see ObjectModel::validateController() */ public function validateController($htmlentities = true) { $errors = array(); /* required fields */ $fields_required = $this->fieldsRequired; if (isset(self::$fieldsRequiredDatabase[get_class($this)])) $fields_required = array_merge( $this->fieldsRequired, self::$fieldsRequiredDatabase[get_class($this)] ); foreach ($fields_required as $field) if (($value = $this->{$field}) == false && (string)$value != '0') if (!$this->id || $field != 'passwd') $errors[] = ''.self::displayFieldName($field, get_class($this), $htmlentities) .' '.Tools::displayError('is required.'); /* Checks maximum fields sizes */ foreach ($this->fieldsSize as $field => $max_length) if ($value = $this->{$field} && Tools::strlen($value) > $max_length) $errors[] = ''.self::displayFieldName($field, get_class($this), $htmlentities) .' '.Tools::displayError('is too long.').' ('.Tools::displayError('Maximum length:').' '.$max_length.')'; /* Checks fields validity */ foreach ($this->fieldsValidate as $field => $function) if ($value = $this->{$field}) if (!Validate::$function($value) && (!empty($value) || in_array($field, $this->fieldsRequired))) $errors[] = ''.self::displayFieldName($field, get_class($this), $htmlentities).' '.Tools::displayError('is invalid.'); else if ($field == 'passwd') if ($value = Tools::getValue($field)) $this->{$field} = Tools::encrypt($value); else $this->{$field} = $value; if ($this->quantity_expected <= 0) $errors[] = ''.self::displayFieldName('quantity_expected', get_class($this)).' '.Tools::displayError('is invalid.'); if ($this->tax_rate < 0 || $this->tax_rate > 100) $errors[] = ''.self::displayFieldName('tax_rate', get_class($this)).' '.Tools::displayError('is invalid.'); if ($this->discount_rate < 0 || $this->discount_rate > 100) $errors[] = ''.self::displayFieldName('discount_rate', get_class($this)).' '.Tools::displayError('is invalid.'); return $errors; } }