Получение начислений

GET /api/check
Возвращает список начислений по ИНН организации и лицевому счёту. Ответ всегда представляет собой массив, если найдены начисления, иначе ошибка 404.

🔐 Авторизация

Query parameters

ПараметрТип/ФорматОбязательныйОписаниеПример
tinstring<от 10 до 12 символов>✅ИНН организации7712345678
accountstring<от 1 до 100 символов>✅Лицевой счётЛС-1234567890

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

GET /api/check?tin=9731062087&account=ЛС-1234567890

Ответ

ПараметрТип/ФорматОбязательныйОписаниеПример
idstring<uuid>✅Уникальный идентификатор начисления75b12bb4-a87b-4c5d-8e4d-900802c67ed3
categorystring✅Категория начисленияКвартплата, Электроэнергия
accountstring✅Лицевой счет плательщикаЛС-1234567890
toPaystring✅Сумма к оплате15620.50
periodstring<ГГГГ-ММ-01>✅Период начисления2025-08-01
addressstring✅Адрес объекта недвижимостиг Москва, ул Тверская, д 15
addressKeystring<uuid>✅Уникальный ID адреса0c5b2444-70a0-4932-980c-b4dc0d3f02b5
unitTypestring❌Тип помещенияflat, parking, commercial
unitNamestring❌Номер/название помещения42, 123А
organizationstring✅Наименование организации-получателяООО УК "Столичный дом"
tinstring✅ИНН организации9731062087
iecstring❌КПП организации770101001
routingNumberstring✅БИК банка получателя044525555
bankAccountstring✅Расчетный счет организации40702810500000001234
receiptFileUrlstring❌Ссылка на начислениеhttps://example.com/receipt.pdf
purposestring✅Назначение платежа для банковского переводаКвартплата за август 2025 г. по лицевому счету ЛС-1234567890

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

json
{ "data": [ { "id": "c7f3a892-e5b1-4d6c-8a9f-1234567890ab", "category": "Квартплата", "account": "ЛС-7845123690", "toPay": "15620.50", "period": "2025-08-01", "address": "г Москва, ул Тверская, д 15", "addressKey": "0c5b2444-70a0-4932-980c-b4dc0d3f02b5", "unitType": "flat", "unitName": "42", "organization": "ООО УК \"Столичный дом\"", "tin": "7712345678", "iec": "770101001", "routingNumber": "044525555", "bankAccount": "40702810500000001234", "receiptFileUrl": "https://teststorage.com/receipts/august-2025.pdf", "purpose": "Квартплата за август 2025 г. по лицевому счету ЛС-1234567890" }, ] }

Коды ошибок

Код ошибкиHTTP статусСообщениеПричинаРешение
VALIDATION_FAILED400Invalid format of inputОшибка валидации параметровПроверьте формат входных данных
ACCOUNT_NOT_FOUND404Account number is not foundНачисление по Л/С не найденоУточните поисковый запрос
INTERNAL_SERVER_ERROR500Internal server errorВнутренняя ошибка сервераПопробуйте позже или обратитесь в поддержку