Фиды данных из Домопланера
Для синхронизации со сторонними системами мы разработали фиды формата JSON. Это ссылка, по которой в режиме реального времени отдается информация из аккаунта застройщика. Фиды актуальны и не кэшируются. Если произойдет изменение в Домопланере, то это сразу же отразится в фидах.
Фиды можно сделать в разделе Настройки - Интеграции – Экспорт данных. Обычно для синхронизации с 1С используется два типов фидов: фид сделок и фид помещений (они называются "Полный от сделок" и "Полный от помещений").
Формат дат без времени (например, дата ДДУ или подачи сделки на регистрацию) по умолчанию DD.MM.YYYY. Если вам нужен свой формат, то добавьте к ссылке параметр ?date_format=YYYY-MM-DD. Тогда все даты изменят формат на передаваемый.
Даты со временем (например, дата создания клиента) всегда имеют формат YYYY-MM-DD HH:mm:ss в часовом поясе аккаунта застройщика. Часовой пояс можно изменить в Настройки - Настройки аккаунта внутри Домопланера.
Фид помещений
Содержит в себе информацию по помещению, оргнизации-продавце, пользовательские параметры помещений, информацию по сделке.
Фильтр по дому настраивается прямо в интерфейсе фидов. Доступны дополнительные фильтры:
1) ?ids=1234-5678 – взять помещения только с этими ID внутри ДП. ID перечисляются через разделитель "-" (минус).
Фид сделок
Содержит информацию по всем сделкам, внутри данные по объекту, участникам, доп.поля сделок, информация по платежам по сделке.
Работают фильтры. Если указать в конце:
1) ?dt_updated_last_days=2 – тогда в фид загрузится информация только по тем сделкам, которые были обновлены сегодня и вчера. Цифру можно указать на любую. Например, 7 - за последние 7 дней.
2) ?dt_updated_from=2023-08-23 – конкретно указать дату с которой взять сделки, по которым было обновление. Формат YYYY-MM-DD
3) ?dt_updated_from=2023-08-23&dt_updated_to=2023-08-26 – взять сделки, где дата обновления любых данных ко сделке была с 23 августа 2023 по 26 августа 2023 включительно.
4) ?deal_status=XXX-YYY-ZZZ – взять сделки только из этих этапов сделок внутри ДП. ID этапов перечисляются через разделитель "-" (минус). ID можно взять в разделе Настройки – Настройки сделок.
5) ?deal_ids=1234-5678 – взять сделки только с этими ID внутри ДП. ID сделок перечисляются через разделитель "-" (минус).
6) ?deal_dogovor_number=НОМЕР – взять только сделки с указанным номером договора, поиск работает только по одному номеру одновременно. Номер нужно передавать в формате URL Encoded.
7) ?dt_status_changed_from=2023-08-23&dt_status_changed_to=2023-08-26 – взять сделки, дата обновления этапа которых была с 23 августа 2023 по 26 августа 2023 включительно.
8) ?dogovor_day_from=2023-08-23&dogovor_day_to=2023-08-26 – дата договора по сделкам в заданном интервале.
9) ?day_reg_start_from=2023-08-23&day_reg_start_to=2023-08-26 – дата подачи на регистрацию по сделкам в заданном интервале.
10) ?day_reg_end_from=2023-08-23&day_reg_end_to=2023-08-26 – дата регистрации по сделкам в заданном интервале.
11) ?flat_status=1-2-3 – фильтр по статусу помещения, 1 = бронь, 2 = оформление, 3 = продано. Можно передать несколько статусов через знак минуса "-".
12) ?only_active=1 – оставить в выдаче только активные сделки