Адаптер для работы с ЕПГУ

Адаптер для работы с ЕПГУ через сервис СМЭВ 3 версии 1.0.3

Общее описание и документация (сайт Госуслуг): https://partners.gosuslugi.ru/catalog/integration_module

Описание конкретных сервисов (сайт Госуслуг): https://gu-st.ru/content/partners/Opisanie%20parametrov%20zaprosa%20dlya%20IM.docx

Особенности тестирования и подключения сервиса в СМЭВ

Особенностью данного СМЭВ сервиса является то, что он сам является шлюзом (интеграционным модулем) к сервисам ЕПГУ. Это значит, что процесс обработки запроса выглядит следующим образом: <сервис Агредатора> -> epgu-adapter -> smev3 -> СМЭВ -> ЕПГУ, то есть включает в процесс как конкретный сервис Агредатора (например epgu-pfr-account), так и сервис-адаптер epgu-adapter и адаптер СМЭВ3 - smev3. Таким образом, процесс подключения состоит из следующих шагов:

1. Подключение к тестовому контуру СМЭВ для базовой проверки сервиса. Не требует дополнительных действий - только проверка доступности тестового контура СМЭВ.
2. Подключение к тестовому контуру ЕПГУ и прохождение теста.
   

Для выполнения данного требования необходимо: - поле ConfirmType(confirm_type) установить в значение REST_API - поле RoutingCode(routing_code) установить в значение SVCDEV - настроить сервиc smev3 в соответствии с требованием ЕПГУ: - признак TestMsg убирается настройкой SERVICE_USE_PRODUCTION: "true" - необходимо указать тестовый адрес SMEV_ENDPOINT: "http://smev3-n0.test.gosuslugi.ru:7500/ws?wsdl"

1. Выполнить запрос. Пример:

{
  "confirm_type": "REST_API",
  "routing_code": "SVCDEV",
  "person": {
    "snils": "000-000-000 03",
    "firstName": "Имя",
    "lastName": "Фамилия",
    "secondName": "Отчество",
    "bdate": "2014-09-19",
    "passport": {
      "series": "22 33",
      "num": "112233",
      "issueDate": "2008-09-29",
      "issueCode": "123-123"
    },
    "phone": "+7 (912) 123-22-11"
  },
  "serviceFormCode": "10000012285",
  "serviceCode": "10000569524"
}

1. Отправить запрос на подключение к продуктовому контуру, и приложить к нему логи взаимодействия от предыдущего запроса.

Переменные окружения

Переменные для конфигурирования подключения к БД, и RabbitMq:

DATABASE_URL, CA_CERT, CLIENT_CERT, CLIENT_KEY, MQ_HOST, MQ_PORT

Переменные для конфигурирования отправки метрик в Elasticsearch:

ELASTIC_HOST, ELASTIC_PORT, ELASTIC_METRIC_PREFIX

Принимаемые параметры

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

Запрос на получение государственной или муниципальной услуги для указанной организации по инициативе третьей стороны (Пример: услуга «Получение разъяснений по вопросам применения федеральным антимонопольным органом антимонопольного законодательства»)

Структура элемента Person

Структура элемента Passport

Структура элемента Org

Структура элемента Draft

Структура элемента Field

Структура элемента Part

Параметры ответа

Структура элемента Limit

Структура элемента Info

Ответ зависит от конкретного сервиса. Описание находится тут: https://gu-st.ru/content/partners/Opisanie%20parametrov%20zaprosa%20dlya%20IM.docx

Примеры

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

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "person": {
    "snils": "000-000-000 03",
    "firstName": "Имя",
    "lastName": "Фамилия",
    "secondName": "Отчество",
    "bdate": "2014-09-19",
    "passport": {
      "series": "22 33",
      "num": "112233",
      "issueDate": "2008-09-29",
      "issueCode": "123-123"
    },
    "phone": "+7 (912) 123-22-11"
  },
  "serviceFormCode": "10000012285",
  "serviceCode": "10000569524"
}

В случае корректной настройки должен прийти следующий ответ:

{
  "id": "1",
  "statusCode": "NEW",
  "limit": {
    "day": "1000",
    "month": "10000",
    "total": "1000000"
  },
  "stat": {
    "day": "5",
    "month": "166",
    "total": "1626"
  },
  "errorStatusInfo": [
    {
      "Code": "0",
      "Message": "OK"
    }
  ]
}

Запрос на получение государственной или муниципальной услуги для указанной организации по инициативе третьей стороны (Пример: услуга «Получение разъяснений по вопросам применения федеральным антимонопольным органом антимонопольного законодательства»)

Для проверки настройки сервиса можно отправить в консоли отправки панели администрирования следующий запрос:

{
  "ConfirmType": "REST_API",
  "author": {
    "firstName": "Имя",
    "lastName": "Фамилия",
    "secondName": "Отчество",
    "bdate": "1989-03-20",
    "passport": {
      "series": "00 00",
      "num": "000000",
      "issueDate": "2014-08-13",
      "issueCode": "360-037"
    },
    "phone": "+7 (900) 000-00-00"
  },
  "signer": {
    "firstName": "Имя",
    "lastName": "Фамилия",
    "secondName": "Отчество",
    "bdate": "1997-08-08",
    "passport": {
      "series": "00 00",
      "num": "000696",
      "issueDate": "2000-11-11",
      "issueCode": "123-312"
    },
    "phone": "+7 (900) 000-00-00"
  },
  "organization": { "ogrn": "0001234000009", "inn": "3905074565" },
  "serviceFormCode": "567",
  "serviceCode": "10000526395",
  "draft": {
    "version": "1",
    "fields": [
      {
        "code": "IQEpguFasUlRukLaw.nameUl",
        "content": [
          {
            "value": "value:Общество с ограниченной ответственностью \"Балтинформ\"",
            "orderNumber": "0"
          }
        ]
      },
      {
        "code": "IQEpguFasUlRukLaw.INN",
        "content": [
          {
            "value": "value:3905074565",
            "orderNumber": "0"
          },
          {
            "value": "value:0001234000009",
            "orderNumber": "1"
          }
        ]
      }
    ]
  }
}

В случае корректной настройки должен прийти следующий ответ:

{
  "id": "1",
  "statusCode": "NEW",
  "limit": {
    "day": "1000",
    "month": "10000",
    "total": "1000000"
  },
  "stat": {
    "day": "5",
    "month": "166",
    "total": "1626"
  },
  "errorStatusInfo": [
    {
      "Code": "0",
      "Message": "OK"
    }
  ]
}