Различия

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

--- d24:develop:v2:backend:v2 [2025/08/03 15:32]
anton
+++ d24:develop:v2:backend:v2 [2025/08/15 07:28] (текущий)
anton
@@ Строка 1059: / Строка 1059: @@
         "status_id": "1",
         "reasons_count": 0
+    }
+]
+</code>
+==== Получение списка статусов РСО ====
+GET http://server.ru/v2/ref/rso_status_list
+Тип ответа: Массив объектов
+Параметры ответа (объектов массива)
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|status|string|да|Текстовое описание статуса|
+|status_id|number|да|идентификатор статуса в системе|
+**Пример:**
+<code javascript>
+//Запрос
+/*
+ http://server.ru/v2/ref/rso_status_list
+*/
+// Ответ
+[
+    {
+        "status_id": 1,
+        "status": "Зарегистрирована"
+    },
+    {
+        "status_id": 2,
+        "status": "Принята в работу"
+    },
+    {
+        "status_id": 4,
+        "status": "Отложена"
+    },
+    {
+        "status_id": 5,
+        "status": "Открыта повторно"
+    },
+    {
+        "status_id": 25,
+        "status": "Закрыта"
+    },
+    {
+        "status_id": 47,
+        "status": "Невозможно выполнить"
     }
 ]
@@ Строка 2507: / Строка 2554: @@
 **Тело запроса:**
 ^ Название  ^ Тип    ^ Обязательно ^ Описание^
-|house_id|number|да|ИД Дома|
-|owner_id|number|нет|ИД Управляющей компании|
 |svc_id|number|да|идентификатор РСО|
-|note| string|да|Комметрарий от заявки|
+|rso_comment| string|да|Комметарий к заявке РСО|
-|rso_comment| string|да|Комметрарий к заявке РСО|
 |request_id|number|да|ИД Заявки|
@@ Строка 2519: / Строка 2563: @@
 ^ Название  ^ Тип    ^ Обязательно ^ Описание^
 |request_rso_id|number|да|ид заявки рсо|
-|house_id|number|да|ид дома|
-|owner_id|number|да|ид управляющей компании|
+**Примеры:**
+<code javascript>
+//Тело запроса
+{
+    "svc_id:" : 1533,
+    "request_id" : 1300673,
+    "rso_comment" : "комментарий к заявке РСО",
+}
+//Ответ
+{"request_rso_id":78643}
+</code>
+==== Обновление заявки РСО ====
+PUT https://server.ru/v2/request_rso/:request_rso_id
+**Параметры запроса:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|request_rso_id|number|да|ид заявки рсо|
+**Тело запроса:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
 |svc_id|number|да|идентификатор РСО|
-|note|string|да|комментарий заявки рсо|
+|note| string|да|Описание заявки РСО|
-|created_on_tz|string|да|время создания заявки|
+|rso_comment| string|да|Комметарий к заявке РСО|
 |status_id|number|да|ид статуса|
-|rso_status_name|string|да|имя статуса|
+|ext_request_id|string|да|ид заявки из смежной службы|
-|request_id|number|да|ид заявки, на основе которой создана заявка рсо|
+**Тип ответа:** Объект
+**Параметры ответа:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|request_rso_id|number|да|ид заявки рсо|
+|affected_rows|number|да|колво измененных строк|
 **Примеры:**
@@ Строка 2535: / Строка 2612: @@
 {
-    "house_id" : 34021,
+    "status_id" : 1,
     "svc_id:" : 1533,
-    "owner_id" : 23,
+    "rso_comment" : "123",
-    "request_id" : 1300673,
+    "ext_request_id" : "123Ф",
     "note" : "123",
 }
@@ Строка 2544: / Строка 2621: @@
 //Ответ
+{"affected_rows":1,"request_rso_id":78643}
+</code>
+==== Получение списка заявок РСО ====
+GET https://server.ru/v2/request_rso
+**Параметры запроса:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|start|number|да|C какой позиции получить заявки|
+|count|number|да|Сколько заявок получить|
+|date_start|string|да|Начала периода в формате ISO|
+|date_end|string|да|Конец периода в формате ISO|
+|request_rso_id|number|да|ид заявки рсо|
+|svc_id|number|да|ид службы рсо|
+|status_id|number|да|ид статуса|
+|house_id|number|да|ид дома|
+|owner_id|number|да|ид ук|
+|ext_request_id|string|да|ид заявки в смежной службе|
+|city_text|string|да|город|
+|street_text|string|да|улица|
+**Тип ответа:** Объект
+**Параметры ответа:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|address_full|string|да|полный адрес|
+|created_on_tz|string|да|дата создания в формате ISO|
+|house_id|number|да|ид дома|
+|last_comments|array|да|последние комментарии|
+|note|string|да|описание заявки рсо|
+|request_rso_id|number|да|ид заявки рсо|
+|status_id|number|да|ид статуса|
+|request_id|number|да|ид родительской заявки|
+|status_name|string|да|название статуса|
+|svc_name|string|да|название службы рсо|
+|updated_on_tz|string|да|дата изменения в формате ISO|
+**Примеры:**
+<code javascript>
+//Запрос
+https://server.ru/v2/request_rso/?start=1&count=50&date_start=2023-05-01T00:00:00.000Z&date_end=2025-06-10T00:00:00.000Z&owner_id=13521&
+//Ответ
+[
 {
-    "request_rso_id": 77470,
+        "request_rso_id": 78509,
-    "house_id": 54696,
+        "house_id": 54696,
+        "note": "Прачечная . Кол-во объектов: 1. Опции: опция 1 x1 0.00 руб.",
+        "status_id": 5,
+        "request_id": 123,
+        "created_on_tz": "2025-06-09T10:51:24.839Z",
+        "updated_on_tz": "2025-07-29T05:21:52.324Z",
+        "status_name": "Открыта повторно",
+        "last_comments": [
+            {
+                "note": "ewqewqeqwe"
+            },
+            {
+                "note": "3543543543543"
+            }
+        ],
+        "svc_name": "АО «Екатеринбурггаз»",
+        "address_full": "Екатеринбург г, Луначарского ул, дом 240",
+        "RNUM": 1
+    },
+    {
+        "request_rso_id": 78508,
+        "house_id": 54916,
+        "note": "Test",
+        "status_id": 47,
+        "request_id": 7657757,
+        "created_on_tz": "2025-06-09T10:49:13.234Z",
+        "updated_on_tz": "2025-07-29T05:22:04.971Z",
+        "status_name": "Невозможно выполнить",
+        "last_comments": [
+            {
+                "note": "123133"
+            },
+            {
+                "note": "1543543543"
+            }
+        ],
+        "svc_name": "ООО \"Ураллифт\"",
+        "address_full": "Верхняя Пышма г, Александра Козицына ул, дом 1",
+        "RNUM": 2
+    }
+ ]
+</code>
+==== Получение детализации заявки РСО ====
+GET https://server.ru/v2/request_rso/:request_rso_id
+**Параметры запроса:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|request_rso_id|number|да|ид заявки рсо|
+**Тип ответа:** Объект
+**Параметры ответа:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|address_full|string|да|полный адрес|
+|created_on_tz|string|да|дата создания в формате ISO|
+|house_id|number|да|ид дома|
+|owner_id|number|да|ид ук|
+|svc_id|number|да|ид рсо|
+|created_by|string|да|кем создана заявка рсо|
+|position|string|да|должность того, кто создал заявку рсо|
+|access|string|да|доступ того, кто создал заявку рсо|
+|last_comments|array|да|последние комментарии|
+|note|string|да|описание заявки рсо|
+|request_rso_id|number|да|ид заявки рсо|
+|ext_request_id|string|да|ид заявки из смежной службы|
+|request_id|number|да|ид заявки основной|
+|status_id|number|да|ид статуса|
+|status_name|string|да|название статуса|
+|request_status_name|string|да|название статуса основной заявки|
+|svc_name|string|да|название службы рсо|
+|pass_fio|string|да|фио того, кто принял заявки в смежной службе|
+|updated_on_tz|string|да|дата изменения в формате ISO|
+**Примеры:**
+<code javascript>
+//Ответ
+{
+    "request_rso_id": 78643,
+    "request_id": 1343273,
+    "ext_request_id": null,
+    "house_id": 54916,
     "owner_id": 13521,
     "svc_id": 5484,
-    "note": "123",
-    "created_on_tz": "2024-03-28T07:19:10.826Z",
     "status_id": 1,
-    "rso_status_name": "Зарегистрирована",
+    "created_by": "dev",
-    "request_id": 1300673
+    "position": "Технический директор",
+    "access": "С",
+    "created_on_tz": "2025-08-07T04:06:09.638Z",
+    "updated_on_tz": "2025-08-07T04:06:09.789Z",
+    "note": "отт",
+    "pass_fio": null,
+    "last_comments": [
+        {
+            "note": "123"
+        }
+    ],
+    "svc_name": " ГазУралКомплект",
+    "address_full": "Верхняя Пышма г, Александра Козицына ул, дом 1",
+    "status_name": "Зарегистрирована",
+    "request_status_name": "Требуется передать"
 }
+</code>
+==== Получение деталей табов для заявок РСО ====
+GET https://server.ru/v2/request_rso/:request_rso_id/all
+**Переменные URL:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|request_rso_id|number|да|ид заявки рсо|
+**Переменные URL:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|comment|number|нет|хотим ли мы подгружать комментарии в ленту|
+|activity|number|нет|хотим ли мы подгружать историю активности в ленту|
+|call|number|нет|хотим ли мы подгружать звонки в ленту|
+|call_task|number|нет|хотим ли мы подгружать колл таски в ленту|
+Если не передать ни один из параметров, значит будет грузиться все типы, поэтому передавать только в том случае, когда нужно получить конкретные типы.
+Передаются как пример: comment=1
+**Тип ответа:** Объект
+**Параметры ответа:**
+^ Название  ^ Тип    ^ Обязательно ^ Описание^
+|feed_type|string|да|конкретный тип сущности в ленте|
+|created_on_tz|string|да|время создания|
+|user_data|string|да|данные о пользователе в одной строке, с разделителем|
+|payload|string|да|полезная информация в зависимости от типа сущности|
+|feed_opt_1|string|да|резервные данные с 1 до 10, меняются в зависимости от сущности|
+|feed_opt_2|string|да|-|
+|feed_opt_3|string|да|-|
+|feed_opt_4|string|да|-|
+|feed_opt_5|string|да|-|
+|feed_opt_6|string|да|-|
+|feed_opt_7|string|да|-|
+|feed_opt_8|string|да|-|
+|feed_opt_9|string|да|-|
+|feed_opt_10|string|да|-|
+|username|string|да|имя пользователя|
+|position|string|да|позиция|
+|access|string|да|уровень доступа|
+<code javascript>
+//Ответ
+[
+    {
+        "user_data": "dev|Технический директор|С",
+        "feed_type": "comment",
+        "created_on_tz": "2025-08-07T04:06:09.780Z",
+        "payload": "123",
+        "feed_opt_1": null,
+        "feed_opt_2": null,
+        "feed_opt_3": null,
+        "feed_opt_4": null,
+        "feed_opt_5": null,
+        "feed_opt_6": null,
+        "feed_opt_7": null,
+        "feed_opt_8": null,
+        "feed_opt_9": null,
+        "feed_opt_10": null,
+        "username": "dev",
+        "position": "Технический директор",
+        "access": "С"
+    }
+]
 </code>
@@ Строка 3214: / Строка 3510: @@
 |appeal_num|string|номер обращения|
 |appeal_date|string|дата обращения|
+|rso_name|string|назваине организации РСО|
 |autophone|string|АОН|
 |contphone|string|если житель пожелал оставить другой контактный телефон|
@@ Строка 3347: / Строка 3644: @@
     "desired_time_start_on_tz": "2024-04-02T00:00:00.000Z",
     "note": "test1",
+    "rso_name": "АРТЕК",
     "fio": null,
     "emp_note": "emp_note",