> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/knowledge-base/kursy-i-rezervy/rate-source-selection/file-rates.md).

# Курсы обмена из файлов

Создание источников и пар для курсов, которые читаются из текстовых файлов

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

Для работы требуется право «Разрешить управление файлами курсов в админпанели» из блока «Админпанель». Право выдаётся по пути **«Пользователи» — «Список групп пользователей»**.

## Список

В панели управления откройте:

**«Парсер курсов» — «Курсы из файла»**

Заголовок страницы отображается как «Курсы обмена из файлов». В списке видны пара, источник, курс, связанные направления, время обновления и статус. Доступны фильтры по паре, коду, источнику, курсу, формату, статусу и датам.

Запись с пометкой «Курс не определен» или проблемой обновления нельзя использовать без резервного безопасного сценария.

## Источники

Нажмите «Источники». Для каждого источника задаются название и «Ссылка на файл». Список показывает состояние проверки, количество связанных курсов и порядок.

Постоянная ссылка должна быть доступна системе без интерактивного входа. Не используйте ссылку, которая раскрывает секрет в публичном адресе. При смене ссылки сначала проверьте её на одной отключённой паре.

## Добавление пары

Откройте:

**«Парсер курсов» — «Курсы из файла»**

Нажмите «Добавить пару» и заполните:

* существующий или новый источник;
* «Ссылка на файл» для нового источника;
* «Название пары»;
* «Количество знаков после запятой»;
* «Статус».

Форма показывает формат названия `BTC - SBERRUB`. Используйте дефис и фактические коды источника.

Во время ввода выполняется «Проверка пары по файловому источнику». Она показывает:

* открывается ли файл;
* исходное и нормализованное имя пары;
* найдена ли строка;
* найденное выражение;
* итоговое значение;
* номер строки.

Не сохраняйте активную запись, пока предпросмотр не нашёл ожидаемую строку и число.

## Редактирование

При редактировании повторно доступны проверка имени и предпросмотр. Если изменился формат внешнего файла, сначала исправьте отключённую тестовую пару, затем остальные записи.

Изменение точности не исправляет неверное выражение. Сначала проверьте найденное исходное значение, затем округление.

Сохранённый технический код пары не меняется из-за редактирования названия источника или повторного импорта. Это сохраняет работоспособность формул, в которых код уже используется. Не удаляйте существующую пару только ради более удобного названия кода: новая запись будет другим источником для связанных формул.

Исторические коды источников могут содержать пробелы или круглые скобки. Редактор формул распознаёт такую ссылку целиком. Выбирайте её во вкладке «Переменные» и не исправляйте вручную только из-за внешнего вида.

Если разные новые названия после нормализации совпадают, система создаёт отдельные технические коды с числовым окончанием. Сверяйте видимое название, пару и значение, а код копируйте из интерфейса.

Файловые выражения рассчитываются как десятичные значения, в том числе для очень малых курсов и больших промежуточных чисел. Количество знаков после запятой управляет отображением результата, но не заменяет проверку исходного выражения. Перед включением сравните предпросмотр с независимым контрольным расчётом.

## Подключение к направлению

Откройте карточку направления и выберите файловый курс в разделе «Курс обмена». Затем откройте «Как сформирован курс» и убедитесь, что используется правильная запись и правильная ориентация.

## Безопасное обновление файла

1. Сохраните текущий рабочий формат и контрольную строку.
2. Подготовьте новый файл по постоянной ссылке.
3. Проверьте его на отключённой тестовой записи.
4. Сравните исходное и вычисленное значение.
5. Проверьте недоступную или пустую строку.
6. Обновите рабочий источник.
7. Проверьте все связанные пары и направления.

## Если пара не найдена

Проверьте доступность файла, пробелы и регистр кода, дефис, фактическое имя пары, строку предпросмотра и статус источника. Не маскируйте ошибку ручным курсом без срока и ответственного за возврат к рабочему источнику.
