paymentcollection.php

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

<?php
 
namespace Bitrix\Sale;
 
use Bitrix\Main;
use Bitrix\Sale\Internals;
use Bitrix\Main\Entity;
use Bitrix\Main\Localization\Loc;
use Bitrix\Sale\PaySystem\Manager;
use Bitrix\Sale\PaySystem\Service;
 
Loc::loadMessages(__FILE__);

class PaymentCollection extends Internals\EntityCollection
{
    protected $order;

    protected function getEntityParent()
    {
        return $this->getOrder();
    }

    public function createItem(Service $service = null)
    {
        $paymentClassName = static::getItemCollectionClassName();
 
        $payment = $paymentClassName::create($this, $service);
        $this->addItem($payment);
 
        return $payment;
    }

    public function addItem(Internals\CollectableEntity $payment)
    {
        $payment = parent::addItem($payment);
 
        $order = $this->getOrder();
        return $order->onPaymentCollectionModify(EventActions::ADD, $payment);
    }

    public function deleteItem($index)
    {
        $oldItem = parent::deleteItem($index);

        $order = $this->getOrder();
        return $order->onPaymentCollectionModify(EventActions::DELETE, $oldItem);
    }

    public function onItemModify(Internals\CollectableEntity $item, $name = null, $oldValue = null, $value = null)
    {
        $order = $this->getOrder();
        return $order->onPaymentCollectionModify(EventActions::UPDATE, $item, $name, $oldValue, $value);
    }

    public function isPaid()
    {
        if (!empty($this->collection) && is_array($this->collection))
        {
            foreach ($this->collection as $payment)
            {
                if (!$payment->isPaid())
                    return false;
            }
 
            return true;
        }
 
        return false;
    }

    public function onOrderModify($name, $oldValue, $value)
    {
        $result = new Result();
 
        switch($name)
        {
            case "CANCELED":
 
                if ($value == "Y")
                {
                    $isPaid = false;

                    foreach ($this->collection as $payment)
                    {
                        if ($payment->isPaid())
                        {
                            $isPaid = true;
                            break;
                        }
                    }
 
                    if ($isPaid)
                    {
                        $result->addError(new ResultError(Loc::getMessage('SALE_ORDER_CANCEL_PAYMENT_EXIST_ACTIVE'), 'SALE_ORDER_CANCEL_PAYMENT_EXIST_ACTIVE'));
                    }
                }
 
            break;
 
            case "PRICE":
                $payment = $this->getItemForAutoEdit($oldValue);
                if ($payment !== null)
                {
                    $r = $payment->setField("SUM", $value);
                    if (!$r->isSuccess())
                    {
                        $result->addErrors($r->getErrors());
                    }
 
                    $service = $payment->getPaySystem();
                    if ($service)
                    {
                        $price = $service->getPaymentPrice($payment);
                        $payment->setField('PRICE_COD', $price);
                    }
                }
            break;
        }
 
        return $result;
    }
 
    public function onBeforeBasketItemDelete(BasketItem $basketItem) : Result
    {
        $result = new Result();

        foreach ($this->collection as $payment)
        {
            $r = $payment->onBeforeBasketItemDelete($basketItem);
            if (!$r->isSuccess())
            {
                $result->addErrors($r->getErrors());
            }
        }
 
        return $result;
    }
 
    protected function isAllowAutoEdit()
    {
        if (
            !$this->getOrder()->isCanceled()
            &&
            $this->count() === 1
        )
        {
            foreach ($this as $payment)
            {
                $isAllowEditPayment =
                    !$payment->isPaid()
                    &&
                    !$payment->isReturn()
                ;
 
                if ($isAllowEditPayment)
                {
                    if ($service = $payment->getPaySystem())
                    {
                        $isAllowEditPayment = $service->isAllowEditPayment();
                    }
                }
 
                return $isAllowEditPayment;
            }
        }
 
        return false;
    }
 
    private function getItemForAutoEdit($previousOrderSum) :? Payment
    {
        if ($this->isAllowAutoEdit())
        {
            foreach ($this as $payment)
            {
                if ($payment->getSum() === $previousOrderSum)
                {
                    return $payment;
                }
            }
        }
 
        return null;
    }

    public function setOrder(Order $order)
    {
        $this->order = $order;
    }

    public function getOrder()
    {
        return $this->order;
    }

    protected static function createPaymentCollectionObject()
    {
        $registry = Registry::getInstance(static::getRegistryType());
        $paymentCollectionClassName = $registry->getPaymentCollectionClassName();
 
        return new $paymentCollectionClassName();
    }

    public static function getRegistryType()
    {
        return Registry::REGISTRY_TYPE_ORDER;
    }

    public static function load(Order $order)
    {
        $paymentCollection = static::createPaymentCollectionObject();
        $paymentCollection->setOrder($order);
 
        if ($order->getId() > 0)
        {
            $paymentClassName = static::getItemCollectionClassName();
 
            $paymentList = $paymentClassName::loadForOrder($order->getId());
            foreach ($paymentList as $payment)
            {
                $payment->setCollection($paymentCollection);
                $paymentCollection->bindItem($payment);
            }
        }
 
        return $paymentCollection;
    }
 

    public function getPaidSum()
    {
        $sum = 0;
        if (!empty($this->collection) && is_array($this->collection))
        {
            foreach ($this->collection as $payment)
            {
                if ($payment->getField('PAID') == "Y")
                {
                    $sum += $payment->getSum();
                }
            }
        }
 
        return $sum;
    }

    public function getSum()
    {
        $sum = 0;
        if (!empty($this->collection) && is_array($this->collection))
        {
            foreach ($this->collection as $payment)
            {
                $sum += $payment->getSum();
            }
        }
 
        return $sum;
    }

    public function hasPaidPayment()
    {
        foreach ($this->collection as $payment)
        {
            if ($payment->getField('PAID') === "Y")
            {
                return true;
            }
        }
 
        return false;
    }

    public function hasUnpaidPayment()
    {
        foreach ($this->collection as $payment)
        {
            if ($payment->getField('PAID') === "N")
            {
                return true;
            }
        }
 
        return false;
    }

    public function save()
    {
        $result = new Entity\Result();

        if (!$order = $this->getOrder())
        {
            throw new Main\ObjectNotFoundException('Entity "Order" not found');
        }
 
        $itemsFromDb = array();
        if ($this->getOrder()->getId() > 0)
        {
            $itemsFromDbList = static::getList(
                array(
                    "filter" => array("ORDER_ID" => $this->getOrder()->getId()),
                    "select" => array("ID", "PAY_SYSTEM_NAME", "PAY_SYSTEM_ID")
                )
            );
            while ($itemsFromDbItem = $itemsFromDbList->fetch())
                $itemsFromDb[$itemsFromDbItem["ID"]] = $itemsFromDbItem;
        }
 
        $changeMeaningfulFields = array(
            "PAID",
            "PAY_SYSTEM_ID",
            "PAY_SYSTEM_NAME",
            "SUM",
            "IS_RETURN",
            "ACCOUNT_NUMBER",
            "EXTERNAL_PAYMENT",
        );

        foreach ($this->collection as $payment)
        {
            $isNew = $payment->getId() <= 0;
            $isChanged = $payment->isChanged();
 
            if ($order->getId() > 0 && $isChanged)
            {
                $logFields = array();
 
                $fields = $payment->getFields();
                $originalValues = $fields->getOriginalValues();
 
                foreach($originalValues as $originalFieldName => $originalFieldValue)
                {
                    if (in_array($originalFieldName, $changeMeaningfulFields) && $payment->getField($originalFieldName) != $originalFieldValue)
                    {
                        $logFields[$originalFieldName] = $payment->getField($originalFieldName);
                        if (!$isNew)
                            $logFields['OLD_'.$originalFieldName] = $originalFieldValue;
                    }
                }
            }
 
            $r = $payment->save();
            if ($r->isSuccess())
            {
                if ($order->getId() > 0)
                {
                    if ($isChanged)
                    {
                        $registry = Registry::getInstance(static::getRegistryType());

                        $orderHistory = $registry->getOrderHistoryClassName();
                        $orderHistory::addLog(
                            'PAYMENT',
                            $order->getId(),
                            $isNew ? 'PAYMENT_ADD' : 'PAYMENT_UPDATE',
                            $payment->getId(),
                            $payment,
                            $logFields,
                            $orderHistory::SALE_ORDER_HISTORY_LOG_LEVEL_1
                        );
 
                        $orderHistory::addAction(
                            'PAYMENT',
                            $order->getId(),
                            "PAYMENT_SAVED",
                            $payment->getId(),
                            $payment,
                            array(),
                            OrderHistory::SALE_ORDER_HISTORY_ACTION_LOG_LEVEL_1
                        );
                    }
 
                }
            }
            else
            {
                $result->addErrors($r->getErrors());
            }
 
            if (isset($itemsFromDb[$payment->getId()]))
            {
                unset($itemsFromDb[$payment->getId()]);
            }
        }
 
        foreach ($itemsFromDb as $k => $v)
        {
            $v['ENTITY_REGISTRY_TYPE'] = static::getRegistryType();

            $event = new Main\Event('sale', "OnBeforeSalePaymentDeleted", array(
                    'VALUES' => $v,
            ));
            $event->send();
 
            static::deleteInternal($k);

            $event = new Main\Event('sale', "OnSalePaymentDeleted", array(
                    'VALUES' => $v,
            ));
            $event->send();
 
            if ($order->getId() > 0)
            {
                $registry = Registry::getInstance(static::getRegistryType());

                $orderHistory = $registry->getOrderHistoryClassName();
                $orderHistory::addAction('PAYMENT', $order->getId(), 'PAYMENT_REMOVE', $k, null, array(
                    "PAY_SYSTEM_NAME" => $v["PAY_SYSTEM_NAME"],
                    "PAY_SYSTEM_ID" => $v["PAY_SYSTEM_ID"],
                ));
 
                $registry = Registry::getInstance(static::getRegistryType());

                $entityMarker = $registry->getEntityMarkerClassName();
                $entityMarker::deleteByFilter([
                    '=ORDER_ID' => $order->getId(),
                    '=ENTITY_TYPE' => $entityMarker::ENTITY_TYPE_PAYMENT,
                    '=ENTITY_ID' => $k,
                ]);
            }
 
        }
 
        if ($order->getId() > 0)
        {
            $registry = Registry::getInstance(static::getRegistryType());

            $orderHistory = $registry->getOrderHistoryClassName();
            $orderHistory::collectEntityFields('PAYMENT', $order->getId());
        }
 
        return $result;
    }

    public function getInnerPayment()
    {
        if (!$order = $this->getOrder())
        {
            throw new Main\ObjectNotFoundException('Entity "Order" not found');
        }
 
        if ($paySystemId = PaySystem\Manager::getInnerPaySystemId())
        {
            foreach ($this->collection as $payment)
            {
                if ($payment->getPaymentSystemId() == $paySystemId)
                    return $payment;
            }
        }
 
        return false;
    }

    public function createInnerPayment()
    {
        $payment = $this->getInnerPayment();
        if ($payment)
        {
            return $payment;
        }
 
        $paySystemId = PaySystem\Manager::getInnerPaySystemId();
        if (!empty($paySystemId))
        {
            $paySystem = Manager::getObjectById($paySystemId);
            if ($paySystem)
            {
                return $this->createItem($paySystem);
            }
        }
 
        return false;
    }

    public function isExistsInnerPayment()
    {
        if ($paySystemId = PaySystem\Manager::getInnerPaySystemId())
        {
            foreach ($this->collection as $payment)
            {
                if ($payment->getPaymentSystemId() == $paySystemId)
                    return true;
            }
        }
 
        return false;
    }

    public function verify()
    {
        $result = new Result();

        foreach ($this->collection as $payment)
        {
            $r = $payment->verify();
            if (!$r->isSuccess())
            {
                $result->addErrors($r->getErrors());

                if (!$order = $this->getOrder())
                {
                    throw new Main\ObjectNotFoundException('Entity "Order" not found');
                }
 
                $registry = Registry::getInstance(static::getRegistryType());

                $entityMarker = $registry->getEntityMarkerClassName();
                $entityMarker::addMarker($order, $payment, $r);
                $order->setField('MARKED', 'Y');
            }
        }
        return $result;
    }
 
    public function getBasketItemQuantity(BasketItem $basketItem) : float
    {
        $quantity = 0;

        foreach ($this->collection as $payment)
        {
            $quantity += $payment->getBasketItemQuantity($basketItem);
        }
 
        return $quantity;
    }

    public function createClone(\SplObjectStorage $cloneEntity)
    {
        if ($this->isClone() && $cloneEntity->contains($this))
        {
            return $cloneEntity[$this];
        }

        $paymentCollectionClone = parent::createClone($cloneEntity);
 
        if ($this->order)
        {
            if ($cloneEntity->contains($this->order))
            {
                $paymentCollectionClone->order = $cloneEntity[$this->order];
            }
        }
 
        return $paymentCollectionClone;
    }

    public function isMarked()
    {
        if (!empty($this->collection) && is_array($this->collection))
        {
            foreach ($this->collection as $payment)
            {
                if ($payment->isMarked())
                    return true;
            }
        }
 
        return false;
    }

    protected function deleteInternal($primary)
    {
        return Internals\PaymentTable::deleteWithItems($primary);
    }

    private static function getItemCollectionClassName()
    {
        $registry = Registry::getInstance(static::getRegistryType());
        return $registry->getPaymentClassName();
    }

    public static function getList(array $parameters = array())
    {
        return Internals\PaymentTable::getList($parameters);
    }

    public static function getInnerPaySystemId()
    {
        return PaySystem\Manager::getInnerPaySystemId();
    }
}