cashboxpaysystem.php

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

<?php
 
namespace Bitrix\Sale\Cashbox;
 
use Bitrix\Main;
use Bitrix\Sale;
use Bitrix\Sale\BusinessValue;
 
Main\Localization\Loc::loadMessages(__FILE__);

abstract class CashboxPaySystem extends Cashbox implements IPrintImmediately, ICheckable
{
    public const CACHE_ID = '';
    private const TTL = 31536000;
    protected const SEND_METHOD_HTTP_POST = 'POST';
    protected const SEND_METHOD_HTTP_GET = 'GET';
 
    abstract protected function getPrintUrl(): string;
 
    abstract protected function getCheckUrl(): string;
 
    abstract protected function send(string $url, Sale\Payment $payment, array $fields, string $method = self::SEND_METHOD_HTTP_POST): Sale\Result;
 
    abstract protected function processPrintResult(Sale\Result $result): Sale\Result;
 
    abstract protected function getDataForCheck(Sale\Payment $payment): array;
 
    abstract protected function processCheckResult(Sale\Result $result): Sale\Result;
 
    abstract protected function onAfterProcessCheck(Sale\Result $result, Sale\Payment $payment): Sale\Result;
 
    abstract public static function getPaySystemCodeForKkm(): string;

    public static function getSupportedKkmModels()
    {
        $supportedKkmModels = [];
 
        $paySystemIterator = Sale\PaySystem\Manager::getList([
            'filter' => [
                '=ACTIVE' => 'Y',
            ]
        ]);
        while ($paySystemItem = $paySystemIterator->fetch())
        {
            $paySystemService = new Sale\PaySystem\Service($paySystemItem);
            if (
                $paySystemService->isSupportPrintCheck()
                && $paySystemService->getCashboxClass() === '\\'.static::class
            )
            {
                $supportedKkmModels[] = static::getKkmValue($paySystemService);
            }
        }
 
        $supportedKkmModels = array_unique(array_merge(...$supportedKkmModels));
 
        $result = [];
        foreach ($supportedKkmModels as $supportedKkm)
        {
            $result[$supportedKkm] = [
                'NAME' => $supportedKkm
            ];
        }
 
        return $result;
    }

    protected function getPaySystemSetting(Sale\Payment $payment, string $code)
    {
        $params = $payment->getPaySystem()->getParamsBusValue($payment);
        return $params[$code] ?? null;
    }

    protected function checkParams(Check $check): Sale\Result
    {
        $result = new Sale\Result();
 
        $payment = CheckManager::getPaymentByCheck($check);
        if ($payment && $service = $payment->getPaySystem())
        {
            if (!$service->isSupportPrintCheck())
            {
                $result->addError(
                    new Main\Error(
                        Main\Localization\Loc::getMessage(
                            'SALE_CASHBOX_PAYSYSTEM_PAYSYSTEM_NOT_SUPPORT_PRINT_CHECK',
                            [
                                '#PAY_SYSTEM_NAME#' => $service->getField('NAME')
                            ]
                        )
                    )
                );
            }
 
            if (!$service->canPrintCheckSelf($payment))
            {
                $result->addError(
                    new Main\Error(
                        Main\Localization\Loc::getMessage(
                            'SALE_CASHBOX_PAYSYSTEM_PAYSYSTEM_CANT_PRINT_CHECK_SELF',
                            [
                                '#PAY_SYSTEM_NAME#' => $service->getField('NAME')
                            ]
                        )
                    )
                );
            }
        }
        else
        {
            $result->addError(
                new Main\Error(
                    Main\Localization\Loc::getMessage('SALE_CASHBOX_PAYSYSTEM_PAYMENT_NOT_FOUND')
                )
            );
        }
 
        return $result;
    }

    public function printImmediately(Check $check): Sale\Result
    {
        $result = new Sale\Result();
 
        $checkParamsResult = $this->checkParams($check);
        if (!$checkParamsResult->isSuccess())
        {
            $result->addErrors($checkParamsResult->getErrors());
            return $result;
        }
 
        if ($this->needPrintCheck($check))
        {
            $payment = CheckManager::getPaymentByCheck($check);
            if (!$payment)
            {
                $result->addError(
                    new Main\Error(
                        Main\Localization\Loc::getMessage('SALE_CASHBOX_PAYSYSTEM_PAYMENT_NOT_FOUND')
                    )
                );
                return $result;
            }
 
            $url = $this->getPrintUrl();
            $fields = $this->buildCheckQuery($check);
 
            $sendResult = $this->send($url, $payment, $fields);
            if ($sendResult->isSuccess())
            {
                $processPrintResult = $this->processPrintResult($sendResult);
                if ($processPrintResult->isSuccess())
                {
                    $result->setData($processPrintResult->getData());
                }
                else
                {
                    $result->addErrors($processPrintResult->getErrors());
                }
            }
            else
            {
                $result->addErrors($sendResult->getErrors());
            }
        }
 
        return $result;
    }

    protected function needPrintCheck(Check $check): bool
    {
        $isShipmentEntity = (bool)array_filter(
            $check->getEntities(),
            static function ($entity)
            {
                return $entity instanceof Sale\Shipment;
            }
        );
 
        return $check::getType() === SellCheck::getType() && $isShipmentEntity;
    }
 
    public function buildZReportQuery($id)
    {
        return [];
    }

    public function check(Check $check): Sale\Result
    {
        $result = new Sale\Result();
 
        $checkParamsResult = $this->checkParams($check);
        if (!$checkParamsResult->isSuccess())
        {
            $result->addErrors($checkParamsResult->getErrors());
            return $result;
        }
 
        $payment = CheckManager::getPaymentByCheck($check);
        if (!$payment)
        {
            $result->addError(
                new Main\Error(
                    Main\Localization\Loc::getMessage('SALE_CASHBOX_PAYSYSTEM_PAYMENT_NOT_FOUND')
                )
            );
            return $result;
        }
 
        $url = $this->getCheckUrl();
        $fields = $this->getDataForCheck($payment);
        $sendMethod = $this->getCheckHttpMethod();
 
        $sendResult = $this->send($url, $payment, $fields, $sendMethod);
        if (!$sendResult->isSuccess())
        {
            $result->addErrors($sendResult->getErrors());
            return $result;
        }
 
        $processCheckResult = $this->processCheckResult($sendResult);
        if ($processCheckResult->isSuccess())
        {
            $onAfterProcessCheckResult = $this->onAfterProcessCheck($processCheckResult, $payment);
            if (!$onAfterProcessCheckResult->isSuccess())
            {
                $result->addErrors($onAfterProcessCheckResult->getErrors());
            }
        }
        else
        {
            $result->addErrors($processCheckResult->getErrors());
        }
 
        return $result;
    }

    protected function getCheckHttpMethod(): string
    {
        return self::SEND_METHOD_HTTP_POST;
    }

    public static function getFfdVersion(): ?float
    {
        return 1.05;
    }

    public static function getKkmValue(Sale\PaySystem\Service $service): array
    {
        $paySystemCodeForKkm = static::getPaySystemCodeForKkm();
        $supportedKkmModels = BusinessValue::getValuesByCode(
            $service->getConsumerName(),
            $paySystemCodeForKkm
        );
 
        return $supportedKkmModels;
    }
 
    public static function isOfdSettingsNeeded(): bool
    {
        return false;
    }
}