Инструмент предназначен для интеграции системы MACRO с системой строительного контроля Техзор.

Интеграция позволяет:

• автоматически создавать приемки работ в системе Техзор на основании задач по промежуточному вызову стройконтроля в MACRO;
• синхронизировать статусы приемок между двумя системами;
• автоматически создавать дефектовки в MACRO при выявлении нарушений в Техзоре;
• автоматически обновлять статус устранения нарушений;
• фиксировать все изменения в системном логе задачи.

Интеграция сокращает ручной обмен данными между участниками строительного контроля и обеспечивает единый процесс работы с приемками и нарушениями.

#Расположение

Для настройки интеграции:

• Откройте раздел Интеграции.

• Перейдите в блок Стройконтроль.

• Выберите интеграцию Техзор.

#Настройка интеграции

На странице настройки интеграции Техзор доступны следующие параметры:

1. Переключатель «Интеграция подключена»

Используйте переключатель для включения или отключения интеграции.

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

Если переключатель включен, система начинает:

• создавать приемки работ в Техзоре;
• синхронизировать статусы приемок;
• получать нарушения;
• обрабатывать вебхуки от Техзора.

2. Поле API-ключа

В поле укажите API-ключ системы Техзор.

API-ключ используется для выполнения запросов к API Техзора.

3. Поле URL вебхука

Поле содержит URL вебхука, на который система Техзор отправляет уведомления об изменении статусов нарушений.

Данный URL необходимо использовать при настройке вебхуков на стороне Техзора.

#Сопоставление проектов

Сопоставление проектов между MACRO и Техзор выполняется вручную.

Связь проектов хранится и управляется на стороне Техзора.

При взаимодействии с API Техзора система MACRO использует идентификатор объекта Техзора — objectId.

Нажмите кнопку Сопоставление проектов.

Нажмите кнопку + Добавить, чтобы добавить новые строки для выполнения сопоставления.

В каждой строке в колонке «Проект MACRO» выберите проект внутри системы, а в колонке «ID объекта в Техзор» — объект на стороне Техзора.

После завершения сопоставления нажмите кнопку Сохранить.

При необходимости сопоставление можно удалить, нажав на значок 🗑️ (корзина).

#Создание приемки работ

#Цель процесса

Создание приемки позволяет автоматически передавать информацию о необходимости строительной приемки из MACRO в Техзор.

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

#Когда создается задача промежуточного вызова стройконтроля

Задача создается через меню дополнительных действий:

• если работа начата и не завершена;
• если работа начата и завершена.

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

#Пошаговая инструкция

#Шаг 1. Создайте задачу по промежуточному вызову стройконтроля

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

После создания задачи система автоматически инициирует создание приемки в Техзоре.

#Шаг 2. Передача данных в Техзор

При создании приемки MACRO передает следующие данные:

#Шаг 3. Назначение приемки

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

#Шаг 4. Сохранение связи между системами

После успешного создания приемки:

• в задаче MACRO сохраняется идентификатор приемки Техзора — workAcceptanceId;
• в приемке Техзора заполняется кастомное поле с идентификатором задачи MACRO.

#Шаг 5. Формирование записи в логе

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

Пример записи:

• Дата и время — 01.02.2025 15:29
• Пользователь — система
• Изменения — Выгружено в Техзор: приемка работ id: 69526c1b29b3d2f1930b0292

#Синхронизация статусов приемки

#Принцип работы

MACRO автоматически обращается к API Техзора один раз в час и проверяет изменение статусов приемок.

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

#Соответствие статусов

#Логирование изменения статусов

При каждом фактическом изменении статуса задачи система автоматически добавляет запись в лог.

#Изменение статуса на «В работе»

Если в Техзоре установлен статус:

• В процессе приемке
• Выявлены нарушения

в лог добавляется запись:

• Задача принята в работу. Статус задачи в Техзор изменен на: В процессе приемки
  или
• Задача принята в работу. Статус задачи в Техзор изменен на: Выявлены нарушения

#Возврат задачи в работу

Если задача ранее имела другой статус и снова переведена в состояние В работе, система добавляет запись:

• Задача возвращена в работу: Статус задачи в Техзор изменен на: В процессе приемки
  или
• Задача возвращена в работу: Статус задачи в Техзор изменен на: Выявлены нарушения

#Завершение задачи

Если в Техзоре установлен статус Работы приняты, задача переводится в статус Готово.

В лог добавляется запись:

• Выполнена задача: Статус задачи в Техзор изменен на: Работы приняты

#Отклонение задачи

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

В лог добавляется запись:

• Задача отклонена: Статус задачи в Техзор изменен на: Отказ приемки

#Создание дефектовки

#Условия создания дефектовки

Дефектовка создается автоматически, если приемка в Техзоре переходит в статус Выявлены нарушения.

MACRO один раз в час обращается к API Техзора и получает нарушения, связанные с приемкой.

Поиск выполняется по идентификатору приемки Техзора — workAcceptanceId.

#Создание дефектовки в MACRO

После получения нарушения система автоматически:

1. Создает дефектовку у соответствующей работы.
2. Формирует заголовок дефектовки.
3. Прикрепляет фотографии нарушения.
4. Добавляет комментарий в задачу промежуточного вызова стройконтроля.

#Формирование заголовка дефектовки

В заголовке дефектовки указываются:

• источник — «Техзор»;
• идентификатор нарушения Техзора;
• описание нарушения из поля description.

Пример заголовка:

Техзор · Нарушение №11 · Тестовое нарушение

#Прикрепление фотографий

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

#Комментарий в задаче

После создания дефектовки система автоматически добавляет комментарий в задачу MACRO.

Текст комментария:

По результату приемки в Техзоре выявлено нарушение id: 69526f9e7e9e538bf5947034

#Изменение статуса дефектовки

#Принцип работы

Техзор отправляет вебхук в MACRO при изменении статуса нарушения.

MACRO обрабатывает полученное событие и обновляет статус дефектовки.

#Соответствие статусов