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

{toc:maxlevel=3}

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

h3. Для чего подсказки?

Подсказки позволяют составить удобный запрос к базе, например "мск сухонская 11", и автоматический заполнить в локальном справочнике всю прочую информацию о доме: индекс. область, и тд. Это пригодится для передачи полных данных адреса при интеграции [СОРМ3|CarbonBilling:Интеграция с СОРМ3] и возможно в составлении отчётов.

h2. Добавление дома

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!

h3. Модификаторы поиска

При поиске дома Вы можете использовать модификаторы поиска: если добавить "-" перед словом, то результаты с этим словом будут исключены.

Поиск без модификатора \\ \\
!подсказки адресов модификаторы - без модификатора.png|border=0,width=300! \\ \\
Поиск с модификатором\\ \\
!подсказки адресов модификаторы - с модификатором.png|border=0,width=300!

h3. Дома нет в подсказках, что делать?

h4. Добавьте в справочник вручную

Если дома нет в ФИАС, добавьте его через [справочник|https://docs.carbonsoft.ru/pages/viewpage.action?pageId=155713975#Добавлениедомоввсправочник-Вручнуювсправочник].

h4. Оставьте заявку на добавление дома

В ФИАС может не быть каких-то реально существующих домов, их могут добавлять в справочник с задержкой.

Чтобы дом появился в подсказках:

# [Оставьте заявку сервису Дадата|https://dadata.ru/suggestions/usage/address/#why-no-house] - тогда дом появится в подсказках
# Обратитесь в муниципалитет для добавления дома в ФИАС (подробности [на сайте налоговой службы|https://fias.nalog.ru/Help])

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. Из карточки абонента: без подсказок

h3. Модификаторы поиска?

При поиске дома Вы можете использовать модификаторы поиска: если добавить "-" перед словом, то результаты с этим словом будут исключены. Например, в справочнике присутствуют адреса "г. Екатеринбург, ул. Ленина 62" и "г. Екатеринбург, ул. Ленина 62, к.1". Для того, чтобы при поиске был предложен только вариант "г. Екатеринбург, ул. Ленина 62", в поиске необходимо ввести "Екатеринбург Ленина 62 -1".

Поиск без модификатора \\ \\
!Дом (1).png|border=0,width=300! \\ \\
Поиск с модификатором\\ \\
!Дом (2).png|border=0,width=300!

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. Строения заносятся копированием уже существующих записей справочника по иерархии

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