Различия
Здесь показаны различия между двумя версиями данной страницы.
| Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
|
d24:develop:v2:backend:v2 [2025/07/25 09:08] anton |
d24:develop:v2:backend:v2 [2025/08/15 07:28] (текущий) anton |
||
|---|---|---|---|
| Строка 370: | Строка 370: | ||
| Параметры запроса: | Параметры запроса: | ||
| ^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
| - | |cnt_id | number | да | Идентификатор юр. лица в базе данных Д24 | | + | |cnt_id | number | нет | Идентификатор юр. лица в базе данных Д24 | |
| Тип ответа: Массив | Тип ответа: Массив | ||
| Строка 386: | Строка 386: | ||
| //Запрос | //Запрос | ||
| /* | /* | ||
| - | http://server.ru/v2/ref/contractors_list?cnt_id=1 | + | http://server.ru/v2/ref/oi_templates_list?cnt_id=1 |
| */ | */ | ||
| Строка 1059: | Строка 1059: | ||
| "status_id": "1", | "status_id": "1", | ||
| "reasons_count": 0 | "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": "Невозможно выполнить" | ||
| } | } | ||
| ] | ] | ||
| Строка 1334: | Строка 1381: | ||
| |info_id|number|да|идентификатор созданного оповещения в системе| | |info_id|number|да|идентификатор созданного оповещения в системе| | ||
| |info_ids|array|да|все ид оповещений (если создалось на несколько УК)| | |info_ids|array|да|все ид оповещений (если создалось на несколько УК)| | ||
| - | |oi_detail|object|да|детали созданного оповещения| | ||
| Строка 1369: | Строка 1415: | ||
| "affected_rows": 1, | "affected_rows": 1, | ||
| "info_id": 139284, | "info_id": 139284, | ||
| - | "info_ids": [139284], | + | "info_ids": [139284] |
| - | "oi_detail": ... см.детали оповещения | + | |
| } | } | ||
| </code> | </code> | ||
| Строка 1422: | Строка 1467: | ||
| **Параметры ответа:** | **Параметры ответа:** | ||
| ^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
| + | |affected_rows|number|да|сколько строк обновилось| | ||
| |info_id|number|да|идентификатор оповещения, которое обновлялось| | |info_id|number|да|идентификатор оповещения, которое обновлялось| | ||
| - | |created_by|number|да|идентификатор пользователя, который создал оповещение| | + | |
| - | |svc_id|number|да|идентификатор РСО| | + | |
| - | |request_id|number|да|идентификатор заявки| | + | |
| - | |owner_id |number|да|идентификатор УК| | + | |
| - | |employee_id|number|да|идентификатор исполнителя| | + | |
| - | |essence_id|number|да|идентификатор причины обращения| | + | |
| - | |flag_system|string|да|флаг отправки уведомления жителям Д / Н| | + | |
| - | |start_at|string|да|дата начала в формате ДД.ММ.ГГГГ ЧЧ:ММ| | + | |
| - | |end_at|string|да|дата окончания в формате ДД.ММ.ГГГГ ЧЧ:ММ| | + | |
| - | |created_at|string|да|дата создания в формате ДД.ММ.ГГГГ ЧЧ:ММ| | + | |
| - | |start_at_tz|string|да|дата начала в формате ИСО| | + | |
| - | |end_at_tz|string|да|дата окончания в формате ИСО| | + | |
| - | |created_on_tz|string|да|дата создания в формате ИСО| | + | |
| - | |updated_on_tz|string|да|дата изменения в формате ИСО| | + | |
| - | |type|string|да|тип оповещения| | + | |
| - | |note|string|да|текст оповещения| | + | |
| - | |last_comments|array|да|комментарии к оповещению| | + | |
| - | |status|string|да|статус оповещения| | + | |
| - | |reason|string|да|причина оповещения| | + | |
| - | |resp|string|да|зона ответственностио оповещения| | + | |
| - | |what|string|да|объект оповещения| | + | |
| - | |access|string|да|доступы юзера| | + | |
| - | |header|string|да|название акции| | + | |
| - | |more_info_link|string|да|ссылка на доп инфо| | + | |
| - | |price|number|да|цена| | + | |
| - | |push_text|string|да|текст уведомления для жителей| | + | |
| - | |username|string|да|имя пользователя| | + | |
| - | |position|string|да|должность пользователя| | + | |
| - | |emp_str|string|да|информация об исполнителе| | + | |
| - | |essence|string|да|информация об причине обращения| | + | |
| - | |svc|string|да|имя РСО| | + | |
| - | |service_list|string|да|услуги оповещения| | + | |
| - | |reason_str|string|да|информация о причине| | + | |
| - | |what_str|string|да|информация об объекте| | + | |
| - | |type_str|string|да|информация о типе оповещения| | + | |
| - | |status_str|string|да|информация о статусе оповещения| | + | |
| - | |service_list_str|string|да|информация об услугах| | + | |
| - | |resp_str|string|да|информация о зоне ответственности| | + | |
| - | |houses|array|да|дома, привязанные к оповещению| | + | |
| - | |house_state_list|array|да|дома, привязанные к оповещению с информацией о статусе| | + | |
| Строка 1792: | Строка 1799: | ||
| |updated_on_tz|string|да|дата и время обновления оповещения в формате ISO| | |updated_on_tz|string|да|дата и время обновления оповещения в формате ISO| | ||
| |note|string|да|текст оповещения| | |note|string|да|текст оповещения| | ||
| + | |request_status_name|string|нет|статус заявки, из которой создалось оповещение| | ||
| |last_comments|array|да|последние комментарии| | |last_comments|array|да|последние комментарии| | ||
| |houses|array|да|список домов для оповещения| | |houses|array|да|список домов для оповещения| | ||
| Строка 1843: | Строка 1851: | ||
| "updated_on_tz": "2024-09-19T09:41:34.460Z", | "updated_on_tz": "2024-09-19T09:41:34.460Z", | ||
| "type": "У", | "type": "У", | ||
| + | "request_status_name": "Принята в работу", | ||
| "note": "постман", | "note": "постман", | ||
| "last_comments": [ | "last_comments": [ | ||
| Строка 1979: | Строка 1988: | ||
| "comment": "123" | "comment": "123" | ||
| } | } | ||
| + | |||
| + | **Параметры ответа** | ||
| + | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
| + | |affected_rows|number|да|сколько строк изменилось| | ||
| + | |status_id|string|да|идентификатор прикрепленного дома| | ||
| + | |||
| //Ответ | //Ответ | ||
| Строка 2539: | Строка 2554: | ||
| **Тело запроса:** | **Тело запроса:** | ||
| ^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
| - | |house_id|number|да|ИД Дома| | ||
| - | |owner_id|number|нет|ИД Управляющей компании| | ||
| |svc_id|number|да|идентификатор РСО| | |svc_id|number|да|идентификатор РСО| | ||
| - | |note| string|да|Комметрарий от заявки| | + | |rso_comment| string|да|Комметарий к заявке РСО| |
| - | |rso_comment| string|да|Комметрарий к заявке РСО| | + | |
| |request_id|number|да|ИД Заявки| | |request_id|number|да|ИД Заявки| | ||
| Строка 2551: | Строка 2563: | ||
| ^ Название ^ Тип ^ Обязательно ^ Описание^ | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
| |request_rso_id|number|да|ид заявки рсо| | |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|да|идентификатор РСО| | |svc_id|number|да|идентификатор РСО| | ||
| - | |note|string|да|комментарий заявки рсо| | + | |note| string|да|Описание заявки РСО| |
| - | |created_on_tz|string|да|время создания заявки| | + | |rso_comment| string|да|Комметарий к заявке РСО| |
| |status_id|number|да|ид статуса| | |status_id|number|да|ид статуса| | ||
| - | |rso_status_name|string|да|имя статуса| | + | |ext_request_id|string|да|ид заявки из смежной службы| |
| - | |request_id|number|да|ид заявки, на основе которой создана заявка рсо| | + | |
| + | |||
| + | **Тип ответа:** Объект | ||
| + | |||
| + | **Параметры ответа:** | ||
| + | ^ Название ^ Тип ^ Обязательно ^ Описание^ | ||
| + | |request_rso_id|number|да|ид заявки рсо| | ||
| + | |affected_rows|number|да|колво измененных строк| | ||
| **Примеры:** | **Примеры:** | ||
| Строка 2567: | Строка 2612: | ||
| { | { | ||
| - | "house_id" : 34021, | + | "status_id" : 1, |
| "svc_id:" : 1533, | "svc_id:" : 1533, | ||
| - | "owner_id" : 23, | + | "rso_comment" : "123", |
| - | "request_id" : 1300673, | + | "ext_request_id" : "123Ф", |
| "note" : "123", | "note" : "123", | ||
| } | } | ||
| Строка 2576: | Строка 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, | "owner_id": 13521, | ||
| "svc_id": 5484, | "svc_id": 5484, | ||
| - | "note": "123", | ||
| - | "created_on_tz": "2024-03-28T07:19:10.826Z", | ||
| "status_id": 1, | "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> | </code> | ||
| Строка 3246: | Строка 3510: | ||
| |appeal_num|string|номер обращения| | |appeal_num|string|номер обращения| | ||
| |appeal_date|string|дата обращения| | |appeal_date|string|дата обращения| | ||
| + | |rso_name|string|назваине организации РСО| | ||
| |autophone|string|АОН| | |autophone|string|АОН| | ||
| |contphone|string|если житель пожелал оставить другой контактный телефон| | |contphone|string|если житель пожелал оставить другой контактный телефон| | ||
| Строка 3379: | Строка 3644: | ||
| "desired_time_start_on_tz": "2024-04-02T00:00:00.000Z", | "desired_time_start_on_tz": "2024-04-02T00:00:00.000Z", | ||
| "note": "test1", | "note": "test1", | ||
| + | "rso_name": "АРТЕК", | ||
| "fio": null, | "fio": null, | ||
| "emp_note": "emp_note", | "emp_note": "emp_note", | ||