> 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/guide/nastroiki/eksport-kursov.md).

# Экспорт курсов

Настройка экспортного файла для мониторингов

Раздел «Экспорт курсов» используется для создания XML-файлов с курсами обменника.

Такие файлы обычно используются для:

* мониторингов обменных пунктов;
* партнёрских сервисов;
* собственных интеграций;
* внешних агрегаторов курсов;
* автоматического обмена данными между системами.

После создания система автоматически формирует XML-файл, который можно передать стороннему сервису по прямой ссылке.

Откройте: **«Настройки» — «Экспорт курсов»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-52d3454d71bbfe9ca15ec73a10bac81d0a791aba%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

В этом разделе можно создавать неограниченное количество экспортных файлов с разными настройками и наборами направлений.

## Как работает экспорт курсов

Каждый экспорт представляет собой отдельный XML-файл.

Например, если создать файл с названием: `rates`

система автоматически сформирует: `rates.xml`

После генерации он будет доступен по ссылке:

```
https://ваш_домен/exports/rates.xml
```

{% content-ref url="/spaces/uyjsNtEAtO6Sby8CHWyD/pages/Ny9MDhCjIGjUgLs9Zimw" %}
[Как сделать короткую ссылку на файл курсов?](/help-center/rabota-v-sisteme/sait-i-kontent/kak-sdelat-korotkuyu-ssylku-na-fail-kursov.md)
{% endcontent-ref %}

Каждый файл может иметь собственные настройки:

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

***

## Создание нового файла

Для создания файла:

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-3210f9c1bb71e6c6554d962c78fa2e156c548896%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

1. Откройте раздел **«Экспорт курсов».**
2. Нажмите **«Добавить файл».**
3. Заполните основные параметры.
4. Сохраните настройки.

{% stepper %}
{% step %}

### Название файла

Название определяет имя XML-файла.

Примеры:

```
rates
bestchange
monitoring
partner_export
```

Используйте:

* латинские буквы;
* цифры;
* символ `_`;
* символ `-`.

Не используйте:

```
курсы
rates.xml
мой файл
```

Расширение `.xml` система добавляет автоматически.
{% endstep %}

{% step %}

### Тип файла

Доступны два варианта.

#### XML

Стандартный XML-файл.

Подходит для:

* партнёров;
* собственных интеграций;
* агрегаторов;
* сторонних сервисов.

#### BestChange XML

Файл формируется по формату BestChange.

Используйте этот вариант, если файл предназначен для мониторинга BestChange.
{% endstep %}

{% step %}

### Доступность файла

Определяет, как файл будет доступен пользователям.

#### Всем

Файл отображается в публичном списке экспортов.

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

#### Только по ссылке

Файл не отображается в публичном списке.

Получить его можно только по прямой ссылке.

{% hint style="warning" %}
Важно: этот режим не устанавливает пароль на файл. Он только скрывает его из публичного списка.
{% endhint %}
{% endstep %}

{% step %}

### Статус

Определяет, участвует ли файл в автоматическом обновлении.

#### Включено

Файл автоматически обновляется системой.

#### Выключено

Файл сохраняется в системе, но больше не обновляется.
{% endstep %}

{% step %}

### Описание файла

Поле «Описание» используется для пояснения назначения файла.

Например: **Файл для мониторинга курсов**

Если файл доступен всем, описание может отображаться рядом со ссылкой.
{% endstep %}
{% endstepper %}

***

## Настройки расчёта курсов

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-a4409592c163c3ab2f74f4083a2de0dec0365ff2%2Fimage.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% stepper %}
{% step %}

### Учитывать правила верификации карты

Если включено, система учитывает правила верификации карты при расчёте курсов.

Рекомендуется оставить включённым, если в обменнике используются направления с обязательной проверкой карт.
{% endstep %}

{% step %}

### Скрывать направление при недостаточном резерве

Настройка: **«Скрывать направление, если резерв меньше минимальной суммы обмена»**

Если включена, направление не попадёт в XML, когда доступного резерва недостаточно для создания заявки.

Пример:

<table><thead><tr><th width="277.33984375">Параметр</th><th>Значение</th></tr></thead><tbody><tr><td>Минимальная сумма обмена</td><td>100 USDT</td></tr><tr><td>Резерв</td><td>50 USDT</td></tr></tbody></table>

Такое направление будет исключено из файла.
{% endstep %}
{% endstepper %}

***

## Знаки после запятой

Определяет, как округлять значения курсов и сумм.

Доступны два режима.

{% stepper %}
{% step %}

#### От настроек валюты

Система использует количество знаков после запятой из настроек валюты.

Это рекомендуемый режим.
{% endstep %}

{% step %}

#### Принудительно

Администратор сам задаёт количество знаков после запятой.

Например: `2`

Тогда все значения будут выводиться с двумя знаками после запятой.

Используйте только если внешний сервис требует конкретный формат.
{% endstep %}
{% endstepper %}

## Комиссии в XML

{% stepper %}
{% step %}

### fromfee

Определяет комиссию по стороне «Отдаю».

Можно выбрать:

* дополнительную комиссию обменника;
* комиссию платёжной системы.
  {% endstep %}

{% step %}

### tofee

Определяет комиссию по стороне «Получаю».

Можно выбрать:

* дополнительную комиссию обменника;
* комиссию платёжной системы.
  {% endstep %}
  {% endstepper %}

***

## Ручные направления

Настройка: **«Разрешить отключить ручные направления, когда оператор не в сети»**

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

Это удобно для:

* наличных обменов;
* ручных переводов;
* направлений с ручной обработкой;
* направлений с выдачей реквизитов оператором.

## Исключённые направления

В настройках файла можно выбрать направления, которые не должны попадать в экспорт.

Это полезно, если нужно создать отдельный файл:

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

Исключение действует только для текущего файла.

## Какие направления попадают в экспорт

Направление будет включено в XML, если:

* направление активно;
* обе валюты направления активны;
* курс больше нуля;
* направление не находится в списке исключений;
* экспорт разрешён в настройках направления;
* направление прошло все правила публикации;
* хватает резерва, если включена проверка резервов.

## Настройки экспорта в направлении

На каждое направление дополнительно влияет его собственная настройка экспорта.

Откройте нужное направление и перейдите в раздел: **«Экспорт»**

Там доступен параметр: **«Добавить направление в файл курсов»**

<figure><img src="https://1156649716-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FYuqSN6CIJoIeh8EPb0uE%2Fuploads%2Fgit-blob-f302a2b2e2cd0aac5970b16d10ccc871b4fb98af%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

Варианты:

<table><thead><tr><th width="271.359375">Значение</th><th>Описание</th></tr></thead><tbody><tr><td>Да</td><td>Направление участвует в экспорте</td></tr><tr><td>Да, только по расписанию</td><td>Направление попадает в XML только в определённое время</td></tr><tr><td>Нет</td><td>Направление полностью исключается из файлов курсов</td></tr></tbody></table>

## Автоматическое обновление файлов

Файлы курсов обновляются автоматически через систему планировщика задач.

После изменения настроек может потребоваться некоторое время, пока система сформирует новый XML-файл.

Если файл не обновляется, проверьте:

* включён ли экспорт;
* включено ли автоматическое обновление файлов курсов;
* есть ли активные направления;
* нет ли ошибок в курсах.

## Рекомендуемая настройка

Для большинства обменников подходит следующий вариант:

<table><thead><tr><th width="324.3203125">Параметр</th><th>Значение</th></tr></thead><tbody><tr><td>Тип файла</td><td>XML</td></tr><tr><td>Доступность</td><td>Только по ссылке</td></tr><tr><td>Статус</td><td>Включено</td></tr><tr><td>Знаки после запятой</td><td>От настроек валют</td></tr><tr><td>Проверка резервов</td><td>Включена</td></tr><tr><td>Учитывать верификацию карты</td><td>Включено</td></tr></tbody></table>

Для BestChange рекомендуется создать отдельный файл с типом: `BestChange XML`

## Частые проблемы

<details>

<summary>Файл не появился</summary>

Проверьте:

* файл включён;
* указано корректное название;
* есть активные направления;
* система успела выполнить обновление.

</details>

<details>

<summary>Направление отсутствует в XML</summary>

Проверьте:

* направление активно;
* курс больше нуля;
* хватает резерва;
* экспорт разрешён в настройках направления;
* направление не находится в исключениях.

</details>

<details>

<summary>XML пустой</summary>

Обычно это означает, что ни одно направление не прошло условия публикации.

Проверьте статусы направлений, валют, курсов и резервов.

</details>

***

### Коротко

Раздел «Экспорт курсов» позволяет формировать XML-файлы с курсами обменника для мониторингов, партнёров и внешних сервисов. Для каждого файла можно настроить формат, список направлений, комиссии, правила публикации и доступность, а система будет автоматически поддерживать данные в актуальном состоянии.