🏪 Управление партнерами

Назад к списку Редактировать
Информация
Slug:
partners-management.html
Обновлено:
30.05.2026 15:03
Размер:
8.56 KB
Путь:
/resources/docs/user/partners-management.html
Редактировать
Ссылки
Публичная ссылка:
Ссылка в админке:
🏪 Управление партнерами

Что такое партнер в системе DEXA?

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

Информация о партнере включает:

  • Название и контакты - отображаются клиентам на сайте
  • Геолокация - город, адрес, координаты для карты
  • Режим работы - часы приема клиентов
  • Принимаемые валюты - список доступных для обмена валют
  • Индивидуальные курсы - могут отличаться от общих
  • Рейтинг - на основе отзывов клиентов
  • API интеграция - отдельный источник курсов для партнера

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

  1. Перейдите в раздел Партнеры → Добавить партнера
  2. Заполните обязательные поля:
    • Название - наименование партнера
    • Город - выберите из списка
    • Адрес - полный физический адрес
    • Телефон - контактный номер
    • Email - электронная почта
    • График работы - например: "09:00-21:00, без выходных"
  3. Опционально заполните:
    • Координаты - широта и долгота для отображения на карте
    • Рейтинг - начальный рейтинг (0-5)
    • API для курсов - выберите внешний источник курсов для партнера
    • Принимаемые валюты - отметьте валюты, которые принимает партнер
    • Описание - дополнительная информация о партнере
  4. Нажмите Сохранить
⚠️ Важно: Если у партнера не настроены принимаемые валюты, система будет считать, что он не принимает НИКАКИЕ валюты! Это приведет к ошибке при создании заявок для этого партнера.

Настройка курсов партнера

У каждого партнера могут быть свои курсы обмена. Они имеют приоритет над общими курсами.

Система приоритетов курсов:

  1. Ручной курс партнера - самый высокий приоритет
  2. Внешний курс партнера - из выбранного API с наценкой
  3. Ручной общий курс - общий курс для всех партнеров
  4. Общий внешний курс - из API по умолчанию

Настройка индивидуальных курсов:

  1. Перейдите в карточку партнера
  2. Нажмите кнопку Настроить курсы (иконка графика в списке партнеров)
  3. Для каждой валютной пары можно настроить:
    • Ручной курс - фиксированное значение
    • Использовать внешний курс как базу - галочка для применения наценки к внешнему курсу
    • Наценка/скидка % - процент для внешнего курса
    • Мин/макс сумма - лимиты для этого партнера
    • Активность - включить/отключить курс
  4. Нажмите Сохранить все курсы
💡 Пример: Если вы хотите, чтобы курс партнера был на 2% выше рыночного:
  • Поставьте галочку "Использовать внешний курс как базу"
  • В поле "Наценка %" укажите 2
  • Ручной курс можно оставить пустым
Итоговый курс = внешний курс × (1 + 2/100) = внешний курс × 1.02

Обновление курсов партнера из API

Если партнеру назначен API источник, вы можете обновить его курсы автоматически:

  1. В карточке партнера нажмите кнопку Обновить курсы (в правом верхнем углу)
  2. Выберите API из выпадающего списка или используйте API по умолчанию
  3. Нажмите Обновить
📝 Примечание: При обновлении из API старые внешние курсы партнера удаляются и заменяются новыми. Если API недоступен, старые курсы остаются.

Управление партнерами на сайте

На публичной части сайта партнеры отображаются в разделе:

  • Главная страница - после выбора города становятся доступны партнеры
  • Страница "Партнеры" - полный список партнеров с фильтрацией по городам
  • На карте - с указанием координат (в разработке)

Удаление партнера

⚠️ Важно: Невозможно удалить партнера, если:
  • У него есть активные заявки
  • У него настроены индивидуальные курсы обмена
  • У него есть внешние курсы из API
Сначала удалите или переназначьте связанные записи.
Последнее обновление: 30.05.2026 в 15:03 
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Управление партнерами - DEXA</title>
    <style>
        body { font-family: Arial, sans-serif; line-height: 1.6; color: #333; max-width: 1200px; margin: 0 auto; padding: 20px; }
        h1 { color: #2c3e50; border-bottom: 2px solid #3498db; padding-bottom: 10px; }
        h2 { color: #34495e; margin-top: 30px; }
        h3 { color: #7f8c8d; margin-top: 20px; }
        code { background: #f4f4f4; padding: 2px 6px; border-radius: 4px; }
        .note { background: #e3f2fd; border-left: 4px solid #2196f3; padding: 15px; margin: 20px 0; }
        .warning { background: #fff3cd; border-left: 4px solid #ffc107; padding: 15px; margin: 20px 0; }
        table { width: 100%; border-collapse: collapse; margin: 20px 0; }
        th, td { border: 1px solid #ddd; padding: 10px; text-align: left; }
        th { background: #f5f5f5; }
    </style>
</head>
<body>
<h1>🏪 Управление партнерами</h1>

<h2>Что такое партнер в системе DEXA?</h2>
<p>Партнер - это физический обменный пункт или компания, которая проводит обменные операции с клиентами.</p>

<h3>Информация о партнере включает:</h3>
<ul>
    <li><strong>Название и контакты</strong> - отображаются клиентам на сайте</li>
    <li><strong>Геолокация</strong> - город, адрес, координаты для карты</li>
    <li><strong>Режим работы</strong> - часы приема клиентов</li>
    <li><strong>Принимаемые валюты</strong> - список доступных для обмена валют</li>
    <li><strong>Индивидуальные курсы</strong> - могут отличаться от общих</li>
    <li><strong>Рейтинг</strong> - на основе отзывов клиентов</li>
    <li><strong>API интеграция</strong> - отдельный источник курсов для партнера</li>
</ul>

<h2>Добавление партнера</h2>
<ol>
    <li>Перейдите в раздел <strong>Партнеры → Добавить партнера</strong></li>
    <li>Заполните обязательные поля:
        <ul>
            <li><strong>Название</strong> - наименование партнера</li>
            <li><strong>Город</strong> - выберите из списка</li>
            <li><strong>Адрес</strong> - полный физический адрес</li>
            <li><strong>Телефон</strong> - контактный номер</li>
            <li><strong>Email</strong> - электронная почта</li>
            <li><strong>График работы</strong> - например: "09:00-21:00, без выходных"</li>
        </ul>
    </li>
    <li>Опционально заполните:
        <ul>
            <li><strong>Координаты</strong> - широта и долгота для отображения на карте</li>
            <li><strong>Рейтинг</strong> - начальный рейтинг (0-5)</li>
            <li><strong>API для курсов</strong> - выберите внешний источник курсов для партнера</li>
            <li><strong>Принимаемые валюты</strong> - отметьте валюты, которые принимает партнер</li>
            <li><strong>Описание</strong> - дополнительная информация о партнере</li>
        </ul>
    </li>
    <li>Нажмите <strong>Сохранить</strong></li>
</ol>

<div class="warning">
    <strong>⚠️ Важно:</strong> Если у партнера не настроены принимаемые валюты, система будет считать, что он не принимает НИКАКИЕ валюты!
    Это приведет к ошибке при создании заявок для этого партнера.
</div>

<h2>Настройка курсов партнера</h2>
<p>У каждого партнера могут быть свои курсы обмена. Они имеют приоритет над общими курсами.</p>

<h3>Система приоритетов курсов:</h3>
<ol>
    <li><strong>Ручной курс партнера</strong> - самый высокий приоритет</li>
    <li><strong>Внешний курс партнера</strong> - из выбранного API с наценкой</li>
    <li><strong>Ручной общий курс</strong> - общий курс для всех партнеров</li>
    <li><strong>Общий внешний курс</strong> - из API по умолчанию</li>
</ol>

<h3>Настройка индивидуальных курсов:</h3>
<ol>
    <li>Перейдите в карточку партнера</li>
    <li>Нажмите кнопку <strong>Настроить курсы</strong> (иконка графика в списке партнеров)</li>
    <li>Для каждой валютной пары можно настроить:
        <ul>
            <li><strong>Ручной курс</strong> - фиксированное значение</li>
            <li><strong>Использовать внешний курс как базу</strong> - галочка для применения наценки к внешнему курсу</li>
            <li><strong>Наценка/скидка %</strong> - процент для внешнего курса</li>
            <li><strong>Мин/макс сумма</strong> - лимиты для этого партнера</li>
            <li><strong>Активность</strong> - включить/отключить курс</li>
        </ul>
    </li>
    <li>Нажмите <strong>Сохранить все курсы</strong></li>
</ol>

<div class="note">
    <strong>💡 Пример:</strong> Если вы хотите, чтобы курс партнера был на 2% выше рыночного:
    <ul>
        <li>Поставьте галочку "Использовать внешний курс как базу"</li>
        <li>В поле "Наценка %" укажите 2</li>
        <li>Ручной курс можно оставить пустым</li>
    </ul>
    Итоговый курс = внешний курс × (1 + 2/100) = внешний курс × 1.02
</div>

<h2>Обновление курсов партнера из API</h2>
<p>Если партнеру назначен API источник, вы можете обновить его курсы автоматически:</p>
<ol>
    <li>В карточке партнера нажмите кнопку <strong>Обновить курсы</strong> (в правом верхнем углу)</li>
    <li>Выберите API из выпадающего списка или используйте API по умолчанию</li>
    <li>Нажмите <strong>Обновить</strong></li>
</ol>

<div class="note">
    <strong>📝 Примечание:</strong> При обновлении из API старые внешние курсы партнера удаляются и заменяются новыми.
    Если API недоступен, старые курсы остаются.
</div>

<h2>Управление партнерами на сайте</h2>
<p>На публичной части сайта партнеры отображаются в разделе:</p>
<ul>
    <li><strong>Главная страница</strong> - после выбора города становятся доступны партнеры</li>
    <li><strong>Страница "Партнеры"</strong> - полный список партнеров с фильтрацией по городам</li>
    <li><strong>На карте</strong> - с указанием координат (в разработке)</li>
</ul>

<h2>Удаление партнера</h2>
<div class="warning">
    <strong>⚠️ Важно:</strong> Невозможно удалить партнера, если:
    <ul>
        <li>У него есть активные заявки</li>
        <li>У него настроены индивидуальные курсы обмена</li>
        <li>У него есть внешние курсы из API</li>
    </ul>
    Сначала удалите или переназначьте связанные записи.
</div>

</body>
</html>