.. meta::
   :description: Пакетные операции со шлюзами в UI менеджера SBC: одновременное управление несколькими конфигурациями шлюзов для массовых обновлений и обслуживания.

.. _batchoperationsforgates:

Групповые операции со шлюзами
##################################

.. role:: ex

.. role:: code



Введение
^^^^^^^^^^^^^^^^

| Batch Operations feature allows simultaneous management of multiple
  payment gates without the need to edit each gate individually.
| The functionality is designed to simplify administrative tasks related
  to gate configuration, particularly for cases where acquirer limits or
  filters must be updated across many gates at once. This functionality
  is available in the "Gates" section of the user interface. It is
  available for Manager and Superior roles by default, and can be added
  for Employees by request.

Доступные действия:

.. list-table::
  :widths: 33, 67
  :header-rows: 1
  :class: longtable table-text-justify table-text-center

  * - Действие
    - Описание
  * - :code:`Включить/Отключить`
    - Включает или выключает выбранные шлюзы.
  * - :code:`Мин/макс`
    - Устанавливает минимальную и максимальную сумму операции.
  * - :code:`Ограничения эквайера`
    - Позволяет подключить и настроить фильтры Referral и Velocity.

|

Обработка групповых операций в интерфейсе пользователя
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

1. Перейдите в :code:`Настройки` -> :code:`Конфигурация` -> :code:`Шлюзы`.
2. Используйте **Точный Поиск** для фильтрации шлюзов по нужным критериям.
3. Отметьте шлюзы чекбоксами в левом столбце списка. Можно выбрать все шлюзы на странице или все найденные (до 20 000).
4. После выбора шлюзов нажмите :code:`Действия` в правом верхнем углу, чтобы открыть список доступных операций.

|

.. image:: ../../../_static/images/batch_operations_for_gates/select_gates.png
  :alt: SelectGates
  :align: center
  :width: 450

|

.. note::
  Одновременно может выполняться только одна операция. При попытке запустить новую операцию будет отображено соответствующее предупреждающее сообщение.

Включение/выключение шлюзов
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Эта операция изменяет статус активности сразу у нескольких шлюзов.

| Шаги:
| 1. Выберите нужные шлюзы.
| 2. Нажмите :code:`Действия` -> :code:`Включить/отключить`.
| 3. В появившемся модальном окне выберите действие (Включить или Отключить).
| 4. Нажмите :code:`Применить`.

|

.. image:: ../../../_static/images/batch_operations_for_gates/en_di_gates.png
  :alt: EnableDisableGates
  :align: center
  :width: 550

Установка лимитов Мин/макс
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Used to define minimum and maximum allowed transaction amounts for
selected gates. If the selected gates have different currencies, the
system converts the values automatically based on the current internal
exchange rate.

| Шаги:
| 1. Выберите шлюзы.
| 2. Выберите :code:`Действия` -> :code:`Мин/макс`.
| 3. В модальном окне укажите:
|   - :code:`Валюта` — выбирается из списка (допускается только одна);
|   - :code:`Минимальная сумма транзакции`;
|   - :code:`Максимальная сумма транзакции`.
| 4. Проверьте, что минимальная сумма не превышает максимальную.
| 5. Нажмите :code:`Применить`.

|

.. image:: ../../../_static/images/batch_operations_for_gates/min_max_tr.png
  :alt: MinMaxAmountGates
  :align: center
  :width: 550

|

.. Warning:: If the MIN or MAX value is already set at the gate level,
    then when applying the batch, incorrect values (for example, if MIN is greater than MAX)
    may be displayed as successfully applied, but will not actually be written to the gate.
    The display of notifications will be improved in the future.

Ограничения эквайера
~~~~~~~~~~~~~~~~~~~~~~~~~

This function allows applying **Referral** and **Velocity** filters to a
group of gates, and configuring their specific parameters.

| Шаги:
| 1. Выберите шлюзы.
| 2. Выберите :code:`Действия` -> :code:`Ограничения эквайера`.
| 3. В модальном окне отметьте выбранные шлюзы и нажмите :code:`Применить`.
| 4. На вкладке **Фильтры** выберите один или несколько фильтров из списка (Referral и Velocity).
| 5. На вкладке **Конфигурации** задайте параметры фильтров:
|  - Включение/выключение фильтра;
|  - Выбор валюты;
|  - Лимиты суммы и количества. Если выбранные шлюзы имеют разные валюты, система автоматически конвертирует значения на основе текущего внутреннего обменного курса;
|  - Дополнительные параметры (например, *для всех шлюзов с одинаковым дескриптором*).
| 6. Наведите курсор на значок :ex:`i` рядом с параметром, чтобы увидеть подсказку.
| 7. Нажмите :code:`Применить` для применения изменений.

|

.. image:: ../../../_static/images/batch_operations_for_gates/restrictions_1.png
  :alt: restrictions_1
  :align: center
  :width: 550

.. image:: ../../../_static/images/batch_operations_for_gates/restrictions_2.png
  :alt: restrictions_2
  :align: center
  :width: 550
  
.. image:: ../../../_static/images/batch_operations_for_gates/restrictions_3.png
  :alt: restrictions_3
  :align: center
  :width: 550
  
Выполнение и мониторинг задач
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Each batch operation is added to the execution queue and processed
asynchronously by the backend system.

**Поведение интерфейса:**

-  While the batch task is running, an informational panel is displayed
   above the gate list showing:

   -  Общим количеством шлюзов в обработке;
   -  Текущим прогрессом (в процентах)
   -  Количеством успешно обновлённых шлюзов.
   -  Количеством неуспешно обновлённых шлюзов.

-  После завершения задачи:

   -  A download link for a CSV file with failed gate updates and
      error codes appears.
   -  Временный CSV файл удаляется после загрузки;
   -  Панель можно закрыть кнопкой :code:`Закрыть (X)`.
    
.. image:: ../../../_static/images/batch_operations_for_gates/excec_status.png
  :alt: excec_status
  :align: center
  :width: 880

|