Интеграция ФИАС API: проверка и нормализация адресов
Встроим официальные сведения Государственного адресного реестра в форму сайта, CRM, 1С или внутренний сервис. Пользователь выбирает адрес, а система сохраняет не только строку, но и структурированные элементы, уникальные идентификаторы ФИАС, индекс и доступные реестровые коды. Для накопленной базы сначала проверим выборку, отделим точные совпадения от неоднозначных и только после этого подготовим массовое обновление с журналом изменений.
Когда стоит обратиться
Обычно к нам обращаются в таких ситуациях:
- Один адрес записан в базе несколькими способами, из-за чего появляются дубли клиентов, объектов, доставок или договоров.
- Форма принимает произвольный текст и не сохраняет идентификатор адресного объекта и его место в иерархии ГАР.
- Адрес передаётся между сайтом, CRM и 1С одной строкой, поэтому отдельные элементы теряются или разбираются по-разному.
- Нужно нормализовать существующую базу, сохранив спорные записи для проверки сотрудником вместо рискованной автоматической замены.
Что именно мы сделаем
Заказчик регистрируется на официальном портале и получает мастер-токен, а мы проверяем доступ к нужным методам Открытого API ФИАС.
Встраиваем поиск и последовательный выбор элементов адреса в выбранную форму сайта, CRM или 1С.
Сохраняем официальное написание, идентификаторы, индекс и структурированные элементы отдельно от отображаемой строки.
Сопоставляем поля при передаче в CRM, доставку, документы или другую связанную систему и проверяем обратное обновление.
Для накопленной базы обрабатываем контрольную выборку, задаём порог уверенности и выделяем неоднозначные совпадения на ручную проверку.
Проводим контроль адресов разной сложности и передаём журнал изменений и порядок работы со спорной записью.
Что входит в стоимость
59 900 ₽ за всю работу
Подключаем Открытые API-сервисы ФИАС по мастер-токену заказчика, встраиваем адресный поиск и сохраняем структуру ГАР. Настраиваем передачу полей в связанную систему, обрабатываем неоднозначный результат и на контрольной выборке готовим безопасный порядок нормализации существующей базы.
Что будет готово
Передадим вам
- Рабочий адресный поиск по Открытому API ФИАС в выбранной форме или внутренней системе.
- Структурированное хранение адреса, уникальных идентификаторов, индекса и доступных кодов ГАР.
- Отчёт по контрольной выборке, правила нормализации и журнал изменений существующей базы.
Перед сдачей проверим
- Контрольные адреса находятся в ГАР и сохраняются с правильной структурой и уникальными идентификаторами.
- После передачи между выбранными системами элементы адреса не теряются и не превращаются в произвольную строку.
- Точные совпадения обновляются по правилам, а неоднозначные адреса остаются в отдельном списке для подтверждения сотрудником.
Как это выглядит на практике
Оформление выезда мастера
Клиент вводит улицу и дом, выбирает официальный вариант из ГАР, а сайт сохраняет структурированные элементы и уникальный идентификатор. CRM получает те же поля и больше не создаёт второй объект из-за другого сокращения. При обработке старой базы уверенные совпадения нормализуются автоматически, а несколько неоднозначных адресов попадают сотруднику на проверку с предложенными вариантами.
- 01
Клиент начинает вводить улицу и выбирает подходящий официальный вариант.
- 02
После номера дома система получает индекс, муниципалитет и GUID ФИАС.
- 03
Зона обслуживания определяется по структурированным данным адреса.
- 04
Заказ уходит в CRM с готовыми полями для маршрута и документов.
Что понадобится для работы
От вас
- Мастер-токен, полученный заказчиком после регистрации для использования Открытых API-сервисов ФИАС.
- Доступ к тестовой копии сайта, CRM, 1С или другой системе и описание текущих адресных полей.
- Контрольная выборка адресов, включая корпуса, строения, помещения, старые названия и неполные записи.
Если у вас немного другая ситуация
Небольшие уточнения, которые помогают довести согласованный результат до рабочего состояния, уже учитываем в цене. Если по ходу работы появится отдельный крупный блок или понадобится платная лицензия, сначала обсудим варианты и стоимость. Расскажите о своей ситуации — подстроим план под неё.
- 3 000 ₽после подписания договора через Диадок
- 56 900 ₽после выполнения, демонстрации и приёмки результата
Предоплата входит в общую стоимость. Оставшуюся сумму оплачиваете после демонстрации и приёмки готовой работы.
Часто спрашивают
Об этой услуге
Чем ФИАС и ГАР отличаются от обычных подсказок адреса?
ГАР содержит официальные сведения об адресах, а ФИАС предоставляет доступ к этим данным и их идентификаторам. В базе сохраняется не только строка из формы, но и GUID, индекс и место объекта в адресной иерархии.
Можно очистить уже накопленную базу?
Да. Сначала проверим выборку и покажем спорные совпадения, затем согласуем массовое обновление подходящих записей.
Что произойдёт со старым названием улицы?
Система найдёт доступные сведения реестра, покажет актуальный вариант и сохранит связь через идентификатор адресного объекта.
Что нужно для подключения к Открытому API ФИАС?
Заказчик регистрируется на официальном портале ФИАС и получает мастер-токен. Мы подключаем его к форме или внутренней системе, настраиваем хранение структурированных полей и проверяем контрольные адреса.
Использование Открытых API-сервисов ФИАС платное?
Официальные условия предусматривают безвозмездное использование открытых API после регистрации разработчика и получения мастер-токена. Инфраструктура вашей системы и возможные сторонние сервисы учитываются отдельно.
Цена и изменения по ходу работы
Цена на странице окончательная?
Да. Перед началом мы сверяем исходные данные и фиксируем результат в договоре. Указанная на странице сумма покрывает согласованную работу целиком, даже если её техническая реализация потребует больше времени, чем ожидалось при оценке.
Что означает резерв незапланированных работ?
Это уже включённый в цену запас времени на небольшие связанные уточнения заказчика, которые появляются после старта: например, добавить поле, изменить формат уведомления или учесть ещё одно условие обработки.
Резерв рассчитывается по формуле: стоимость услуги × 30% ÷ 1 500 ₽. Для услуги за 30 000 ₽ это 6 часов. Эти часы относятся только к дополнительным, заранее незапланированным уточнениям. Они не являются сроком проекта и не ограничивают время на основную работу: согласованный результат мы выполняем полностью.
Можно уточнять детали уже во время работы?
Да. Небольшие связанные изменения обычно помещаются во включённый резерв и не требуют доплаты. Если новая идея заметно меняет результат или превращается в самостоятельную задачу, сначала обсудим подход и стоимость. Любое решение согласуем до выполнения.
Начало работы и оплата
Как оформляются договор и оплата?
Подписываем договор через Диадок. Предоплата составляет 3 000 ₽ и входит в общую стоимость услуги. Остаток оплачивается после демонстрации и приёмки готового результата.
Когда начинается срок выполнения?
Срок отсчитывается после согласования задачи, получения необходимых доступов и материалов, подписания договора и поступления предоплаты. Конкретную дату старта и плановый день готовности подтверждаем перед началом.
Как учитываются платные лицензии и внешние сервисы?
До старта проверяем, нужны ли тарифы, лицензии, сертификаты или дополнительные ресурсы внешних систем. Если они потребуются, заранее покажем варианты и стоимость. По возможности аккаунты и лицензии оформляются сразу на заказчика.
Проверка результата и гарантия
Как принимается готовая работа?
Вместе проверяем согласованные сценарии на контрольных данных или тестовой копии, а затем демонстрируем результат. Для интеграций сверяем передачу данных и обработку ошибок, для сайта — работу нужных страниц и действий пользователя, для отчёта — расчёты и обновление данных.
Какая гарантия действует после сдачи?
На выполненные изменения действует гарантия 3 месяца. Если в изменённой нами части обнаружится ошибка нашей реализации, проверим и исправим её без дополнительной оплаты. Переданные материалы, настройки и код остаются у заказчика.