Первоначальная настройка системы

1. Загрузите и сохраните токены ОРД VK

Перейдите в раздел «Настройки» → загрузите валидные токены для интеграции с ОРД VK и сохраните их.

⚠️ Токен действителен 1 год. За 1 месяц до истечения срока система отправит уведомление на указанный email.

Как получить токен (https://vkhost.github.io/)

2. Загрузите справочники

В том же разделе «Настройки» нажмите кнопки для загрузки следующих справочников:

  • Договоры
  • Контрагенты
  • Коды ККТУ
  • Группы VK

Важно! После любых изменений в ОРД (добавление/редактирование договоров, контрагентов, ККТУ или групп ВК) обязательно обновите соответствующие справочники в системе, чтобы новые данные стали доступны при создании рекламных объявлений.

2. Создание рекламного объявления

1. Перейдите в журнал и нажмите на кнопку «Добавить пост» или «Добавить репост».

2. Заполните все обязательные поля.

Кнопка «Отправить» недоступна, пока не заполнены все необходимые данные.

3. При вводе любого из следующих полей:

  • Код ККТУ
  • Реквизиты договора
  • Реквизиты контрагента

— остальные поля из этого списка автоматически заполняются из журнала на основе выбранного значения.

3. Формирование актов выполненных работ

Автоматическое формирование (ежемесячно)

  • С 1 по 3 число каждого месяца система автоматически формирует акты за предыдущий календарный месяц.
  • Акт формируется по завершении рекламного периода, но если объявление пересекает границу месяца, то:
  • Генерируется несколько актов — по одному на каждый отчетный период (месяц).
  • Каждый акт отражает оплаченные услуги именно за тот месяц, в котором проходил показ.

Пример:

Объявление размещено с 25 января по 25 февраля

  • Первый акт — формируется 1–3 февраля:
  • Период: 25.01 – 31.01
  • Второй акт — формируется 1–3 марта:
  • Период: 01.02 – 25.02

⚠️ Перед запуском в боевой режим обязательно проверьте корректность формирования актов вручную!

Ручное формирование

  • В админпанели доступна кнопка «Создать акты в ОРД».
  • Акт формируется по завершении рекламного периода. Для рекламных кампаний, которые пересекают границу месяца, акт составляется в начале следующего месяца. С учетом этих ограничений акты могут не формироваться.
  • Если акт за указанный период уже существует — повторное формирование пропускается.

4. Отправка актов в ЕРИР

1. Проверка данных

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

2. Отправка

В админпанели нажмите кнопку «Отправить акты в ЕРИР».

  • Если акт уже отправлен — повторная отправка игнорируется.
  • После создания актов в автоматическом режиме с 1 по 3 число отправка происходит так же в автоматическом режиме.

3. Уведомления

  • После формирования актов: на email приходит письмо с перечнем ID объявлений, ID актов и суммами.
  • После отправки в ЕРИР: письмо с количеством отправленных актов, их ID и общей суммой.

5. Уведомления и контроль

  • Токен истекает через 11 месяцев → система отправляет email-напоминание о необходимости замены.
  • Все операции (формирование, отправка, ошибки) логируются и отображаются в журнале объявлений с фильтрами, статусами и прямой ссылкой на пост в VK.

✅ Рекомендации перед запуском

  1. Проведите полный тестовый цикл:
    • Создание объявления → публикация → формирование акта → отправка в ЕРИР.
  2. Убедитесь, что справочники актуальны.
  3. Настройте email-адреса для получения системных уведомлений.
  4. Обучите команду работе с админпанелью.