Просмотр и резерв объекта недвижимости

Метод используется для проведения операций просмотра и резерва.

Для проведения операции резерва требуется загрузка 2 файлов(фотографии или сканы паспорта клиента: разворот с фотографией и пропиской).

Требуется обязательная валидация полей паспортных данных на количество символов!

Используемый метод: Appeal.add_appeal_wrapper

Описание основной сигнатуры вызова метода

Название ключа	Описание	Тип значения	Обязательный	Значение по-умолчанию
pricelist_id	id объекта(выбранной квартиры)	number	Да	Null
operation_type_id	id операции: 40 - операция просмотра, 15 - операция резерва	number	Да	Null
operation_data	Данные по операции	array	Да	[ ]
appeal_data	Данные по обращению	array	Да	[ ]
files	Файлы прикрепленные к обращению	array	Да	[ ]

Описание сигнатуры объекта "operation_data" для операции просмотра

Название ключа	Описание	Тип значения	Обязательный	Значение по-умолчанию
prosm_type	всегда 'appeal'	string	Да	'appeal'
view_date	желаемая дата просмотра в формате 'dd.mm.yyyy' ('24.05.2018')	string	Да
view_time	время просмотра в формате 'hh:mm' ('12:00')	string	Да
manager_id	выбранный id менеджера по бронированию (из словаря доступных менеджеров)	number	Да	Null
email	email клиента	string	Да

Описание сигнатуры объекта "operation_data" для операции резерва

Название ключа	Описание	Тип значения	Обязательный	Значение по-умолчанию
bron_type	всегда 'appeal'	string	Да	'appeal'
manager_id	выбранный id менеджера по бронированию (из словаря доступных менеджеров)	number	Да	Null
email	email клиента	string	Да
pay_type	id тип оплаты: 4 - 100% оплата, 5 - рассрочка, 6 - ипотека	string	Да
subagent_id	id субагента системы	number	Да	Null
notice	описание	string	Да

Описание сигнатуры объекта "appeal_data"

Название ключа	Описание	Тип значения	Обязательный	Значение по-умолчанию
manager_id	выбранный id менеджера по бронированию (из словаря доступных менеджеров)	number	Да	Null
fam	фамилия клиента	string	Да
name	имя клиента	string	Да
otch	отчество клиента	string	Да
data_rozhd	дата рождения в формате 'dd.mm.yyyy' ('24.05.2018')	string	Да
mj_reg	место жительства по регистрации	string	Да
mj_fakt	место жительства фактическое	string	Да
korr_addr	корреспондентский адрес	string	Да
mesto_rozhd	место рождения	string	Да
grazhdanstvo	гражданство	string	Да
pol	пол: m - мужской, f - женский	string	Да
pasp_seriya	серия паспорта	string	Да
pasp_num	номер паспорта	string	Да
pasp_date	дата выдачи паспорта	string	Да
pasp_kod_podrazdel	Паспорт код подразделения	string	Да
pasp_vidan	Кем выдан паспорт	string	Да
inn	ИНН	string	Да
phone	телефон в формате - "+7 (234) 234-23-42"	string	Да
rekl_phone	Рекламный телефон в формате - "+7 (234) 234-23-42"	string	Да
email	email клиента	string	Да
notice	описание	string	Да

Описание сигнатуры объекта из массива объектов "files" - [{объект1}, {объект2}] для операции резерва

Название ключа	Описание	Тип значения	Обязательный	Значение по-умолчанию
filename	имя файла	string	Да
b64data	b64 файла	string	Да

Пример запроса - операция просмотра

   1 QUERY_HOST="https://spn24.ru/api/v1"
   2 QUERY_ID="530c4636-0408-45f8-ab41-28a749a3c43e"
   3 QUERY_METHOD="Appeal.add_appeal_wrapper"
   4 QUERY_HEADER="Content-Type: application/json"
   5 QUERY_HEADER_AUTH="Authorization: WWWToken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   6 
   7 QUERY_BODY="{
   8     \"id\": \"$QUERY_ID\",
   9     \"method\": \"$QUERY_METHOD\",
  10     \"jsonrpc\": \"2.0\",
  11     \"params\": {
  12         \"client_id\": \"\",
  13         \"pricelist_id\": 23191,
  14         \"operation_type_id\": 40,
  15         \"ext_appeal\": \"\",
  16         \"operation_data\": {
  17             \"prosm_type\": \"appeal\",
  18             \"view_date\": \"24.05.2018\",
  19             \"view_time\": \"34:53\",
  20             \"manager_id\": 20,
  21             \"email\": \"\"
  22         },
  23         \"appeal_data\": {
  24                 \"manager_id\": 20,
  25                 \"fam\": \"\",
  26                 \"name\": \"Name\",
  27                 \"otch\": \"\",
  28                 \"data_rozhd\": '',
  29                 \"mj_fakt\": \"\",
  30                 \"korr_addr: \"\",
  31                 \"mesto_rozhd\": \"\",
  32                 \"grazhdanstvo\": 1,
  33                 \"pol\":\"m\",
  34                 \"pasp_seriya\": \"\",
  35                 \"pasp_num\": \"\",
  36                 \"pasp_date\": \"\",
  37                 \"pasp_kod_podrazdel\": \"\",
  38                 \"pasp_vidan\": \"\",
  39                 \"inn\": \"\",
  40                 \"snils\": \"\",
  41                 \"phone\": \"+7 (235) 345-34-53\",
  42                 \"email\": \"\",
  43                 \"rekl_phone\": \"\",
  44                 \"notice\":[]
  45     }
  46 }"
  47 
  48 curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST

Пример запроса - операция резерва

   1 QUERY_HOST="https://someserver/path/to/api"
   2 QUERY_ID="530c4636-0408-45f8-ab41-28a749a3c43e"
   3 QUERY_METHOD="Appeal.add_appeal_wrapper"
   4 QUERY_HEADER="Content-Type: application/json"
   5 QUERY_HEADER_AUTH="Authorization: WWWToken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   6 QUERY_BODY="{
   7     \"id\": \"$QUERY_ID\",
   8     \"jsonrpc\": \"2.0\", 
   9     \"method\": \"$QUERY_METHOD\",
  10     \"params\": {
  11         \"client_id\": \"\",
  12         \"pricelist_id\": 23191,
  13         \"operation_type_id\": 15,
  14         \"ext_appeal\": \"\",
  15         \"operation_data\": {
  16             \"bron_type\": \"appeal\",
  17             \"manager_id\": 20,
  18             \"email\": \"\",
  19             \"pay_type\": \"4\",
  20             \"subagent_id\": 2,
  21             \"notice\": \"\"
  22         },
  23         \"appeal_data\":{
  24             \"manager_id\": 20,
  25             \"fam\": \"Family\",
  26             \"name\": \"Name\",
  27             \"otch\": \"Surname\",
  28             \"data_rozhd\": \"25.05.2018\",
  29             \"mj_reg\": \"23423423\",
  30             \"mj_fakt\": \"2323423423\",
  31             \"korr_addr\": \"2342342\",
  32             \"mesto_rozhd\": \"23423423\",
  33             \"grazhdanstvo\": \"1\",
  34             \"pol\":\"m\",
  35             \"pasp_seriya\": \"2423\",
  36             \"pasp_num\": \"234234\",
  37             \"pasp_date\": \"25.05.2018\",
  38             \"pasp_kod_podrazdel\": \"234-234\",
  39             \"pasp_vidan\": \"23423423423\",
  40             \"inn\": \"\", 
  41             \"snils\": \"\",
  42             \"phone\": \"+7 (234) 234-23-42\",
  43             \"email": \"\",
  44             \"rekl_phone\": \"\",
  45             \"notice\": \"\"
  46         },
  47         \"files\":[
  48                 {
  49                     \"filename\": \"ff56ea62f64bc1a5ad5ff8423129d095f1c3f959.jpg\",
  50                     \"b64data\": \"b64datastring\",
  51                 },
  52                 {
  53                     \"filename\": \"35346434534533.png\",
  54                     \"b64data\": \"b64datastring\",
  55                 }
  56         ]
  57     }     
  58 }"
  59 curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST
  60

Просмотр объекта