Выгрузка объектов недвижимости из Битрикс24 в Циан: реклама всех объектов из одного окна
Задача
Сотрудники создавали каждый объект на Циане вручную и управляли его рекламой в личном кабинете площадки. Мы разработали приложение внутри Битрикс24: сотрудник отмечает объекты в одной таблице, выбирает продвижение и одной кнопкой обновляет фид. CRM стала единственным источником данных — что отмечено в карточках, то и выходит на площадку.
Стек работ
Приложение Битрикс24
XML-фид Циана
Vue, PHP
О проекте
Приложение состоит из двух частей: интерфейса во фрейме портала и серверного генератора фида. Интерфейс работает под учётной записью сотрудника, отдельный вход не нужен. Генератор записывает изменения обратно в карточки CRM, собирает фид по спецификации Циана, накладывает водяные знаки на фото и публикует фид по постоянной ссылке, откуда его забирает площадка.
Запрос
- Объекты заводили на Циане руками. Данные из CRM приходилось дублировать в кабинете площадки.
- Реклама настраивалась по одному объекту. Не было общей картины, какие объекты сейчас в рекламе и с каким продвижением.
- Выгрузка по фильтрам была ненадёжной. Стандартные фильтры по смарт-процессу объектов работали нестабильно, и объекты могли выпадать.
- Площадка по-своему читала данные. Пустая комиссия превращалась в 100%, аренда коммерции умножалась на площадь, продажа и аренда одного объекта конфликтовали.
Нужно было управлять рекламой всех объектов из Битрикс24 и получать валидный фид без ручного перевода данных.
Как мы справлялись с поставленными задачами
Разработано встроенное приложение Битрикс24 из двух частей: интерфейса управления рекламой на Vue 2 и Vuetify и серверного генератора фида на PHP. Сотрудник отмечает объекты и нажимает одну кнопку, а запись в CRM, сборка фида и публикация происходят автоматически.
Единая таблица объектов
Все объекты смарт-процесса загружаются разом пакетными запросами. Сортировка, поиск и постраничный вывод работают мгновенно, любое поле CRM можно вывести колонкой или фильтром.
Галочка «В рекламе»
Синхронизирована с полем CRM в обе стороны. Для каждого объекта выбирается продвижение: без продвижения, Стандарт, Премиум, Топ или аукцион со ставкой.
Настройки выгрузки
Площадки, общий способ продвижения, ставки и дневной лимит задаются в нижней панели. Колонки, фильтры и сортировка сохраняются на сервере между сессиями.
Фид по спецификации Циана
Сервер заново читает каждый объект по явному списку ID, определяет категорию Циана по типу объекта и сделки, переводит поля CRM в справочники площадки и собирает XML со строгим порядком тегов.
Фото с водяным знаком
Водяной знак накладывается автоматически, обработанные файлы кешируются, а недоступные ссылки в фид не попадают. Большие пачки фото обрабатываются в фоне.
Отчёт о каждой выгрузке
После выгрузки видно, сколько объектов ушло в фид, что записано в CRM и какие объекты пропущены с причинами. В карточках фиксируются даты входа в рекламу и выхода из неё.
Интеграции
- Битрикс24 REST API. Смарт-процесс объектов, пакетные запросы, запись флагов, продвижения, дат и площадок через вебхук.
- Циан, XML-фид (feed_version 2). Категории по XSD площадки, справочники ремонта, материалов, коммуникаций и категорий земли.
- Публикация фида. Готовый feed_cian.xml лежит по постоянной ссылке, Циан забирает его по расписанию.
Интерфейс — встроенное приложение Битрикс24 на Vue 2 и Vuetify, серверная часть — PHP.
Результат
Что изменилось после внедрения:
- Рекламой всех объектов управляют из одной таблицы в Битрикс24, без ручной работы в кабинете Циана.
- CRM задаёт состав фида: что отмечено в карточках, то и выходит на площадку.
- Поля CRM автоматически переводятся в коды Циана — ручного перевода данных нет.
- Объекты не выпадают из выгрузки: фид строится по явному списку ID.
- Типичные ошибки площадки исключены заранее: комиссия, аренда коммерции, конфликты ID, запрещённые символы.
- Каждая выгрузка сопровождается отчётом, а в карточках видны даты входа в рекламу и выхода из неё.
Инструменты
Битрикс24 REST API, Vue 2, Vuetify, PHP, XML-фид Циана
Результаты
Реклама объектов больше не разнесена между CRM и кабинетом площадки: всё управляется из одного окна, фото защищены водяным знаком, а по каждой выгрузке есть понятный отчёт.
сохранить и обновить фид
единственный источник данных
на всех фото
после каждой выгрузки
перевода полей в коды Циана
Нужна такая же выгрузка объектов из Битрикс24?
Разберём вашу ситуацию на бесплатном аудите: за 3 дня покажем, что из этого кейса применимо у вас, сколько займёт и во что обойдётся. Отчёт останется у вас.