Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Следующая версия Следующая версия справа и слева | ||
d24:develop:v2:backend:v2 [2022/08/30 07:18] klabukovai [Получение детализации профиля] |
d24:develop:v2:backend:v2 [2024/04/11 09:43] predeinay |
||
---|---|---|---|
Строка 9: | Строка 9: | ||
===== Виды push-уведомлений ===== | ===== Виды push-уведомлений ===== | ||
- | * З_СП Заявка | принята в работуЗ_СО Заявка | открыта повторно | + | * З_СП Заявка | принята в работу (переход в заявку с ид object_id при наличии) |
- | * З_К Заявка | Комментарий к заявке добавлен | + | * З_СО Заявка | открыта повторно (переход в заявку с ид object_id при наличии) |
- | * З_Ф Заявка | Фото к заявке добавлено | + | * З_К Заявка | Комментарий к заявке добавлен (переход в заявку с ид object_id при наличии) |
- | * З_Н Заявка | Пользователь назначен исполнителем или ответственным | + | * З_Ф Заявка | Фото к заявке добавлено (переход в заявку с ид object_id при наличии) |
- | * О_С Оповещение | Оповещение новое об отключениях | + | * З_Н Заявка | Пользователь назначен исполнителем или ответственным (переход в заявку с ид object_id при наличии) |
- | * З_СР Заявки | Срочные заявки - открытие приложения с предустановленным фильтром | + | * О_С Оповещение | Оповещение новое об отключениях (переход в оповещение с ид object_id при наличии) |
- | * З_НП Заявки | Не принятые в работу - открытие приложения с предустановленным фильтром | + | * З_СР Заявки | Срочные заявки - открытие приложения с предустановленным фильтром ?????????????? DEPRECATED |
- | * З_КА Заявки | Посылается запрос по статусу аварийной заявки с быстрой кнопкой «Авария устранена» | + | * З_НП Заявки | Не принятые в работу - открытие приложения с предустановленным фильтром (например "1 заявок требуют вашего внимания") (фильтры - Мои + Непринятые в работу) |
+ | * З_КА Заявки | Посылается запрос по статусу аварийной заявки с быстрой кнопкой «Авария устранена» (переход в заявку с ид object_id при наличии) | ||
+ | * Ч_Н Чек-лист | Пользователь назначен проверяющим (переход в чек-лист с ид object_id при наличии) | ||
+ | * Ч_НП Чек-лист | Находящиеся в работе чек листы | ||
+ | * Без вида / с видом не определнным - открытие текста пуша в модалке | ||
+ | apple | ||
+ | <code> | ||
+ | let push = { | ||
+ | aps : { | ||
+ | sound : "default", | ||
+ | alert : { | ||
+ | title : "Диспетчер24", | ||
+ | body : MESSAGE, | ||
+ | object_id : OBJECT_ID, | ||
+ | object : OBJECT_TYPE, | ||
+ | msg_id : PUSH_ID | ||
+ | } | ||
+ | } | ||
+ | }; | ||
+ | |||
+ | if (OBJECT_TYPE == 'З_Н'){ | ||
+ | Object.assign(push['aps'], {category : "RequestStatus"}); | ||
+ | } | ||
+ | </code> | ||
===== Константы ===== | ===== Константы ===== | ||
Строка 140: | Строка 163: | ||
Параметры тела запроса: | Параметры тела запроса: | ||
^ Название ^ Тип ^ Обязательно ^ Описание ^ | ^ Название ^ Тип ^ Обязательно ^ Описание ^ | ||
- | | devType | string | да | android / ios Тип устройства, чтобы система понимала как отправлять push-уведомления т.п.| | + | | devType | string | да | android / ios Тип устройства, если интеграция с системой то указывать необходимо int| |
|pushToken | string | да | Токен для push-уведомлений | | |pushToken | string | да | Токен для push-уведомлений | | ||
Строка 154: | Строка 177: | ||
// Тело запроса | // Тело запроса | ||
{ | { | ||
- | "devType" : "android", | + | "devType" : "int", |
- | "pushToken" : "klnefkszkjn5lkawelnflkzsdfk" | + | "pushToken" : "" |
} | } | ||
+ | // в pushToken необходимо писать уникальный тект, например "uk_pravii_bereg" | ||
// Ответ | // Ответ | ||
{ | { | ||
Строка 196: | Строка 220: | ||
| cnt | string | да | Название юридического лица | | | cnt | string | да | Название юридического лица | | ||
| cnt_id | number | да | Идентификатор юр. лица в базе данных Д24 | | | cnt_id | number | да | Идентификатор юр. лица в базе данных Д24 | | ||
+ | | account_id | number | да | ИД аккаунта | | ||
+ | | callback_phone | string | да | Тел. юр. лица | | ||
+ | | support_phone | string | да | Тел. поддержки юр. лица | | ||
**Пример:** | **Пример:** | ||
Строка 203: | Строка 230: | ||
{ | { | ||
"cnt": "Жил. трест Кир. р-на (Спартак)", | "cnt": "Жил. трест Кир. р-на (Спартак)", | ||
- | "cnt_id": 10983 | + | "cnt_id": 10983, |
+ | "account_id": 2621, | ||
+ | "callback_phone": "283-05-21", | ||
+ | "support_phone": "328-7100" | ||
}, | }, | ||
{ | { | ||
"cnt": "Жил. трест Кир. р-на (Центр)", | "cnt": "Жил. трест Кир. р-на (Центр)", | ||
- | "cnt_id": 11041 | + | "cnt_id": 11041, |
+ | "account_id": 2621, | ||
+ | "callback_phone": "283-05-21", | ||
+ | "support_phone": "328-7100" | ||
}, | }, | ||
{ | { | ||
"cnt": "Жил. трест Кир. р-на ООО РЭУ-25 (Рекорд)", | "cnt": "Жил. трест Кир. р-на ООО РЭУ-25 (Рекорд)", | ||
- | "cnt_id": 11081 | + | "cnt_id": 11081, |
+ | "account_id": 2621, | ||
+ | "callback_phone": "283-05-21", | ||
+ | "support_phone": "328-7100" | ||
+ | } | ||
+ | ] | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ==== Получение списка доступных городов ==== | ||
+ | GET http://server.ru/v2/ref/city_list?cnt_id=value | ||
+ | |||
+ | Параметры запроса: | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |cnt_id | number | нет | Идентификатор юр. лица в базе данных Д24 | | ||
+ | |||
+ | Тип ответа: Массив. | ||
+ | |||
+ | Параметры ответа (объектов массива) | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | | city_text | string | да | Название города | | ||
+ | |||
+ | **Пример:** | ||
+ | <code javascript> | ||
+ | // ответ | ||
+ | [ | ||
+ | { | ||
+ | city_text:"Курган г" | ||
} | } | ||
] | ] | ||
Строка 217: | Строка 277: | ||
==== Получение списка доступных улиц / населенных пунктов ==== | ==== Получение списка доступных улиц / населенных пунктов ==== | ||
- | GET http://server.ru/v2/ref/street_list?cnt_id=value | + | GET http://server.ru/v2/ref/street_list?cnt_id=value&city_text=value |
Параметры запроса: | Параметры запроса: | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
|cnt_id | number | да | Идентификатор юр. лица в базе данных Д24 | | |cnt_id | number | да | Идентификатор юр. лица в базе данных Д24 | | ||
+ | |city_text | strng | нет | Название города | | ||
+ | |||
Тип ответа: Массив | Тип ответа: Массив | ||
Строка 263: | Строка 325: | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
| cnt_id | number | нет | идентификатор юр. лица в системе. Если при запросе отсутствует, то в ответе будут все улицы/нас. пункты по доступным юр. лицам| | | cnt_id | number | нет | идентификатор юр. лица в системе. Если при запросе отсутствует, то в ответе будут все улицы/нас. пункты по доступным юр. лицам| | ||
+ | | city_text | string | нет | название города| | ||
+ | | street_text | string | нет | название улицы| | ||
Тип ответа: Массив с объектами | Тип ответа: Массив с объектами | ||
Строка 270: | Строка 334: | ||
| address | string | да | полный адрес дома| | | address | string | да | полный адрес дома| | ||
| house_id | number | да | идентификатор дома в системе| | | house_id | number | да | идентификатор дома в системе| | ||
+ | | fias | string | нет | идентификатор fias| | ||
+ | | flag_active | string | да | активен ли дом Д/Н| | ||
+ | | city_text | string | да | город дома| | ||
+ | | street_text | string | нет | улица дома| | ||
+ | | house_num | string | да | номер дома| | ||
+ | | corp | string | нет | корпус дома| | ||
+ | | struct | string | нет | строение дома| | ||
+ | | is_flat | string | нет | разрешено ли создавать квартиры| | ||
+ | | is_office | string | нет | разрешено ли создавать офисы| | ||
+ | | is_parking| string | нет | разрешено ли создавать парковки| | ||
+ | | is_larder | string | нет | разрешено ли создавать кладовки| | ||
+ | | is_section | string | нет | разрешено ли создавать секции| | ||
+ | | is_apart | string | нет | разрешено ли создавать апартаменты| | ||
+ | | is_alone | string | нет | разрешено ли создавать типы без помещений| | ||
+ | | is_moto_parking | string | нет | разрешено ли создавать мотоместа| | ||
+ | | is_bike_parking | string | нет | разрешено ли создавать веломеста| | ||
+ | | is_non_residential | string | нет | разрешено ли создавать нежилые помещения| | ||
+ | | is_strict_flat_select | string | нет | разрешено ли создавать новые flat| | ||
+ | |||
+ | |||
+ | |||
**Пример:** | **Пример:** | ||
<code javascript> | <code javascript> | ||
Строка 282: | Строка 367: | ||
{ | { | ||
"address":"Кемерово г, Дружбы ул, дом 1Б", | "address":"Кемерово г, Дружбы ул, дом 1Б", | ||
- | "house_id":50136 | + | "house_id":50136, |
+ | "fias": null, | ||
+ | "flag_active": "Д", | ||
+ | "city_text": "Кемерово г", | ||
+ | "street_text": "Дружбы ул", | ||
+ | "house_num": "1Б", | ||
+ | "corp": null, | ||
+ | "struct": null, | ||
+ | "is_flat": "Н", | ||
+ | "is_office": "Н", | ||
+ | "is_parking": "Н", | ||
+ | "is_larder": "Н", | ||
+ | "is_section": "Н", | ||
+ | "is_apart": "Н", | ||
+ | "is_alone": "Н", | ||
+ | "is_moto_parking": "Н", | ||
+ | "is_bike_parking": "Н", | ||
+ | "is_non_residential": "Н", | ||
+ | "is_strict_flat_select": "Н" | ||
}, | }, | ||
{ | { | ||
"address":"Кемерово г, Дружбы ул, дом 1А", | "address":"Кемерово г, Дружбы ул, дом 1А", | ||
- | "house_id":50135 | + | "house_id":50135, |
+ | "fias": null, | ||
+ | "flag_active": "Н", | ||
+ | "city_text": "Кемерово г", | ||
+ | "street_text": "Дружбы ул", | ||
+ | "house_num": "1А", | ||
+ | "corp": null, | ||
+ | "struct": null, | ||
+ | "is_flat": "Н", | ||
+ | "is_office": "Н", | ||
+ | "is_parking": "Н", | ||
+ | "is_larder": "Н", | ||
+ | "is_section": "Н", | ||
+ | "is_apart": "Н", | ||
+ | "is_alone": "Н", | ||
+ | "is_moto_parking": "Н", | ||
+ | "is_bike_parking": "Н", | ||
+ | "is_non_residential": "Н", | ||
+ | "is_strict_flat_select": "Н" | ||
+ | }, | ||
+ | ... | ||
+ | ] | ||
+ | </code> | ||
+ | |||
+ | ==== Получение списка групп домов ==== | ||
+ | GET http://server.ru/v2/ref/group_obj_list?cnt_id=value | ||
+ | |||
+ | Параметры запроса: | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | | cnt_id | number | да | идентификатор юр. лица в системе.| | ||
+ | |||
+ | Тип ответа: Массив с объектами | ||
+ | |||
+ | Параметры ответа (объектов массива) | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | | description | string | да | название группы | | ||
+ | | group_obj_id | number | да | идентификатор группы| | ||
+ | |||
+ | |||
+ | |||
+ | **Пример:** | ||
+ | <code javascript> | ||
+ | |||
+ | //Запрос | ||
+ | /* | ||
+ | http://server.ru/v2/ref/group_obj_list?cnt_id=11601 | ||
+ | */ | ||
+ | |||
+ | // Ответ | ||
+ | [ | ||
+ | { | ||
+ | "group_obj_id": 234, | ||
+ | "description": "Луначарского" | ||
+ | }, | ||
+ | { | ||
+ | "group_obj_id": 235, | ||
+ | "description": "Нелуначарского" | ||
}, | }, | ||
... | ... | ||
Строка 373: | Строка 532: | ||
|flat_id| number|да|идентификатор квартиры в системе| | |flat_id| number|да|идентификатор квартиры в системе| | ||
|FLAT_TYPE|number|да|тип помещения. Смотреть [[d24:develop:v2:backend:v2#типы_помещений|описание типов помещений]]| | |FLAT_TYPE|number|да|тип помещения. Смотреть [[d24:develop:v2:backend:v2#типы_помещений|описание типов помещений]]| | ||
+ | |entrance|string|нет|номер подъезда| | ||
+ | |floor|number|нет|номер этажа| | ||
**Пример:** | **Пример:** | ||
Строка 385: | Строка 546: | ||
[ | [ | ||
{ | { | ||
- | "flat": "37", | + | "flat_id": 876841, |
- | "flat_id": 55282, | + | "flat": "кв 1", |
- | "FLAT_TYPE": 1 | + | "flat_type": 1, |
- | | + | "flat_num": "1", |
+ | "entrance": null, | ||
+ | "floor": null | ||
}, | }, | ||
{ | { | ||
- | "flat": "38", | + | "flat_id": 1069252, |
- | "flat_id": 55283, | + | "flat": "оф scriptalert(1)/script", |
- | "FLAT_TYPE": 1 | + | "flat_type": 4, |
+ | "flat_num": "scriptalert(1)/script", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
}, | }, | ||
{ | { | ||
- | "flat": "39", | + | "flat_id": 876842, |
- | "flat_id": 55284, | + | "flat": "кв 2", |
- | "FLAT_TYPE": 1 | + | "flat_type": 1, |
+ | "flat_num": "2", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
}, | }, | ||
{ | { | ||
- | "flat": "40", | + | "flat_id": 876843, |
- | "flat_id": 55285, | + | "flat": "кв 3", |
- | "FLAT_TYPE": 1 | + | "flat_type": 1, |
+ | "flat_num": "3", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 876844, | ||
+ | "flat": "кв 4", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "4", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 876845, | ||
+ | "flat": "кв 5", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "5", | ||
+ | "entrance": "1", | ||
+ | "floor": 2 | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 876846, | ||
+ | "flat": "кв 6", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "6", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 876847, | ||
+ | "flat": "кв 7", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "7", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 876848, | ||
+ | "flat": "кв 8", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "8", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 876849, | ||
+ | "flat": "кв 9", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "9", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 876850, | ||
+ | "flat": "кв 10", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "10", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 1082244, | ||
+ | "flat": "кв 12", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "12", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 966663, | ||
+ | "flat": "кв 15", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "15", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 2774303, | ||
+ | "flat": "м/м 321", | ||
+ | "flat_type": 3, | ||
+ | "flat_num": "321", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
+ | }, | ||
+ | { | ||
+ | "flat_id": 2617083, | ||
+ | "flat": "кв 381", | ||
+ | "flat_type": 1, | ||
+ | "flat_num": "381", | ||
+ | "entrance": null, | ||
+ | "floor": null | ||
} | } | ||
] | ] | ||
Строка 555: | Строка 815: | ||
}, | }, | ||
{ | { | ||
- | "emp" : "Клабуков Александр Витальевич", | + | "emp" : "Клабуков Александр Витальевич [deprecated]", |
"emp_id" : 12 | "emp_id" : 12 | ||
}, | }, | ||
Строка 596: | Строка 856: | ||
}, | }, | ||
{ | { | ||
- | "resp": "Клабуков Александр Игоревич", | + | "resp": "Клабуков Александр Игоревич [deprecated]", |
"resp_id": 35293 | "resp_id": 35293 | ||
}, | }, | ||
Строка 671: | Строка 931: | ||
|status| string|да|-| | |status| string|да|-| | ||
|status_id|string|да|-| | |status_id|string|да|-| | ||
+ | |reasons_count|number|да|-| | ||
**Пример:** | **Пример:** | ||
Строка 684: | Строка 945: | ||
{ | { | ||
"status": "Открытые заявки", | "status": "Открытые заявки", | ||
- | "status_id": "1:65:70:5:2:23:4" | + | "status_id": "1:65:70:5:2:23:4", |
+ | "reasons_count": 0 | ||
}, | }, | ||
{ | { | ||
"status": "...Новые", | "status": "...Новые", | ||
- | "status_id": "1:65:70:5" | + | "status_id": "1:65:70:5", |
+ | "reasons_count": 0 | ||
}, | }, | ||
{ | { | ||
"status": ".....|Зарегистрирована", | "status": ".....|Зарегистрирована", | ||
- | "status_id": "1" | + | "status_id": "1", |
+ | "reasons_count": 0 | ||
} | } | ||
] | ] | ||
Строка 984: | Строка 1248: | ||
|cnt_id|number|нет|идентификатор юр. лица| | |cnt_id|number|нет|идентификатор юр. лица| | ||
|house_id|number|нет|идентификатор дома| | |house_id|number|нет|идентификатор дома| | ||
- | |status|string|нет|статус оповещения| | + | |status|string|нет|статус оповещения "А" - активно "З" - закрыто| |
- | |type|string|нет|типы оповещения через двоеточие| | + | |type|string|нет|тип оповещения| |
|service|string|нет|список услуг через двоеточие| | |service|string|нет|список услуг через двоеточие| | ||
|custom_filter|string|нет|отменяет все прочие фильтры| | |custom_filter|string|нет|отменяет все прочие фильтры| | ||
+ | |date_start|string|нет|дата и время начала в ISO формате| | ||
+ | |date_end|string|нет|дата и время конца в ISO формате| | ||
+ | |city_text|string|нет|фильтр по городу| | ||
+ | |street_text|string|нет|фильтр по улице| | ||
+ | |reason|string|нет|причина оповещения| | ||
+ | |resp|string|нет|зона ответственности| | ||
+ | |svc_id|string|нет|РСО оповещения| | ||
+ | |moderation_needed|string|нет|статус модерации Д\Н| | ||
+ | |||
+ | |||
+ | |||
**Тип ответа:** Массив объектов | **Тип ответа:** Массив объектов | ||
Строка 998: | Строка 1273: | ||
|start_at|string|да|дата и время начала в часовом поясе пользователя. Формат DD.MM.YYYY hh24:mi| | |start_at|string|да|дата и время начала в часовом поясе пользователя. Формат DD.MM.YYYY hh24:mi| | ||
|end_at|string|может быть null|дата и время конца в часовом поясе пользователя. Формат DD.MM.YYYY hh24:mi| | |end_at|string|может быть null|дата и время конца в часовом поясе пользователя. Формат DD.MM.YYYY hh24:mi| | ||
- | |created_at|string|да| дата и время создания оповещения| | + | |created_at|string|да|дата и время создания оповещения. Формат DD.MM.YYYY hh24:mi| |
+ | |start_at_tz|string|да|дата и время начала в ISO формате| | ||
+ | |end_at_tz|string|может быть null|дата и время конца в ISO формате| | ||
+ | |created_on_tz|string|да|дата и время создания оповещения в ISO формате| | ||
+ | |updated_on_tz|string|может быть null|дата и время изменения оповещения в ISO формате| | ||
|note|string|да|текст оповещения| | |note|string|да|текст оповещения| | ||
- | |status|string|да|статус оповещения| | + | |last_comments|array|да|список последних комментариев| |
+ | |reason|string|да|причина оповещения| | ||
+ | |reason_str|string|да|текстовое описание причины оповещения| | ||
+ | |resp|string|да|зона ответственности| | ||
+ | |status|string|да|статус оповещения статус оповещения "А" - активно "З" - закрыто| | ||
|status_str|string|да|текстовое описание статуса оповещения| | |status_str|string|да|текстовое описание статуса оповещения| | ||
- | |service_list|string|может быть null|код услуги, к которой относится оповещение| | + | |service_list|string|может быть null|список услуг через двоеточие| |
- | |service_list_str|string|может быть null|услуга, к которой относится оповещение| | + | |service_list_str|string|может быть null|текстовое описание услуг оповещения через запятую| |
- | |all_flags|string|-|-| | + | |all_flags|string|-|все флаги| |
+ | |area_str|string|-|области ответственности службы| | ||
|object_list|array|да|список домов оповещения| | |object_list|array|да|список домов оповещения| | ||
+ | |||
+ | **Параметры массива last_comments (список последних комментариев):** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |note|string|да|текст комментария| | ||
**Параметры массива object_list (список домов оповещения):** | **Параметры массива object_list (список домов оповещения):** | ||
Строка 1067: | Строка 1355: | ||
|end_at|string|может быть null|дата и время конца в часовом поясе пользователя. Формат DD.MM.YYYY hh24:mi| | |end_at|string|может быть null|дата и время конца в часовом поясе пользователя. Формат DD.MM.YYYY hh24:mi| | ||
|created_at|string|да| дата и время создания оповещения| | |created_at|string|да| дата и время создания оповещения| | ||
+ | |start_at_tz|string|да|дата и время начала в часовом поясе пользователя в формате ISO| | ||
+ | |end_at_tz|string|да|дата и время конца в часовом поясе пользователя в формате ISO| | ||
+ | |created_on_tz|string|да|дата и время создания оповещения в формате ISO| | ||
+ | |updated_on_tz|string|да|дата и время обновления оповещения в формате ISO| | ||
|note|string|да|текст оповещения| | |note|string|да|текст оповещения| | ||
- | |status|string|да|статус оповещения| | + | |last_comments|string|да|последние комментарии| |
+ | |houses|string|да|список домов для оповещения| | ||
+ | |status|string|да|статус оповещения статус оповещения "А" - активно "З" - закрыто| | ||
|status_str|string|да|текстовое описание статуса оповещения| | |status_str|string|да|текстовое описание статуса оповещения| | ||
|service_list|string|может быть null|код услуги, к которой относится оповещение| | |service_list|string|может быть null|код услуги, к которой относится оповещение| | ||
Строка 1108: | Строка 1402: | ||
} | } | ||
</code> | </code> | ||
+ | ==== Получение списка домов, на которые распространяется оповещение в виде списка состояний по каждому дому ==== | ||
+ | GET http://server.ru/v2/oi/:info_id/house_state | ||
- | ==== Получение списка домов, на которые распространяется оповещение ==== | + | **переменные URL:** |
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |info_id|number|да|идентификатор оповещения, для которого нужно получить список домов| | ||
+ | |||
+ | **Тип ответа:** Массив объектов | ||
+ | |||
+ | **Параметры ответа (объектов массива):** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |status_id|string|да|id записи состояния| | ||
+ | |house_id|string|да|id дома| | ||
+ | |status|string|да|статус состояния дома "А" - активно "З" - закрыто| | ||
+ | |date_start_tz|string|да|Временная метка по UTC даты начала| | ||
+ | |date_end_tz|string|да|Временная метка по UTC даты окончания| | ||
+ | |address|string|да|Текстовое представление адреса| | ||
+ | |||
+ | **Пример:** | ||
+ | <code javascript> | ||
+ | |||
+ | //Запрос | ||
+ | /* | ||
+ | http://server.ru/v2/oi/139246/house_state | ||
+ | */ | ||
+ | |||
+ | // Ответ | ||
+ | [ | ||
+ | { | ||
+ | "status_id": 4981824, | ||
+ | "house_id": 40783, | ||
+ | "status": "З", | ||
+ | "date_start_tz": "2024-01-15T10:18:00.000Z", | ||
+ | "date_end_tz": null, | ||
+ | "address": "Курган г, Бурова-Петрова ул, дом 78" | ||
+ | }, | ||
+ | { | ||
+ | "status_id": 4981825, | ||
+ | "house_id": 49396, | ||
+ | "status": "З", | ||
+ | "date_start_tz": "2024-01-15T10:18:00.000Z", | ||
+ | "date_end_tz": null, | ||
+ | "address": "Курган г, Куртамышская ул, дом 18 К1" | ||
+ | } | ||
+ | ] | ||
+ | </code> | ||
+ | |||
+ | ==== Получение списка домов, на которые распространяется оповещение в виде группировки по улицами ==== | ||
GET http://server.ru/v2/oi/:info_id/houses | GET http://server.ru/v2/oi/:info_id/houses | ||
Строка 1406: | Строка 1746: | ||
**Параметры ответа (объектов массива):** | **Параметры ответа (объектов массива):** | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |phone_id|number|да| Ид записи сномером телефона| | ||
|phone|string|да| Номер телефона| | |phone|string|да| Номер телефона| | ||
|house|string|да|Адрес дома| | |house|string|да|Адрес дома| | ||
|flat|string|да|номер квартиры| | |flat|string|да|номер квартиры| | ||
+ | |created_on_tz|string|да|дата создания в формате ISO| | ||
+ | |last_call_on_tz|string|да|последний звонок в формате ISO| | ||
+ | |fio|string|да|ФИО| | ||
+ | |flag_sms_notify|string|да|флаг для оповещения смс, может быть А, Д или Н| | ||
+ | |oico|string|да|флаг смс из ОЙКО, может быть Д или Н| | ||
|entrance|string|может быть null| обозначение подъезда| | |entrance|string|может быть null| обозначение подъезда| | ||
|floor|number|может быть null|номер этажа| | |floor|number|может быть null|номер этажа| | ||
Строка 1440: | Строка 1786: | ||
] | ] | ||
</code> | </code> | ||
+ | |||
+ | ===== Заявки РСО ===== | ||
+ | |||
+ | ==== Создание заявки ==== | ||
+ | POST https://server.ru/v2/request_rso | ||
+ | |||
+ | **Тело запроса:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |house_id|number|да|ИД Дома| | ||
+ | |owner_id|number|нет|ИД Управляющей компании| | ||
+ | |svc_id|number|да|идентификатор РСО| | ||
+ | |note| string|да|Комметрарий к заявке РСО| | ||
+ | |request_id|number|да|ИД Заявки| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |request_rso_id|number|да|ид заявки рсо| | ||
+ | |house_id|number|да|ид дома| | ||
+ | |owner_id|number|да|ид управляющей компании| | ||
+ | |svc_id|number|да|идентификатор РСО| | ||
+ | |note|string|да|комментарий заявки рсо| | ||
+ | |created_on_tz|string|да|время создания заявки| | ||
+ | |status_id|number|да|ид статуса| | ||
+ | |rso_status_name|string|да|имя статуса| | ||
+ | |request_id|number|да|ид заявки, на основе которой создана заявка рсо| | ||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | //Тело запроса | ||
+ | |||
+ | { | ||
+ | "house_id" : 34021, | ||
+ | "svc_id:" : 1533, | ||
+ | "owner_id" : 23, | ||
+ | "request_id" : 1300673, | ||
+ | "note" : "123", | ||
+ | } | ||
+ | |||
+ | //Ответ | ||
+ | |||
+ | { | ||
+ | "request_rso_id": 77470, | ||
+ | "house_id": 54696, | ||
+ | "owner_id": 13521, | ||
+ | "svc_id": 5484, | ||
+ | "note": "123", | ||
+ | "created_on_tz": "2024-03-28T07:19:10.826Z", | ||
+ | "status_id": 1, | ||
+ | "rso_status_name": "Зарегистрирована", | ||
+ | "request_id": 1300673 | ||
+ | } | ||
+ | |||
+ | </code> | ||
+ | |||
+ | |||
===== Заявки ===== | ===== Заявки ===== | ||
Строка 1448: | Строка 1853: | ||
**Тело запроса:** | **Тело запроса:** | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
- | |house_id|number|да|-| | + | |house_id|number|да|ид дома| |
- | |ess_id|number|да|-| | + | |ess_id|number|да|ид причины обращения| |
- | |type_id|number|да|-| | + | |type_id|number|да|ид типа работ| |
- | |note| string|да|-| | + | |flat_id|number|нет|ид квартиры| |
- | |contphone|string|нет|-| | + | |note| string|да|заметка| |
+ | |contphone|string|нет|номер телефона| | ||
|flat|string|нет|номер помещения| | |flat|string|нет|номер помещения| | ||
|entr|string|нет|подъезд| | |entr|string|нет|подъезд| | ||
|floor|string|нет|этаж| | |floor|string|нет|этаж| | ||
|flat_type|number|нет|тип помещения. Смотреть [[d24:develop:v2:backend:v2#типы_помещений|описание типов помещений]]| | |flat_type|number|нет|тип помещения. Смотреть [[d24:develop:v2:backend:v2#типы_помещений|описание типов помещений]]| | ||
- | |email|string|нет|-| | + | |email|string|нет|электронная почта| |
+ | |fio|string|нет|фио| | ||
+ | |appeal_num|string|нет|номер обращения| | ||
+ | |appeal_date|string|нет|дата создания номера обращения| | ||
+ | |desired_time_start|string|нет|желаемое время выполнения| | ||
+ | |check_work_id|number|нет|ид чек-листа| | ||
- | **Тип ответа:** Объект | + | **Тип ответа:** |
**Параметры ответа:** | **Параметры ответа:** | ||
- | ^ Название ^ Тип ^ Обязательно ^ Описание^ | + | Заявка как в детализации заявки |
- | |request_id|number|да|созданная заявка| | + | |
**Примеры:** | **Примеры:** | ||
Строка 1475: | Строка 1885: | ||
"ess_id" : 1533, | "ess_id" : 1533, | ||
"type_id" : 23, | "type_id" : 23, | ||
+ | "flat_id": 111, | ||
"note" : "Тест ppostman", | "note" : "Тест ppostman", | ||
"contphone" : "9125212573", | "contphone" : "9125212573", | ||
Строка 1481: | Строка 1892: | ||
"floor" : "9", | "floor" : "9", | ||
"email" : "predeinay@gmail.com", | "email" : "predeinay@gmail.com", | ||
+ | "fio": "ФИО", | ||
+ | "appeal_num": "123", | ||
+ | "appeal_date": "2023-10-13T19:00:00.000Z", | ||
+ | "desired_time_start": "2024-04-05T19:00:00.000Z", | ||
+ | "check_work_id": 123, | ||
"flat_type": 1 | "flat_type": 1 | ||
} | } | ||
Строка 1487: | Строка 1903: | ||
{ | { | ||
- | "request_id": 1298371 | + | "request_id": 1302749, |
+ | "rtype": "Плановая", | ||
+ | "req_type": "plan", | ||
+ | "flag_emergency": "Н", | ||
+ | "is_paid": "Н", | ||
+ | "is_local_need": "Н", | ||
+ | "is_favorites": "Н", | ||
+ | "is_closed": "N", | ||
+ | "is_oico_account": 0, | ||
+ | "house": "Белинского ул, дом 123", | ||
+ | "full_address": "Екатеринбург г, Белинского ул, дом 123", | ||
+ | "fias": null, | ||
+ | "flat": "кв 5", | ||
+ | "flat_num": "5", | ||
+ | "flat_type": 1, | ||
+ | "cnt_id": 13521, | ||
+ | "house_id": 55056, | ||
+ | "flat_id": 1211608, | ||
+ | "type_id": 21, | ||
+ | "ess_id": 3303, | ||
+ | "status_id": 1, | ||
+ | "reason_id": null, | ||
+ | "emp_id": null, | ||
+ | "resp_id": 35374, | ||
+ | "priority_id": null, | ||
+ | "request_rso_id": null, | ||
+ | "check_id": null, | ||
+ | "execution_time": "19.04.2024 06:19", | ||
+ | "closing_time": null, | ||
+ | "created_at": "05.04.2024 06:19", | ||
+ | "updated_at": null, | ||
+ | "deadline_at": "19.04.2024", | ||
+ | "local_at": null, | ||
+ | "appointed_at": "05.04.2024 19:00", | ||
+ | "execution_time_on_tz": "2024-04-19T06:19:44.000Z", | ||
+ | "closing_time_on_tz": null, | ||
+ | "created_on_tz": "2024-04-05T06:19:44.309Z", | ||
+ | "updated_on_tz": null, | ||
+ | "scheduled_execution_time_on_tz": "2024-04-19T06:19:44.000Z", | ||
+ | "desired_time_start_on_tz": "2024-04-05T19:00:00.000Z", | ||
+ | "note": "123 123", | ||
+ | "fio": "123", | ||
+ | "emp_note": null, | ||
+ | "floor": 1, | ||
+ | "entr": "11", | ||
+ | "autophone": null, | ||
+ | "contphone": "123", | ||
+ | "email": "123@123.ert", | ||
+ | "tags": null, | ||
+ | "last_comments": [], | ||
+ | "price": null, | ||
+ | "material_price": null, | ||
+ | "paid": null, | ||
+ | "ess": "Запрос записи разговора диспетчерской", | ||
+ | "emp": null, | ||
+ | "resp": "Системный пользователь ", | ||
+ | "created_by": "dev", | ||
+ | "emp_phone": null, | ||
+ | "resp_phone": null, | ||
+ | "uploads_count": 0, | ||
+ | "status": "Зарегистрирована", | ||
+ | "rso_status_name": null, | ||
+ | "ext_pay_system_id": "42", | ||
+ | "inn": "7203333262", | ||
+ | "what_was_done": null, | ||
+ | "oi_id": null, | ||
+ | "oi_status": null, | ||
+ | "rsfat_value": null, | ||
+ | "rsft_value": null, | ||
+ | "reason": null, | ||
+ | "type": "Прочее", | ||
+ | "rate": null, | ||
+ | "deadline_str": 14, | ||
+ | "appointed_str": "Сегодня с 19:00", | ||
+ | "cnt_callback_phone": "34332830521", | ||
+ | "request_tags": [] | ||
} | } | ||
</code> | </code> | ||
Строка 1499: | Строка 1990: | ||
**Тело запроса:** | **Тело запроса:** | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
- | |status_id|number | нет | - | | + | |status_id|number | нет | ид статуса заявки | |
- | |reason_id|number | нет | - | | + | |reason_id|number | нет | ид причины закрытия заявки | |
- | |emp_id| number | нет | - | | + | |emp_id| number | нет | ид исполнителя | |
- | |resp_id| number | нет | - | | + | |resp_id| number | нет | ид ответственного | |
- | |deadline_at| string | нет | - | | + | |deadline_at| string | нет | срок выполнения заявки | |
|tag_ids| string | нет | идентификаторы тэгов для сохранения, указанные через запятую Пример: "1,2,3". чтобы удалить все тэги необходимо послать "0" | | |tag_ids| string | нет | идентификаторы тэгов для сохранения, указанные через запятую Пример: "1,2,3". чтобы удалить все тэги необходимо послать "0" | | ||
- | |emp_note| string | нет | - | | + | |emp_note| string | нет | заметка от исполнителя | |
- | |comment| string | нет | - | | + | |comment| string | нет | комментарий | |
+ | |entrance| string | нет | подъезд | | ||
+ | |floor| number | нет | этаж | | ||
+ | |note|string|нет| заметка | | ||
+ | |comment_flag_webhook| string | нет | Отправлять ли жителю Д\Н | | ||
|image_url| string | нет | Ссылка на изображение. Отправляется обязательно вместе с image_name | | |image_url| string | нет | Ссылка на изображение. Отправляется обязательно вместе с image_name | | ||
|image_name| string | нет | Название изображения | | |image_name| string | нет | Название изображения | | ||
Строка 1512: | Строка 2007: | ||
|local_at| string | нет | Дата, когда исполнитель локализовал аварию по заявке "ДД.ММ.ГГГГ ЧЧ:ММ" | | |local_at| string | нет | Дата, когда исполнитель локализовал аварию по заявке "ДД.ММ.ГГГГ ЧЧ:ММ" | | ||
|material_price| number | нет | Стоимость материалов по заявке | | |material_price| number | нет | Стоимость материалов по заявке | | ||
- | |price|number | нет | - | | + | |price|number | нет | цена | |
- | |what_was_done|string|нет| - | | + | |what_was_done|string|нет| что было сделано | |
- | |paid|number|нет| - | | + | |paid|number|нет| сколько оплачено | |
+ | |is_favorites|string|нет| Добавить/убрать из избранного (Д/Н) | | ||
+ | |phone_contact|string|нет| Контактный номер телефона жителя | | ||
+ | |flag_payment|string|нет| Оплачена ли заявка (Д/Н) | | ||
+ | |email|string|нет| Электронная почта | | ||
+ | |essence_id|number|нет| ИД причины обращения | | ||
+ | |priority_id|number|нет| Приоритет заявки | | ||
+ | |||
**Тип ответа:** Объект | **Тип ответа:** Объект | ||
Строка 1521: | Строка 2024: | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
|affected_rows|number|да|количество затронутых изменениями / созданных строк (вместе с комментариями)| | |affected_rows|number|да|количество затронутых изменениями / созданных строк (вместе с комментариями)| | ||
+ | |request|-|да|обновленная заявка с полями как в детализации| | ||
**Примеры:** | **Примеры:** | ||
Строка 1542: | Строка 2046: | ||
"emp_note" : "типа скрытый от операторов текст", | "emp_note" : "типа скрытый от операторов текст", | ||
"comment" : "Типа коммент от исполнителя", | "comment" : "Типа коммент от исполнителя", | ||
+ | "comment_flag_webhook": "Д", | ||
"image_url" : "https://ds24.ru/fs/static/2017/08/14/some_test.jpg", | "image_url" : "https://ds24.ru/fs/static/2017/08/14/some_test.jpg", | ||
"image_name" : "some test", | "image_name" : "some test", | ||
Строка 1549: | Строка 2054: | ||
"price": 100.2, | "price": 100.2, | ||
"what_was_done": "что-то сделано", | "what_was_done": "что-то сделано", | ||
- | "paid": 100.3 | + | "paid": 100.3, |
+ | "is_favorites" : "Д", | ||
+ | "phone_contact": "9754936397", | ||
+ | "flag_payment" : "Д", | ||
+ | "entrance" : "11" | ||
+ | "floor" : "11", | ||
+ | "email": "email@email.ru", | ||
+ | "essence_id": 111, | ||
+ | "priority_id": 2 | ||
} | } | ||
//Ответ | //Ответ | ||
{ | { | ||
- | "affected_rows": 3 | + | "affected_rows": 1, |
+ | "request": { | ||
+ | "request_id": 1300673, | ||
+ | "rtype": "Плановая", | ||
+ | "req_type": "plan", | ||
+ | "flag_emergency": "Н", | ||
+ | "is_paid": "Д", | ||
+ | "is_local_need": "Н", | ||
+ | "is_favorites": "Н", | ||
+ | "is_closed": "N", | ||
+ | "is_oico_account": 1, | ||
+ | "house": "Луначарского ул, дом 240", | ||
+ | "full_address": "Екатеринбург г, Луначарского ул, дом 240", | ||
+ | "fias": null, | ||
+ | "flat": "кв 100", | ||
+ | "flat_num": "100", | ||
+ | "flat_type": 1, | ||
+ | "cnt_id": 13521, | ||
+ | "house_id": 54696, | ||
+ | "flat_id": 1206770, | ||
+ | "type_id": 21, | ||
+ | "ess_id": 4114, | ||
+ | "status_id": 1, | ||
+ | "reason_id": null, | ||
+ | "emp_id": 36059, | ||
+ | "resp_id": 35574, | ||
+ | "priority_id": null, | ||
+ | "request_rso_id": 77530, | ||
+ | "check_id": null, | ||
+ | "execution_time": "04.04.2022 00:00", | ||
+ | "closing_time": null, | ||
+ | "created_at": "01.08.2023 20:37", | ||
+ | "updated_at": "02.04.2024 05:56", | ||
+ | "deadline_at": "04.04.2022", | ||
+ | "local_at": "2024-04-01T00:00:00.000Z", | ||
+ | "appointed_at": "02.04.2024", | ||
+ | "execution_time_on_tz": "2022-04-04T00:00:00.000Z", | ||
+ | "closing_time_on_tz": null, | ||
+ | "created_on_tz": "2023-08-01T20:37:01.705Z", | ||
+ | "updated_on_tz": "2024-04-02T05:56:44.009Z", | ||
+ | "scheduled_execution_time_on_tz": null, | ||
+ | "desired_time_start_on_tz": "2024-04-02T00:00:00.000Z", | ||
+ | "note": "test1", | ||
+ | "fio": null, | ||
+ | "emp_note": "emp_note", | ||
+ | "floor": 11, | ||
+ | "entr": "11", | ||
+ | "autophone": null, | ||
+ | "contphone": "123", | ||
+ | "email": "mail@mail.ru", | ||
+ | "tags": "<span >тест</span><span style=\"background-color:#ADFFB2\">ожидает оплаты</span>", | ||
+ | "last_comments": [ | ||
+ | { | ||
+ | "note": "1" | ||
+ | }, | ||
+ | { | ||
+ | "note": "note1" | ||
+ | } | ||
+ | ], | ||
+ | "price": 0, | ||
+ | "material_price": 10, | ||
+ | "paid": 100, | ||
+ | "ess": "Запросы по раскрытию информации по 731 пп", | ||
+ | "emp": "dsfjhskbskdf5", | ||
+ | "resp": "\"'`Alexander Galimov", | ||
+ | "created_by": "Пользователь личного кабинета ", | ||
+ | "emp_phone": "1746538770", | ||
+ | "resp_phone": null, | ||
+ | "uploads_count": 24, | ||
+ | "status": "Зарегистрирована", | ||
+ | "rso_status_name": "Зарегистрирована", | ||
+ | "ext_pay_system_id": "42", | ||
+ | "inn": "7203333262", | ||
+ | "what_was_done": "qwe1", | ||
+ | "oi_id": null, | ||
+ | "oi_status": null, | ||
+ | "rsfat_value": 6623, | ||
+ | "rsft_value": 90, | ||
+ | "reason": null, | ||
+ | "type": "Прочее", | ||
+ | "rate": null, | ||
+ | "deadline_str": -732, | ||
+ | "appointed_str": "02.04.2024", | ||
+ | "cnt_callback_phone": "34332830521", | ||
+ | "request_tags": [ | ||
+ | { | ||
+ | "color": "#ADFFB2", | ||
+ | "title": "ожидает оплаты" | ||
+ | } | ||
+ | ] | ||
+ | } | ||
} | } | ||
</code> | </code> | ||
Строка 1568: | Строка 2171: | ||
|count|number|да|Сколько заявок получить| | |count|number|да|Сколько заявок получить| | ||
|cnt_id|number|нет| идентификатор юр. лица| | |cnt_id|number|нет| идентификатор юр. лица| | ||
+ | |city|string|нет| Название города| | ||
|street|string|нет|улица| | |street|string|нет|улица| | ||
|house_id|number|нет|идентификатор дома| | |house_id|number|нет|идентификатор дома| | ||
Строка 1586: | Строка 2190: | ||
|custom_filter|string|нет|возможные значения фильтра: new / in_work / on_hold / deadline / finished . Mожет быть передано несколько значений через двоеточие (:).| | |custom_filter|string|нет|возможные значения фильтра: new / in_work / on_hold / deadline / finished . Mожет быть передано несколько значений через двоеточие (:).| | ||
|is_only_my|number|нет|фильтр, определяющий необходимо ли показывать все заявки или только те, у которых пользователь - ответственный / исполнитель ( 0 - все / 1 - пользователя)| | |is_only_my|number|нет|фильтр, определяющий необходимо ли показывать все заявки или только те, у которых пользователь - ответственный / исполнитель ( 0 - все / 1 - пользователя)| | ||
- | |custom_order|string|нет|тип сортировки заявок ( EXEC_TIME / CREATED_TIME - по сроку выполнения / дате создания) EXEC_TIME по умолчанию если не указано иное.| | + | |custom_order|string|нет|тип сортировки заявок ( По дате изменения: update; По дате создания: create; По сроку выполнения: execution; По дате выполнения: closing| |
+ | |sort|string|нет|Направление сортировки. по возрастанию(asc): A; по убыванию(desc): D;| | ||
|house_ids|string|нет|список идентификаторов домов через двоеточие. Пример: "1:2:3"| | |house_ids|string|нет|список идентификаторов домов через двоеточие. Пример: "1:2:3"| | ||
|flat_ids|string|нет|список идентификаторов помещений через двоеточие. Пример: "1:2:3"| | |flat_ids|string|нет|список идентификаторов помещений через двоеточие. Пример: "1:2:3"| | ||
Строка 1596: | Строка 2201: | ||
|exec_time_start|string|нет|начало срока выполнения| | |exec_time_start|string|нет|начало срока выполнения| | ||
|exec_time_end|string|нет|конец срока выполнения| | |exec_time_end|string|нет|конец срока выполнения| | ||
+ | |is_favorites|number|нет|фильтр, определяющий необходимо ли показывать все заявки или только те, которые у пользователя в избранном ( 0 - все / 1 - избранные)| | ||
+ | |add_type|string|нет|фильтр SLA. Тип фильтра. значения: RSFAT - первое принятие в работу; RSFT - время до выполнения| | ||
+ | |add_more_than|number|нет|фильтр SLA. Больше чем. указывается в количестве секунд. Не будет работать, если не указан add_type| | ||
+ | |add_less_than|number|нет|фильтр SLA. Меньше чем. указывается в количестве секунд. Не будет работать, если не указан add_type| | ||
**Тип ответа:** Массив объектов | **Тип ответа:** Массив объектов | ||
Строка 1607: | Строка 2216: | ||
|house|string|да|Адрес дома| | |house|string|да|Адрес дома| | ||
|flat|string|может быть null|номер квартиры| | |flat|string|может быть null|номер квартиры| | ||
+ | |entr|string|нет|обозначение подъезда| | ||
|status|string|да|текстовое описание статуса| | |status|string|да|текстовое описание статуса| | ||
|status_id|number|да|идентификатор статуса| | |status_id|number|да|идентификатор статуса| | ||
Строка 1613: | Строка 2223: | ||
|execution_time|string|нет|дата и время выполнения заявки| | |execution_time|string|нет|дата и время выполнения заявки| | ||
|price|number|может быть null| Цена заявки. Определена, если заявка платная, если нет, то null| | |price|number|может быть null| Цена заявки. Определена, если заявка платная, если нет, то null| | ||
- | |material_price|number|-|-| | + | |material_price|number|-|стоимость материалов по заявке| |
- | |tags|string|может быть null|-| | + | |tags|string|может быть null|тэги заявки| |
- | |uploads_count|number|-|-| | + | |uploads_count|number|-|кол-во скачиваний заявки| |
|appointed_str|string|может быть null|время прихода специалиста в формате сегодня / завтра / вчера / дата c hh:mm( до hh:mm)| | |appointed_str|string|может быть null|время прихода специалиста в формате сегодня / завтра / вчера / дата c hh:mm( до hh:mm)| | ||
|appointed_at|string|может быть null|Дата и время прихода специалиста| | |appointed_at|string|может быть null|Дата и время прихода специалиста| | ||
Строка 1622: | Строка 2232: | ||
|emp_id|number|может быть null|идентификатор исполнителя| | |emp_id|number|может быть null|идентификатор исполнителя| | ||
|reason|string|может быть null|текстовое описание причины статуса| | |reason|string|может быть null|текстовое описание причины статуса| | ||
- | |local_at|-|может быть null|-| | + | |local_at|string|может быть null|Дата, когда исполнитель локализовал аварию по заявке «ДД.ММ.ГГГГ ЧЧ:ММ» | |
|contphone|string|да|Номер телефона клиента обратившегося с заявкой| | |contphone|string|да|Номер телефона клиента обратившегося с заявкой| | ||
|house_id|number|нет|идентификатор дома| | |house_id|number|нет|идентификатор дома| | ||
- | |flat_type|number|нет|тип помещения. Смотреть [[d24:develop:v2:backend:v2#типы_помещений|описание типов помещений]] | + | |flat_type|number|нет|тип помещения] |
|flat_num|string|нет|номер помещения| | |flat_num|string|нет|номер помещения| | ||
- | |autophone|string|нет|-| | + | |autophone|string|нет|АОН| |
|ess_id|number|нет|идентификатор причины обращения| | |ess_id|number|нет|идентификатор причины обращения| | ||
|type_id|number|нет|идентификатор типа заявки| | |type_id|number|нет|идентификатор типа заявки| | ||
+ | |is_favorites|string|да|добавлена ли заявка в избранное Д/Н| | ||
Строка 1652: | Строка 2262: | ||
"house": "Луначарского ул, дом 240", | "house": "Луначарского ул, дом 240", | ||
"flat": "кв 100", | "flat": "кв 100", | ||
+ | "entr": "2", | ||
"status": "Зарегистрирована", | "status": "Зарегистрирована", | ||
"created_at": "17.03.2022 15:26", | "created_at": "17.03.2022 15:26", | ||
Строка 1674: | Строка 2285: | ||
"autophone": null, | "autophone": null, | ||
"ess_id": 3263, | "ess_id": 3263, | ||
- | "type_id": 21 | + | "type_id": 21, |
+ | "is_favorites" :"Д" | ||
}, | }, | ||
{ | { | ||
Строка 1683: | Строка 2295: | ||
"house": "Луначарского ул, дом 240", | "house": "Луначарского ул, дом 240", | ||
"flat": "кв 100", | "flat": "кв 100", | ||
+ | "entr": null, | ||
"status": "Зарегистрирована", | "status": "Зарегистрирована", | ||
"created_at": "17.03.2022 15:26", | "created_at": "17.03.2022 15:26", | ||
Строка 1705: | Строка 2318: | ||
"autophone": null, | "autophone": null, | ||
"ess_id": 3263, | "ess_id": 3263, | ||
- | "type_id": 21 | + | "type_id": 21, |
+ | "is_favorites" :"Н" | ||
}, | }, | ||
... | ... | ||
Строка 1725: | Строка 2339: | ||
^Название^Тип^Обязательно^Описание^ | ^Название^Тип^Обязательно^Описание^ | ||
|tag_id|number|да|идентификатор тега| | |tag_id|number|да|идентификатор тега| | ||
- | |title|string|да|-| | + | |title|string|да|наименование| |
- | |color|string|нет|-| | + | |color|string|нет|цвет| |
- | |is_set|string|да|-| | + | |is_set|string|да|установлено ли| |
**Пример:** | **Пример:** | ||
Строка 1769: | Строка 2383: | ||
|request_id|number|идентификатор заявки| | |request_id|number|идентификатор заявки| | ||
|rtype|string|тип заявки| | |rtype|string|тип заявки| | ||
+ | |req_type|string|тип заявки полем из бд| | ||
|flag_emergency|string|аварийная ли заявка. Д - аварийная / Н - не аварийная| | |flag_emergency|string|аварийная ли заявка. Д - аварийная / Н - не аварийная| | ||
|note|string|текст заявки| | |note|string|текст заявки| | ||
|house|string| Адрес дома| | |house|string| Адрес дома| | ||
- | |flat|string|номер квартиры| | + | |fias|string| фиас| |
+ | |full_address|string| Полный адрес дома| | ||
+ | |flat|string|тип и номер квартиры| | ||
+ | |flat_num|string|номер квартиры| | ||
+ | |flat_type|number|тип помещения| | ||
|status|string|текущий статус| | |status|string|текущий статус| | ||
|reason|string|причина статуса| | |reason|string|причина статуса| | ||
Строка 1782: | Строка 2401: | ||
|contphone|string|если житель пожелал оставить другой контактный телефон| | |contphone|string|если житель пожелал оставить другой контактный телефон| | ||
|email|string|Адрес электронной почты жителя| | |email|string|Адрес электронной почты жителя| | ||
- | |tags|string|-| | + | |tags|string|тэги заявки| |
|type|string|Тип работ (из справочника)| | |type|string|Тип работ (из справочника)| | ||
|ess|string|Причина обращения (из справочника)| | |ess|string|Причина обращения (из справочника)| | ||
Строка 1789: | Строка 2408: | ||
|created_by|string|пользователь, создавший заявку| | |created_by|string|пользователь, создавший заявку| | ||
|deadline_at|string|Последняя дата срока выполнения заявки в формате DD.MM.YYYY | | |deadline_at|string|Последняя дата срока выполнения заявки в формате DD.MM.YYYY | | ||
+ | |closing_time|string|Время закрытия заявки в формате DD.MM.YYYY hh24:mi | | ||
+ | |execution_time|string|Дата срока выполнения заявки в формате DD.MM.YYYY hh24:mi| | ||
+ | |execution_time_on_tz|string|Дата срока выполнения заявки в формате YYYY-MM-DD"T"HH24:MI:SS.FF3"Z"| | ||
+ | |closing_time_on_tz|string|Дата закрытия заявки в формате YYYY-MM-DD"T"HH24:MI:SS.FF3"Z"| | ||
+ | |created_on_tz|string|Дата создания заявки в формате YYYY-MM-DD"T"HH24:MI:SS.FF3"Z"| | ||
+ | |updated_on_tz|string|Дата обновления в формате YYYY-MM-DD"T"HH24:MI:SS.FF3"Z"| | ||
+ | |scheduled_execution_time_on_tz|string|Дата запланированного выполнения заявки формате YYYY-MM-DD"T"HH24:MI:SS.FF3"Z"| | ||
+ | |desired_time_start_on_tz|string|Дата желаемого выполнения заявки формате YYYY-MM-DD"T"HH24:MI:SS.FF3"Z"| | ||
|deadline_str|number|Количество до конца срока выполнения заявки. Может иметь отрицательное значение| | |deadline_str|number|Количество до конца срока выполнения заявки. Может иметь отрицательное значение| | ||
|emp_note|string|скрытый комментарий только для пользователей Д24 (операторы не видят)| | |emp_note|string|скрытый комментарий только для пользователей Д24 (операторы не видят)| | ||
- | |appointed_at|string|время и дата прибытия исполнителя в часовом поясе пользователя. Формат - DD.MM.YYYY hh24:mi | | + | |appointed_at|string|время и дата прибытия исполнителя в часовом поясе пользователя. Формат - DD.MM.YYYY | |
|emp_phone|string|телефон(ы) исполнителя| | |emp_phone|string|телефон(ы) исполнителя| | ||
|resp_phone|string|телефон(ы) ответственного| | |resp_phone|string|телефон(ы) ответственного| | ||
Строка 1801: | Строка 2428: | ||
|resp_id|number| Идентификатор ответственного| | |resp_id|number| Идентификатор ответственного| | ||
|cnt_id|number| Идентификатор юр. лица| | |cnt_id|number| Идентификатор юр. лица| | ||
+ | |oi_id|number| Идентификатор оповещения| | ||
+ | |oi_status|string| Статус оповещения| | ||
+ | |house_id|number| Идентификатор дома| | ||
+ | |priority_id|number| Идентификатор приоритета заявки| | ||
+ | |flat_id|number| Идентификатор помещения| | ||
+ | |request_rso_id|number| Идентификатор РСО заявки| | ||
+ | |rso_status_name|string| Статус РСО заявки| | ||
|is_paid|string| Оплачено или нет. Д - оплачено / Н - не оплачено| | |is_paid|string| Оплачено или нет. Д - оплачено / Н - не оплачено| | ||
|price|number| стоимость заявки| | |price|number| стоимость заявки| | ||
+ | |rate|number| рейтинг заявки| | ||
|paid|number| сколько оплачено в данный момент по заявке| | |paid|number| сколько оплачено в данный момент по заявке| | ||
|material_price| number|стоимость материалов по заявке| | |material_price| number|стоимость материалов по заявке| | ||
|appointed_str|string|желаемое время прихода специалиста| | |appointed_str|string|желаемое время прихода специалиста| | ||
- | |uploads_count|number|-| | + | |uploads_count|number|кол-во скачиваний заявки| |
+ | |last_comments|string|комменты к заявке в виде массива| | ||
+ | |request_tags|string|тэги заявки в виде массива| | ||
|check_id|number|id связанного с заявкой чек-листа (если он есть, то заявка была создана через чек-лист)| | |check_id|number|id связанного с заявкой чек-листа (если он есть, то заявка была создана через чек-лист)| | ||
|is_local_need|string|нужна ли локализация аварии. Н - нет / Д - да| | |is_local_need|string|нужна ли локализация аварии. Н - нет / Д - да| | ||
Строка 1812: | Строка 2449: | ||
|what_was_done|string| что было сделано | | |what_was_done|string| что было сделано | | ||
|cnt_callback_phone| string|телефон для обращения в кц в десятизначном формате| | |cnt_callback_phone| string|телефон для обращения в кц в десятизначном формате| | ||
+ | |is_favorites|string|добавлена ли заявка в избранное Д/Н| | ||
+ | |is_closed|string|закрыта ли заявка Y/N| | ||
+ | |ext_pay_system_id|string|код платежной системы из ойко| | ||
+ | |inn|string|инн юр лица| | ||
+ | |is_oico_account|number|Есть ли у собственника приложение oico, варианты ответа 0 - нет приложения/1 нет приложения - есть приложение) | | ||
+ | |fio|string| ФИО заявителя | | ||
+ | |rsft_value|number| SLA Время первого принятия в работу | | ||
+ | |rsfat_value|number| SLA Время выполнения | | ||
**Примеры:** | **Примеры:** | ||
Строка 1819: | Строка 2464: | ||
/* | /* | ||
- | https://server.ru/v2/request/1298309 | + | https://server.ru/v2/request/1300673 |
*/ | */ | ||
Строка 1825: | Строка 2470: | ||
{ | { | ||
- | "request_id": 1298309, | + | "request_id": 1300673, |
"rtype": "Плановая", | "rtype": "Плановая", | ||
+ | "req_type": "plan", | ||
"flag_emergency": "Н", | "flag_emergency": "Н", | ||
- | "note": "Не работает освещение в пом 13. Этаж 1", | + | "is_paid": "Д", |
- | "house": "Бакинских комиссаров, дом 3", | + | |
- | "flat": null, | + | |
- | "status": "Закрыта", | + | |
- | "reason": "принудительно модератором", | + | |
- | "created_at": "28.10.2021 11:02", | + | |
- | "updated_at": "01.11.2021 15:15", | + | |
- | "floor": null, | + | |
- | "entr": null, | + | |
- | "autophone": null, | + | |
- | "contphone": null, | + | |
- | "email": null, | + | |
- | "tags": "<span style=\"background-color:#8BC4F7\">метка</span>", | + | |
- | "type": "Электричество", | + | |
- | "ess": "Восстановить освещение в МОП", | + | |
- | "emp": null, | + | |
- | "resp": "Предеин Анатолий", | + | |
- | "created_by": "Беллендир Наталья", | + | |
- | "deadline_at": "01.11.2021", | + | |
- | "emp_note": null, | + | |
- | "appointed_at": null, | + | |
- | "emp_phone": null, | + | |
- | "resp_phone": "9616161616", | + | |
- | "status_id": 25, | + | |
- | "reason_id": 4884, | + | |
- | "type_id": 24, | + | |
- | "ess_id": 1561, | + | |
- | "emp_id": null, | + | |
- | "resp_id": 33, | + | |
- | "cnt_id": 10401, | + | |
- | "deadline_str": null, | + | |
- | "price": null, | + | |
- | "paid": null, | + | |
- | "material_price": null, | + | |
- | "is_paid": "Н", | + | |
- | "appointed_str": null, | + | |
- | "uploads_count": 0, | + | |
"is_local_need": "Н", | "is_local_need": "Н", | ||
- | "local_at": null, | + | "is_favorites": "Н", |
- | "what_was_done": null, | + | "is_closed": "N", |
- | "cnt_callback_phone": "3522222888", | + | "is_oico_account": 1, |
- | "check_id": null | + | "house": "Луначарского ул, дом 240", |
+ | "full_address": "Екатеринбург г, Луначарского ул, дом 240", | ||
+ | "fias": null, | ||
+ | "flat": "кв 100", | ||
+ | "flat_num": "100", | ||
+ | "flat_type": 1, | ||
+ | "cnt_id": 13521, | ||
+ | "house_id": 54696, | ||
+ | "flat_id": 1206770, | ||
+ | "type_id": 21, | ||
+ | "ess_id": 4114, | ||
+ | "status_id": 1, | ||
+ | "reason_id": null, | ||
+ | "emp_id": 36059, | ||
+ | "resp_id": 35574, | ||
+ | "priority_id": null, | ||
+ | "request_rso_id": 77530, | ||
+ | "check_id": null, | ||
+ | "execution_time": "04.04.2022 00:00", | ||
+ | "closing_time": null, | ||
+ | "created_at": "01.08.2023 20:37", | ||
+ | "updated_at": "02.04.2024 05:56", | ||
+ | "deadline_at": "04.04.2022", | ||
+ | "local_at": "2024-04-01T00:00:00.000Z", | ||
+ | "appointed_at": "02.04.2024", | ||
+ | "execution_time_on_tz": "2022-04-04T00:00:00.000Z", | ||
+ | "closing_time_on_tz": null, | ||
+ | "created_on_tz": "2023-08-01T20:37:01.705Z", | ||
+ | "updated_on_tz": "2024-04-02T05:56:44.009Z", | ||
+ | "scheduled_execution_time_on_tz": null, | ||
+ | "desired_time_start_on_tz": "2024-04-02T00:00:00.000Z", | ||
+ | "note": "test1", | ||
+ | "fio": null, | ||
+ | "emp_note": "emp_note", | ||
+ | "floor": 1, | ||
+ | "entr": "1", | ||
+ | "autophone": null, | ||
+ | "contphone": "123", | ||
+ | "email": "mail@mail.ru", | ||
+ | "tags": "<span >тест</span><span style=\"background-color:#ADFFB2\">ожидает оплаты</span>", | ||
+ | "last_comments": [ | ||
+ | { | ||
+ | "note": "1" | ||
+ | }, | ||
+ | { | ||
+ | "note": "note1" | ||
+ | } | ||
+ | ], | ||
+ | "price": 0, | ||
+ | "material_price": 10, | ||
+ | "paid": 100, | ||
+ | "ess": "Запросы по раскрытию информации по 731 пп", | ||
+ | "emp": "dsfjhskbskdf5", | ||
+ | "resp": "\"'`Alexander Galimov", | ||
+ | "created_by": "Пользователь личного кабинета ", | ||
+ | "emp_phone": "1746538770", | ||
+ | "resp_phone": null, | ||
+ | "uploads_count": 24, | ||
+ | "status": "Зарегистрирована", | ||
+ | "rso_status_name": "Зарегистрирована", | ||
+ | "ext_pay_system_id": "42", | ||
+ | "inn": "7203333262", | ||
+ | "what_was_done": "qwe1", | ||
+ | "oi_id": null, | ||
+ | "oi_status": null, | ||
+ | "rsfat_value": 6623, | ||
+ | "rsft_value": 90, | ||
+ | "reason": null, | ||
+ | "type": "Прочее", | ||
+ | "rate": null, | ||
+ | "deadline_str": -732, | ||
+ | "appointed_str": "02.04.2024", | ||
+ | "cnt_callback_phone": "34332830521", | ||
+ | "request_tags": [ | ||
+ | { | ||
+ | "color": "#ADFFB2", | ||
+ | "title": "ожидает оплаты" | ||
+ | } | ||
+ | ] | ||
} | } | ||
+ | </code> | ||
+ | |||
+ | ==== Получение деталей табов для заявки ==== | ||
+ | GET https://server.ru/v2/request/:request_id/all | ||
+ | |||
+ | **Переменные URL:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |request_id|number|да|Идентификатор заявки, которую нужно поменять| | ||
+ | |||
+ | **Переменные URL:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |comment|number|нет|хотим ли мы подгружать комментарии в ленту| | ||
+ | |activity|number|нет|хотим ли мы подгружать историю активности в ленту| | ||
+ | |sms|number|нет|хотим ли мы подгружать смс в ленту| | ||
+ | |call|number|нет|хотим ли мы подгружать звонки в ленту| | ||
+ | |file|number|нет|хотим ли мы подгружать прикрепленные файлы в ленту| | ||
+ | |telegram|number|нет|хотим ли мы подгружать телеграм сообщения в ленту| | ||
+ | |pushes|number|нет|хотим ли мы подгружать пуши из МП в ленту| | ||
+ | |||
+ | Если не передать ни один из параметров, значит будет грузиться все типы, поэтому передавать только в том случае, когда нужно получить конкретные типы. | ||
+ | |||
+ | Передаются как пример: comment=1 | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |id|number|да|-| | ||
+ | |feed_type|string|да|конкретный тип сущности в ленте| | ||
+ | |created_on_tz|string|да|время создания| | ||
+ | |user_data|string|да|данные о пользоватле в одной строке, с разделителем| | ||
+ | |payload|string|да|полезная информация в зависимости от типа сущности| | ||
+ | |feed_opt_1|string|да|резервные данные с 1 до 5, меняются в зависимости от сущности| | ||
+ | |feed_opt_2|string|да|-| | ||
+ | |feed_opt_3|string|да|-| | ||
+ | |feed_opt_4|string|да|-| | ||
+ | |feed_opt_5|string|да|-| | ||
+ | |username|string|да|имя пользователя| | ||
+ | |position|string|да|позиция| | ||
+ | |access|string|да|уровень доступа| | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | //Ответ | ||
+ | [ | ||
+ | { | ||
+ | "id": 1978271, | ||
+ | "user_data": "dev| |С", | ||
+ | "feed_type": "comment", | ||
+ | "created_on_tz": "2024-03-28T07:35:36.494Z", | ||
+ | "payload": "123", | ||
+ | "feed_opt_1": "Н", | ||
+ | "feed_opt_2": null, | ||
+ | "feed_opt_3": null, | ||
+ | "feed_opt_4": null, | ||
+ | "feed_opt_5": null, | ||
+ | "username": "dev", | ||
+ | "position": " ", | ||
+ | "access": "С" | ||
+ | }, | ||
+ | { | ||
+ | "id": 10677037, | ||
+ | "user_data": "dev| |С", | ||
+ | "feed_type": "activity", | ||
+ | "created_on_tz": "2024-03-28T07:19:10.826Z", | ||
+ | "payload": "На основе данной заявки была создана заявка в ГазУралКомплект #77470", | ||
+ | "feed_opt_1": null, | ||
+ | "feed_opt_2": null, | ||
+ | "feed_opt_3": null, | ||
+ | "feed_opt_4": null, | ||
+ | "feed_opt_5": null, | ||
+ | "username": "dev", | ||
+ | "position": " ", | ||
+ | "access": "С" | ||
+ | }, | ||
+ | { | ||
+ | "id": 2152559, | ||
+ | "user_data": null, | ||
+ | "feed_type": "sms", | ||
+ | "created_on_tz": "2018-03-23T04:37:27.986Z", | ||
+ | "payload": "Заявка 1287313, следите по тел. 349-91-11 или на https://pultdoma.ru", | ||
+ | "feed_opt_1": "9133815924", | ||
+ | "feed_opt_2": "2018-03-23 08:37:00 ", | ||
+ | "feed_opt_3": null, | ||
+ | "feed_opt_4": null, | ||
+ | "feed_opt_5": null, | ||
+ | "username": null, | ||
+ | "position": null, | ||
+ | "access": null | ||
+ | }, | ||
+ | { | ||
+ | "id": 5308122, | ||
+ | "user_data": "Почевалов Андрей Александрович|Ст.инженер|П", | ||
+ | "feed_type": "call", | ||
+ | "created_on_tz": "2018-03-24T03:07:06.745Z", | ||
+ | "payload": "c1-1521860826.65794", | ||
+ | "feed_opt_1": "Исполнитель", | ||
+ | "feed_opt_2": "9232230214", | ||
+ | "feed_opt_3": "3", | ||
+ | "feed_opt_4": null, | ||
+ | "feed_opt_5": null, | ||
+ | "username": "Почевалов Андрей Александрович", | ||
+ | "position": "Ст.инженер", | ||
+ | "access": "П" | ||
+ | }, | ||
+ | { | ||
+ | "id": 37521, | ||
+ | "user_data": "dev| |С", | ||
+ | "feed_type": "file", | ||
+ | "created_on_tz": "2024-03-25T09:22:05.250Z", | ||
+ | "payload": "ljklk", | ||
+ | "feed_opt_1": "lj", | ||
+ | "feed_opt_2": null, | ||
+ | "feed_opt_3": null, | ||
+ | "feed_opt_4": null, | ||
+ | "feed_opt_5": null, | ||
+ | "username": "dev", | ||
+ | "position": " ", | ||
+ | "access": "С" | ||
+ | }, | ||
+ | ] | ||
+ | |||
+ | </code> | ||
+ | |||
+ | ==== Получение контрольных вопросов для заявки ==== | ||
+ | GET https://server.ru/v2/request/:request_id/questions | ||
+ | |||
+ | **Переменные URL:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |request_id|number|да|Идентификатор заявки, которую нужно поменять| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |answer_id|number|да|ид ответа| | ||
+ | |question_id|number|да|ид вопроса| | ||
+ | |question_text|string|да|текст вопроса| | ||
+ | |answer_text|string|да|текст ответа| | ||
+ | |answer_type|string|да|тип ответа| | ||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | //Ответ | ||
+ | [ | ||
+ | { | ||
+ | "answer_id": 257, | ||
+ | "question_id": 35, | ||
+ | "question_text": "Оцените качество выполнения заявки", | ||
+ | "answer_text": "2", | ||
+ | "answer_type": "Н" | ||
+ | } | ||
+ | ] | ||
+ | |||
+ | </code> | ||
+ | |||
+ | |||
+ | ==== Получение подписчиков заявки ==== | ||
+ | GET https://server.ru/v2/request/:request_id/subscribers | ||
+ | |||
+ | **Переменные URL:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |request_id|number|да|Идентификатор заявки, которую нужно поменять| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |id|number|да|-| | ||
+ | |username|string|да|имя пользователя| | ||
+ | |access|string|да|уровень доступа| | ||
+ | |position|string|да|позиция| | ||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | //Ответ | ||
+ | [ | ||
+ | { | ||
+ | "id":1672, | ||
+ | "username":"Служба поддержки", | ||
+ | "access":"С", | ||
+ | "position":"Директор" | ||
+ | } | ||
+ | ] | ||
+ | |||
+ | </code> | ||
+ | |||
+ | ==== Получение SLA заявки ==== | ||
+ | GET https://server.ru/v2/request/:request_id/sla | ||
+ | |||
+ | **Переменные URL:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |request_id|number|да|Идентификатор заявки, которую нужно поменять| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |name|string|да|наименования статуса| | ||
+ | |status_id|number|да|ид статуса| | ||
+ | |created_on_tz|string|да|время создания| | ||
+ | |hours_round|number|да|округленное до часов общее время заявки в работе| | ||
+ | |days|number|да|кол-во дней заявки в работе| | ||
+ | |hours|number|да|кол-во часов заявки в работе| | ||
+ | |minutes|number|да|кол-во минут заявки в работе| | ||
+ | |seconds|number|да|кол-во секунд заявки в работе| | ||
+ | |req_sla_first_apply_time|number|да|первое принятие в работу| | ||
+ | |req_sla_finish_time|number|да|время окончания| | ||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | //Ответ | ||
+ | [ | ||
+ | { | ||
+ | "name": "Принята в работу", | ||
+ | "status_id": 2, | ||
+ | "created_on_tz": "2023-03-27T07:25:29.616Z", | ||
+ | "hours_round": 8808, | ||
+ | "days": 367, | ||
+ | "hours": 0, | ||
+ | "minutes": 6, | ||
+ | "seconds": 0, | ||
+ | "req_sla_first_apply_time": null, | ||
+ | "req_sla_finish_time": null | ||
+ | } | ||
+ | ] | ||
+ | |||
+ | </code> | ||
+ | |||
+ | ==== Добавление комментария или прикрепление файла в ленту ==== | ||
+ | POST https://server.ru/v2/request/:request_id/all/:feed_type | ||
+ | |||
+ | **Переменные URL:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |request_id|number|да|идентификатор заявки| | ||
+ | |feed_type|string|да|тип сущности, которую собираемся менять| | ||
+ | |||
+ | feed_type может быть comment или file | ||
+ | |||
+ | **Тело запроса:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |note|string|нет|комметарий| | ||
+ | |flag_webhook |string|нет|вебхук, отправлять жителю или нет| | ||
+ | |fileName |string|нет|имя файла| | ||
+ | |fileUrl |string|нет|юрл файла| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |ok|boolean|да|успешное обновление| | ||
+ | |||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | //Добавление комментария | ||
+ | |||
+ | //Тело запроса | ||
+ | |||
+ | { | ||
+ | "note": "123" | ||
+ | "flag_webhook": "Д" | ||
+ | } | ||
+ | |||
+ | //Ответ | ||
+ | {"ok":true} | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ==== Изменение объекта в ленте (табах) заявки ==== | ||
+ | POST https://server.ru/v2/request/:request_id/all/:feed_type/:id | ||
+ | |||
+ | **Переменные URL:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |request_id|number|да|идентификатор заявки| | ||
+ | |feed_type|string|да|тип сущности| | ||
+ | |id|string|да|ид объекта, который собираемся менять| | ||
+ | |||
+ | feed_type может быть comment, call, file | ||
+ | |||
+ | **Тело запроса:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |note|string|нет|комментарий| | ||
+ | |flag_webhook |string|нет|вебхук, отправлять жителю или нет| | ||
+ | |mark_average |number|нет|оценка| | ||
+ | |delete_file |boolean|нет|булевое обозначение удаления файла| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |ok|boolean|да|успешное обновление| | ||
+ | |||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | //Изменения флага для комментария или прикрепленного файла | ||
+ | |||
+ | //Тело запроса | ||
+ | |||
+ | { | ||
+ | "flag_webhook": "Д" | ||
+ | } | ||
+ | |||
+ | //Ответ | ||
+ | {"ok":true} | ||
+ | </code> | ||
+ | |||
+ | <code javascript> | ||
+ | //Изменения оценки звонка | ||
+ | |||
+ | //Тело запроса | ||
+ | |||
+ | { | ||
+ | "mark_average": 4 | ||
+ | } | ||
+ | |||
+ | //Ответ | ||
+ | {"ok":true} | ||
+ | </code> | ||
+ | |||
+ | <code javascript> | ||
+ | //Удаление файла | ||
+ | |||
+ | //Тело запроса | ||
+ | |||
+ | { | ||
+ | "delete_file": true | ||
+ | } | ||
+ | |||
+ | //Ответ | ||
+ | {"ok":true} | ||
</code> | </code> | ||
Строка 1997: | Строка 3030: | ||
POST https://server.ru/v2/request/:request_id/tocurrentrepair | POST https://server.ru/v2/request/:request_id/tocurrentrepair | ||
+ | - сработает только если flag_emergency = Д в тек момент | ||
+ | - устанавливается время локализации = systimestamp | ||
+ | - устанавливается статус "Требуется передать", что бы была возможность сбросить флаг аварийности | ||
+ | - flag_emergency = Н (заявка перестает быть аварийной) | ||
+ | - исполнитель назначается дневной по плановым / платным заявкам | ||
+ | - автотегирование с правилом "Отправляют на участок (Сценарий исполнителя)" | ||
+ | |||
**Переменные URL** | **Переменные URL** | ||
Строка 2083: | Строка 3123: | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
|created_at|string|да|Дата создания| | |created_at|string|да|Дата создания| | ||
+ | |created_on_tz|string|да| Zulu Временная метка события по utc | | ||
|type|number|да|Тип события 0 - комментарий, 1 - активность, 2 - файлы, 3 - изображения с превью, 4 - запись разговора| | |type|number|да|Тип события 0 - комментарий, 1 - активность, 2 - файлы, 3 - изображения с превью, 4 - запись разговора| | ||
|note|string|да|текст события| | |note|string|да|текст события| | ||
Строка 2088: | Строка 3129: | ||
|id|number|да|идентификатор события| | |id|number|да|идентификатор события| | ||
|flag_webhook|string|да| Статус публикации события. Д - опубликовано / Н - не опубликовано"| | |flag_webhook|string|да| Статус публикации события. Д - опубликовано / Н - не опубликовано"| | ||
- | |creator_type|number|да|-| | + | |creator_type|number|да|0 - событие внутри системы, 1 - событие от собственника ч/з мп| |
+ | |creator_id|number|да|id пользователя создавшего событие в ленте| | ||
**Примеры:** | **Примеры:** | ||
Строка 2102: | Строка 3144: | ||
[ | [ | ||
{ | { | ||
- | "created_at":"17.07.2017 18:58", | + | "created_at": "12.03.2024 01:16", |
- | "type":1, | + | "created_on_tz": "2024-03-11T20:16:44.842Z", |
- | "note":"Смена исполнителя ->> Башкирев Эдуард Олегович\r\n...", | + | "type": 0, |
- | "created_by":"Журавлева Марина Сергеевна", | + | "note": "прот", |
- | "id": 12345, | + | "created_by": "кто-то очень умный", |
- | "flag_webhook": "Д", | + | "flag_webhook": "Н", |
- | "creator_type": 0 | + | "id": 27072208, |
+ | "creator_type": 0, | ||
+ | "creator_id": 33 | ||
}, | }, | ||
{ | { | ||
- | "created_at":"17.07.2017 18:03", | + | "created_at": "12.03.2024 01:16", |
- | "type":3, | + | "created_on_tz": "2024-03-11T20:16:44.840Z", |
- | "note":"https://pultdoma.ru/front/uploads/img/17-07-2017/3196190_549_2_596c99ab73ae0.jpg", | + | "type": 1, |
- | "created_by":"Пользователь личного кабинета", | + | "note": "Статус сменился с Принята в работу на Выполнена", |
- | "id": 123456, | + | "created_by": "кто-то очень умный", |
+ | "flag_webhook": null, | ||
+ | "id": 59487612, | ||
+ | "creator_type": 0, | ||
+ | "creator_id": 33 | ||
+ | }, | ||
+ | { | ||
+ | "created_at": "11.03.2024 16:08", | ||
+ | "created_on_tz": "2024-03-11T11:08:51.999Z", | ||
+ | "type": 0, | ||
+ | "note": "фывафыва", | ||
+ | "created_by": "кто-то очень умный", | ||
"flag_webhook": "Н", | "flag_webhook": "Н", | ||
- | "creator_type": 0 | + | "id": 27067540, |
+ | "creator_type": 0, | ||
+ | "creator_id": 278794 | ||
+ | }, | ||
+ | { | ||
+ | "created_at": "11.03.2024 16:08", | ||
+ | "created_on_tz": "2024-03-11T11:08:51.979Z", | ||
+ | "type": 1, | ||
+ | "note": "Статус сменился с Зарегистрирована на Принята в работу", | ||
+ | "created_by": "кто-то очень умный", | ||
+ | "flag_webhook": null, | ||
+ | "id": 59470759, | ||
+ | "creator_type": 0, | ||
+ | "creator_id": 278794 | ||
} | } | ||
] | ] | ||
Строка 2195: | Строка 3263: | ||
|type_description|string|да|описание типа пуша.| | |type_description|string|да|описание типа пуша.| | ||
|created_at|string|да|время создания пуша в формате DD.MM.YYYY hh.mm| | |created_at|string|да|время создания пуша в формате DD.MM.YYYY hh.mm| | ||
+ | |created_on_tz|string|да|время создания пуша в формате ISO| | ||
+ | |object_status|string|да|состояние статуса из заявки| | ||
+ | |address_full|string|да|полный адрес| | ||
**Примеры:** | **Примеры:** | ||
Строка 2270: | Строка 3341: | ||
"type_description": "Новая заявка", | "type_description": "Новая заявка", | ||
"created_at": "22.12.2021 10:37" | "created_at": "22.12.2021 10:37" | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ==== Пометить прочитанными все push-уведомления у пользователя ==== | ||
+ | |||
+ | POST https://server.ru/v2/push/readall | ||
+ | |||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа:** | ||
+ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
+ | |affected_rows|number|да|количество затронутых обновлением строк| | ||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | //Запрос | ||
+ | |||
+ | /* | ||
+ | https://server.ru/v2/push/readall | ||
+ | */ | ||
+ | |||
+ | //Ответ code: 200 | ||
+ | |||
+ | { | ||
+ | affected_rows: 167 | ||
} | } | ||
</code> | </code> | ||
Строка 2284: | Строка 3383: | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
|username| string |да| Имя пользователя |, | |username| string |да| Имя пользователя |, | ||
- | |can_close_request|boolean |да| - |, | + | |can_close_request|boolean |да| доступ к закрытию заявок 1 или 0 |, |
- | |can_access_meters|boolean |да| - |, | + | |can_access_meters|boolean |да| доступ к счетчикам 1 или 0 |, |
- | |can_access_contacts|boolean |да| - |, | + | |can_access_contacts|boolean |да| доступ к контактам1 или 0|, |
- | |account_name| string |да| -|, | + | |account_name| string |да| имя аккаунта|, |
|phone| string |да| Номер телефона пользователя|, | |phone| string |да| Номер телефона пользователя|, | ||
- | |emp_id| number |да| - |, | + | |emp_id| number |да| ид пользователя |, |
|not_read_push_count| number |да|количество непрочитанных push-уведомлений |, | |not_read_push_count| number |да|количество непрочитанных push-уведомлений |, | ||
|can_comment_to_ext_system| |да|варианты 0 / 1| | |can_comment_to_ext_system| |да|варианты 0 / 1| | ||
- | |token_id| number |да| -|, | + | |token_id| number |да| ид токена|, |
- | |can_access_material_price|boolean |да| - | | + | |can_access_material_price|boolean |да| доступ к изменению цены материалов 1 или 0 | |
- | |sip|array|да|-| | + | |sip|array|да|Массив с объектами. Тип объектов см. ниже| |
+ | |access_status_list|string|да|Идентификаторы разрешенных статусов для изменения через двоеточие. Пример: 2:5:21:3:25:47| | ||
+ | |ref_users|object|да|Объект со всеми полями в юзере. см ниже| | ||
**sip**: | **sip**: | ||
Строка 2300: | Строка 3401: | ||
|queue_num|string|-| | |queue_num|string|-| | ||
|queue_name|string|-| | |queue_name|string|-| | ||
+ | |||
+ | **ref_users** | ||
+ | ^название^тип^обязательно^описание^ | ||
+ | |ALLOWED_CLOSED_REASON|string|нет|Идентификаторы разрешенных причин закрытия заявки для изменения через двоеточие. Пример: 7164:7:8| | ||
+ | ||||| | ||
**Примеры:** | **Примеры:** | ||
Строка 2313: | Строка 3419: | ||
{ | { | ||
- | "username": "Предеин Анатолий", | + | "username": "dev", |
- | "can_close_request": true, | + | "can_close_request": false, |
"can_access_meters": true, | "can_access_meters": true, | ||
"can_access_contacts": true, | "can_access_contacts": true, | ||
- | "account_name": "Не активен", | + | "can_access_checklist": true, |
- | "phone": "9898004862", | + | "can_access_settings": true, |
- | "emp_id": 22055, | + | "account_name": "Лучшая", |
- | "not_read_push_count": 10, | + | "phone": null, |
- | "can_comment_to_ext_system": 1, // варианты 0/1 | + | "emp_id": 35753, |
- | "token_id": 12345, | + | "not_read_push_count": 82, |
- | "can_access_material_price": true, | + | "can_comment_to_ext_system": 1, |
+ | "token_id": 5626, | ||
+ | "can_access_material_price": false, | ||
+ | "access_status_list": "2:5:21:3:25:47", | ||
+ | "ref_users": { | ||
+ | "EMPLOYEE_ID": 35753, | ||
+ | "LOGIN": "dev", | ||
+ | "POSITION": null, | ||
+ | "PHONES": null, | ||
+ | "ACCOUNT_ID": 2621, | ||
+ | "EMAIL": null, | ||
+ | "USERNAME": "dev", | ||
+ | "access": "А", | ||
+ | "STATUS": "Р", | ||
+ | "CC_EMP_ID": null, | ||
+ | "FLAG_LOGIN": "Д", | ||
+ | "POSITION_ID": 7, | ||
+ | "PROFILE_ID": null, | ||
+ | "VERIFIED": "Д", | ||
+ | "FLAG_OI_SMS": "Д", | ||
+ | "FLAG_NOTICE_DEBT": "Н", | ||
+ | "VAC_DATE_START": "2021-08-23T13:26:00.000Z", | ||
+ | "VAC_DATE_END": "2021-09-06T00:00:00.000Z", | ||
+ | "VAC_EMPLOYEE_ID": null, | ||
+ | "FLAG_DASHBOARD": "Д", | ||
+ | "FLAG_NIGHT_SERVICE": "Н", | ||
+ | "FLAG_SMS_SEND": "Д", | ||
+ | "SMS_CHARSET_TYPE": "Р", | ||
+ | "FLAG_METERS": "Д", | ||
+ | "TOKEN": null, | ||
+ | "VAC_COMMENT": null, | ||
+ | "FLAG_REQ_CONTROL": "Д", | ||
+ | "TIME_TO_CONTROL": null, | ||
+ | "FLAG_CONTACT": "Д", | ||
+ | "FLAG_UPLOAD_DEBT": "Н", | ||
+ | "FLAG_SHOW_DEBT": "Н", | ||
+ | "GCM_ID": null, | ||
+ | "ANDROID_VERSION": null, | ||
+ | "ANDROID_ACTIVITY_TZ": null, | ||
+ | "FLAG_PP_SMS_SEND": "Н", | ||
+ | "FLAG_PP_CALL_SEND": "Н", | ||
+ | "TIMETABLE": null, | ||
+ | "TELEGRAM_CHAT_ID": null, | ||
+ | "PHONES_OTHER": null, | ||
+ | "NOTIFY_COUNT": 183, | ||
+ | "NOTIFY_CLICK": 0, | ||
+ | "NOTIFY_PARAMS": "О;К", | ||
+ | "FLAG_CAN_CLOSE": "Н", | ||
+ | "FLAG_CURATOR": "Д", | ||
+ | "FLAG_RESP_TLGRM": "Д", | ||
+ | "FLAG_PP_CUSTOM_PROFILE": "Н", | ||
+ | "FLAG_CONTRACTOR": "Н", | ||
+ | "FLAG_CURATOR_TAKE_OFF": "Н", | ||
+ | "PUSH_CONFIG": "З_Н:З_К:З_Ф:З_СО:З_СП:on", | ||
+ | "FLAG_CAN_CHANGE_DEADLINE": "Д", | ||
+ | "CHIEF_EMPLOYEE_ID": null, | ||
+ | "FLAG_PP_EMAIL_SEND": "Н", | ||
+ | "FLAG_CAN_COMMENT_TO_EXT_SYSTEM": "Д", | ||
+ | "FLAG_KEY_EMPLOYEE": "Н", | ||
+ | "PP_CALL_PASS_DELAY": null, | ||
+ | "BLOCKED_STATUSES": null, | ||
+ | "ALLOWED_STATUSES": "2:5:21:3:25:47", | ||
+ | "FLAG_CHECK_LIST": "Д", | ||
+ | "FLAG_MATERIAL_PRICE": "Н", | ||
+ | "ALLOWED_CLOSED_REASON": null, | ||
+ | "IS_NEW_UI_REQUESTS": "Y", | ||
+ | "FLAG_SUPPORT": "Н", | ||
+ | "FLAG_VOIP_CALL": "Д", | ||
+ | "flag_check_list": "Д", | ||
+ | "employee_id": 35753, | ||
+ | "username": "dev", | ||
+ | "allowed_statuses": "2:5:21:3:25:47", | ||
+ | "accessToken": "9]J!5bzQ3B$__R|_*k.C!x3<nZ4XA3Eo1BE7371E7797CA4A5F6F651AA9C6EB43" | ||
+ | }, | ||
"sip": [ | "sip": [ | ||
{ | { | ||
Строка 2343: | Строка 3522: | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
|descr|string |да|описание| | |descr|string |да|описание| | ||
- | |value|string |да|-| | + | |value|string |да|значение| |
- | |is_set|string |да|-| | + | |is_set|string |да|установлено ли| |
**Примеры:** | **Примеры:** | ||
Строка 2386: | Строка 3565: | ||
|push_config|string|нет|какие пуши юзеру необходимы| | |push_config|string|нет|какие пуши юзеру необходимы| | ||
|start_app|string|нет|выполняется каждый раз 1 раз при запуске АПП чтобы вести статистику использования апп| | |start_app|string|нет|выполняется каждый раз 1 раз при запуске АПП чтобы вести статистику использования апп| | ||
+ | |voip_token|string|нет|Если вдруг voip_token для sip звонилки изменился на девайсе или был получен позже| | ||
+ | |brand_code|string|нет|бренд код заложенный для WL | | ||
**Тип ответа:** Объект | **Тип ответа:** Объект | ||
Строка 2402: | Строка 3583: | ||
"fcm_token": "NEWTOKEN123", | "fcm_token": "NEWTOKEN123", | ||
"push_config": "З_Ф:З_Н:З_К", | "push_config": "З_Ф:З_Н:З_К", | ||
- | "start_app" : "im started!!" | + | "start_app" : "im started!!", |
+ | "brand_code" : "EASYSOLUTION" | ||
} | } | ||
//Ответ | //Ответ | ||
Строка 2462: | Строка 3644: | ||
^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
|start|number|да|Позиция, с которой получить данные| | |start|number|да|Позиция, с которой получить данные| | ||
- | |count|number|да|Количество получаемых данных| | + | |count|number|да|количество получаемых данных| |
- | |statuses|string|нет|Фильтр по статусам. Отправляется список статусов в формате STATUS1:STATUS2:STATUS3. Пример: "PENDING:INWORK".\\ Смотреть [[d24:develop:v2:backend:v2#статусы_чек-листа|описание статусов чек-листа.]]| | + | |statuses|string|нет|фильтр по статусам. Отправляется список статусов в формате STATUS1:STATUS2:STATUS3. Пример: "PENDING:INWORK".\\ Смотреть [[d24:develop:v2:backend:v2#статусы_чек-листа|описание статусов чек-листа.]]| |
|employee_id|number|нет|фильтр по исполнителю| | |employee_id|number|нет|фильтр по исполнителю| | ||
|cnt_id|number|нет|идентификатор юр. лица| | |cnt_id|number|нет|идентификатор юр. лица| | ||
- | |house_id|number|нет|идентификатор дома| | + | |house_id|number|нет|фильтр по дому| |
+ | |check_id|number|нет|фильтр по идентификатору чек-листа| | ||
+ | |date_start|string|нет|дата и время начала в ISO формате| | ||
+ | |date_end|string|нет|дата и время конца в ISO формате| | ||
**Тип ответа:** Массив с объектами | **Тип ответа:** Массив с объектами | ||
Строка 2682: | Строка 3867: | ||
|ess|string|да| Текст причины обращения для создания заявки | | |ess|string|да| Текст причины обращения для создания заявки | | ||
|type_id|number|да|идентификатор типа работы| | |type_id|number|да|идентификатор типа работы| | ||
+ | |required_action_list |string|нет|Перечень действий необходимых при выполнении работы| | ||
**Примеры:** | **Примеры:** | ||
Строка 2704: | Строка 3890: | ||
"ess_id" : 123, | "ess_id" : 123, | ||
"ess" : "Какая то причина обращения для создания заявки", | "ess" : "Какая то причина обращения для создания заявки", | ||
- | "type_id: 24 | + | "type_id: 24, |
+ | "required_action_list" : "Y_P:Y_R:I_P:I_C:I_R" | ||
} | } | ||
+ | |||
+ | правила и особенности формирования "required_action_list" | ||
+ | Y_ / N_ / I_ - это действия (Есть нарушения / Нет нарушений / Невозможно выполонить) | ||
+ | P / C / R - это необходимая сущность (Фото/ Коммент / Заявка) | ||
+ | Как пример Y_P:Y_R:I_P:I_C:I_R - если есть нарушения надо фото и заявку, если невозможно выполнить то и фото и коммент и заявку | ||
+ | |||
</code> | </code> | ||
Строка 2911: | Строка 4104: | ||
</code> | </code> | ||
+ | |||
+ | |||
+ | ===== Сохраненные настройки фильтров ===== | ||
+ | |||
+ | ==== создание настроек фильтров ==== | ||
+ | POST https://server.ru/v2/request_filter | ||
+ | |||
+ | **Тело запроса:** | ||
+ | ^Название^тип^обязательно^описание^ | ||
+ | |cnt_id|number|нет|id Организации | | ||
+ | |note|string|да|Описание настройки фильтров| | ||
+ | |filter_data|string|да|Настройки фильтров в виде строки в формате JSON| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа** | ||
+ | ^Название^тип^обязательно^описание^ | ||
+ | |filter_id|number|да| id сохраненных настроек| | ||
+ | |cnt_id|number|нет|id организации| | ||
+ | |employee_id|number|да|id сотрудника| | ||
+ | |note|string|да|описание настроек фильтра| | ||
+ | |filter_data|string|да|Данные настроек фильтра в виде строки в формате JSON. см пример| | ||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | // Запрос | ||
+ | /* | ||
+ | https://server.ru/v2/request_filter | ||
+ | */ | ||
+ | |||
+ | //тело запроса | ||
+ | |||
+ | { | ||
+ | cnt_id: 10401, | ||
+ | filter_data: "{\"period_exec\":-1,\"street\":\"Агатовая ул\",\"city\":\"all\",\"is_only_my\":0,\"period\":\"all\",\"custom_order\":\"create\",\"group_obj_id\":\"notSel\",\"resp_ids\":[],\"emp_ids\": [],\"rtype_ids\":[],\"status_ids\":[],\"type_ids\":[],\"ess_ids\":[],\"tag_ids\":[],\"house_ids\":[],\"flat_ids\": | ||
+ | [],\"sort\":\"D\",\"search_phone\":\"\",\"keywords\":\"\",\"request_id\":\"\",\"add_type\":\"notSel\",\"add_less_than\":0,\"add_more_than\":0,\"add_more_less_select\":\"more\"}", | ||
+ | note: "Тестовый фильтр" | ||
+ | } | ||
+ | |||
+ | //Ответ | ||
+ | { | ||
+ | "filter_id": 13261, | ||
+ | "cnt_id": 10401, | ||
+ | "note": "Тестовый фильтр", | ||
+ | "filter_data": "{\"period_exec\":-1,\"street\":\"Агатовая ул\",\"city\":\"all\",\"is_only_my\":0,\"period\":\"all\",\"custom_order\":\"create\",\"group_obj_id\":\"notSel\",\"resp_ids\":[],\"emp_ids\":[],\"rtype_ids\":[],\"status_ids\":[],\"type_ids\":[],\"ess_ids\":[],\"tag_ids\":[],\"house_ids\":[],\"flat_ids\":[],\"sort\":\"D\",\"search_phone\":\"\",\"keywords\":\"\",\"request_id\":\"\",\"add_type\":\"notSel\",\"add_less_than\":0,\"add_more_than\":0,\"add_more_less_select\":\"more\"}", | ||
+ | "employee_id": 127853 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ==== Обновление настроек фильтров ==== | ||
+ | PUT https://server.ru/v2/request_filter/:filter_id | ||
+ | |||
+ | **Тело запроса:** | ||
+ | ^Название^тип^обязательно^описание^ | ||
+ | |note|string|да|Описание настройки фильтров| | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа** | ||
+ | ^Название^тип^обязательно^описание^ | ||
+ | |filter_id|number|да| id сохраненных настроек| | ||
+ | |note|string|да|описание настроек фильтра| | ||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | // Запрос | ||
+ | /* | ||
+ | PUT https://server.ru/v2/request_filter/13261 | ||
+ | */ | ||
+ | |||
+ | //тело запроса | ||
+ | |||
+ | { | ||
+ | note: "Тестовый фильтр" | ||
+ | } | ||
+ | |||
+ | //Ответ | ||
+ | { | ||
+ | "filter_id": 13261, | ||
+ | "note": "Тестовый фильтр", | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | ==== Удаление настроек фильтров ==== | ||
+ | DELETE https://server.ru/v2/request_filter/:filter_id | ||
+ | |||
+ | **Тип ответа:** Объект | ||
+ | |||
+ | **Параметры ответа** | ||
+ | ^Название^тип^обязательно^описание^ | ||
+ | |filter_id|number|да| id удаленных настроек| | ||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | // Запрос | ||
+ | /* | ||
+ | DELETE https://server.ru/v2/request_filter/13261 | ||
+ | */ | ||
+ | |||
+ | //Ответ | ||
+ | { | ||
+ | "filter_id": 13261 | ||
+ | } | ||
+ | </code> | ||
+ | |||
+ | |||
+ | ==== получение настроек фильтров ==== | ||
+ | GET https://server.ru/v2/request_filter?cnt_id=value | ||
+ | |||
+ | **query параметры:** | ||
+ | ^Название^тип^обязательно^описание^ | ||
+ | |cnt_id|number|нет|id Организации | | ||
+ | |||
+ | **Тип ответа:** Массив | ||
+ | |||
+ | **Параметры ответа** | ||
+ | ^Название^тип^обязательно^описание^ | ||
+ | |filter_id|number|да| id сохраненных настроек| | ||
+ | |cnt_id|number|да|id организации| | ||
+ | |employee_id|number|да|id сотрудника| | ||
+ | |note|string|да|описание настроек фильтра| | ||
+ | |filter_data|string|да|Данные настроек фильтра в виде строки в формате JSON. см пример| | ||
+ | |||
+ | |||
+ | **Примеры:** | ||
+ | |||
+ | <code javascript> | ||
+ | |||
+ | // Запрос | ||
+ | /* | ||
+ | GET https://server.ru/v2/request_filter/10401 | ||
+ | */ | ||
+ | |||
+ | //Ответ | ||
+ | [ | ||
+ | { | ||
+ | "filter_id": 13261, | ||
+ | "cnt_id": 10401, | ||
+ | "note": "Тестовый фильтр", | ||
+ | "employee_id": 127853, | ||
+ | "filter_data": "{\"period_exec\":-1,\"street\":\"Агатовая ул\",\"city\":\"all\",\"is_only_my\":0,\"period\":\"all\",\"custom_order\":\"create\",\"group_obj_id\":\"notSel\",\"resp_ids\":[],\"emp_ids\":[],\"rtype_ids\":[],\"status_ids\":[],\"type_ids\":[],\"ess_ids\":[],\"tag_ids\":[],\"house_ids\":[],\"flat_ids\":[],\"sort\":\"D\",\"search_phone\":\"\",\"keywords\":\"\",\"request_id\":\"\",\"add_type\":\"notSel\",\"add_less_than\":0,\"add_more_than\":0,\"add_more_less_select\":\"more\"}" | ||
+ | } | ||
+ | ] | ||
+ | </code> | ||
+ | |||
+ | ==== описание filter_data ==== | ||
+ | |||
+ | посмотреть описание полей можно тут: [[d24:develop:v2:backend:v2#получение_списка_заявок|]] | ||
+ | |||
+ | ^название^значение по дефолту | ||
+ | |period_exec|-1| | ||
+ | |street|"all"| | ||
+ | |city|"all"| | ||
+ | |is_only_my |0| | ||
+ | |period |"all" (обозначает все)| | ||
+ | |custom_order |"create"| | ||
+ | |group_obj_id |"notSel" (обозначает не выбрано)| | ||
+ | |resp_ids |[] (пустой массив)| | ||
+ | |emp_ids |[] (пустой массив)| | ||
+ | |rtype_ids |[] (пустой массив)| | ||
+ | |status_ids |[] (пустой массив)| | ||
+ | |type_ids |[] (пустой массив)| | ||
+ | |ess_ids |[] (пустой массив)| | ||
+ | |tag_ids |[] (пустой массив)| | ||
+ | |house_ids |[] (пустой массив)| | ||
+ | |flat_ids |[] (пустой массив)| | ||
+ | |sort |"D"| | ||
+ | |search_phone |"" (пустая строка)| | ||
+ | |keywords |""(пустая строка)| | ||
+ | |request_id |""(пустая строка)| | ||
+ | |add_type |"notSel" (обозначает не выбрано)| | ||
+ | |add_less_than |0| | ||
+ | |add_more_than |0| | ||
+ | |add_more_less_select |"more"| | ||
+ | |||
+ | **нужно добавить is_favorites в disp_front** |