> For the complete documentation index, see [llms.txt](https://manual.boxexchanger.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manual.boxexchanger.net/obmen/parser-kursov/bestchange-v2.md).
# BestChange v2
## Установка парсера
Используя параметры ниже, установите парсер через функционал "**Install plugin**" по инструкции [Install plugin](/dopolnitelnye-sistemy/install-plugin.md).
Параметры для Install Plugin
**Plugin type**: **`Parser-rate module`**
**Plugin URL**: **`@boxexchanger-plugins/parser-bestchange-v2`**
**Directory path**: **`bestchange-v2`**
**Auth: (Deploy token)**: оставляем пустым
**Package tag**: **`latest`**
## Настройка парсера
1. Для запуска парсера, следуйте инструкции [Парсер курсов](/obmen/parser-kursov.md#konfiguraciya-parsera).
{% hint style="info" %}
Для применения изменений в поле, необходимо соглашаться с перезагрузкой процессов сервера.
{% endhint %}
2. В поле **"api\_key**" укажите API ключ (см. уточнение ниже) для получения курсов обмена -> нажмите "**Применить изменения (API\_KEY)**.
{% hint style="info" %}
API ключ для получения курсов обмена вы можете сгенерировать в ЛК BestChange по ссылке: . На странице "Профиль" - в разделе "API для получения курсов обмена", согласитесь с условиями использования BestChange -> нажмите "[**Получить**](#user-content-fn-1)[^1]" -> [**скопируйте**](#user-content-fn-2)[^2] API ключ.
{% endhint %}
3. Поле "**batch**" рекомендуем оставлять без изменений. Значение в данном поле отвечает за количество курсов, которое будет обрабатываться в одном API запросе. Максимальное значение: 500.
4. В поле "**places**" укажите места по которым необходимо получить курсы. К примеру, если необходимо получить курсы по 1,2 и 4 месту из списка BestChange по паре - введите **`1,2,4`** -> нажмите "**Применить изменения (PLACES)"**
5. В поле "**routes**" введите пары, по которым необходимо получить курсы. **Подробнее о формате и особенностях ввода пар:**
{% hint style="info" %}
Обратите внимание, в качестве XML для валют и городов необходимо использовать сигнатуры, представленные на странице BestChange:
{% endhint %}
{% hint style="info" %}
* **Особенности при указании пар:**\
а) **Безналичные валюты:** **`XML1_XML2`**. К примеру, для того чтобы получить курсы по паре **USDT TRC20 -> Monobank UAH** необходимо ввести **`USDTTRC20_MONOBUAH`**\
б) **Наличные валюты**: **`XML1_XML2-CITY`**. К примеру, для того чтобы получить курсы по паре **Cash USD KIEV -> USDT TRC20** необходимо ввести **`CASHUSD_USDTTRC20-KIEV`**
* Пары необходимо разделять запятой (**`,`**). **Пример**: **`USDTTRC20_MONOBUAH,CASHUSD_USDTTRC20-KIEV,BTC_USDTTRC20`**
{% endhint %}
-> нажмите "**Применить изменения (ROUTES)"**.
6. В поле "**cityKey**" укажите формат отображения названия города в паре:\
а) Значение **`name`** (**по умолчанию**). При таком параметре, название города в админ панели будет отображаться как имя города на английском языке, которое указано на [странице](https://www.bestchange.com/wiki/rates.html) BestChange. К примеру, если в поле "**routes**" ввести **`CASHUSD_USDTTRC20-WRCL`**, то в админ панели пара будет отображаться как **TOP\_1 - CASHUSD - WROCLAW -> USDTTRC20**.\
б) Значение **`code`**. При таком параметре, название города в админ панели будет отображаться как сигнатура города, которая указана на [странице](https://www.bestchange.com/wiki/rates.html) BestChange. К примеру, если в поле "**routes**" ввести **`CASHUSD_USDTTRC20-WRCL`**, то в админ панели пара будет отображаться как **TOP\_1 - CASHUSD - WRCL -> USDTTRC20**.\
\
-> нажмите "**Применить изменения (CITYKEY)"**.
{% hint style="warning" %}
В случае изменения формата отображения города в поле "**cityKey**" при условии, что парсер активен и в нем существуют пары - существующие курсы с предущим названием города перестанут обновляться, однако будут добавлены новые курсы, которые указаны в поле "**routes**" с обновленным названием города.
{% endhint %}
6. В поле "**sourceRate**" укажите источник курса:\
а) Значение **`bestchange.ru`**. При таком параметре курсы будут парситься из русскоязычной версии BestChange.\
б) Значение **`bestchange.com`**. При таком параметре курсы будут парситься из англоязычной версии BestChange.
7. В поле "**Интервал**" укажите в миллисекундах частоту обновления курсов. Рекомендуемое значение: `15000` -> нажмите "**Применить изменения (INTERVAL)".**
8. В поле "**ignoreChangerIds**" вы можете указать BestChange id обменных сервисов, курсы которых будут игнорироваться при парсинге.
{% hint style="success" %}
Обязательно добавьте в поле "**ignoreChangerIds**" BestChange Id вашего обменного сервиса. Данный шаг необходим для того чтобы парсер игнорировал курс вашего обменника при получении курсов и учитывал лишь курсы ваших конкурентов.
{% endhint %}
9. Парсер настроен.
{% hint style="info" %}
Перед использованием парсера также ознакомьтесь с разделом [Парсер курсов](/obmen/parser-kursov.md#prioritetnost-obnovlenii-kursov) для понимания порядка обновления курсов.
{% endhint %}
### Валидация курсов
В случае, если на BestChange отсутствуют курсы по паре, указанной в поле "**routes**" -> система установит курс 0 для такой пары.
* На клиентской части, направление с курсом 0 будет отображаться, однако станет [**недоступным**](#user-content-fn-3)[^3] для создания заявки.
* В админ панели на странице "**Настройка направлений"** - в поле с направлением, у которого выставлен курс 0, будет отображаться **знак предупреждения**. При наведении на данный знак, будет отображаться комментарий "[**Parser rate invalid rate can't be 0**](#user-content-fn-4)[^4]".
* В случае, если на BestChange курс по паре появится, то в парсере курс автоматически обновится и направление будет снова доступно для создания заявки на клиентской части. В админ панели, в свою очередь, курс также обновится и пропадет знак предупреждения.
[^1]: 
[^2]: 
[^3]: 
[^4]: 