К списку

Фид сделок: описание формата Базис.Недвижимость JSON

10.06.2021
#Фиды #Интеграции #Загрузка данных

О фиде

Данный фид можно использовать для загрузки данных по сделкам, покупателям и их паспортных данных из внешних систем, например, из 1С или CRM системы.

Формат фида - JSON. Массив объектов, каждый объект - сделка, внутри сделки вложен массив клиентов по сделке.

Пример фида

Жирным отмечены обязательные данные, которые должны присутствовать в фиде, остальные опциональны.

------------------------------------

[
    {
	"internal_id": "39273", - ID сделки в вашей системе
	"room_internal_id": "128939", - ID квартиры в вашей системе
	"status_id": 6, - ID статуса в БН (справочник будет позже)
	"contract_type_id": 1, - ID типа договора в БН (справочник позже)
	"contract_number": "Р001", - Номер договора по сделке
	"contract_date": "11.10.2020", - Дата договора по сделке
	"price": 8904000, - Сумма сделки
	"payments": 7000000, - Сумма платежей по договору
	"surcharge_amount": 0, - Сумма доплаты по результатам обмеров БТИ
        "registration_date": "11.11.2020", - Дата регистрации сделки
        "registration_number": "10098:1219123", - Номер регистрации сделки
        "act_date": "12.11.2020", - Дата акта приема-передачи
        "one_sided_act_date": "13.11.2020",  - Дата одностороннего акта приема-передачи 
        "resign_one_sided_act": 1,  - Односторонний акт переподписан на двусторонний (0/1)   
        "readiness_message_date": "14.11.2020",  - Дата сообщения о готовности объекта  
        "readiness_message_sending_date": "15.11.2020",  - Дата отправки сообщения о готовности объекта   
        "readiness_message_sending_number": "А32621",  - Трек-номер отправки сообщения о готовности  
        "keys_given": 1, - Ключи получены (0/1)
        "custom_fields": {
           "customFieldCode1": "значение собственного поля 1",
           "customFieldCode2": "значение собственного поля 2"
        },
	"clients": [
	     {
			"internal_id": "4326", - ID клиента в вашей системе
			"last_name": "Крылов",
			"first_name": "Иван",
			"middle_name": "Николаевич",
			"phone": "79002007300", - телефон клиента, должен быть уникальным
			"email": "krylov097@mail.ru",
			"personal_data": {
				"date_of_birth": "12.12.2020",
				"place_of_birth": "Город Ленинград",
				"passport_series": "4571",
				"passport_number": "548562",
				"passport_issue_date": "01.01.1991",
				"passport_issued_by": "УФМС №123 по Ленинскому району",
				"passport_department_code": "125-451",
				"address_match": true, - Адрес регистрации совпадает с адресом проживания (true/false)
				"registration_address": "Санкт-Петербург, Ленинский р-н, ул Ленина, д. 18, стр. 19, кв. 25, индекс 148754", - Адрес прописки одной строкой. Загружается либо одной строкой, либо разбивкой по полям.
				"registration_city": "Санкт-Петербург",
				"registration_district": "Ленинский р-н",
				"registration_street": "ул Ленина",
				"registration_house": "18",
				"registration_building": "19",
				"registration_apartment": "25",
				"registration_postal_code": "148754",
				"residential_address": "Санкт-Петербург, Ленинский р-н, ул Ленина, д. 18, стр. 19, кв. 25, индекс 148754", - Адрес проживания одной строкой. Загружается либо одной строкой, либо разбивкой по полям.
				"residential_city": "Санкт-Петербург",
				"residential_district": "Ленинский р-н",
				"residential_street": "ул Ленина",
				"residential_house": "18",
				"residential_building": "19",
				"residential_apartment": "25",
				"residential_postal_code": "148754",
				"inn": "124859687454",
				"snils": "145-789-157 47"
			}
		}
	 ]
    }
]

------------------------------------

Как загрузить фид сделок в свой аккаунт Базис.Недвижимость

В меню "Объекты" кнопка "Импорт" - "Загрузка из Фида"

Выберите тип фида "Фид Базис.Недвижимость" и вставьте ссылку на свой фид, в процессе загрузки будут созданы сделки/покупатели/загружены паспортные данные, согласно данным из фида. 

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



ПОХОЖИЕ СТАТЬИ
Как подключить внешнюю систему к API
Установка кабинета покупателя на свой сайт
Связь виджета с внешними скриптами
Фид помещений: описание формата Базис.Недвижимость