Должники и реестры
Управление задолженностями и реестрами
Как работает обмен данными
Двухэтапный процесс интеграции с учётной системой УК
Этап 1
Привязка кодов плательщиков- УК передаёт файл с адресами жителей и кодами плательщиков из своей учётной системы (ГИС ЖКХ)
- Система привязывает коды плательщиков к адресам в нашей базе
- После привязки дальнейший обмен возможен только по коду плательщика — без повторного парсинга адресов
Этап 2
Реестр задолженностей- УК отправляет данные о задолженностях, используя уже привязанные коды плательщиков
- Два варианта: сумма долга (число) или факт наличия долга (да/нет)
- Система автоматически применяет меры взыскания
Что происходит после получения реестра
- Заморозка ключей — при условии, что на адресе установлен домофон Спутник и в ГИСе Спутника к квартире привязаны ключи
- Push-уведомления — отправка уведомлений жителям через приложение Спутник
- Погашение долга — если плательщик исчезает из реестра, ключи размораживаются автоматически
Этап 1: Файл привязки
Первичная загрузка с адресами и кодами плательщиков
| Поле | Код | Тип | Обязательное | Описание |
|---|---|---|---|---|
| Адрес | address | string | Да | Полный адрес: город, улица, дом, квартира |
| ID плательщика | payer_id | string | Да | Уникальный код из учётной системы УК |
| ФИО | name | string | Нет | ФИО жителя (если УК готова передавать) |
| Сумма долга | amount | number | Нет | Можно указать позже, на этапе 2 |
После загрузки система привяжет каждый код плательщика к адресу. В последующих загрузках достаточно указывать только код плательщика и данные о задолженности.
Этап 2: Реестр задолженностей
Регулярная загрузка данных о задолженностях по привязанным кодам плательщиков
Вариант А: Факт наличия долга
payer_id+has_debt(да/нет)Для УК, не желающих передавать суммы задолженностей
Вариант Б: С суммой задолженности
payer_id+amount(рубли)Если указана сумма — наличие долга определяется автоматически (amount > 0)
Применяемые меры
- Заморозка ключей — только если на адресе есть домофон Спутник и ключи привязаны к квартире в ГИС Спутника
- Push-уведомления — отправка уведомлений жителям через мобильное приложение
- Погашение — когда плательщик исчезает из реестра, долг считается погашенным, ключи размораживаются
Справочник полей
Полное описание всех полей для файлов импорта
| Заголовок (RU) | Заголовок (EN) | Тип | Обяз. | Пример | Описание |
|---|---|---|---|---|---|
| Адрес | address | string | Да | г. Казань, ул. Козина, д. 3а, кв. 15 | Полный адрес: город, улица, дом, квартира |
| ID плательщика | payer_id | string | Да | 12345678 | Уникальный код из учётной системы УК |
| ФИО | name | string | Нет | Иванов Иван Иванович | ФИО жителя |
| Сумма долга | amount | number | Нет | 5000.50 | Сумма в рублях (дробная часть через точку) |
| Наличие долга | has_debt | да/нет | Нет | да | Если указана сумма — определяется автоматически |
- CSV: принимает и русские, и английские заголовки столбцов
- XLSX/XLS: читает по позиции столбца (A–E), заголовки игнорируются
- Форматы: .xlsx, .xls, .csv | Макс. размер: 10 МБ
Скачать шаблон
Шаблон файла для загрузки реестра должников
Автоматический обмен (Webhook)
Скоро
Автоматическая загрузка реестров из 1С и других систем через Webhook
Webhook позволяет автоматически получать реестры должников из вашей учётной системы (1С, ЕИС и др.) без ручной загрузки файлов.
После настройки ваша система будет отправлять данные по расписанию (например, ежедневно), и таблица должников обновится автоматически.
URL для Webhook
POST /api/v1/imports/webhookСтатус
Не настроен