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

{toc:maxlevel=3}

h1. Добавление дома из карточки абонента или при создании

h2. Как это работает

Дома не обязательно заводить сначала в [справочнике|CarbonBilling:Дома] - Вы можете содать дом при заведении абонента или из карточки уже существующего.

h3. Поиск адреса по справочнику
Наберите адрес в удобном формате и выберите нужный из предложенных вариантов.

!addr_parse.png|border=0,width=400! \\ \\

h3. Запрос можно исправить
Если ошиблись или нужно дополнить запрос:

# Нажмите на поле выбора адреса \\ \\
!addr_parse_edit_click.png|border=0,width=300! \\ \\
# Отредактируйте ранее заведенные данные\\ \\
!addr_parse_edit.png|border=0,width=292!

h2. Технические детали

Существует два справочника, используемых для подстановки адреса: [ФИАС|https://ru.wikipedia.org/wiki/ФИАС] и [локальный справочник "Дома"|CarbonBilling:Дома]

h3. Сначала ищем по ФИАС
При создании нового дома, если он есть в ФИАС, но отсутствует в локальном справочнике, в локальный попадает копия. Это позволяет не хранить адресную базу всей России на локальном сервере (около 100Гб) и при этом заводить дома синхронизированными с общероссийской базой адресов.
Чтобы не завести дом из ФИАС в локальном справочник несколько раз, по КЛАДР ID проверяется, есть этот дом в локальном справочнике или нет.

h3. Если адреса почему-то нет в ФИАС ищем в локальном справочнике
Допускаем такую возможность, поэтому в первую очередь поиск идет в ФИАС, но если запрос к нему не дал результатов, то поиск повторяется по локальному справочнику.

h3. Ищем улицы только в своих городах
При запросе к ФИАС поиск происходит только по списку населённых пунктов уже заведенных в локальном справочнике. Таким образом можно заводить адрес ведя только улицу в регионах предоставления услуг и не получить в выводе Москву, если Вы работаете, например, во Владивостоке.
Если еще не завели ни одного города то поиск будет по городу в котором зарегистрирован IP сервера биллинга.

h3. Подключаем новый город - пишем его в запросе
Если в поиск ввести и улицу и город, то поиск в ФИАС будет по выбранному городу.

h3. По-умолчанию выводим в результатах только дома/строения, но это настраивается
В форме выводятся только строения. Добавить абоненту в качестве адреса город и улицу, без строения, не получится.
Если Вам все же требуется указать абоненту в качестве адреса целую улицу или город, включите опцию "*Назначать абонентам любые типы записей*" в [настройках биллинга|http://docs.carbonsoft.ru/68845666#Настройки%28вфайле%29-Справочникдомов].

h3. Результатов может быть много, выводим первые пять
Вне зависимости от количества результатов в любом из справочников, выводим только 5 первых строк. Если адреса все равно нет, попробуйте дополнить запрос - добавить уточнения вроде "село" или "район" (район субъекта федерации, условно говоря области, а не города) или префикс к дому.

h3. Какие данные получаем из ФИАС в локальный справочник
Регион, Область, Город, Улица, Дом, Блок, Индекс, ОКАТО, kladr_id (уникальный ID строения/улицы/прочих объектов в справочнике)

h3. В справочнике уже есть дома, но заводили сами без ФИАС
Установите в доме [опцию "Синхронизировать с КЛАДР(ФИАС)"|Интеграция с ФИАС], данные подгрузятся.
Если домов много, это можно сделать с помощью [CarbonBilling:API REST v2.0]

h1. Добавление дома через справочник

Дома можно добавить и [синхронизировать с ФИАС|CarbonBilling:Интеграция с ФИАС] через справочник.
h4. Сначала нужно завести город

# Если нет ни одного города, откройте запись "*Город*" и скопируйте её
{note}Запись "Город" не нужно ни удалять, ни переименовывать{note}
!homes_copy.png|border=0,width=500! \\ \\
# Заполните в копии наименование нужного города и сохраните. При необходимости можете сразу синхронизировать с ФИАС \\ \\
!homes_form_fill.png|border=0,width=600! \\ \\
# Получившуюся запись с городом уже можно скопировать, добавив улицы и строения \\ \\
!homes_created.png|border=0,width=600! \\ \\

h4. Строения заносятся копированием уже существующих записей справочника по иерархии

* добавьте регион (не обязательно)
* скопируйте его, заполните город и сохраните
* на городе снова нажмите "*Копировать*" и создайте улицу
* скопируйте улицу и заведите дом/строение.