Просмотр Исходного

{toc}

h2. Общая информация

Дома можно синхронизировать с [Федеральной информационной адресной системой (ФИАС)|https://fias.nalog.ru/Updates.aspx]. У синхронизации есть некоторые особенности работы:
* Синхронизация проходит со справочником "ФИАС", однако используется структура адреса совместимая со справочником "КЛАДР", поэтому в документации используются оба названия.
* Дерево домов строится от субъекта РФ

h2. Как синхронизировать?

В настройках [дома|CarbonBilling:Добавление домов в справочник] включите опцию "*Синхронизировать с КЛАДР(ФИАС)*" и обновите страницу:

!fias_sync_button.png|border=0,width=300!

h2. Как повторно синхронизировать?

Отключите опцию и снова включите.

h2. Я включаю опцию, а она отключается. Почему?

Вероятно происходит какая-то ошибка синхронизации. Все ошибки пишутся в лог:
{code}/app/asr_billing/var/log/workers/send_commands.log{code}
Как правило, это исключительные ситуации и они требуют анализа отделом разработки.

h2. Часть полей пустая

В изначальной реализации синхронизации было ограниченное количество атрибутов дома. В последствии появились дополнительные атрибуты.
Чтобы заполнить пустые атрибуты, повторно синхронизируйте дом.

h2. Не удается добавить корректно адрес в справочник биллинга

Некоторые адреса в справочнике заведены с небольшими особенностями
||Пример||
|Свердловская область, городской округ Березовский, город Березовский, +улица Ленина (п.Шиловка)+|
Обратите внимание, как именно указано название улицы. Если информацию в скобках опустить, то в данном случае будет назначен адрес непосредственно из города Березовский.
* Если у вас возникают какие-либо проблемы с заполнением справочника домов, вы можете проверить адрес в карточке абонента - [поле "Дом"|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=115867650#Дома-Сподсказками] (*Будет работать лишь в том случае, если включены подсказки*)
* Проверить в самом справочнике [ФИАС|https://fias.nalog.ru].

----

h2. В карточке абонента автоматически изменяется назначенный адрес

Например, абонент проживает по адресу Иркутская обл., Усольский р-н, тер. ДНП Жилой Комплекс, д 189

|В "Общих настройках" биллинга включена опция *"Использовать подсказки для домов"*|

В карточке абонента заполняем поле *"Адрес"*, далее может возникнуть два состояния :
* Возникнет надпись _"Не найдено"_;
* Адрес будет заполнен _"Иркутская обл., Усольский р-н, тер. ДНП Жилой Комплекс, д 189"_, но при сохранении поле изменится, к примеру на _"тер. ДНП Жилой Комплекс, д 245"_ (ранее указывали в биллинге этот адрес другому абоненту)

h4. Отладка проблемы

# Подключитесь к серверу по ssh и сделайте sql-запрос для определения ID записи адреса _"тер. ДНП Жилой Комплекс, д 245"_ в БД биллинга в таблице abonents у абонента:
{code}
[root@carbon~]# sqlexec "select home_id from abonents where id=6121"

HOME_ID
============
2522
{code}
# Далее, сделаем запрос для определения внешнего ID этого адреса в сторонней системе КЛАДР
{code}
[root@carbon~]# sqlexec -l "select * from homes where id=2522" | grep KLAD
KLADR_ID 38021000000000900
KLADR_SYNC_DATE <null>
KLADR_SYNC 0
{code}
# Необходимо проверить данные в стороннем сервисе, от которого получаем информацию об адресах ["Дадата":| https://dadata.ru/suggestions/#address]
В поле указываем необходимый адрес _Иркутская обл., Усольский р-н, тер. ДНП Жилой Комплекс, д 189_
!189.png|width=500px!
Сервис выводить информацию по адресу, но с предупреждением +"Неизвестный дом"+. Обратите внимание на записи "Код ФИАС" и "Код КЛАДР".
"Код КЛАДР" соответствует записи из БД биллинга
|KLADR_ID| 38021000000000900
|"Код КЛАДР"| 38021000000000900
|"Код ФИАС"| 51b29200-0812-486a-ace4-cbe5439c4efb (актуальный)
# Необходимо будет найти в сервисе ["Дадата" |https://dadata.ru/suggestions/#address] назначенный адрес _"тер. ДНП Жилой Комплекс, д 245"_
!245.png|width=500px!
Сверяем значение "Код ФИАС" и "Код КЛАДР" у этих адресов - они идентичны, так как оба дома отсутствуют в системе.

*ИТОГ:* биллинг проверяет при сохранении, чтобы не было дублей адресов. "Код КЛАДР" в "Дадате" = HOMES.KLADR_ID в БД биллинга. Так как "Дадата" на запрос обоих домов отдаёт идентичные ID, а одна запись адреса уже есть в БД биллинга, поэтому адрес в карточке сохраняется не с тем домом, что был в подсказке, а с тем что уже есть в БД биллинга.

h4. Решение
Добавить адрес в справочник "Дома" в БД биллинга вручную, без включения опции "Синхронизировать с "КЛАДР" - делается администратором биллинга;
Сообщить абоненту, что его дома нет в справочнике и есть возможность либо отключить подсказки, либо временно добавить дом в реквизиты строкой и подождать когда дом появится в ФИАС.