Актуальную версию документа см. на сайте Министерства цифрового развития, связи и массовых коммуникаций Российской Федерации по адресу https://digital.gov.ru/ru/documents/6186/.

Создание центра обслуживания

Адрес метода:

URL: esia-rs/api/public/v1/orgs/{org_oid}/rcs

Входные параметры:

На вход сервис должен получать объект, описывающий центр обслуживания, который необходимо добавить к организации.

Параметры из URL:

org_oid - идентификатор организации, в которой добавляется ЦО;

Параметры тела запроса:

address - структурированный адрес места расположения ЦО в составе:

type - тип адреса - для ЦО всегда равен "RA";

addressStr - адрес, строковое представление - адрес без указания номера дома, корпуса, строения и квартиры;

countryId - 3-символьный код страны по справочнику ОКСМ;

zipCode - почтовый индекс;

fiasCode - ФИАС код (уровень 7...9) адреса места расположения ЦО;

region - название субъекта РФ согласно справочнику ССРФ;

area - район;

city - город;

district - внутригородской район;

settlement - населенный пункт;

street - название улицы;

additionArea - дополнительная территория;

additionAreaStreet - название улицы на дополнительной территории;

house - номер дома;

building - строение;

frame - корпус;

lat - широта (геокоордината);

lng - долгота (геокоордината).

contact - контактная информация ЦО - номер(а) телефона(ов) и/или адрес(а) электронной почты;

name - наименование ЦО;

features - возможности ЦО, перечисление "rcr", "reg", "del", "cfm", "rbi";

pdos - разрешения на отображение операций, перечисление "rcr", "reg", "del", "cfm", "rbi";

information - дополнительная информация;

opnModes - режим работы ЦО, перечисление: "WEEKENDS", "EARLY", "LATE";

1. WEEKENDS - работает по выходным;

2. EARLY - открыто с 8:00 утра;

3. LATE - Закрывается позже 19:00 вечера.

4. WEEKENDS, EARLY - работает по выходным (открыто с 8:00 утра);

5. WEEKENDS, LATE - работает по выходным, закрывается позже 19:00 вечера;

6. EARLY, LATE - работает с 8:00 утра и закрывается позже 19:00 вечера;

7. WEEKENDS, EARLY, LATE - работает по выходным (работает с 8:00 утра и закрывается позже 19:00 вечера).

operationTime - время работы ЦО;

HTTP метод: POST

Тело запроса: application/json;charset=UTF-8

Пример запроса:

POST esia-rs/api/public/v1/orgs/1000000001/rcs HTTP/1.1

Host: esia-portal1.test.gosuslugi.ru

Authorization: Bearer

eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0eyJleHAiOjE0NDYyMTU2ND

Content-Type: application/json

Cache-Control: no-cache

{

"name" : "Клиентский центр в ОПС 143960",

"operationTime" : "пн. 11.00 - 20.00, вт. - пт. 09.00 - 20.00, сб. 09.00

- 18.00, вс. - вых.",

"information" : "Необходим паспорт и номер СНИЛС",

"features" : [ "rcr", "reg", "del" ],

"address" : {

"type" : "RA",

"addressStr" : "Кемеровская Область, Таштагольский Район, Шерегеш

Поселок городского типа",

"countryId" : "RUS",

"zipCode" : "123104",

"region" : "Кемеровская Область",

"area" : "Регион Садовое неком-е товарищество",

"city" : "Шерегеш Поселок городского типа",

"district" : "нет",

"settlement" : "Усть-Анзас Поселок",

"street" : "Советская Улица",

"additionAreaStreet": "ект",

"house" : "86/1",

"building" : "е",

"frame" : "204у",

"flat" : "пом.419",

"fiasCode" : "2604e353-b9dd-4542-a8bf-020c8f982797",

"lat": 55.757911,

"lng": 37.600681

},

"contact" : {

"type" : "RAC",

"value" : "8-800-550-07-70"

},

"opnModes" : [ "LATE", "WEEKENDS", "EARLY" ],

"raTypeId" : 8

}

Значения типа ЦО (raTypeId)

Код

Название

1

МФЦ

2

Территориальное управление социальной защиты населения

3

Центр занятости населения

4

Территориальное отделение ЗАГС

5

Удостоверяющий центр

6

Государственное казенное учреждение

7

Администрация муниципального образования

8

Банковская организация

9

Отделение Почты России

10

Территориальное отделение Ростелеком

11

Территориальное управление ПФР

12

Территориальное управление МВД

13

Территориальное отделение Фонда социального страхования

14

РОИВ

15

ФОИВ

Пример успешного ответа:

{

"oid": "1000000234", // идентификатор созданного ЦО

"message": "Success|Fail"

}

Пример ответа с ошибкой:

{

"code": "ESIA-038000",

"message": "организация не найдена"

}

Перечень возможных возвращаемых ошибок:

Код

Описание

ESIA-038903

Отсутствует название ЦО

ESIA-038904

Не указано время работы ЦО (operationTime)

ESIA-038905

Не указан тип ЦО (raTypeId)

ESIA-038906

У ЦО отсутствуют контакты

ESIA-034008

Не указан адрес

ESIA-034004

Адресная строка пустая

ESIA-034003

Отсутствует индекс в адресе ЦО

ESIA-038000

Организация не найдена

ESIA-038902

Отсутствует фича fts ЦО (в запросе не указаны разрешенные ЦО операции)

ESIA-005043

Организация не имеет фичи ra (организация не имеет разрешения на операции создания, изменения, удаления центров обслуживания)

ESIA-005040

У организации нет группы TECH_CONSOLE" (у организации нет группы доступа (сотрудников) для работы с Технологическим порталом ЕСИА (использования Rest API))

Требуемый scope:

org_ra?org_oid={p.org_oid}&mode=w