Для комфортного управления данными мобильного
приложения для поставщиков реализован механизм
интеграции. Интеграция включает в себя 3 основные
функции:
импорт данных в мобильное приложение;
экспорт показаний счетчиков, переданных
абонентами;
экспорт реестров с оплатами от абонентов.
Интеграция мобильного приложения Альфа Дом с 1С и
другими системами учета возможна двумя способами:
обмен через файлы CSV;
обмен при помощи API.
Обмен через файлы CSV предполагает ручную
выгрузку(загрузку) данных из(в) вашей учетной
системы файлов для импорта и экспорта в определенных
форматах, в то время как обмен через API работает
полностью автоматически, без участия пользователя,
что минимизирует ошибки.
Общие правила обмена данными
При импорте данных происходит полное замещение
информации о лицевом счете в мобильном
приложении;
Импорт данных допустимо проводить частично - не
по всем лицевым счетам. В таком случае в
мобильном приложении будут обновлены только те
лицевые счета, которые указаны в импорте;
Если во время импорта не указать счетчики, а до
этого в мобильном приложении они были у лицевого
счета, то после импорта счетчики в мобильном
приложении у такого абонента удаляться;
В связи с тем, что у абонентов в приложениях
после оплаты задолженность уменьшается сразу, а
провайдеры разносят платежи с задержкой, то
импорт данных необходимо производить после
полной актуализации задолженности в учетной
системе провайдера. Так как при импорте
задолженность в мобильном приложении полностью
заменяется на ту, которую выгружает провайдер.
Таким образом, можно попасть в кассовый разрыв,
когда абонент уже оплатил, а провайдер еще не
успел разнести данные;
Импорты необходимо проводить не реже одного раза
в месяц, желательно после выполнения расчета
коммунальных услуг в системе учета провайдера;
Перед первым обменом обязательно необходимо
настроить типы счетчиков. Более подробно о
настройки счетчиков рассказано
здесь
;
Номера лицевых счетов абонентов и заводских
номеров приборов учета в импорте должны быть
уникальными в пределах одного провайдера;
В одном импорте нельзя использовать несколько
строк с одним и тем же лицевым счетом, но с
разными счетчиками. Если у лицевого счета
несколько счетчиков, строка (или запрос в случае
API) должна быть одна, и в ней перечисляются все
счетчики абонента;
Минусовая сумма - это задолженность абонента
перед поставщиком услуг. Положительная сумма -
это переплата со стороны абонента. Если из вашей
системы учета выгружаются суммы с
противоположным знаком, то в настройках импорта
в личном кабинете есть возможность инвертировать
знак баланса..
Особенности определения адресов
Сервис “Альфа Дом” работает только с теми адресами,
которые присутствуют в ФИАС. Если дом отсутствует в
ФИАС, его невозможно добавить в мобильное
приложение.
При импорте данных происходит распознавание строки
адреса до 8 уровня по ФИАС - до номера дома. Если
адрес не распознан, он будет пропущен, а в логе
ошибок по таким лицевым счетам вы будете видеть
ошибку “noaddress”.
Распознавание адреса выполняется при помощи сервиса
DaData. Проверить самостоятельно в ручном режиме
адрес вы можете, перейдя по ссылке
https://dadata.ru/suggestions/#address
.
Для повышения качества распознавания адресов
придерживайтесь следующих рекомендаций:
Не указывайте в адресе индекс;
Адреса лицевых счетов должны быть максимально
приближены к адресам по ФИАС. Желательно
указывать в адресе не только город, но и
область, например: “Саратовская область, г.
Саратов, ул. Ленина, д. XXX”. Если не указать
область, система может найти данный адрес в
другой области;
Адрес лицевого счета (кроме номера квартиры)
ОБЯЗАТЕЛЬНО должен содержаться в одной колонке
файла. Нельзя город выгружать в одном столбце, а
улицу или область, в другом и т.д.;
Не обязательно, но очень желательно при импорте
номер квартиры (помещения) указывать не в общей
строке адреса, а отдельной колонкой (”свойством”
в случае импорта по API).