Bridge-and-Join-s/internal/lkgateway/web/templates/admin_help_quik.html

{{define "content"}}
<div class="doc-header">
  <h1>QUIK МНП: подготовка к переводам M2M</h1>
  <p class="lede">Инструкция для администратора сервера QUIK. Что открыть в QUIK Administrator, что создать и включить, какие права выдать, чтобы bj мог блокировать, списывать и зачислять бумаги клиентов через Модуль неторговых поручений (МНП) при переводах по MOEX МОСТ. Каждый шаг со ссылкой на раздел и страницу документа ARQA.</p>
</div>

<div class="doc">
  <nav class="doc-toc" id="toc">
    <div class="toc-group">Зачем</div>
    <a href="#why">Как это работает</a>
    <div class="toc-group">Чек-лист</div>
    <a href="#s1">1. Классы на сервере QUIK</a>
    <a href="#s2">2. Классы в плагине МНП</a>
    <a href="#s3">3. Инструменты МНП</a>
    <a href="#s4">4. Типы поручений</a>
    <a href="#s5">5. Технологический пользователь</a>
    <a href="#s6">6. Права клиентов и менеджеров</a>
    <a href="#s7">7. Перезапуск модуля</a>
    <a href="#s8">8. База данных МНП</a>
    <div class="toc-group">Контроль</div>
    <a href="#bj">Что bj делает сам</a>
    <a href="#verify">Как проверить</a>
    <a href="#errors">Типичные ошибки</a>
    <a href="#report">Что сообщить нам</a>
    <div class="toc-group">Документы</div>
    <a href="#docs">Скачать документы</a>
  </nav>

  <article class="doc-body">

  <h2 id="why">Как это работает</h2>
  <p>bj не подключается к серверу QUIK напрямую. Он работает с <strong>базой данных Модуля неторговых поручений</strong> (МНП): вызывает хранимые процедуры и читает экспортные таблицы. Модуль сам передаёт поручения на сервер QUIK, проверяет позицию клиента, блокирует бумаги, исполняет или снимает поручение. Поэтому всё, что должен сделать администратор, находится в двух местах: <strong>QUIK Administrator</strong> (справочник «Классы», «Пользователи») и <strong>плагин МНП</strong> в нём же (меню «Модули»).</p>
  <table>
    <thead><tr><th style="width:190px">Ситуация</th><th>Что делает bj в МНП</th><th style="width:210px">Тип поручения в МНП</th></tr></thead>
    <tbody>
      <tr><td>Клиент переводит бумаги <strong>из нас</strong> в другой депозитарий</td><td>регистрирует поручение (QUIK блокирует бумаги) → отправляет перевод в НРД → по успеху подписывает поручение (бумаги списываются), по отказу снимает его с причиной (блокировка снимается, клиент видит причину в терминале)</td><td><strong>Вывод ЦБ (M2M)</strong>, класс <code>INSTROUTM2M</code></td></tr>
      <tr><td>Бумаги приходят <strong>к нам</strong> из другого депозитария</td><td>после зачисления в НРД регистрирует поручение по ISIN — оно исполняется сразу, бумаги появляются на позиции клиента</td><td><strong>Ввод ЦБ (M2M)</strong>, класс <code>INSTRINM2M</code></td></tr>
    </tbody>
  </table>
  <p class="muted">Эти два типа появились в МНП версии 21.4.0 и по умолчанию <strong>выключены</strong>, а нужные им классы и инструменты нужно создать вручную. Именно это и описано ниже. Основной документ — «Перевод ЦБ в MOEX МОСТ» (ARQA, v1.1, 2026), далее «МОСТ», страницы указаны по нему.</p>

  <h2 id="s1">Шаг 1. Создать классы на сервере QUIK</h2>
  <p><em>Где:</em> QUIK Administrator → справочник <strong>«Классы»</strong> (это база самого сервера QUIK, не плагин). <em>Документ:</em> МОСТ п. 4.1, стр. 11.</p>
  <p>Создайте два класса с параметрами:</p>
  <table>
    <thead><tr><th>Параметр</th><th>Класс 1</th><th>Класс 2</th></tr></thead>
    <tbody>
      <tr><td>Код</td><td><code>INSTROUTM2M</code></td><td><code>INSTRINM2M</code></td></tr>
      <tr><td>Наименование (рус)</td><td>Поручения на Вывод ЦБ M2M</td><td>Поручения на Ввод ЦБ M2M</td></tr>
      <tr><td>Код позиции</td><td><code>|EQTV|</code></td><td><code>|EQTV|</code></td></tr>
      <tr><td>Тип класса</td><td>Поручения</td><td>Поручения</td></tr>
      <tr><td>Активные операции</td><td>Включено</td><td>Включено</td></tr>
    </tbody>
  </table>
  <p class="muted">Альтернатива из руководства администратора МНП (шаг 5, стр. 10): применить к базе сервера QUIK (<code>QUIK_DB</code>) скрипт из дистрибутива модуля <code>scripts/mssql/add_classes_instructions_ms.sql</code>. Важно применять его именно к базе сервера QUIK, а не к <code>master</code>.</p>

  <h2 id="s2">Шаг 2. Добавить классы в плагин МНП</h2>
  <p><em>Где:</em> QUIK Administrator → Модули → МНП → справочник <strong>«Классы инструментов»</strong>. <em>Документ:</em> МОСТ п. 4.1, шаг 2, стр. 11.</p>
  <p>Добавьте оба класса, созданных на шаге 1, и на каждом выберите фирму, по которой будет меняться позиция клиента: <code>MC0413600000</code> (Фондовый рынок).</p>

  <h2 id="s3">Шаг 3. Создать инструменты МНП</h2>
  <p><em>Где:</em> QUIK Administrator → Модули → МНП → справочник <strong>«Инструменты»</strong>. <em>Документ:</em> МОСТ п. 4.2, стр. 14.</p>
  <table>
    <thead><tr><th>Код инструмента</th><th>Привязать к классу</th><th>Назначение</th></tr></thead>
    <tbody>
      <tr><td><code>RUROUTM2M</code></td><td><code>INSTROUTM2M</code></td><td>псевдоинструмент поручений на вывод; через него списывается комиссия депозитария</td></tr>
      <tr><td><code>RURINM2M</code></td><td><code>INSTRINM2M</code></td><td>псевдоинструмент поручений на ввод</td></tr>
    </tbody>
  </table>
  <p>Коды берите <strong>ровно такие</strong>, как в документе: bj передаёт их в вызовах процедур. Если инструменты уже созданы под другими кодами (например, по имени класса), сообщите нам коды — мы подставим их в настройках.</p>
  <p>Затем на <strong>сервере QUIK</strong> в настройках Библиотеки расчёта лимитов по фирме <code>MC0413600000</code> добавьте эти инструменты и привяжите к валюте (рубли) и тегу расчётов, с которого списывается комиссия депозитария: раздел «Инструменты» / «Параметры учёта неторговых поручений» (МОСТ п. 4.2, стр. 14, второй абзац).</p>

  <h2 id="s4">Шаг 4. Включить типы поручений M2M</h2>
  <p><em>Где:</em> QUIK Administrator → Модули → МНП → справочник <strong>«Типы поручений»</strong>. <em>Документ:</em> МОСТ п. 4.3, стр. 16–22.</p>
  <ol>
    <li>Найдите типы <strong>«Ввод ЦБ М2М»</strong> и <strong>«Вывод ЦБ М2М»</strong> (созданы модулем автоматически, ID 101 и 100). Откройте каждый и установите флажок <strong>«Тип поручения доступен»</strong> — по умолчанию он снят.</li>
    <li>У «Вывод ЦБ М2М» в списке классов, для которых доступен тип, выберите режим <strong>«Только выбранные»</strong> и класс <code>INSTROUTM2M</code>.</li>
    <li>У «Ввод ЦБ М2М» — то же самое с классом <code>INSTRINM2M</code>.</li>
    <li>У всех <em>остальных</em> типов на Вывод / Поставку ЦБ переключите классы на «Только выбранные» и убедитесь, что класс <code>INSTROUTM2M</code> у них <strong>выключен</strong>. Иначе по этому классу можно будет зарегистрировать обычное поручение вместо M2M.</li>
    <li>Подписи: у «Вывод ЦБ М2М» по умолчанию одна подпись — <strong>Депозитарий</strong>. Её ставит bj после ответа НРД. Дополнительные подписи не добавляйте без согласования с нами. У «Ввод ЦБ М2М» подписей нет — поручение исполняется сразу.</li>
    <li>Поля формы менять не нужно. Если в «Вывод ЦБ М2М» не требуется привязка к номеру договора и проверка ИИС, поля «Договор обслуживания» и «Согласие на закрытие счёта ИИС» можно скрыть (МОСТ, стр. 21).</li>
  </ol>

  <h2 id="s5">Шаг 5. Права технологического пользователя модуля</h2>
  <p><em>Где:</em> QUIK Administrator → справочник <strong>«Пользователи»</strong>. <em>Документ:</em> МОСТ п. 5.1, стр. 24; руководство администратора МНП, раздел 2, шаг 6, стр. 10.</p>
  <p><strong>Кто это.</strong> Служебный пользователь QUIK, от имени которого модуль МНП подключается к серверу QUIK. Его логин записан в файле модуля <code>instructions.ini</code>, секция <code>[QuikApi]</code>, параметр <code>User</code>. У него уже есть права на классы МНП (INSTR и другие); нужно добавить такие же на новые классы.</p>
  <ol>
    <li>Выдайте пользователю <strong>полные права</strong> на классы <code>INSTROUTM2M</code> и <code>INSTRINM2M</code>: «Просмотр поручений», «Активные операции», «Создание поручений», «Просмотр поручений по всем брокерам», все флажки «Виды поручений», все флажки «Право подписи».</li>
    <li>В правах по классу «Поручения» по всем классам МНП установите флажок <strong>«Специальные операции»</strong>.</li>
  </ol>
  <p class="muted">Без этих прав модуль не получает новые классы от сервера QUIK и на любое поручение M2M отвечает «Неверный тип поручения», хотя в базе всё включено.</p>

  <h2 id="s6">Шаг 6. Права клиентов и менеджеров</h2>
  <p><em>Документ:</em> МОСТ п. 5.2–5.3, стр. 25–27. Для работы bj этот шаг не обязателен, но без него клиенты не смогут сами подавать «Вывод ЦБ (M2M)» из терминала и не увидят исполненные вводы.</p>
  <ul>
    <li>Клиентам на класс <code>INSTROUTM2M</code>: «Просмотр поручений», «Клиент фирмы», «Активные операции», «Создание поручений», «Вывод бумаг», «Коды клиентов у дилера».</li>
    <li>Клиентам на класс <code>INSTRINM2M</code> (без «Активных операций»): «Просмотр поручений», «Клиент фирмы», «Ввод бумаг», «Коды клиентов у дилера».</li>
    <li>Менеджерам (только просмотр): «Просмотр поручений», «Просмотр поручений по всем брокерам», «Ввод бумаг», «Вывод бумаг».</li>
  </ul>

  <h2 id="s7">Шаг 7. Перезапустить модуль МНП</h2>
  <p>Типы поручений, классы и права модуль читает <strong>при старте</strong> и при подключении к серверу QUIK. Справочники (клиенты, инструменты, депозитарии) он перечитывает на ходу, а вот настройки шагов 1–5 — нет. После завершения настройки перезапустите службу МНП (обычно это делается ночью по регламенту аутсорсера). Пока модуль не перезапущен, поручения M2M отвергаются с текстом «Неверный тип поручения».</p>

  <h2 id="s8">Шаг 8. База данных МНП</h2>
  <p>Со стороны базы всё уже настроено, менять ничего не нужно. Для справки:</p>
  <ul>
    <li>Логин bj состоит в ролях <code>InstrEuImport</code> (справочники), <code>InstrEuBroker</code> (регистрация, подпись, снятие), <code>InstrEx</code> (экспортные таблицы) — руководство администратора, стр. 13 и 16.</li>
    <li>Справочник депозитариев M2M (<code>M2MDepoRecipients</code>) и депо-счета клиентов bj заполняет сам процедурами импорта; в QUIK Administrator этот справочник не виден (МОСТ п. 6.1, стр. 29).</li>
    <li>Справочник инструментов заполняется автоматически с сервера QUIK (опция <code>AutoFillQuikSecurities=1</code> в <code>instructions.ini</code>, руководство администратора, стр. 45) — для этого технологическому пользователю нужно право «Класс доступен» на биржевые классы, например <code>TQBR</code> (МОСТ п. 6.3, стр. 30).</li>
    <li>По желанию: опция <code>[General].AllowReverseExecutedInstruction=1</code> в <code>instructions.ini</code> разрешает отменять уже исполненные поручения (по умолчанию запрещено, руководство администратора, стр. 48).</li>
  </ul>

  <h2 id="bj">Что bj делает в МНП автоматически</h2>
  <p>После настройки цикл включается в bj: <a href="/admin/setup#sec-quik-cycle">Настройка → QUIK МНП → «Автоматический цикл M2M в МНП»</a> (главный предохранитель «Разрешить записи в МНП» и три переключателя). Что происходит при включённых переключателях:</p>
  <table>
    <thead><tr><th style="width:230px">Событие в bj</th><th>Действие в МНП</th><th style="width:230px">Что видит клиент в QUIK</th></tr></thead>
    <tbody>
      <tr><td>Исходящий перевод отправляется в НРД</td><td>регистрация «Вывод ЦБ (M2M)» <em>до</em> отправки; если QUIK отказал (нет позиции) — перевод в НРД не отправляется</td><td>поручение «Активно», бумаги заблокированы</td></tr>
      <tr><td>Принимающий депозитарий отказал по бумаге / сервис МОСТ отклонил</td><td>снятие поручения с текстом причины</td><td>поручение «Снято», причина в комментарии, блокировка снята</td></tr>
      <tr><td>НРД принял наше поручение 16 (отчёт MS010)</td><td>подпись «Депозитарий» → исполнение</td><td>поручение «Исполнено», бумаги списаны</td></tr>
      <tr><td>НРД принял наше поручение 16/1 по входящему переводу</td><td>регистрация «Ввод ЦБ (M2M)» по ISIN — исполняется сразу</td><td>поручение «Исполнено», бумаги на позиции</td></tr>
      <tr><td>Клиент сам подал «Вывод ЦБ (M2M)» из QUIK</td><td>bj видит его в экспорте, оповещает оператора; после создания заявки поручение привязывается в карточке, дальше — как обычный исходящий</td><td>своё поручение «Активно», затем исполнено или снято с причиной</td></tr>
    </tbody>
  </table>
  <p class="muted">Код клиента QUIK bj берёт из номера портфеля клиента в DEPO: «БР-859» → «BR859». Исключения задаются в той же форме настроек. Каждый шаг с ответом модуля виден в карточке перевода и на странице <a href="/admin/quik">QUIK МНП</a>; при ошибке приходит оповещение и есть кнопки для ручного повтора.</p>

  <h2 id="verify">Как проверить, что всё готово</h2>
  <ol>
    <li>В bj: <a href="/admin/setup#sec-quik">Настройка → QUIK МНП</a> → «Проверить подключение». В отчёте должны быть видны процедуры <code>sp_NewInstrSec</code>, <code>sp_SignInstrSec</code>, <code>cancel_instruction</code> и таблица <code>M2MDepoRecipients</code>.</li>
    <li>Скажите нам «проверяйте». Мы на согласованном клиенте для проверки регистрируем «Ввод ЦБ (M2M)» на 1 штуку (должно исполниться сразу, позиция +1), затем «Вывод ЦБ (M2M)» на 1 штуку с подписью депозитария (позиция −1). Весь цикл занимает две минуты, клиент видит оба поручения в терминале.</li>
    <li>Признак готовности в самой базе МНП: у типов 100 и 101 снят признак Disabled, у классов INSTROUTM2M / INSTRINM2M есть фирма, инструменты привязаны к классам. Это мы проверяем сами.</li>
  </ol>

  <h2 id="errors">Типичные ошибки модуля и что они значат</h2>
  <table>
    <thead><tr><th style="width:320px">Ответ модуля</th><th>Причина</th><th>Что сделать</th></tr></thead>
    <tbody>
      <tr><td>Неверный тип поручения.</td><td>Модуль не знает тип «Ввод/Вывод ЦБ М2М» или у технологического пользователя нет прав на класс</td><td>Шаги 1, 5, 7: классы на сервере QUIK, права техпользователя, перезапуск модуля</td></tr>
      <tr><td>Не найдено описание фирмы.</td><td>Поручение подано типом «Перевод ЦБ», у которого поля «Фирма списания / зачисления» берутся из «Описания» фирмы, а оно пустое</td><td>Для M2M этот тип не используется. Если нужен — заполнить «Описание» в справочнике «Фирмы» плагина МНП</td></tr>
      <tr><td>Поле 'ISIN' не поддержано для поручений с заполненным биржевым кодом класса.</td><td>В вызове одновременно код класса и ISIN</td><td>Ошибка вызова на нашей стороне, к настройке не относится</td></tr>
      <tr><td>Указан несуществующий счет ДЕПО поставщика-получателя.</td><td>Обычный (не M2M) тип «Получение ЦБ» требует депо-счёт получателя в формате, который принимает только терминал</td><td>Для зачислений использовать «Ввод ЦБ (M2M)», ему депо-реквизиты не нужны</td></tr>
      <tr><td>Транзакция проверяется на сервере Quik.</td><td>Не ошибка: промежуточный статус, модуль ждёт ответ сервера QUIK (до минуты)</td><td>Ничего</td></tr>
    </tbody>
  </table>

  <h2 id="report">Что сообщить нам после настройки</h2>
  <ul>
    <li>Что классы созданы на сервере QUIK и в плагине МНП (шаги 1–2).</li>
    <li>Точные коды инструментов, если они отличаются от <code>RUROUTM2M</code> / <code>RURINM2M</code> (шаг 3).</li>
    <li>Что типы 100/101 включены и привязаны к классам (шаг 4), права техпользователю выданы (шаг 5).</li>
    <li>Время перезапуска модуля (шаг 7).</li>
    <li>Код клиента QUIK, на котором разрешено проводить проверку, и что у него есть хотя бы одна бумага на позиции.</li>
  </ul>

  <h2 id="docs">Документы ARQA</h2>
  <ul>
    <li><a href="/admin/docs/Perevod-CB-v-MOEX-MOST.pdf">Перевод ЦБ в MOEX МОСТ</a> — основной документ: п. 4.1 (стр. 11), 4.2 (стр. 14), 4.3 (стр. 16), 5.1–5.3 (стр. 24–27), 6 (стр. 27), 8.6 (стр. 58–63).</li>
    <li><a href="/admin/docs/MNP-Rukovodstvo-administratora.pdf">МНП — Руководство по администрированию</a> — раздел 2 «Установка и настройка» (технологический пользователь: шаги 5–7, стр. 10–11), справочники плагина (раздел 3), настройки <code>instructions.ini</code> (раздел 4).</li>
    <li><a href="/admin/docs/MNP-Tablicy-i-procedury-BD.pdf">МНП — Таблицы и процедуры БД</a> — для разработчика: хранимые процедуры (раздел 3), экспортные таблицы (2.50), импорт справочников (3.19).</li>
  </ul>
  </article>
</div>
{{end}}