Автоматическое обновление курса валют 1С-Битрикс

Николай Ковалёв
5 апр 2024
5 мин
Автоматическое обновление курса валют 1С-Битрикс

В редакциях 1С-Битрикс: Малый бизнес и выше заложен встроенный функционал для работы с мультивалютностью. Платформа позволяет вручную загружать актуальные котировки на любую выбранную дату, однако полностью автоматизировать этот процесс штатными средствами системы из коробки нельзя.

В этой статье разберем, как автоматически один раз в сутки запрашивать свежие данные и обновлять курсы нужных валют на сайте. Описанный способ подходит для сайтов, у которых в качестве базовой валюты используется белорусский или российский рубль.

Для получения актуального курса белорусского рубля (BYN) скрипт будет отправлять запросы к официальному API Национального банка Республики Беларусь. А для получения курса российского рубля (RUB) — к API Центрального банка Российской Федерации.

Готовый скрипт, который нужно добавить в файл /bitrix/php_interface/init.php:

class MyClass
{
    /**
     * Получения курса для валюты
     *
     * @param string $target_currency
     * @param string|null $date
     * @return void|string
     */
    public static function getExchangeRate(string $target_currency, string $date = null): void|string
    {
        if (empty($target_currency))
            return;

        \Bitrix\Main\Loader::includeModule('currency');
        global $DB;

        $log_file = $_SERVER['DOCUMENT_ROOT'] . '/get_' . $target_currency . '_currency.log';
        $base_currency = \Bitrix\Currency\CurrencyManager::getBaseCurrency();
        $target_date = $date ? $date : date('d.m.Y'); // если дата не указана, получаем для текущего дня
    
        switch ($base_currency) {
            case 'BYR':
            case 'BYN':
                $url = 'http://www.nbrb.by/Services/XmlExRates.aspx?ondate=' . $DB->FormatDate($target_date, CLang::GetDateFormat('SHORT', LANGUAGE_ID), 'Y-M-D');

                break;

            case 'RUB':
            case 'RUR':
                $url = 'https://www.cbr.ru/scripts/XML_daily.asp?date_req=' . $DB->FormatDate($target_date, CLang::GetDateFormat('SHORT', LANGUAGE_ID), 'D.M.Y');

                break;
        }
    
        $http = new \Bitrix\Main\Web\HttpClient();
        $http->setRedirect(true, 3);
        $data = $http->get($url);
    
        $charset = 'windows-1251';
        $matches = [];
        
        if (preg_match('/<\?XML[^>]{1,}encoding=["\']([^>"\']{1,})["\'][^>]{0,}\?>/i', $data, $matches))
            $charset = trim($matches[1]);

        $data = preg_replace('#<!DOCTYPE[^>]+?>#i', '', $data);
        $data = preg_replace('#<\\?XML[^>]+?\\?>#i', '', $data);
        $data = \Bitrix\Main\Text\Encoding::convertEncoding($data, $charset, SITE_CHARSET);
    
        $objXML = new CDataXML();
        $res = $objXML->LoadString($data);

        if ($res !== false)
            $data = $objXML->GetArray();
        else
            $data = false;

        $result = [];
    
        if (!empty($data) && is_array($data)) {
            switch ($base_currency) {
                case 'BYR':
                case 'BYN':
                    if (!empty($data['DailyExRates']['#']['Currency']) && is_array($data['DailyExRates']['#']['Currency'])) {
                        $currency_list = $data['DailyExRates']['#']['Currency'];

                        foreach ($currency_list as $currency_rate) {
                            if ($currency_rate['#']['CharCode'][0]['#'] == $target_currency) {
                                $result['STATUS'] = 'OK';
                                $result['RATE_CNT'] = (int) $currency_rate['#']['Scale'][0]['#'];
                                $result['RATE'] = (float) str_replace(',', '.', $currency_rate['#']['Rate'][0]['#']);

                                break;
                            }
                        }
                        unset($currency_rate, $currency_list);
                    }

                    break;

                case 'RUB':
                case 'RUR':
                    if (!empty($data['ValCurs']['#']['Valute']) && is_array($data['ValCurs']['#']['Valute'])) {
                        $currency_list = $data['ValCurs']['#']['Valute'];

                        foreach ($currency_list as $currency_rate) {
                            if ($currency_rate['#']['CharCode'][0]['#'] == $target_currency) {
                                $result['STATUS'] = 'OK';
                                $result['RATE_CNT'] = (int) $currency_rate['#']['Nominal'][0]['#'];
                                $result['RATE'] = (float) str_replace(',', '.', $currency_rate['#']['Value'][0]['#']);

                                break;
                            }
                        }
                        unset($currency_rate, $currency_list);
                    }

                    break;
            }
        }
    
        if ($result['STATUS'] == 'OK') {
            $db_rate = CCurrencyRates::GetList('date', 'desc', [
                'CURRENCY' => $target_currency,
                'DATE_RATE' => $target_date,
            ]);

            if (!$ar_rate = $db_rate->Fetch()) {
                $fields = [
                    'RATE' => $result['RATE'] * 0.97,
                    'RATE_CNT' => $result['RATE_CNT'],
                    'CURRENCY' => $target_currency,
                    'DATE_RATE' => $target_date,
                ];

                if (!CCurrencyRates::Add($fields))
                    file_put_contents($log_file, $target_date . ' Ошибка добавления курса' . PHP_EOL, FILE_APPEND);
                else
                    file_put_contents($log_file, $target_date . ' Курс успешно добавлен' . PHP_EOL, FILE_APPEND);
            }
            else
            {
                file_put_contents($log_file, $target_date . ' Курс уже существует' . PHP_EOL, FILE_APPEND);
            }
        }
    
        return 'MyClass::getExchangeRate(\'' . $target_currency . '\');';
    }
}

Остается создать агента, который раз в сутки будет запускать скрипт. Для этого переходим в Настройки > Настройки продукта > Агенты. Жмем Добавить агента и заполняем поля:

Дата и время следующего запуска: Вводим необходимую дату, не меньше текущей
Активен: Да
Функция агента: MyClass::getExchangeRate('RUB');
Периодичность выполнения: через заданный интервал
Интервал (сек.): 86400

После сохранения, перейдите в список агентов. Если агент успешно отрабатывает, в столбец Последний запуск запишется дата запуска, а дата в столбце Следующий запуск автоматически увеличится на сутки.