Дерево страниц

Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

Реализуются следующие сервисы:

Сервис данных о ЛС

1.

Маршрут

api/VoiceAssistant/GetPersonalAccountInfo

Метод

GET

Заголовки

Аутентификации пользователя

Описание

Получение информации по лицевому счету

Тело запроса


Описание объекта запроса

Свойство

Тип

Описание

street 

строка

Улица, обязательное поле, без префиксов: ул, улица, ул.

numHouse

строка

Номер дома, без префиксов

numApartment

строка

Номер квартиры, без префиксов

numRoom

строка

Номер комнаты, без префиксов

surname

строка

Фамилия, только фамилия

shortNum

строка

Обязательное поле, последние 4 цифры ПК


Тело ответа


Описание объекта ответа

Свойство

Тип

Описание

personalAccount

строка

ПК

dateOpen

dateTime

Дата открытия ЛС

square

decimal

Общая площадь

countRoom

int

Кол-во комнат


Пример


[

  {

    "personalAccount": "8103841319",

    "dateOpen": "2022-03-12T14:41:08.701441",

    "square": 58.5,

    "countRoom": 3

  }

]



Сервис данных о ЛС

2.

Маршрут

/api/VoiceAssistant/GetPayment/{publicPersonalAccount}

Метод

GET

Заголовки

Аутентификации пользователя

Описание

Получение списка оплат (3 последние)

Тело запроса


Описание объекта запроса

Свойство

Тип

Описание

publicPersonalAccount

строка

ПК, обязательный


Тело ответа


Описание объекта ответа

Свойство

Тип

Описание

itemNumber

int

Номер строки

sum

decimal

Сумма оплаты

date

dateTime

Дата оплаты

source

строка

Где оплачивали


Пример


[

  {

    "itemNumber": 1,

    "sum": 5312.95,

    "date": "2022-04-15T00:00:00",

    "source": " - "

  },

  {

    "itemNumber": 2,

    "sum": 10541.24,

    "date": "2022-03-10T00:00:00",

    "source": " - "

  },

  {

    "itemNumber": 3,

    "sum": 5316.24,

    "date": "2022-01-24T00:00:00",

    "source": " - "

  }

]



Сервис данных о ЛС

3

Маршрут

/api/VoiceAssistant/GetCounters

Метод

GET

Заголовки

Аутентификации пользователя

Описание

Список ПУ у абонента

Тело запроса


Описание объекта запроса

Свойство

Тип

Описание

publicPersonalAccount

строка

ПК, обязательный


Тело ответа


Описание объекта ответа

Свойство

Тип

Описание

itemNumber

int

Номер строки

serviceName

string

Наименование услуги

number

string

Заводской номер ПУ

value

decimal

Показание

dateUchet

dateTime

Дата учета показания

verificationDateNext

dateTime

Дата следующей поверки


Пример


[

  {

    "itemNumber": 1,

    "serviceName": "Холодное водоснабжение",

    "number": "0001672369",

    "value": "133.00000",

    "dateUchet": "2022-05-01T00:00:00",

    "verificationDateNext": "2026-04-01T00:00:00"

  },

  {

    "itemNumber": 2,

    "serviceName": "Электроснабжение",

    "number": "37527720",

    "value": "2 566.00000",

    "dateUchet": "2022-05-01T00:00:00",

    "verificationDateNext": "2035-12-24T00:00:00"

  }

]



Сервис данных о ЛС

4

Маршрут

/api/VoiceAssistant/SaveValue

Метод

POST

Заголовки

Аутентификации пользователя

Описание

Сохранение показания ПУ

Тело запроса


Описание объекта запроса

Свойство

Тип

Описание

publicPersonalAccount

строка

ПК, обязательный

counterNumber

строка

Заводской номер ПУ

counterValue

Вещественное число

Показание ПУ


Тело ответа


Описание объекта ответа

Свойство

Тип

Описание

Успешно

строка

«Показание успешно сохранено»

Неуспешно


«Прибор учета с номером не был найден»

«Для прибора учета с номером предыдущие показания не найдены»

«У прибора учета с номером предыдущее показание  больше, чем текущее»

«Неверный сальдовый месяц и год: месяц.год»


Пример





Сервис данных о ЛС

5

Маршрут

api/VoiceAssistant/ChargesPerMonth

Метод

GET

Заголовки

Аутентификации пользователя

Описание

Получение начислений за определенный месяц и год

Тело запроса


Описание объекта запроса

Свойство

Тип

Описание

publicPersonalAccount

строка

ПК, обязательный

month

Целое число

месяц

year

Целое число

год


Тело ответа


Описание объекта ответа

Свойство

Тип

Описание

sum

decimal

Начислено к оплате

sumMonth

decimal

Начислено за месяц

sumBalance

decimal

Начислено в т.ч долг/переплата

date

dateTime

Месяц начислений


Пример


{

  "sum": 5312.95,

  "sumMonth": 5312.95,

  "sumBalance": 10533.23,

  "date": "2022-03-01T00:00:00"

}



Сервис данных о ЛС

6

Маршрут

api/VoiceAssistant/GetChargesDescription

Метод

GET

Заголовки

Аутентификации пользователя

Описание

Получение расшифровки начислений за предыдущий месяц

Тело запроса


Описание объекта запроса

Свойство

Тип

Описание

publicPersonalAccount

строка

ПК, обязательный

serviceName

строка

Наименование услуги

serviceNumber

Целое число

Идентификатор услуги


Тело ответа


Описание объекта ответа

Свойство

Тип

Описание

Charges

строка

Начисление

Description

строка

Расшифровка начисления


Пример

/api/VoiceAssistant/GetChargesDescription?publicPersonalAccount=9050000042&serviceName=Электроснабжение&serviceNumber=

{

    "Charges": 719.98,

    "Description": " К оплате 719.98 рублей, в  том числе 684.80 рублей за текущий месяц,35.18 рублей долг за прошлый период. 

Начислено 35.18 по следующим данным : тариф 3.20 рублей * расход 214.00"

}