255 lines
8.5 KiB
PHP
255 lines
8.5 KiB
PHP
<?php
|
|
/*
|
|
* 2007-2015 PrestaShop
|
|
*
|
|
* NOTICE OF LICENSE
|
|
*
|
|
* This source file is subject to the Open Software License (OSL 3.0)
|
|
* that is bundled with this package in the file LICENSE.txt.
|
|
* It is also available through the world-wide-web at this URL:
|
|
* http://opensource.org/licenses/osl-3.0.php
|
|
* If you did not receive a copy of the license and are unable to
|
|
* obtain it through the world-wide-web, please send an email
|
|
* to license@prestashop.com so we can send you a copy immediately.
|
|
*
|
|
* DISCLAIMER
|
|
*
|
|
* Do not edit or add to this file if you wish to upgrade PrestaShop to newer
|
|
* versions in the future. If you wish to customize PrestaShop for your
|
|
* needs please refer to http://www.prestashop.com for more information.
|
|
*
|
|
* @author PrestaShop SA <contact@prestashop.com>
|
|
* @copyright 2007-2015 PrestaShop SA
|
|
* @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 It now defines stock movements when the advanced stock management system is available
|
|
*/
|
|
class StockMvtCore extends ObjectModel
|
|
{
|
|
public $id;
|
|
|
|
/**
|
|
* @var string The creation date of the movement
|
|
*/
|
|
public $date_add;
|
|
|
|
/**
|
|
* @var int The employee id, responsible of the movement
|
|
*/
|
|
public $id_employee;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var string The first name of the employee responsible of the movement
|
|
*/
|
|
public $employee_firstname;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var string The last name of the employee responsible of the movement
|
|
*/
|
|
public $employee_lastname;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var int The stock id on wtich the movement is applied
|
|
*/
|
|
public $id_stock;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var int the quantity of product with is moved
|
|
*/
|
|
public $physical_quantity;
|
|
|
|
/**
|
|
* @var int id of the movement reason assoiated to the movement
|
|
*/
|
|
public $id_stock_mvt_reason;
|
|
|
|
/**
|
|
* @var int Used when the movement is due to a customer order
|
|
*/
|
|
public $id_order = null;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var int detrmine if the movement is a positive or negative operation
|
|
*/
|
|
public $sign;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var int Used when the movement is due to a supplier order
|
|
*/
|
|
public $id_supply_order = null;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var float Last value of the weighted-average method
|
|
*/
|
|
public $last_wa = null;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var float Current value of the weighted-average method
|
|
*/
|
|
public $current_wa = null;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var float The unit price without tax of the product associated to the movement
|
|
*/
|
|
public $price_te;
|
|
|
|
/**
|
|
* @since 1.5.0
|
|
* @var int Refers to an other id_stock_mvt : used for LIFO/FIFO implementation in StockManager
|
|
*/
|
|
public $referer;
|
|
|
|
/**
|
|
* @deprecated since 1.5.0
|
|
* @deprecated stock movement will not be updated anymore
|
|
*/
|
|
public $date_upd;
|
|
|
|
/**
|
|
* @deprecated since 1.5.0
|
|
* @see physical_quantity
|
|
* @var int
|
|
*/
|
|
public $quantity;
|
|
|
|
/**
|
|
* @see ObjectModel::$definition
|
|
*/
|
|
public static $definition = array(
|
|
'table' => 'stock_mvt',
|
|
'primary' => 'id_stock_mvt',
|
|
'fields' => array(
|
|
'id_employee' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'required' => true),
|
|
'employee_firstname' => array('type' => self::TYPE_STRING, 'validate' => 'isName'),
|
|
'employee_lastname' => array('type' => self::TYPE_STRING, 'validate' => 'isName'),
|
|
'id_stock' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'required' => true),
|
|
'physical_quantity' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedInt', 'required' => true),
|
|
'id_stock_mvt_reason' =>array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId', 'required' => true),
|
|
'id_order' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId'),
|
|
'id_supply_order' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId'),
|
|
'sign' => array('type' => self::TYPE_INT, 'validate' => 'isInt', 'required' => true),
|
|
'last_wa' => array('type' => self::TYPE_FLOAT, 'validate' => 'isPrice'),
|
|
'current_wa' => array('type' => self::TYPE_FLOAT, 'validate' => 'isPrice'),
|
|
'price_te' => array('type' => self::TYPE_FLOAT, 'validate' => 'isPrice', 'required' => true),
|
|
'referer' => array('type' => self::TYPE_INT, 'validate' => 'isUnsignedId'),
|
|
'date_add' => array('type' => self::TYPE_DATE, 'validate' => 'isDate', 'required' => true),
|
|
),
|
|
);
|
|
|
|
protected $webserviceParameters = array(
|
|
'objectsNodeName' => 'stock_movements',
|
|
'objectNodeName' => 'stock_movement',
|
|
'fields' => array(
|
|
'id_employee' => array('xlink_resource'=> 'employees'),
|
|
'id_stock' => array('xlink_resource'=> 'stock'),
|
|
'id_stock_mvt_reason' => array('xlink_resource'=> 'stock_movement_reasons'),
|
|
'id_order' => array('xlink_resource'=> 'orders'),
|
|
'id_supply_order' => array('xlink_resource'=> 'supply_order'),
|
|
),
|
|
);
|
|
|
|
/**
|
|
* @deprecated since 1.5.0
|
|
*
|
|
* This method no longer exists.
|
|
* There is no equivalent or replacement, considering that this should be handled by inventories.
|
|
*/
|
|
public static function addMissingMvt($id_employee)
|
|
{
|
|
// display that this method is deprecated
|
|
Tools::displayAsDeprecated();
|
|
}
|
|
|
|
/**
|
|
* Gets the negative (decrements the stock) stock mvts that correspond to the given order, for :
|
|
* the given product, in the given quantity.
|
|
*
|
|
* @since 1.5.0
|
|
* @param int $id_order
|
|
* @param int $id_product
|
|
* @param int $id_product_attribute Use 0 if the product does not have attributes
|
|
* @param int $quantity
|
|
* @param int $id_warehouse Optional
|
|
* @return Array mvts
|
|
*/
|
|
public static function getNegativeStockMvts($id_order, $id_product, $id_product_attribute, $quantity, $id_warehouse = null)
|
|
{
|
|
$movements = array();
|
|
$quantity_total = 0;
|
|
|
|
// preps query
|
|
$query = new DbQuery();
|
|
$query->select('sm.*, s.id_warehouse');
|
|
$query->from('stock_mvt', 'sm');
|
|
$query->innerJoin('stock', 's', 's.id_stock = sm.id_stock');
|
|
$query->where('sm.sign = -1');
|
|
$query->where('sm.id_order = '.(int)$id_order);
|
|
$query->where('s.id_product = '.(int)$id_product.' AND s.id_product_attribute = '.(int)$id_product_attribute);
|
|
|
|
// if filer by warehouse
|
|
if (!is_null($id_warehouse)) {
|
|
$query->where('s.id_warehouse = '.(int)$id_warehouse);
|
|
}
|
|
|
|
// orders the movements by date
|
|
$query->orderBy('date_add DESC');
|
|
|
|
// gets the result
|
|
$res = Db::getInstance(_PS_USE_SQL_SLAVE_)->query($query);
|
|
|
|
// fills the movements array
|
|
while ($row = Db::getInstance(_PS_USE_SQL_SLAVE_)->nextRow($res)) {
|
|
if ($quantity_total >= $quantity) {
|
|
break;
|
|
}
|
|
$quantity_total += (int)$row['physical_quantity'];
|
|
$movements[] = $row;
|
|
}
|
|
|
|
return $movements;
|
|
}
|
|
|
|
/**
|
|
* For a given product, gets the last positive stock mvt
|
|
*
|
|
* @since 1.5.0
|
|
* @param int $id_product
|
|
* @param int $id_product_attribute Use 0 if the product does not have attributes
|
|
* @return bool|array
|
|
*/
|
|
public static function getLastPositiveStockMvt($id_product, $id_product_attribute)
|
|
{
|
|
$query = new DbQuery();
|
|
$query->select('sm.*, w.id_currency, (s.usable_quantity = sm.physical_quantity) as is_usable');
|
|
$query->from('stock_mvt', 'sm');
|
|
$query->innerJoin('stock', 's', 's.id_stock = sm.id_stock');
|
|
$query->innerJoin('warehouse', 'w', 'w.id_warehouse = s.id_warehouse');
|
|
$query->where('sm.sign = 1');
|
|
if ($id_product_attribute) {
|
|
$query->where('s.id_product = '.(int)$id_product.' AND s.id_product_attribute = '.(int)$id_product_attribute);
|
|
} else {
|
|
$query->where('s.id_product = '.(int)$id_product);
|
|
}
|
|
$query->orderBy('date_add DESC');
|
|
|
|
$res = Db::getInstance(_PS_USE_SQL_SLAVE_)->executeS($query);
|
|
|
|
if ($res != false) {
|
|
return $res['0'];
|
|
}
|
|
return false;
|
|
}
|
|
}
|