cashboxbitrix.php

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

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

class CashboxBitrix extends Cashbox
{
    const TYPE_Z_REPORT = 1;

    public function buildCheckQuery(Check $check)
    {
        $result = array();
 
        $data = $check->getDataForCheck();
 
        foreach ($data['payments'] as $payment)
        {
            $result['payments'][] = array(
                'type' => $this->getValueFromSettings('PAYMENT_TYPE', $payment['type']),
                'value' => $payment['sum']
            );
        }
 
        $typeMap = $this->getCheckTypeMap();
        if (isset($typeMap[$data['type']]))
        {
            $result['type'] = $typeMap[$data['type']];
        }
        else
        {
            return array();
        }
 
        $result['uuid'] = static::buildUuid(static::UUID_TYPE_CHECK, $data['unique_id']);
        $result['zn'] = $this->getField('NUMBER_KKM');
        $result['items'] = array();
        foreach ($data['items'] as $item)
        {
            $vat = $this->getValueFromSettings('VAT', $item['vat']);
            if ($vat === null)
                $vat = $this->getValueFromSettings('VAT', 'NOT_VAT');
 
            $value = array(
                'name' => $item['name'],
                'price' => (float)$item['base_price'],
                'quantity' => $item['quantity'],
                'VAT' => (int)$vat
            );
 
            if (isset($item['discount']) && is_array($item['discount']))
            {
                $discountValue = PriceMaths::roundPrecision($item['base_price']*$item['quantity']) - $item['sum'];
                $value['discount'] = $discountValue;
 
                $discountType = $item['discount']['discount_type'] === 'P' ? 1 : 0;
                $value['discount_type'] = $discountType;
            }
 
            $result['items'][] = $value;
        }
        $result['client'] = $data['client_email'];

        $dateTime = $data['date_create'];
        $result['timestamp'] = (string)$dateTime->getTimestamp();
 
        return $result;
    }

    public function buildZReportQuery($id)
    {
        $dateTime = new Main\Type\DateTime();
 
        return array(
            'type' => static::TYPE_Z_REPORT,
            'uuid' => static::buildUuid(static::UUID_TYPE_REPORT, $id),
            'timestamp' => (string)$dateTime->getTimestamp(),
            'zn' => $this->getField('NUMBER_KKM')
        );
    }

    public static function getName()
    {
        return Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_TITLE');
    }

    public static function saveCashbox(array $cashbox)
    {
        if (isset($cashbox['ID']) && (int)$cashbox['ID'] > 0)
        {
            if ($cashbox['ENABLED'] !== $cashbox['PRESENTLY_ENABLED'])
            {
                Manager::update($cashbox['ID'], array('ENABLED' => $cashbox['PRESENTLY_ENABLED']));
 
                if ($cashbox['PRESENTLY_ENABLED'] === 'N')
                {
                    static::showAlarmMessage($cashbox['ID']);
                }
            }
 
            $fields = array('DATE_LAST_CHECK' => new Main\Type\DateTime());
            if (isset($cashbox['SETTINGS']))
            {
                $fields['SETTINGS'] = $cashbox['SETTINGS'];
            }
 
            if (isset($cashbox['HANDLER']))
            {
                $fields['HANDLER'] = $cashbox['HANDLER'];
            }
 
            Manager::update($cashbox['ID'], $fields);
        }
        else
        {
            $result = Manager::add(
                array(
                    'ACTIVE' => 'N',
                    'DATE_CREATE' => new Main\Type\DateTime(),
                    'NAME' => static::getName(),
                    'NUMBER_KKM' => $cashbox['NUMBER_KKM'],
                    'HANDLER' => $cashbox['HANDLER'],
                    'ENABLED' => $cashbox['PRESENTLY_ENABLED'],
                    'DATE_LAST_CHECK' => new Main\Type\DateTime(),
                    'EMAIL' => self::getCashboxDefaultEmail(),
                )
            );
 
            if ($result->isSuccess())
            {
                if ($cashbox['PRESENTLY_ENABLED'] === 'N')
                {
                    static::showAlarmMessage($result->getId());
                }
 
                Internals\CashboxZReportTable::add(array(
                    'STATUS' => 'Y',
                    'CASHBOX_ID' => $result->getId(),
                    'DATE_CREATE' => new Main\Type\DateTime(),
                    'DATE_PRINT_START' => new Main\Type\DateTime(),
                    'LINK_PARAMS' => '',
                    'CASH_SUM' => $cashbox['CACHE'],
                    'CASHLESS_SUM' => $cashbox['INCOME'] - $cashbox['CACHE'],
                    'CUMULATIVE_SUM' => $cashbox['NZ_SUM'],
                    'RETURNED_SUM' => 0,
                    'CURRENCY' => 'RUB',
                    'DATE_PRINT_END' => new Main\Type\DateTime()
                ));
            }
        }
    }

    private static function getCashboxDefaultEmail()
    {
        $email = Main\Config\Option::get('main', 'email_from');
        if (!$email)
        {
            $dbRes = Main\UserGroupTable::getList([
                'select' => ['EMAIL' => 'USER.EMAIL'],
                'filter' => [
                    '=GROUP_ID' => 1
                ],
                'order' => [
                    'USER.ID' => 'ASC'
                ]
            ]);
 
            $data = $dbRes->fetch();
            if ($data)
            {
                $email = $data['EMAIL'];
            }
        }
 
        return $email;
    }

    protected static function showAlarmMessage($cashboxId)
    {
        $tag = "CASHBOX_STATUS_ERROR";
 
        $dbRes = \CAdminNotify::GetList([], ["TAG" => $tag]);
 
        if ($res = $dbRes->Fetch())
        {
            return;
        }
 
        \CAdminNotify::Add([
            "MESSAGE" => Localization\Loc::getMessage('SALE_CASHBOX_ACCESS_UNAVAILABLE', ['#CASHBOX_ID#' => $cashboxId]),
            "TAG" => $tag,
            "MODULE_ID" => "SALE",
            "ENABLE_CLOSE" => "Y",
            "NOTIFY_TYPE" => \CAdminNotify::TYPE_ERROR
        ]);
    }
 

    public static function getCashboxList(array $data)
    {
        $result = array();
 
        if (isset($data['kkm']) && is_array($data['kkm']))
        {
            $factoryNum = array();
            foreach ($data['kkm'] as $kkm)
            {
                $factoryNum[] = $kkm['zn'];
            }
 
            $cashboxList = Manager::getListFromCache();
            foreach ($cashboxList as $item)
            {
                if (in_array($item['NUMBER_KKM'], $factoryNum))
                {
                    $result[$item['NUMBER_KKM']] = $item;
                }
            }
 
            foreach ($data['kkm'] as $kkm)
            {
                if (!isset($result[$kkm['zn']]))
                {
                    $result[$kkm['zn']] = array(
                        'NUMBER_KKM' => $kkm['zn'],
                        'NUMBER_FN' => $kkm['fn'],
                        'HANDLER' => '\\'.get_called_class(),
                        'CACHE' => $kkm['cache'],
                        'INCOME' => $kkm['reg_income'],
                        'NZ_SUM' => $kkm['nz_sum']
                    );
                }
 
                $result[$kkm['zn']]['PRESENTLY_ENABLED'] = ($kkm['status'] === 'ok') ? 'Y' : 'N';
            }
        }
 
        return $result;
    }

    public static function applyPrintResult(array $data)
    {
        $processedIds = array();
 
        foreach ($data['kkm'] as $kkm)
        {
            if (isset($kkm['printed']) && is_array($kkm['printed']))
            {
                foreach ($kkm['printed'] as $item)
                {
                    $uuid = static::parseUuid($item['uuid']);
 
                    $result = null;
                    if ($uuid['type'] === static::UUID_TYPE_CHECK)
                    {
                        $result = static::applyCheckResult($item);
                    }
                    elseif ($uuid['type'] === static::UUID_TYPE_REPORT)
                    {
                        $result = static::applyZReportResult($item);
                    }
 
                    if ($result !== null)
                    {
                        if ($result->isSuccess())
                        {
                            $processedIds[] = $item['uuid'];
                        }
                        else
                        {
                            $errors = $result->getErrors();
                            foreach ($errors as $error)
                            {
                                if ($error instanceof Errors\Error)
                                {
                                    $processedIds[] = $item['uuid'];
                                    break;
                                }
                            }
                        }
                    }
                }
            }
        }
 
        return $processedIds;
    }

    protected static function extractCheckData(array $data)
    {
        $uuid = self::parseUuid($data['uuid']);
        $result = array(
            'ID' => $uuid['id'],
            'TYPE' => $uuid['type'],
        );
 
        if ($data['code'] !== 0 && isset($data['message']))
        {
            $errorMsg = Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_ERR'.$data['code']);
            if (!$errorMsg)
                $errorMsg = $data['message'];
 
            $errorType = static::getErrorType($data['code']);
 
            $result['ERROR'] = array(
                'CODE' => $data['code'],
                'MESSAGE' => $errorMsg,
                'TYPE' => ($errorType === Errors\Error::TYPE) ? Errors\Error::TYPE : Errors\Warning::TYPE
            );
        }
 
        $result['LINK_PARAMS'] = static::getCheckLinkParams($data);
 
        return $result;
    }

    private static function getCheckLinkParams($data)
    {
        $linkParams = static::parseQrParam($data['qr']);
 
        $uuid = self::parseUuid($data['uuid']);
        $check = CheckManager::getObjectById($uuid['id']);
        if ($check)
        {
            $linkParams[Check::PARAM_CALCULATION_ATTR] = $check::getCalculatedSign();
        }
 
        if (isset($data['rn']))
        {
            $linkParams[Check::PARAM_REG_NUMBER_KKT] = $data['rn'];
        }
 
        return $linkParams;
    }

    protected static function extractZReportData(array $data)
    {
        $uuid = self::parseUuid($data['uuid']);
        $result = array(
            'ID' => $uuid['id'],
            'TYPE' => $uuid['type'],
        );
 
        if ($data['code'] !== 0 && isset($data['message']))
        {
            $errorMsg = Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_ERR'.$data['code']);
            if (!$errorMsg)
                $errorMsg = $data['message'];
 
            $errorType = static::getErrorType($data['code']);
            if ($errorType == null)
                $errorType = Errors\Warning::TYPE;
 
            $result['ERROR'] = array('MESSAGE' => $errorMsg, 'CODE' => $data['code'], 'TYPE' => $errorType);
        }
 
        $result['CASH_SUM'] = $data['payments_cache'];
        $result['CASHLESS_SUM'] = $data['reg_income'] - $data['payments_cache'];
        $result['CUMULATIVE_SUM'] = $data['nz_sum'];
        $result['RETURNED_SUM'] = $data['reg_return'];
        $result['LINK_PARAMS'] = static::parseQrParam($data['qr']);
 
        return $result;
    }

    protected function getCheckTypeMap()
    {
        return array(
            SellCheck::getType() => 1,
            SellReturnCashCheck::getType() => 2,
            SellReturnCheck::getType() => 2
        );
    }

    private static function parseQrParam($qr)
    {
        $result = array();
        $params = explode('&', $qr);
        if ($params)
        {
            foreach ($params as $param)
            {
                [$key, $value] = explode('=', $param);
                switch ($key)
                {
                    case 'fn' :
                        $key = Check::PARAM_FN_NUMBER;
                        break;
                    case 'fp' :
                        $key = Check::PARAM_FISCAL_DOC_ATTR;
                        break;
                    case 'i' :
                        $key = Check::PARAM_FISCAL_DOC_NUMBER;
                        break;
                    case 't' :
                        $key = Check::PARAM_DOC_TIME;
                        $dateTime = new Main\Type\DateTime($value, 'Ymd\THis');
                        $value = (string)$dateTime->getTimestamp();
                        break;
                    case 's' :
                        $key = Check::PARAM_DOC_SUM;
                        break;
                    case 'n' :
                        $key = Check::PARAM_CALCULATION_ATTR;
                        break;
                    default:
                        continue 2;
                }
 
                $result[$key] = $value;
            }
        }
 
        return $result;
    }

    protected static function getErrorType($errorCode)
    {
        $errors = array(-3800, -3803, -3804, -3805, -3816, -3807, -3896, -3897, -4026);
        if (in_array($errorCode, $errors))
            return Errors\Error::TYPE;
 
        $warnings = array();
        if (in_array($errorCode, $warnings))
            return Errors\Warning::TYPE;
 
        return null;
    }

    public static function getSettings($modelId = 0)
    {
        $settings = array();
 
        $kkmList = static::getSupportedKkmModels();
        if (isset($kkmList[$modelId]))
        {
            $defaultSettings = $kkmList[$modelId]['SETTINGS'];
 
            if (isset($defaultSettings['PAYMENT_TYPE']))
            {
                $settings['PAYMENT_TYPE'] = array(
                    'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_P_TYPE'),
                    'REQUIRED' => 'Y',
                    'ITEMS' => array()
                );
 
                foreach ($defaultSettings['PAYMENT_TYPE'] as $type => $value)
                {
                    $settings['PAYMENT_TYPE']['ITEMS'][$type] = array(
                        'TYPE' => 'STRING',
                        'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_P_TYPE_LABEL_'.mb_strtoupper($type)),
                        'VALUE' => $value
                    );
                }
            }
 
 
            $settings['VAT'] = array(
                'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_VAT'),
                'REQUIRED' => 'Y',
                'ITEMS' => array(
                    'NOT_VAT' => array(
                        'TYPE' => 'STRING',
                        'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_VAT_LABEL_NOT_VAT'),
                        'VALUE' => $defaultSettings['VAT']['NOT_VAT']
                    )
                )
            );
 
            if (Main\Loader::includeModule('catalog'))
            {
                $dbRes = Catalog\VatTable::getList(array('filter' => array('ACTIVE' => 'Y')));
                $vatList = $dbRes->fetchAll();
                if ($vatList)
                {
                    foreach ($vatList as $vat)
                    {
                        $value = '';
                        if (isset($defaultSettings['VAT'][(int)$vat['RATE']]))
                            $value = $defaultSettings['VAT'][(int)$vat['RATE']];
 
                        $settings['VAT']['ITEMS'][(int)$vat['ID']] = array(
                            'TYPE' => 'STRING',
                            'LABEL' => $vat['NAME'].' ['.(int)$vat['RATE'].'%]',
                            'VALUE' => $value
                        );
                    }
                }
            }
        }
 
        $hours = array();
        for ($i = 0; $i < 24; $i++)
        {
            $value = ($i < 10) ? '0'.$i : $i;
            $hours[$i] = $value;
        }
 
        $minutes = array();
        for ($i = 0; $i < 60; $i+=5)
        {
            $value = ($i < 10) ? '0'.$i : $i;
            $minutes[$i] = $value;
        }
 
        $settings['Z_REPORT'] = array(
            'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_Z_REPORT'),
            'ITEMS' => array(
                'TIME' => array(
                    'TYPE' => 'DELIVERY_MULTI_CONTROL_STRING',
                    'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_Z_REPORT_LABEL'),
                    'ITEMS' => array(
                        'H' => array(
                            'TYPE' => 'ENUM',
                            'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_Z_REPORT_LABEL_H'),
                            'VALUE' => 23,
                            'OPTIONS' => $hours
                        ),
                        'M' => array(
                            'TYPE' => 'ENUM',
                            'LABEL' => Localization\Loc::getMessage('SALE_CASHBOX_BITRIX_SETTINGS_Z_REPORT_LABEL_M'),
                            'VALUE' => 30,
                            'OPTIONS' => $minutes
                        ),
                    )
                )
            )
        );
 
        return $settings;
    }

    public static function extractSettingsFromRequest(Main\HttpRequest $request)
    {
        $settings = parent::extractSettingsFromRequest($request);
 
        if ($settings['PAYMENT_TYPE'])
        {
            /* hack is for difference between real values of payment cashbox's settings and user view (diff is '-1') */
            foreach ($settings['PAYMENT_TYPE'] as $i => $payment)
            {
                if ((int)$payment)
                    $settings['PAYMENT_TYPE'][$i] = (int)$payment - 1;
                else
                    $settings['PAYMENT_TYPE'][$i] = 0;
            }
        }
 
        return $settings;
    }

    public static function getGeneralRequiredFields()
    {
        $generalRequiredFields = parent::getGeneralRequiredFields();
 
        $map = Internals\CashboxTable::getMap();
        $generalRequiredFields['KKM_ID'] = $map['KKM_ID']['title'];
        $generalRequiredFields['NUMBER_KKM'] = $map['NUMBER_KKM']['title'];
 
        return $generalRequiredFields;
    }

    public static function getSupportedKkmModels()
    {
        return array(
            'atol' => array(
                'NAME' => 'ATOL',
                'SETTINGS' => array(
                    'VAT' => array(
                        'NOT_VAT' => 4,
                        0 => 1,
                        10 => 2,
                        18 => 3
                    ),
                    'PAYMENT_TYPE' => array(
                        Check::PAYMENT_TYPE_CASH => 0,
                        Check::PAYMENT_TYPE_CASHLESS => 3,
                    )
                )
            ),
        );
    }
 
    public static function getFfdVersion(): ?float
    {
        return 1.0;
    }
}