basketitembase.php

См. документацию.

<?php
namespace Bitrix\Sale;
 
use Bitrix\Main;
use Bitrix\Main\ArgumentNullException;
use Bitrix\Main\Localization;
use Bitrix\Sale\Basket\RefreshFactory;
use Bitrix\Sale\Internals;
use Bitrix\Sale\Tax\VatCalculator;
 
Localization\Loc::loadMessages(__FILE__);

abstract class BasketItemBase extends Internals\CollectableEntity
{
    protected $propertyCollection;

    protected $calculatedFields;

    protected $provider;

    protected $internalId = null;
 
    protected static $idBasket = 0;

    public function findItemByBasketCode($basketCode)
    {
        if ((string)$this->getBasketCode() === (string)$basketCode)
        {
            return $this;
        }
 
        return null;
    }

    public function findItemByXmlId($xmlId)
    {
        if ((string)$this->getField('XML_ID') === (string)$xmlId)
        {
            return $this;
        }
 
        return null;
    }

    public static function getRegistryEntity()
    {
        return Registry::ENTITY_BASKET_ITEM;
    }

    public function findItemById($id)
    {
        $id = (int)$id;
 
        if ($id <= 0)
        {
            return null;
        }
 
        if ($this->getId() === $id)
        {
            return $this;
        }
 
        return null;
    }

    public function getBasketCode()
    {
        if ($this->internalId == null)
        {
            if ($this->getId() > 0)
            {
                $this->internalId = $this->getId();
            }
            else
            {
                static::$idBasket++;
                $this->internalId = 'n'.static::$idBasket;
            }
        }
 
        return $this->internalId;
    }

    public static function create(BasketItemCollection $basketItemCollection, $moduleId, $productId, $basketCode = null)
    {
        $fields = [
            "MODULE" => $moduleId,
            "BASE_PRICE" => 0,
            "CAN_BUY" => 'Y',
            "VAT_RATE" => null,
            "CUSTOM_PRICE" => 'N',
            "PRODUCT_ID" => $productId,
            'XML_ID' => static::generateXmlId(),
        ];
 
        $basket = $basketItemCollection->getBasket();
        if ($basket instanceof BasketBase)
        {
            $fields['LID'] = $basket->getSiteId();
        }
 
        $basketItem = static::createBasketItemObject($fields);
 
        if ($basketCode !== null)
        {
            $basketItem->internalId = $basketCode;
            if (mb_strpos($basketCode, 'n') === 0)
            {
                $internalId = intval(mb_substr($basketCode, 1));
                if ($internalId > static::$idBasket)
                {
                    static::$idBasket = $internalId;
                }
            }
        }
 
        $basketItem->setCollection($basketItemCollection);
 
        return $basketItem;
    }

    protected static function generateXmlId()
    {
        return uniqid('bx_');
    }

    private static function createBasketItemObject(array $fields = [])
    {
        $registry = Registry::getInstance(static::getRegistryType());
        $basketItemClassName = $registry->getBasketItemClassName();
 
        return new $basketItemClassName($fields);
    }

    public static function getSettableFields()
    {
        $result = [
            "NAME", "LID", "SORT", "PRODUCT_ID", "PRODUCT_PRICE_ID", "PRICE_TYPE_ID",
            "CATALOG_XML_ID", "PRODUCT_XML_ID", "DETAIL_PAGE_URL",
            "BASE_PRICE", "PRICE", "DISCOUNT_PRICE", "CURRENCY", "CUSTOM_PRICE",
            "QUANTITY", "WEIGHT", "DIMENSIONS", "MEASURE_CODE", "MEASURE_NAME",
            "DELAY", "CAN_BUY", "NOTES", "VAT_RATE", "VAT_INCLUDED", "BARCODE_MULTI",
            "SUBSCRIBE", "PRODUCT_PROVIDER_CLASS", "CALLBACK_FUNC", "ORDER_CALLBACK_FUNC",
            "CANCEL_CALLBACK_FUNC", "PAY_CALLBACK_FUNC", "TYPE", "SET_PARENT_ID",
            "DISCOUNT_NAME", "DISCOUNT_VALUE", "DISCOUNT_COUPON", "RECOMMENDATION", "XML_ID",
            "MARKING_CODE_GROUP"
        ];
 
        return array_merge($result, static::getCalculatedFields());
    }

    public static function getSettableFieldsMap()
    {
        static $fieldsMap = null;
 
        if ($fieldsMap === null)
        {
            $fieldsMap = array_fill_keys(static::getSettableFields(), true);
        }
 
        return $fieldsMap;
    }

    public static function getCalculatedFields()
    {
        return [
            'DISCOUNT_PRICE_PERCENT',
            'IGNORE_CALLBACK_FUNC',
            'DEFAULT_PRICE',
            'DISCOUNT_LIST'
        ];
    }

    public static function getAvailableFields()
    {
        return static::getSettableFields();
    }

    public static function getCustomizableFields() : array
    {
        return [
            'PRICE' => 'PRICE',
            'BASE_PRICE' => 'BASE_PRICE',
            'VAT_INCLUDED' => 'VAT_INCLUDED',
            'VAT_RATE' => 'VAT_RATE'
        ];
    }

    protected static function getMeaningfulFields()
    {
        return ['QUANTITY', 'PRICE', 'CUSTOM_PRICE'];
    }

    protected function __construct(array $fields = [])
    {
        parent::__construct($fields);
 
        $this->calculatedFields = new Internals\Fields();
    }

    protected function checkBeforeDelete()
    {
        return new Result();
    }

    public function delete()
    {
        $result = new Result();
 
        $checkResult = $this->checkBeforeDelete();
        if (!$checkResult->isSuccess())
        {
            $result->addErrors($checkResult->getErrors());
            return $result;
        }

        $oldEntityValues = $this->fields->getOriginalValues();

        $event = new Main\Event('sale', "OnBeforeSaleBasketItemEntityDeleted", [
                'ENTITY' => $this,
                'VALUES' => $oldEntityValues,
        ]);
        $event->send();
 
        if ($event->getResults())
        {
            foreach($event->getResults() as $eventResult)
            {
                if($eventResult->getType() == Main\EventResult::ERROR)
                {
                    $eventResultData = $eventResult->getParameters();
                    if ($eventResultData instanceof ResultError)
                    {
                        $error = $eventResultData;
                    }
                    else
                    {
                        $error = new ResultError(
                            Localization\Loc::getMessage('SALE_EVENT_ON_BEFORE_SALEBASKETITEM_ENTITY_DELETED_ERROR'),
                            'SALE_EVENT_ON_BEFORE_SALEBASKETITEM_ENTITY_DELETED_ERROR'
                        );
                    }
 
                    $result->addError($error);
                }
            }
 
            if (!$result->isSuccess())
            {
                return $result;
            }
        }
 
        $this->setFieldNoDemand("QUANTITY", 0);

        $r = parent::delete();
        if (!$r->isSuccess())
        {
            $result->addErrors($r->getErrors());
            return $result;
        }

        $oldEntityValues = $this->fields->getOriginalValues();

        $event = new Main\Event('sale', "OnSaleBasketItemEntityDeleted", [
                'ENTITY' => $this,
                'VALUES' => $oldEntityValues,
        ]);
        $event->send();
 
        if ($event->getResults())
        {
            foreach($event->getResults() as $eventResult)
            {
                if($eventResult->getType() == Main\EventResult::ERROR)
                {
                    $eventResultData = $eventResult->getParameters();
                    if ($eventResultData instanceof ResultError)
                    {
                        $error = $eventResultData;
                    }
                    else
                    {
                        $error = new ResultError(
                            Localization\Loc::getMessage('SALE_EVENT_ON_SALEBASKETITEM_ENTITY_DELETED_ERROR'),
                            'SALE_EVENT_ON_SALEBASKETITEM_ENTITY_DELETED_ERROR'
                        );
                    }
 
                    $result->addError($error);
                }
            }
        }
 
        return $result;
    }
 
    protected function normalizeValue($name, $value)
    {
        if ($this->isPriceField($name))
        {
            $value = PriceMaths::roundPrecision($value);
        }
        elseif ($name === 'VAT_RATE')
        {
            $value = is_numeric($value) ? (float)$value : null;
        }
 
        return parent::normalizeValue($name, $value);
    }

    public function setField($name, $value)
    {
        if ($this->isCalculatedField($name))
        {
            $this->calculatedFields->set($name, $value);
            return new Result();
        }
 
        if ($name === 'CUSTOM_PRICE')
        {
            if ($value == 'Y')
            {
                $this->markFieldCustom('PRICE');
            }
            else
            {
                $this->unmarkFieldCustom('PRICE');
            }
        }
 
        return parent::setField($name, $value);
    }

    public function setFieldNoDemand($name, $value)
    {
        if ($this->isCalculatedField($name))
        {
            $this->calculatedFields->set($name, $value);
            return;
        }
 
        if ($name === 'CUSTOM_PRICE')
        {
            if ($value === 'Y')
            {
                $this->markFieldCustom('PRICE');
            }
            else
            {
                $this->unmarkFieldCustom('PRICE');
            }
        }
 
        parent::setFieldNoDemand($name, $value);
    }

    public function getField($name)
    {
        static $calculatedFields = null;
 
        if ($calculatedFields === null)
        {
            $calculatedFields = array_fill_keys(static::getCalculatedFields(), true);
        }
 
        if (isset($calculatedFields[$name]))
        {
            if (
                isset($this->calculatedFields[$name])
                || (is_array($this->calculatedFields) && array_key_exists($name, $this->calculatedFields))
            )
            {
                return $this->calculatedFields->get($name);
            }
 
            return null;
        }
 
        return parent::getField($name);
    }

    protected function onBeforeSetFields(array $values)
    {
        $priorityFields = [
            'CURRENCY', 'CUSTOM_PRICE', 'VAT_RATE', 'VAT_INCLUDED',
            'PRODUCT_PROVIDER_CLASS', 'SUBSCRIBE', 'TYPE', 'LID', 'FUSER_ID'
        ];
 
        $priorityValues = [];
        foreach ($priorityFields as $field)
        {
            if (isset($values[$field]))
            {
                $priorityValues[$field] = $values[$field];
            }
        }
 
        return $priorityValues + $values;
    }

    public function setFields(array $fields)
    {
        foreach ($fields as $name => $value)
        {
            if ($this->isCalculatedField($name))
            {
                $this->calculatedFields[$name] = $value;
                unset($fields[$name]);
            }
        }
 
        return parent::setFields($fields);
    }

    public function getProviderName()
    {
        return $this->getProvider();
    }

    public function getCallbackFunction()
    {
        $callbackFunction = $this->getField('CALLBACK_FUNC');
        if (empty($callbackFunction))
        {
            return null;
        }
 
        $callbackFunction = trim((string)$callbackFunction);
        if (empty($callbackFunction) || !function_exists($callbackFunction))
        {
            return null;
        }
 
        return $callbackFunction;
    }

    public function getProviderEntity()
    {
        $module = $this->getField('MODULE');
        $productProviderName = $this->getField('PRODUCT_PROVIDER_CLASS');
        if (
            !isset($module)
            || !isset($productProviderName)
            || (strval($productProviderName) == "")
        )
        {
            return false;
        }
 
        if (!empty($module) && Main\Loader::includeModule($module))
        {
            return Internals\Catalog\Provider::getProviderEntity($productProviderName);
        }
 
        return null;
    }

    public function getProvider()
    {
        if ($this->provider !== null)
            return $this->provider;
 
        $module = $this->getField('MODULE');
        $productProviderName = $this->getField('PRODUCT_PROVIDER_CLASS');
        if (
            !isset($module)
            || !isset($productProviderName)
            || (strval($productProviderName) == "")
        )
        {
            return null;
        }
 
        $providerName = Internals\Catalog\Provider::getProviderName($module, $productProviderName);
        if ($providerName !== null)
        {
            $this->provider = $providerName;
        }
 
        return $providerName;
    }

    protected function onFieldModify($name, $oldValue, $value)
    {
        $result = new Result();
 
        if ($name === "QUANTITY")
        {
            if ($value == 0)
            {
                $result->addError(new Main\Error(
                    Localization\Loc::getMessage(
                        'SALE_BASKET_ITEM_ERR_QUANTITY_ZERO',
                        ['#PRODUCT_NAME#' => $this->getField('NAME')]
                    )
                ));
                return $result;
            }
 
            $value = (float)$value;
            $oldValue = (float)$oldValue;
            $deltaQuantity = $value - $oldValue;

            $basket = $this->getCollection();
            $context = $basket->getContext();

            $r = Internals\Catalog\Provider::getAvailableQuantityAndPriceByBasketItem($this, $context);
            if (!$r->isSuccess())
            {
                $result->addErrors($r->getErrors());
                $result->setData($r->getData());
 
                return $result;
            }
 
            $providerData = $r->getData();
 
            if ($this->getField('SUBSCRIBE') !== 'Y')
            {
                if ($providerData)
                {
                    if (array_key_exists('AVAILABLE_QUANTITY', $providerData) && $providerData['AVAILABLE_QUANTITY'] > 0)
                    {
                        $availableQuantity = $providerData['AVAILABLE_QUANTITY'];
                    }
                    else
                    {
                        $result->addError(
                            new ResultError(
                                Localization\Loc::getMessage(
                                    'SALE_BASKET_ITEM_WRONG_AVAILABLE_QUANTITY_2',
                                    ['#PRODUCT_NAME#' => $this->getField('NAME')]
                                ),
                                'SALE_BASKET_ITEM_WRONG_AVAILABLE_QUANTITY'
                            )
                        );
 
                        return $result;
                    }
                }
                else
                {
                    $errorMessageCode = 'SALE_BASKET_PRODUCT_NOT_AVAILABLE';
                    if ($this->isService())
                    {
                        $errorMessageCode = 'SALE_BASKET_SERVICE_NOT_AVAILABLE';
                    }
 
                    $result->addError(
                        new ResultError(
                            Localization\Loc::getMessage(
                                $errorMessageCode,
                                ['#PRODUCT_NAME#' => $this->getField('NAME')]
                            ),
                            'SALE_BASKET_ITEM_WRONG_AVAILABLE_QUANTITY'
                        )
                    );
 
                    return $result;
                }
            }
            else
            {
                $availableQuantity = $value;
            }
 
            if (isset($providerData['PRICE_DATA']['CUSTOM_PRICE']))
            {
                $this->markFieldCustom('PRICE');
            }
 
            $notPurchasedQuantity = $this->getNotPurchasedQuantity();
 
            if ($value != 0
                && (
                    (
                        $deltaQuantity > 0
                        && roundEx($availableQuantity, SALE_VALUE_PRECISION) < roundEx($notPurchasedQuantity, SALE_VALUE_PRECISION)
                    ) // plus
                    || (
                        $deltaQuantity < 0
                        && roundEx($availableQuantity, SALE_VALUE_PRECISION) > roundEx($notPurchasedQuantity, SALE_VALUE_PRECISION)
                    ) // minus
                )
            )
            {
                if ($deltaQuantity > 0)
                {
                    $canAddCount = $availableQuantity - $this->getReservedQuantity();
                    if ($canAddCount > 0)
                    {
                        $mess = Localization\Loc::getMessage(
                            'SALE_BASKET_AVAILABLE_FOR_ADDING_QUANTITY_IS_LESS',
                            [
                                '#PRODUCT_NAME#' => $this->getField('NAME'),
                                '#QUANTITY#' => $oldValue,
                                '#ADD#' => $canAddCount,
                            ]
                        );
                    }
                    else
                    {
                        $mess = Localization\Loc::getMessage(
                            'SALE_BASKET_AVAILABLE_FOR_ADDING_QUANTITY_IS_ZERO',
                            [
                                '#PRODUCT_NAME#' => $this->getField('NAME'),
                                '#QUANTITY#' => $oldValue,
                            ]
                        );
                    }
                }
                else
                {
                    $mess = Localization\Loc::getMessage(
                        'SALE_BASKET_AVAILABLE_FOR_DECREASE_QUANTITY',
                        [
                            '#PRODUCT_NAME#' => $this->getField('NAME'),
                            '#AVAILABLE_QUANTITY#' => $availableQuantity
                        ]
                    );
                }
 
                $result->addError(new ResultError($mess, "SALE_BASKET_AVAILABLE_QUANTITY"));
                $result->setData([
                    "AVAILABLE_QUANTITY" => $availableQuantity,
                    "REQUIRED_QUANTITY" => $deltaQuantity
                ]);
 
                return $result;
            }

            $collection = $this->getCollection();

            $basket = $collection->getBasket();
 
            if ((!$basket->getOrder() || $basket->getOrderId() == 0) && !($collection instanceof BundleCollection))
            {
                if (!$this->isMarkedFieldCustom('PRICE') && $value > 0)
                {
                    $r = $basket->refresh(RefreshFactory::createSingle($this->getBasketCode()));
                    if (!$r->isSuccess())
                    {
                        $result->addErrors($r->getErrors());
                        return $result;
                    }
                }
            }
 
            if (!$this->isMarkedFieldCustom('PRICE'))
            {
                $providerName = $this->getProviderName();
                if (strval($providerName) == '')
                {
                    $providerName = $this->getCallbackFunction();
                }
 
 
                if (!empty($providerData['PRICE_DATA']))
                {
                    if (isset($providerData['PRICE_DATA']['PRICE']))
                    {
                        $this->setField('PRICE', $providerData['PRICE_DATA']['PRICE']);
                    }
 
                    if (isset($providerData['PRICE_DATA']['BASE_PRICE']))
                    {
                        $this->setField('BASE_PRICE', $providerData['PRICE_DATA']['BASE_PRICE']);
                    }
 
                    if (isset($providerData['PRICE_DATA']['DISCOUNT_PRICE']))
                    {
                        $this->setField('DISCOUNT_PRICE', $providerData['PRICE_DATA']['DISCOUNT_PRICE']);
                    }
                }
                elseif ($providerName && !$this->isCustom())
                {
                    $result->addError(
                        new ResultError(
                            Localization\Loc::getMessage(
                                'SALE_BASKET_ITEM_WRONG_PRICE',
                                ['#PRODUCT_NAME#' => $this->getField('NAME')]
                            ),
                            'SALE_BASKET_ITEM_WRONG_PRICE'
                        )
                    );
 
                    return $result;
                }
            }
        }
 
        $r = parent::onFieldModify($name, $oldValue, $value);
        if ($r->isSuccess())
        {
            if ($r->hasWarnings())
            {
                $result->addWarnings($r->getWarnings());
            }
 
            if (
                $name === 'BASE_PRICE'
                || $name === 'DISCOUNT_PRICE'
            )
            {
                if (!$this->isCustomPrice())
                {
                    $price = $this->getField('BASE_PRICE') - $this->getField('DISCOUNT_PRICE');
                    $r = $this->setField('PRICE', $price);
                    if (!$r->isSuccess())
                        $result->addErrors($r->getErrors());
                }
            }
        }
        else
        {
            $result->addErrors($r->getErrors());
        }
 
        return $result;
    }

    public function isVatInPrice()
    {
        return $this->getField('VAT_INCLUDED') === 'Y';
    }

    public function getVat(): float|int
    {
        return PriceMaths::roundPrecision($this->getVatUnit() * $this->getQuantity());
    }

    public function getVatUnit(bool $withRound = true): float|int
    {
        $calculator = new VatCalculator((float)$this->getVatRate());
 
        return $calculator->calc(
            $this->getPrice(),
            $this->isVatInPrice(),
            $withRound
        );
    }

    public function getInitialPrice()
    {
        $price = PriceMaths::roundPrecision($this->getPrice() * $this->getQuantity());
 
        if ($this->isVatInPrice())
            $price -= $this->getVat();
 
        return $price;
    }

    public function getBasePriceWithVat()
    {
        $price = $this->getBasePrice();
 
        if (!$this->isVatInPrice())
        {
            $vatRate = (float)$this->getVatRate();
            $price += $this->getBasePrice() * $vatRate;
        }
 
        return PriceMaths::roundPrecision($price);
    }

    public function getPriceWithVat()
    {
        $price = $this->getPrice();
 
        if (!$this->isVatInPrice())
        {
            $vatRate = (float)$this->getVatRate();
            $price += $this->getPrice() * $vatRate;
        }
 
        return PriceMaths::roundPrecision($price);
    }

    public function getFinalPrice()
    {
        $price = PriceMaths::roundPrecision($this->getPrice() * $this->getQuantity());
 
        if (!$this->isVatInPrice())
            $price += $this->getVat();
 
        return $price;
    }

    protected function isCalculatedField($field)
    {
        static $calculateFields = null;
 
        if ($calculateFields === null)
        {
            $calculateFields = array_fill_keys(static::getCalculatedFields(), true);
        }
 
        return isset($calculateFields[$field]);
    }

    public function getProductId()
    {
        return (int)$this->getField('PRODUCT_ID');
    }

    public function getPrice()
    {
        return (float)$this->getField('PRICE');
    }

    public function getBasePrice()
    {
        return (float)$this->getField('BASE_PRICE');
    }

    public function getDiscountPrice()
    {
        return (float)$this->getField('DISCOUNT_PRICE');
    }

    public function isCustomPrice()
    {
        return $this->isMarkedFieldCustom('PRICE');
    }

    public function getCurrency()
    {
        return $this->getField('CURRENCY');
    }

    public function changeCurrency(string $currency): Main\Result
    {
        $result = new Main\Result();
 
        $oldCurrency = $this->getCurrency();
        if ($oldCurrency === $currency)
        {
            return $result;
        }
 
        $result->addErrors(
            $this->setField('CURRENCY', $currency)->getErrors()
        );
 
        return $result;
    }

    public function getQuantity() : float
    {
        return (float)$this->getField('QUANTITY');
    }

    public function getNotPurchasedQuantity() : float
    {
        return (float)$this->getField('QUANTITY');
    }

    public function getWeight()
    {
        return $this->getField('WEIGHT');
    }

    public function getVatRate()
    {
        return $this->getField('VAT_RATE');
    }

    public function getFUserId()
    {
        return $this->getField('FUSER_ID');
    }

    public function setOrderId($id)
    {
        $this->setField('ORDER_ID', (int)$id);
    }

    public function isBarcodeMulti()
    {
        return $this->getField('BARCODE_MULTI') === "Y";
    }

    public function canBuy() : bool
    {
        return $this->getField('CAN_BUY') === 'Y';
    }

    public function isDelay() : bool
    {
        return $this->getField('DELAY') === 'Y';
    }

    public function isSupportedMarkingCode() : bool
    {
        return $this->getMarkingCodeGroup() !== '';
    }

    public function getMarkingCodeGroup() : string
    {
        return (string)$this->getField('MARKING_CODE_GROUP');
    }

    public function getPropertyCollection()
    {
        if ($this->propertyCollection === null)
        {
            $registry = Registry::getInstance(static::getRegistryType());

            $basketPropertyCollectionClassName = $registry->getBasketPropertiesCollectionClassName();
 
            if ($this->getId() > 0)
            {
                $collection = $this->getCollection();
                $basketPropertyCollectionClassName::loadByCollection($collection);
            }
 
            if ($this->propertyCollection === null)
            {
                $this->propertyCollection = $basketPropertyCollectionClassName::load($this);
            }
        }
 
        return $this->propertyCollection;
    }

    public function isExistPropertyCollection()
    {
        return $this->propertyCollection !== null;
    }

    public function setPropertyCollection(BasketPropertiesCollectionBase $propertyCollection)
    {
        $this->propertyCollection = $propertyCollection;
    }

    public function setPrice($value, $custom = false)
    {
        $result = new Result();
 
        if ($custom)
        {
            $this->markFieldCustom('PRICE');
        }
        else
        {
            $this->unmarkFieldCustom('PRICE');
        }
 
        $r = $this->setField('PRICE', $value);
        if (!$r->isSuccess())
        {
            $result->addErrors($r->getErrors());
        }
 
        return $result;
    }

    public static function getRoundFields()
    {
        return [
            'BASE_PRICE',
            'DISCOUNT_PRICE',
            'DISCOUNT_PRICE_PERCENT',
        ];
    }

    public function initFields(array $values)
    {
        if (!isset($values['BASE_PRICE']) || doubleval($values['BASE_PRICE']) == 0)
            $values['BASE_PRICE'] = $values['PRICE'] + $values['DISCOUNT_PRICE'];
 
        parent::initFields($values);
    }

    public function save()
    {
        $this->checkCallingContext();
 
        $result = new Result();
 
        $id = $this->getId();
        $isNew = $id === 0;
 
        $this->onBeforeSave();
 
        $r = $this->callEventSaleBasketItemBeforeSaved($isNew);
        if (!$r->isSuccess())
        {
            return $r;
        }
 
        if (!$this->isChanged())
        {
            return $result;
        }
 
        if ($id > 0)
        {
            $r = $this->update();
        }
        else
        {
            $r = $this->add();
            if ($r->getId() > 0)
            {
                $id = $r->getId();
            }
        }
 
        if (!$r->isSuccess())
        {
            return $r;
        }
 
        if ($id > 0)
        {
            $result->setId($id);
 
            $controller = Internals\CustomFieldsController::getInstance();
            $controller->save($this);
        }
 
        $r = $this->callEventSaleBasketItemSaved($isNew);
        if (!$r->isSuccess())
        {
            return $r;
        }
 
        $propertyCollection = $this->getPropertyCollection();
        $r = $propertyCollection->save();
        if (!$r->isSuccess())
        {
            $result->addErrors($r->getErrors());
        }
 
        $this->callEventOnBasketItemEntitySaved();
 
        return $result;
    }

    public function getBasket()
    {
        $collection = $this->getCollection();
 
        return $collection->getBasket();
    }

    private function checkCallingContext()
    {
        $basket = $this->getBasket();
 
        $order = $basket->getOrder();
 
        if ($order)
        {
            if (!$order->isSaveRunning())
            {
                trigger_error("Incorrect call to the save process. Use method save() on \Bitrix\Sale\Order entity", E_USER_WARNING);
            }
        }
        else
        {
            if (!$basket->isSaveRunning())
            {
                trigger_error("Incorrect call to the save process. Use method save() on \Bitrix\Sale\Basket entity", E_USER_WARNING);
            }
        }
    }

    protected function onBeforeSave()
    {
        $collection = $this->getCollection();
 
        $basket = $collection->getBasket();
 
        if ($this->getField('ORDER_ID') <= 0)
        {
            $orderId = $collection->getOrderId();
            if ($orderId > 0)
            {
                $this->setFieldNoDemand('ORDER_ID', $orderId);
            }
        }
 
        if ($this->getId() <= 0)
        {
            if ($this->getField('FUSER_ID') <= 0)
            {
                $fUserId = (int)$basket->getFUserId(true);
                if ($fUserId <= 0)
                {
                    throw new Main\ArgumentNullException('FUSER_ID');
                }
 
                $this->setFieldNoDemand('FUSER_ID', $fUserId);
            }
        }
    }

    protected function add()
    {
        $result = new Result();
 
        $dateInsert = new Main\Type\DateTime();
 
        $this->setFieldNoDemand('DATE_INSERT', $dateInsert);
        $this->setFieldNoDemand('DATE_UPDATE', $dateInsert);
 
        $fields = $this->fields->getValues();
 
        $r = $this->addInternal($fields);
        if (!$r->isSuccess())
        {
            $result->addErrors($r->getErrors());
            return $result;
        }
 
        if ($resultData = $r->getData())
        {
            $result->setData($resultData);
        }
 
        $id = $r->getId();
        $this->setFieldNoDemand('ID', $id);
        $result->setId($id);
 
        return $result;
    }

    protected function update()
    {
        $result = new Result();
 
        $this->setFieldNoDemand('DATE_UPDATE', new Main\Type\DateTime());
 
        $fields = $this->fields->getChangedValues();
 
        if (!empty($fields))
        {
            $r = $this->updateInternal($this->getId(), $fields);
            if (!$r->isSuccess())
            {
                $result->addErrors($r->getErrors());
                return $result;
            }
 
            if ($resultData = $r->getData())
            {
                $result->setData($resultData);
            }
        }
 
        return $result;
    }

    protected function callEventOnBasketItemEntitySaved()
    {
        $oldEntityValues = $this->fields->getOriginalValues();
 
        if (!empty($oldEntityValues))
        {
            $event = new Main\Event(
                'sale',
                'OnSaleBasketItemEntitySaved',
                [
                    'ENTITY' => $this,
                    'VALUES' => $oldEntityValues,
                ]
            );
 
            $event->send();
        }
    }

    protected function callEventSaleBasketItemBeforeSaved($isNewEntity)
    {
        $result = new Result();

        $oldEntityValues = $this->fields->getOriginalValues();

        $event = new Main\Event('sale', EventActions::EVENT_ON_BASKET_ITEM_BEFORE_SAVED, [
            'ENTITY' => $this,
            'IS_NEW' => $isNewEntity,
            'VALUES' => $oldEntityValues,
        ]);
        $event->send();
 
        if ($event->getResults())
        {
            foreach($event->getResults() as $eventResult)
            {
                if($eventResult->getType() == Main\EventResult::ERROR)
                {
                    $errorMsg = new ResultError(
                        Localization\Loc::getMessage('SALE_EVENT_ON_BEFORE_BASKET_ITEM_SAVED'),
                        'SALE_EVENT_ON_BEFORE_BASKET_ITEM_SAVED'
                    );
 
                    $eventResultData = $eventResult->getParameters();
                    if ($eventResultData instanceof ResultError)
                        $errorMsg = $eventResultData;
 
                    $result->addError($errorMsg);
                }
            }
        }
 
        return $result;
    }

    protected function callEventSaleBasketItemSaved($isNewEntity)
    {
        $result = new Result();

        $oldEntityValues = $this->fields->getOriginalValues();

        $event = new Main\Event('sale', EventActions::EVENT_ON_BASKET_ITEM_SAVED, [
            'ENTITY' => $this,
            'IS_NEW' => $isNewEntity,
            'VALUES' => $oldEntityValues,
        ]);
        $event->send();
 
        if ($event->getResults())
        {
            foreach($event->getResults() as $eventResult)
            {
                if($eventResult->getType() == Main\EventResult::ERROR)
                {
                    $errorMsg = new ResultError(
                        Localization\Loc::getMessage('SALE_EVENT_ON_BASKET_ITEM_SAVED_ERROR'),
                        'SALE_EVENT_ON_BASKET_ITEM_SAVED_ERROR'
                    );
                    $eventResultData = $eventResult->getParameters();
 
                    if ($eventResultData instanceof ResultError)
                        $errorMsg = $eventResultData;
 
                    $result->addError($errorMsg);
                }
            }
        }
 
        return $result;
    }

    abstract protected function addInternal(array $fields);

    abstract protected function updateInternal($primary, array $fields);

    public function isChanged()
    {
        $isChanged = parent::isChanged();
 
        if ($isChanged === false)
        {
            $propertyCollection = $this->getPropertyCollection();
            $isChanged = $propertyCollection->isChanged();
        }
 
        return $isChanged;
    }

    public static function load(BasketItemCollection $basketItemCollection, $data)
    {
        $basketItem = static::createBasketItemObject($data);
        $basketItem->setCollection($basketItemCollection);
 
        return $basketItem;
    }

    public function verify()
    {
        $result = new Result();
 
        if ((float)$this->getField('QUANTITY') <= 0)
        {
            $result->addError(new Main\Error(
                Localization\Loc::getMessage(
                    'SALE_BASKET_ITEM_ERR_QUANTITY_ZERO',
                    ['#PRODUCT_NAME#' => $this->getField('NAME')]
                )
            ));
        }
 
        if (!$this->getField('CURRENCY'))
        {
            $result->addError(new Main\Error(
                Localization\Loc::getMessage('SALE_BASKET_ITEM_ERR_CURRENCY_EMPTY')
            ));
        }
 
        if ($basketPropertyCollection = $this->getPropertyCollection())
        {
            $r = $basketPropertyCollection->verify();
            if (!$r->isSuccess())
            {
                $result->addErrors($r->getErrors());
            }
        }
 
        return $result;
    }

    abstract public function getReservedQuantity();

    public function isCustom()
    {
        $moduleId = trim($this->getField('MODULE'));
        $providerClassName = trim($this->getField('PRODUCT_PROVIDER_CLASS'));
        $callback = trim($this->getField('CALLBACK_FUNC'));
 
        return (empty($moduleId) && empty($providerClassName) && empty($callback));
    }

    public static function getEntityEventName()
    {
        return 'SaleBasketItem';
    }
 
    protected function isPriceField(string $name) : bool
    {
        return
            $name === 'BASE_PRICE'
            || $name === 'PRICE'
            || $name === 'DISCOUNT_PRICE'
        ;
    }

    public function toArray() : array
    {
        $result = parent::toArray();
 
        $result['PROPERTIES'] = $this->getPropertyCollection()->toArray();
 
        return $result;
    }

    public function getDefaultPrice()
    {
        return (float)$this->getField('DEFAULT_PRICE');
    }
}