Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
d24:develop:v2:backend:v2 [2022/04/04 10:33]
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>​
 ===== Константы ===== ===== Константы =====
  
Строка 46: Строка 69:
 |IMPOSSIBLE| ​ Невозможно выполнить| |IMPOSSIBLE| ​ Невозможно выполнить|
 |FAILED| ​ Не выполнено| |FAILED| ​ Не выполнено|
 +|FORCIBLY|Принудительно завершено|
 +
 +=== статусы работ чек-листа ===
 +^Код статуса^описание^
 +|0|в ожидании выполнения|
 +|1|успешно выполнено |
 +|2| есть нарушения |
 +|3| невозможно выполнить |
 ===== Определение адреса сервера ===== ===== Определение адреса сервера =====
  
Строка 132: Строка 163:
 Параметры тела запроса:​ Параметры тела запроса:​
 ^ Название ^ Тип ​   ^ Обязательно ^ Описание ^ ^ Название ^ Тип ​   ^ Обязательно ^ Описание ^
-| devType ​ | string | да          | android / ios Тип устройства, ​чтобы ​система понимала ​как отправлять push-уведомления т.п.|+| devType ​ | string | да          | android / ios Тип устройства, ​если интеграция ​ с системой то указывать ​необходимо int|
 |pushToken | string | да          | Токен для push-уведомлений | |pushToken | string | да          | Токен для push-уведомлений |
  
Строка 146: Строка 177:
 // Тело запроса // Тело запроса
 { {
-  "​devType" ​  : "android", +  "​devType" ​  : "int", 
-  "​pushToken"​ : "klnefkszkjn5lkawelnflkzsdfk"+  "​pushToken"​ : ""​
 } }
 +// в pushToken необходимо писать уникальный тект, например "​uk_pravii_bereg"​
 // Ответ // Ответ
 { {
Строка 188: Строка 220:
 | cnt       | string | да          | Название юридического лица | | cnt       | string | да          | Название юридического лица |
 | cnt_id ​   | number | да          | Идентификатор юр. лица в базе данных Д24 | | cnt_id ​   | number | да          | Идентификатор юр. лица в базе данных Д24 |
 +| account_id ​   | number | да          | ИД аккаунта |
 +| callback_phone ​  | string | да          | Тел. юр. лица |
 +| support_phone ​   | string | да          | Тел. поддержки юр. лица |
  
 **Пример:​** **Пример:​**
Строка 195: Строка 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:"​Курган г"
     }     }
 ] ]
Строка 209: Строка 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 | нет ​         | Название города |
 +
  
 Тип ответа:​ Массив Тип ответа:​ Массив
Строка 255: Строка 325:
 ^ Название ​ ^ Тип ​   ^ Обязательно ^ Описание^ ^ Название ​ ^ Тип ​   ^ Обязательно ^ Описание^
 | cnt_id | number | нет | идентификатор юр. лица в системе. Если при запросе отсутствует,​ то в ответе будут все улицы/​нас. пункты по доступным юр. лицам| | cnt_id | number | нет | идентификатор юр. лица в системе. Если при запросе отсутствует,​ то в ответе будут все улицы/​нас. пункты по доступным юр. лицам|
 +| city_text | string | нет | название города|
 +| street_text | string | нет | название улицы|
  
 Тип ответа:​ Массив с объектами Тип ответа:​ Массив с объектами
Строка 262: Строка 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>​
Строка 274: Строка 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":​ "​Нелуначарского"​
     },     },
     ...     ...
Строка 365: Строка 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|нет|номер этажа|
  
 **Пример:​** **Пример:​**
Строка 377: Строка 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
     }     }
 ] ]
Строка 547: Строка 815:
     },     },
     {     {
-        "​emp"​ : "​Клабуков Александр Витальевич",  ​+        "​emp"​ : "​Клабуков Александр Витальевич ​[deprecated]",  ​
         "​emp_id"​ : 12         "​emp_id"​ : 12
     },     },
Строка 588: Строка 856:
     },     },
     {     {
-        "​resp":​ "​Клабуков Александр Игоревич",​+        "​resp":​ "​Клабуков Александр Игоревич ​[deprecated]",
         "​resp_id":​ 35293         "​resp_id":​ 35293
     },     },
Строка 663: Строка 931:
 |status| string|да|-| |status| string|да|-|
 |status_id|string|да|-| |status_id|string|да|-|
 +|reasons_count|number|да|-|
  
 **Пример:​** **Пример:​**
Строка 676: Строка 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
     }     }
 ] ]
Строка 690: Строка 962:
  
  
-==== Получение ​списка ​типов заявок ====+==== Получение типов заявок ====
 GET http://​server.ru/​v2/​ref/​req_type_list GET http://​server.ru/​v2/​ref/​req_type_list
  
Строка 976: Строка 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|нет|статус модерации Д\Н|
 +
 +
 +
  
 **Тип ответа:​** Массив объектов **Тип ответа:​** Массив объектов
Строка 990: Строка 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 (список домов оповещения):​**
Строка 1059: Строка 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|код услуги,​ к которой относится оповещение|
Строка 1100: Строка 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
  
Строка 1398: Строка 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|номер этажа|
Строка 1432: Строка 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>​
 +
 +
  
 ===== Заявки ===== ===== Заявки =====
Строка 1440: Строка 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|да|созданная ​заявка|+
  
 **Примеры:​** **Примеры:​**
Строка 1467: Строка 1885:
     "​ess_id"​ : 1533,     "​ess_id"​ : 1533,
     "​type_id"​ : 23,     "​type_id"​ : 23,
 +    "​flat_id":​ 111,
     "​note"​ : "​Тест ppostman",​     "​note"​ : "​Тест ppostman",​
     "​contphone"​ : "​9125212573",​     "​contphone"​ : "​9125212573",​
Строка 1473: Строка 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
 } }
Строка 1479: Строка 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>​
Строка 1491: Строка 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 | нет | Название изображения |
Строка 1504: Строка 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|нет| Приоритет заявки | 
 + 
  
 **Тип ответа:​** Объект **Тип ответа:​** Объект
Строка 1513: Строка 2024:
 ^ Название ​ ^ Тип ​   ^ Обязательно ^ Описание^ ^ Название ​ ^ Тип ​   ^ Обязательно ^ Описание^
 |affected_rows|number|да|количество затронутых изменениями / созданных строк (вместе с комментариями)| |affected_rows|number|да|количество затронутых изменениями / созданных строк (вместе с комментариями)|
 +|request|-|да|обновленная заявка с полями как в детализации|
  
 **Примеры:​** **Примеры:​**
Строка 1534: Строка 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",
Строка 1541: Строка 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>​
Строка 1552: Строка 2163:
  
 GET https://​server.ru/​v2/​request?​start&​count&​cnt_id&​street&​house_id&​flat_id&​type_id&​type_ids&​ess_id&​ess_ids&​emp_id&​resp_id&​status_ids&​rtype_id GET https://​server.ru/​v2/​request?​start&​count&​cnt_id&​street&​house_id&​flat_id&​type_id&​type_ids&​ess_id&​ess_ids&​emp_id&​resp_id&​status_ids&​rtype_id
-&​rtype_ids&​request_id&​date_start&​date_end&​keywords&​custom_filter&​is_only_my&​custom_order+&​rtype_ids&​request_id&​date_start&​date_end&​keywords&​custom_filter&​is_only_my&​custom_order&​house_ids&​flat_ids&​emp_ids&​resp_ids&​search_phone 
 +&​house_group_ids&​period_exec&​exec_time_start&​exec_time_end
  
 **Параметры запроса:​** **Параметры запроса:​**
Строка 1559: Строка 2171:
 |count|number|да|Сколько заявок получить| |count|number|да|Сколько заявок получить|
 |cnt_id|number|нет| идентификатор юр. лица| |cnt_id|number|нет| идентификатор юр. лица|
 +|city|string|нет| Название города|
 |street|string|нет|улица| |street|string|нет|улица|
 |house_id|number|нет|идентификатор дома| |house_id|number|нет|идентификатор дома|
Строка 1577: Строка 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"​| 
 +|flat_ids|string|нет|список идентификаторов помещений через двоеточие. Пример:​ "​1:​2:​3"​| 
 +|emp_ids|string|нет|список идентификаторов ответственных через двоеточие. Пример:​ "​1:​2:​3"​| 
 +|resp_ids|string|нет|список идентификаторов исполнителей ​через двоеточие. Пример:​ "​1:​2:​3"​| 
 +|search_phone|string|нет|фильтр по номеру телефона.| 
 +|house_group_ids|string|нет|список идентификаторов групп домов через двоеточие. Пример:​ "​1:​2:​3"​| 
 +|period_exec|string|нет|фильтр по срокам выполнения. Просроченные:​ П,На сегодня:​ С,На завтра:​ З,На ближайшие 3 дня: Т,На неделю: Н,​Выполненные: И, Все: В| 
 +|exec_time_start|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|
  
 **Тип ответа:​** Массив объектов **Тип ответа:​** Массив объектов
Строка 1589: Строка 2216:
 |house|string|да|Адрес дома| |house|string|да|Адрес дома|
 |flat|string|может быть null|номер квартиры| |flat|string|может быть null|номер квартиры|
 +|entr|string|нет|обозначение подъезда|
 |status|string|да|текстовое описание статуса| |status|string|да|текстовое описание статуса|
 |status_id|number|да|идентификатор статуса| |status_id|number|да|идентификатор статуса|
 |created_at|string|да|дата и время создания заявки в часовом поясе пользователя| |created_at|string|да|дата и время создания заявки в часовом поясе пользователя|
 +|updated_at|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|Дата и время прихода специалиста|
Строка 1602: Строка 2232:
 |emp_id|number|может быть null|идентификатор исполнителя| |emp_id|number|может быть null|идентификатор исполнителя|
 |reason|string|может быть null|текстовое описание причины статуса| |reason|string|может быть null|текстовое описание причины статуса|
-|local_at|-|может быть null|-|+|local_at|string|может быть null|Дата, когда исполнитель локализовал аварию по заявке «ДД.ММ.ГГГГ ЧЧ:​ММ» ​ | 
 +|contphone|string|да|Номер телефона клиента обратившегося с заявкой| 
 +|house_id|number|нет|идентификатор дома| 
 +|flat_type|number|нет|тип помещения] 
 +|flat_num|string|нет|номер помещения| 
 +|autophone|string|нет|АОН| 
 +|ess_id|number|нет|идентификатор причины обращения| 
 +|type_id|number|нет|идентификатор типа заявки| 
 +|is_favorites|string|да|добавлена ли заявка в избранное Д/Н|
  
  
Строка 1619: Строка 2257:
     {     {
         "​rn":​ 1,         "​rn":​ 1,
-        "​request_id": ​1298309,+        "​request_id": ​1298931,
         "​flag_emergency":​ "​Н",​         "​flag_emergency":​ "​Н",​
-        "​note":​ "Не работает освещение в пом 13. Этаж 1", +        "​note":​ "Химчистка домашнего текстиля", 
-        "​house":​ "Бакинских ​комиссаров, дом ​3", +        "​house":​ "Луначарского ул, дом ​240", 
-        "​flat": ​null+        "​flat": ​"кв 100",​ 
-        "​status":​ "Закрыта",​ +        "​entr":​ "​2"​
-        "​created_at":​ "28.10.2021 11:02",+        "​status":​ "​Зарегистрирована", 
 +        "​created_at":​ "17.03.2022 15:​26",​ 
 +        "​updated_at":​ null, 
 +        "​execution_time":​ "21.03.2022 15:26",
         "​price":​ null,         "​price":​ null,
         "​material_price":​ null,         "​material_price":​ null,
-        "​tags": ​null,+        "​tags": ​"<​span style=\"​background-color:#​FFA366\">​сайт</​span>"​,
         "​uploads_count":​ 0,         "​uploads_count":​ 0,
         "​appointed_str":​ null,         "​appointed_str":​ null,
         "​appointed_at":​ null,         "​appointed_at":​ null,
         "​emp":​ null,         "​emp":​ null,
-        "​deadline_str": ​null+        "​deadline_str": ​-14
-        "​reason": ​"​принудительно модератором"​+        "​reason": ​null
-        "​status_id": ​25,+        "​status_id": ​1,
         "​emp_id":​ null,         "​emp_id":​ null,
-        "​local_at":​ null+        "​local_at":​ null
 +        "​house_id":​ 54696, 
 +        "​flat_type":​ 1, 
 +        "​flat_num":​ "​100",​ 
 +        "​contphone":​ "​9826171613",​ 
 +        "​autophone":​ null, 
 +        "​ess_id":​ 3263, 
 +        "​type_id":​ 21, 
 +        "​is_favorites"​ :"​Д"​
     },     },
     {     {
         "​rn":​ 2,         "​rn":​ 2,
-        "​request_id": ​1298250,+        "​request_id": ​1298930,
         "​flag_emergency":​ "​Н",​         "​flag_emergency":​ "​Н",​
-        "​note":​ "фыывафыаыфы", +        "​note":​ "Химчистка домашнего текстиля", 
-        "​house":​ "Бакинских ​комиссаров, дом ​3", +        "​house":​ "Луначарского ул, дом ​240", 
-        "​flat":​ null,+        "flat": "кв 100",​ 
 +        "entr": null,
         "​status":​ "​Зарегистрирована",​         "​status":​ "​Зарегистрирована",​
-        "​created_at":​ "14.10.2021 09:59", +        "​created_at":​ "17.03.2022 15:26", 
-        "​price": ​10000+        "​updated_at":​ "​31.03.2022 13:​28",​ 
-        "​material_price": ​500+        "​execution_time":​ "​21.03.2022 15:26", 
-        "​tags": ​null,+        "​price": ​null
 +        "​material_price": ​null
 +        "​tags": ​"<​span style=\"​background-color:#​FFA366\">​сайт</​span>"​,
         "​uploads_count":​ 0,         "​uploads_count":​ 0,
         "​appointed_str":​ null,         "​appointed_str":​ null,
         "​appointed_at":​ null,         "​appointed_at":​ null,
-        "​emp": ​null+        "​emp": ​"​dev"​
-        "​deadline_str":​ -28,+        "​deadline_str":​ -14,
         "​reason":​ null,         "​reason":​ null,
         "​status_id":​ 1,         "​status_id":​ 1,
-        "​emp_id": ​null+        "​emp_id": ​35753
-        "​local_at":​ null+        "​local_at":​ null
 +        "​house_id":​ 54696, 
 +        "​flat_type":​ 1, 
 +        "​flat_num":​ "​100",​ 
 +        "​contphone":​ "​9826171613",​ 
 +        "​autophone":​ null, 
 +        "​ess_id":​ 3263, 
 +        "​type_id":​ 21, 
 +        "​is_favorites"​ :"​Н"​
     },     },
     ...     ...
Строка 1679: Строка 2339:
 ^Название^Тип^Обязательно^Описание^ ^Название^Тип^Обязательно^Описание^
 |tag_id|number|да|идентификатор тега| |tag_id|number|да|идентификатор тега|
-|title|string|да|-+|title|string|да|наименование
-|color|string|нет|-+|color|string|нет|цвет
-|is_set|string|да|-|+|is_set|string|да|установлено ли|
  
 **Пример:​** **Пример:​**
Строка 1723: Строка 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|причина статуса|
Строка 1736: Строка 2401:
 |contphone|string|если житель пожелал оставить другой контактный телефон| |contphone|string|если житель пожелал оставить другой контактный телефон|
 |email|string|Адрес электронной почты жителя| |email|string|Адрес электронной почты жителя|
-|tags|string|-|+|tags|string|тэги заявки|
 |type|string|Тип работ (из справочника)| |type|string|Тип работ (из справочника)|
 |ess|string|Причина обращения (из справочника)| |ess|string|Причина обращения (из справочника)|
Строка 1743: Строка 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|телефон(ы) ответственного|
Строка 1755: Строка 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|нужна ли локализация аварии. Н - нет / Д - да|
Строка 1766: Строка 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 Время выполнения |
  
 **Примеры:​** **Примеры:​**
Строка 1773: Строка 2464:
  
 /* /*
- ​https://​server.ru/​v2/​request/​1298309+ ​https://​server.ru/​v2/​request/​1300673
 */ */
  
Строка 1779: Строка 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>​
  
Строка 1951: Строка 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**
Строка 2037: Строка 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|да|текст события|
Строка 2042: Строка 3129:
 |id|number|да|идентификатор события| |id|number|да|идентификатор события|
 |flag_webhook|string|да| Статус публикации события. Д - опубликовано / Н - не опубликовано"​| |flag_webhook|string|да| Статус публикации события. Д - опубликовано / Н - не опубликовано"​|
-|creator_type|number|да|-|+|creator_type|number|да|событие внутри системы,​ 1 - событие от собственника ч/з мп| 
 +|creator_id|number|да|id пользователя создавшего событие в ленте|
  
 **Примеры:​** **Примеры:​**
Строка 2056: Строка 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
     }     }
 ] ]
Строка 2149: Строка 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|да|полный адрес|
  
 **Примеры:​** **Примеры:​**
Строка 2224: Строка 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>​
Строка 2238: Строка 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|да|Массив с объектами. Тип объектов см. ниже| 
 +|access_status_list|string|да|Идентификаторы разрешенных статусов для изменения через двоеточие. Пример:​ 2:​5:​21:​3:​25:​47| 
 +|ref_users|object|да|Объект со всеми полями в юзере. см ниже| 
 + 
 +**sip**: 
 +^название^тип^описание^ 
 +|queue_num|string|-
 +|queue_name|string|-| 
 + 
 +**ref_users** 
 +^название^тип^обязательно^описание^ 
 +|ALLOWED_CLOSED_REASON|string|нет|Идентификаторы разрешенных причин закрытия заявки для изменения через двоеточие. Пример:​ 7164:7:8| 
 +|||||
  
 **Примеры:​** **Примеры:​**
Строка 2261: Строка 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":​ [ 
 +        { 
 +            "​queue_num":​ "​maincc1998",​ 
 +            "​queue_name":​ "​Общий КЦ"​ 
 +        } 
 +    ]
 } }
  
Строка 2285: Строка 3522:
 ^ Название ​ ^ Тип ​   ^ Обязательно ^ Описание^ ^ Название ​ ^ Тип ​   ^ Обязательно ^ Описание^
 |descr|string |да|описание| |descr|string |да|описание|
-|value|string |да|-+|value|string |да|значение
-|is_set|string |да|-|+|is_set|string |да|установлено ли|
  
 **Примеры:​** **Примеры:​**
Строка 2328: Строка 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 |
  
 **Тип ответа:​** Объект **Тип ответа:​** Объект
Строка 2344: Строка 3583:
     "​fcm_token":​ "​NEWTOKEN123",​     "​fcm_token":​ "​NEWTOKEN123",​
     "​push_config":​ "​З_Ф:​З_Н:​З_К",​     "​push_config":​ "​З_Ф:​З_Н:​З_К",​
-    "​start_app"​ : "im started!!"​+    "​start_app"​ : "im started!!", 
 +    "​brand_code"​ : "​EASYSOLUTION"
 } }
 //​Ответ //​Ответ
Строка 2404: Строка 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 формате|
  
 **Тип ответа:​** Массив с объектами **Тип ответа:​** Массив с объектами
Строка 2443: Строка 3686:
         "​status":​ "​INWORK",​         "​status":​ "​INWORK",​
         "​days_count":​ 2,         "​days_count":​ 2,
-        "house": "​Бурова-Петрова ул, дом 78",+        "house_text": "​Бурова-Петрова ул, дом 78",
         "​houses_count":​ 5,         "​houses_count":​ 5,
         "​username":​ "​Предеин Анатолий",​         "​username":​ "​Предеин Анатолий",​
Строка 2474: Строка 3717:
 | all_works_count | number | да | количество всех работ | | all_works_count | number | да | количество всех работ |
 | requests_count | number | да | количество созданных заявок для работ| | requests_count | number | да | количество созданных заявок для работ|
 +|employee_id|number|да|идентификатор исполнителя|
  
 **Примеры:​** **Примеры:​**
Строка 2496: Строка 3740:
     "​all_works_count":​ 5,     "​all_works_count":​ 5,
     "​requests_count":​ 1,     "​requests_count":​ 1,
-    "​status":​ "​INWORK"​+    "​status":​ "​INWORK"​
 +    "​employee_id":​ 33
 } }
  
Строка 2551: Строка 3796:
 |work_group_id|number|нет|идентификатор группы работ (если работа находится в группе) | |work_group_id|number|нет|идентификатор группы работ (если работа находится в группе) |
 |check_id|number|да|идентификатор чек-листа,​ к которому привязана работа| |check_id|number|да|идентификатор чек-листа,​ к которому привязана работа|
-|status|number|да| код статуса работы ​+|status|number|да| код статуса работы. [[d24:​develop:​v2:​backend:​v2#​статусы_работ_чек-листа|описание ​статусов ​работ чеклиста]]|
- +
-**Описание ​статусов работы:** +
-^Код ​статуса^описание+
-|0|в ожидании выполнения| +
-|1|успешно выполнено | +
-|2| есть нарушения | +
-|3| невозможно выполнить |+
  
  
Строка 2623: Строка 3861:
 |note|string|да|описание работы| |note|string|да|описание работы|
 |check_id|number|да|идентификатор чек-листа,​ к которому привязана работа| |check_id|number|да|идентификатор чек-листа,​ к которому привязана работа|
-|check_status|string|да|Код статуса чеклиста,​ к которому привязана работа| +|check_status|string|да|Код статуса чеклиста,​ к которому привязана работа. [[d24:​develop:​v2:​backend:​v2#​статусы_чек-листа|Описание статусов чеклиста]]
-|status|number|да| код статуса работы |+|status|number|да| код статуса работы. [[d24:​develop:​v2:​backend:​v2#​статусы_работ_чек-листа|Описание статуса работ чеклиста]] ​|
 |criteria|string|нет| критерии. Текст в виде списка(с символами переноса строки) | |criteria|string|нет| критерии. Текст в виде списка(с символами переноса строки) |
 |ess_id|number|да| ИД причина обращения для создания заявки | |ess_id|number|да| ИД причина обращения для создания заявки |
 |ess|string|да| Текст причины обращения для создания заявки | |ess|string|да| Текст причины обращения для создания заявки |
 |type_id|number|да|идентификатор типа работы| |type_id|number|да|идентификатор типа работы|
 +|required_action_list |string|нет|Перечень действий необходимых при выполнении работы|
  
 **Примеры:​** **Примеры:​**
Строка 2651: Строка 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>​
  
Строка 2671: Строка 3917:
 |created_on_tz|string|да| когда создан | |created_on_tz|string|да| когда создан |
 |created_by|string|да| кем создан | |created_by|string|да| кем создан |
 +|flag_webhook|string|да|Y или N|
  
 **Описание типов элемента ленты (type):** **Описание типов элемента ленты (type):**
Строка 2857: Строка 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**
  • /var/www/html/wiki/data/attic/d24/develop/v2/backend/v2.1649068410.txt.gz
  • Последние изменения: 2022/04/04 10:33
  • — klabukovai