Курсы из файла

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

Это решение значительно экономит ваше время и исключает ошибки, возникающие при ручном вводе.

Как это работает?

Работа функции состоит из нескольких шагов:

1. Подготовка файла: Вы создаёте текстовый файл и добавляете туда курсы валют в нужном формате.

2. Загрузка файла: Вы размещаете файл по прямой ссылке в интернете (например, на вашем сервере или облачном хранилище).

3. Автоматическая обработка: Система самостоятельно скачивает файл, проверяет и обрабатывает данные, выполняет вычисления и обновляет базу данных.

4. Готово: Курсы валют обновлены и готовы к использованию.

Как правильно подготовить файл?

Файл должен быть обычным файлом с расширением .txt, .csv или .json.

Система автоматически определит формат по расширению ссылки и обработает содержимое.

• .txt — самый гибкий формат: поддерживает формулы, проценты, переменные и несколько пар в строке

• .csv — пары и значения разделены запятой (например: BTC - USDT, 61500)

• .json — данные в виде структуры: { "BTC - USDT": 61500 }

Если используется .txt, каждая строка должна описывать курс одной или нескольких валютных пар.

Например:

USD - RUB : 91.6
BTC - USDT, ETH - USDT : 61500
MAIN = BTC - USDT
ETH - USD : (MAIN) + 10%
USD - RUB : 91.6
BTC - USDT : 61505
RUB - USD : (USD - RUB)
EUR - USD : 1.07 + 0.01
ETH - USDT : (BTC - USDT) + 5%

BTC - USDT, 61500
ETH - USD, (BTC - USDT) - 2000
USD - RUB, 91.6
TRX - USD, (BTC - USDT) * 0.85

{
  "BTC - USDT": 61500,
  "ETH - USD": "(BTC - USDT) - 2000",
  "USD - RUB": 91.6,
  "TRX - USD": "(BTC - USDT) * 0.85 + 1.5%"
}

Общие рекомендации

• Размер файла не должен превышать 2 МБ

• Кодировка файла — UTF-8

• Формулы могут включать: +, -, *, /, %, скобки ()

• Можно использовать переменные и несколько пар в одной строке (только в .txt)

Что может быть указано в файле?

Файл поддерживает

Файл не поддерживает

Эти данные не будут обработаны (система просто их проигнорирует):

Скорость обработки файла

Как начать использовать функцию «Курсы из файла»?

Шаг 1: Создайте файл

Создайте простой текстовый файл (например: kurcy.txt) и вставьте туда курсы в правильном формате (см. выше).

Шаг 2: Загрузите файл

Загрузите этот файл в любое место, где можно получить прямую ссылку (ваш сайт, сервер, облако).

Пример ссылки: https://вашсайт.com/kurcy.txt

Шаг 3: Добавьте ссылку в систему

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

Шаг 4: Запустите обновление

Система автоматически скачает файл и обработает данные.

Какие математические операции можно использовать?

USD - BTC = 1 / (BTC - USD) = 1 / 25000 = 0.00004

Настройка валютных пар и файла курсов

В панели управления откройте раздел «Парсер курсов — Курсы из файла». Здесь вы можете добавить валютные пары и указать ссылку на файл с курсами. Названия валютных пар должны полностью совпадать с названиями пар, указанными внутри вашего файла курсов.

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

Пример валютной пары:

BTC - USD

(название пары должно быть таким же, как в вашем файле)

Пример ссылки на файл:

https://вашсайт.com/kurcy.txt

Чтобы добавить новую пару, нажмите кнопку "Добавить пару" расположенную в правом вверхнем углу

На открывшейся окне, заполните представленную форму

Добавление валютной пары

• Источник: Выберите источник, из которого будет происходить загрузка и парсинг курсов.

• Название:

  Введите название валютной пары точно так, как вы указали её в файле.

  (Например: USD - RUB)

• Знаки после, запятой:

  Укажите точность отображения курса. Рекомендуемое значение — 10 знаков.

  (Пример: курс 74.1234567890)

• Статус:

  Установите статус пары (Включен или Отключен). Неактивные пары не будут обновляться.

Добавление источника

Название: Укажите любое название источника

Ссылка на файл: Укажите ссылку, где у вас расположен файл курсов.

Привязать к направлению

Шаг 1: Переход к направлению обмена

1. Откройте панель управления.

2. Перейдите в раздел:

   «Основное — Направление обмена — Список направлений»

3. Найдите нужное вам направление обмена (например: «Сбербанк RUB → Банк. счёт THB»).

4. Чтобы изменить настройки этого направления, нажмите на значок ✏️ (карандаш).

   

Шаг 2: Переход в раздел «Курс обмена»

После нажатия на значок ✏️ откроются настройки направления обмена.

1. Слева найдите раздел «Обмен» и нажмите на него.

2. Выберите подраздел «Курс обмена».

Теперь откроется форма настройки курса конкретного направления.

Шаг 3: Переход к разделу настройки курса обмена

На странице настройки курса обмена вы увидите разные варианты:

• «Курс из источников»

• «Ручной курс обмена»

• «Курс по формуле»

• «Курс обмена из файла» (вам нужен именно этот раздел)

Следуйте далее инструкции:

1. В блоке «Курс обмена из файла» найдите поле «Выберите курс из файла» и нажмите на него.

2. Откроется список загруженных ранее курсов:

3. Выберите нужный курс из списка, нажав на него (например, USD - RUB).

Шаг 4: Сохранение изменений

После выбора курса:

• Убедитесь, что нужный курс корректно отображается в поле.

• Нажмите на кнопку «Сохранить».

Шаг 5: Проверка привязки курса

После сохранения обязательно проверьте, всё ли настроено правильно:

• Вернитесь в общий список направлений обмена.

• Проверьте, что направление отображает корректный курс из файла.

• При необходимости сделайте тестовый обмен, чтобы убедиться в корректности расчётов.