Инструкция по импорту

Администратор Development

Инструкция по импорту (для внутреннего пользования)

Пошаговое руководство по загрузке объектов и связанных данных из CSV (и других поддерживаемых форматов) через Мастер импорта.

Перед началом

Плагины

Откройте Расширения → Плагины. Убедитесь, что включены:

  • Import — без него раздел «Импорт» и мастер недоступны;
  • RealtyParsed — если на проекте используются дополнительные интеграции и сеттеры из этого плагина (для обычного CSV-импорта объектов достаточно Import).

Файл для импорта

Подготовьте файл по внутренним требованиям к структуре: первая строка — заголовки столбцов, единый разделитель по всему файлу, корректная кодировка (обычно UTF-8). В заголовках не должно быть лишних пробелов и дублирующихся имён столбцов.

Для каждого объекта желательно иметь уникальный внешний идентификатор в отдельном столбце — так система не создаст дубликаты при повторном импорте.

Шаг 1. Запуск мастера и выбор файла

Путь: Настройки → Импорт → Мастер импорта.

Мастер импорта: выбор источника файла, типа CSV и блок «Шаблон» с полями уникального имени и модели

1. Выбор файла

В блоке 1. Выбор файла укажите источник:

  • Загрузить файл — новый файл с компьютера;
  • Загруженный ранее — файл из списка уже загруженных на сервер;
  • Адрес в интернет — ссылка на файл или фид (тип указывается отдельно).

Для CSV выберите тип CSV (или другой подходящий тип, если файл в другом формате).

2. Шаблон

В блоке 2. Шаблон:

  • режим Новый — для нового импорта;
  • Уникальное имя на английском языке — обязательно; при каждом новом импорте задайте новое уникальное имя (латиница, без пробелов, например import_flats_2026_05);
  • Заголовок или описание — по желанию, для ваших заметок;
  • Модель — что импортируете. Типичные значения в списке:
    • объекты недвижимости;
    • заявки;
    • контрагенты;
    • пользователи;
    • фотографии объектов (если фото выносятся в отдельную модель).

Нажмите Начать импорт. Откроется страница Проверка файла (её также можно открыть по ссылке Проверка файла в шапке мастера).

Шаг 2. Проверка файла: разделитель и константы

Проверка файла: поле «Разделитель», флажок «Разбивать данные в соответствии с заголовком» и превью данных справа

Разделитель и заголовки

В левой колонке задайте параметры чтения файла:

  • Разделитель — символ между столбцами (;, ,, : и т.д.), как в вашем CSV;
  • флажок Разбивать данные в соответствии с заголовком — включите, если первая строка файла содержит названия столбцов (обычно так и есть).

Справа отображается превью: сначала заголовок столбца, ниже — значение из первой строки данных. Если столбцы «съехали», смените разделитель и сохраните снова.

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

Константы

Ниже на той же странице — поля constant (пары «ключ — значение»). Ими задают значения, которых нет в файле, но которые должны попасть во все импортируемые записи.

Проверка файла: блок констант constant.0.key и constant.0.value с примером категории квартир

Примеры:

  • все объекты — квартиры: в constant.0.key — Advertisement.category_id, в constant.0.value — номер категории (например 7);
  • тип сделки: Advertisement.rent — 1 для аренды, 0 для продажи;
  • ответственный: Advertisement.rieltor_id — ID пользователя в CRM;
  • сразу в архив: Advertisement.deleted — дата архивирования в нужном формате.

Номер категории можно посмотреть: Настройки → Категории → Список категорий — в таблице у каждой категории есть идентификатор.

Когда константы заданы, нажмите Продолжить импорт (или снова Сохранить, затем Продолжить импорт).

Шаг 3. Сопоставление полей

Мастер по очереди предлагает настроить столбцы из файла. Для каждого столбца:

  1. в поле с названием столбца из файла выберите поле в CRM (поиск по названию);
  2. в блоке Постобработка выберите нужный способ обработки или Нет;
  3. нажмите Добавить поле.

Если включён AI-ассистент, над формой может отображаться готовое предложение сопоставления — проверьте его и при необходимости скорректируйте.

Сопоставление поля: выбор поля CRM, постобработка и кнопка «Добавить поле»

Обязательные и типовые поля (объекты)

Столбец в файле (пример) Поле в CRM Постобработка
Внешний ID Внешний идентификатор Внешний идентификатор — защита от дублей, связь файла с объектом в базе
Категория Категория (из словаря) Данные из словаря — откроется окно сопоставления значений файла и категорий CRM
Цена Цена Нет
Аренда / продажа Аренда (1) / продажа (0) Перевод — сопоставьте «аренда» → 1, «продажа» → 0
Регион, город, район, улица Соответствующие поля географии Привязка местоположений — для каждого уровня адреса своё поле, тот же сеттер
Дом Номер дома Нет
ФИО контрагента Контрагент 1 — ФИО (при нескольких — Контрагент 2 и т.д.) Нет
Телефон Контрагент 1 — телефон Обработка телефона в контрагенте
Заголовок, описание, примечание По смыслу названия столбца Нет
Риелтор / ответственный ID ответственного Данные из словаря — сопоставление с пользователями; новых пользователей добавляйте только по согласованию с менеджером
Ссылки на фото Ссылка на фото Нет; если несколько URL в одной ячейке через запятую — Разделитель и укажите символ (например ,)

Лишние столбцы в файле

Если столбец не нужен (например «Площадь участка» при импорте квартир), оставьте поле CRM пустым, в постобработке выберите Нет и нажмите Добавить поле — столбец будет пропущен.

Нет подходящего поля в CRM

Справа на странице сопоставления можно:

  • Добавить параметр категории — если значение зависит от типа объекта (жилая / коммерческая и т.п.): укажите алиас латиницей без точек, название, тип (число, строка, внешний ключ);
  • Добавить поле в словарь — если параметр нужен для всех объектов (например дополнительный текстовый атрибут): имя в БД, название на русском, тип; для списка «да/нет» выберите тип «внешний ключ» и привяжите к словарю.

Форма добавления параметра категории: алиас, название, тип

Значения нет в словаре

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

  • пользователи;
  • категория;
  • статус заявки;
  • контрагент;
  • заявки.

Ошибка в настройке поля

Если импорт остановился из‑за неверного сопоставления, нажмите Конфигурация в шапке мастера, удалите ошибочную строку (крестик напротив поля), сохраните. Вернитесь к импорту — мастер снова предложит настроить это поле.

Когда все столбцы обработаны, отобразится итоговый экран импорта — это нормально.

Шаг 4. Проверка результата

  1. Откройте Объекты → Объекты.
  2. В фильтре Источник выберите Импорт.
  3. Сравните количество записей в файле и в списке; откройте несколько карточек и проверьте цену, адрес, контрагентов, категорию. Если данных не хватает, чаще всего выбрана неверная постобработка.

Шаг 5. Загрузка фотографий на сервер

Если в импорте были ссылки на фото по URL, файлы нужно скачать на сервер отдельными асинхронными задачами.

Путь: Настройки → Асинхронные задачи → Мои асинхронные задачи (или Асинхронные задачи в подменю).

Создайте по очереди три задачи с моделью CronTabShellCommand и командами:

  1. Agency.AdPictures downloads_set 0
  2. Agency.AdPictures downloads_set 1
  3. Agency.AdPictures downloads

Все три команды отвечают за скачивание изображений. Планировщик обычно запускает их каждые 10 минут; если через 20 минут задачи всё ещё в списке — обратитесь к разработчику.

После выполнения наведите курсор на фото в карточке объекта: в подсказке ссылки должен быть домен вашего сайта. Если указан внешний домен (например площадки-источника), файл на сервер не скачался — проверьте ссылки в файле импорта и повторите задачи.

Дополнительно

  • Конфигурации мастера импорта — Настройки → Импорт → Конфигурации мастера импорта: список сохранённых шаблонов, повторный запуск.
  • Генерация конфига через нейросеть — отдельный пункт меню для автоматического черновика сопоставления по файлу; результат всегда нужно проверить на странице Проверка файла.
  • Настройки → Импорт → Настройки — общие параметры плагина импорта (разделитель по умолчанию и др.).