MACRO

Интеграция с Техзор

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

С помощью интеграции можно вести полный жизненный цикл приемок и нарушений: фиксировать замечания, назначать ответственных, контролировать сроки устранения, прикреплять фотографии и отслеживать статусы.

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

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

#Подготовка интеграции к работе

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

#Работа с приёмкой

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

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

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

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

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

#Создание задачи стройконтроля в MACRO

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

#Автоматическое создание приемки в Техзоре

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

#Проверка данных в приемке Техзора

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

Поле MACROПоле Техзор
Дата и время приемкиНачало приемки
КомментарийОписание
Наименование работыВид работ

На странице «Приёмки работ» вы можете увидеть, что переданные дата и время приёмки отображаются в поле «Начало приёмки».

Внутри самой приёмки:

  • комментарий из MACRO отображается в поле «Описание»;
  • наименование работы отображается в поле «Вид работ».

#Назначение и обработка приемки в Техзоре

Все приемки автоматически создаются на одного пользователя Техзора, который отвечает за дальнейшее распределение приемок внутри системы Техзор. Подробнее о работе с приёмками в системе Техзор вы можете ознакомиться в руководстве пользователяПереход на внешний сайтhttps://confluence.tehzor.com/spaces/manual/pages/983042/%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B9+%D1%80%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB.

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

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

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

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

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

#Возврат статуса приемки в MACRO

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

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

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

Статус приемки в ТехзорСтатус задачи в MACRO
Готово к приемкеНовое
В процессе приемкеВ работе
Выявлены нарушенияВ работе
Работы принятыГотово
Отказ приемкиОтклонено

#

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

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

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

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

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

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

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

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

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

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

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

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

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

#Работа с нарушениями

#Фиксация нарушения в Техзоре

Если в ходе приёмки были выявлены нарушения, их можно зафиксировать в системе Техзор. Дефектовка создается автоматически, если приемка в Техзоре переходит в статус Выявлены нарушения. Также нарушение можно создать внутри приемки, нажав кнопку «+» в разделе «Нарушения и осмотры».

Подробнее о фиксации нарушения в системе Техзор можно ознакомиться в инструкцииПереход на внешний сайтhttps://confluence.tehzor.com/spaces/manual/pages/20649267/%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D1%8F+%D0%BF%D0%BE+%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B5+%D1%81+%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%87%D0%BA%D0%BE%D0%B9+%D0%BF%D1%80%D0%B8%D0%B5%D0%BC%D0%BA%D0%B8+%D1%80%D0%B0%D0%B1%D0%BE%D1%82#id-%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D1%8F%D0%BF%D0%BE%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B5%D1%81%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%87%D0%BA%D0%BE%D0%B9%D0%BF%D1%80%D0%B8%D0%B5%D0%BC%D0%BA%D0%B8%D1%80%D0%B0%D0%B1%D0%BE%D1%82-%D0%A4%D0%B8%D0%BA%D1%81%D0%B0%D1%86%D0%B8%D1%8F%D0%B2%D1%8B%D1%8F%D0%B2%D0%BB%D0%B5%D0%BD%D0%BD%D0%BE%D0%B3%D0%BE%D0%BD%D0%B0%D1%80%D1%83%D1%88%D0%B5%D0%BD%D0%B8%D1%8F.1.

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

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

#Автоматическое создание дефектовки в MACRO

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

  1. Создает дефектовку у соответствующей работы.

  2. Формирует заголовок дефектовки.

  3. Прикрепляет фотографии нарушения, если они были загружены.

  4. Добавляет комментарий в задачу промежуточного вызова стройконтроля.

#Проверка дефектовки, фотографий и комментария в MACRO

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

  • источник — «Техзор»;

  • идентификатор нарушения Техзора;

  • описание нарушения из поля Описание.

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

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

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

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

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

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

#Изменение статуса нарушения в Техзоре

После того как нарушение будет устранено, его статус нужно изменить в Техзоре.

Когда статус нарушения меняется в Техзоре, MACRO автоматически обновляет состояние дефектовки:

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

#Инструкции по работе с Техзор

  1. Руководство пользователяПереход на внешний сайтhttps://confluence.tehzor.com/spaces/manual/pages/983042/%D0%98%D0%BD%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%86%D0%B8%D0%BE%D0%BD%D0%BD%D1%8B%D0%B9+%D1%80%D0%B0%D0%B7%D0%B4%D0%B5%D0%BB
  2. Инструкция по созданию приемки работ (десктопная версия)Переход на внешний сайтhttps://confluence.tehzor.com/spaces/manual/pages/20653807/%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D1%8F+%D0%BF%D0%BE+%D1%81%D0%BE%D0%B7%D0%B4%D0%B0%D0%BD%D0%B8%D1%8E+%D0%BF%D1%80%D0%B8%D0%B5%D0%BC%D0%BA%D0%B8+%D1%80%D0%B0%D0%B1%D0%BE%D1%82+%D0%B4%D0%B5%D1%81%D0%BA%D1%82%D0%BE%D0%BF%D0%BD%D0%B0%D1%8F+%D0%B2%D0%B5%D1%80%D1%81%D0%B8%D1%8F
  3. Инструкция по работе с карточкой приемки работПереход на внешний сайтhttps://confluence.tehzor.com/spaces/manual/pages/20649267/%D0%98%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%86%D0%B8%D1%8F+%D0%BF%D0%BE+%D1%80%D0%B0%D0%B1%D0%BE%D1%82%D0%B5+%D1%81+%D0%BA%D0%B0%D1%80%D1%82%D0%BE%D1%87%D0%BA%D0%BE%D0%B9+%D0%BF%D1%80%D0%B8%D0%B5%D0%BC%D0%BA%D0%B8+%D1%80%D0%B0%D0%B1%D0%BE%D1%82