Работа с адресным классификатором ГАР с помощью API

31.03.24

Интеграция - WEB-интеграция

В статье рассказывается о функциях работы с адресным классификатором ГАР по API. Работа по API происходит онлайн, не нужно качать справочник, не нужно его периодически обновлять, при этом программный код получается сравнительно простой. Единственное что нужно - соединение с интернетом. Функции, описанные в статье, будут работать как на управляемых формах, так и на обычных.

Скачать исходный код

Наименование Файл Версия Размер
Работа с адресным классификатором ГАР с помощью API:
.cf 20,25Kb
4
.cf 1.1.1 20,25Kb 4 Скачать

Для работы с API потребуется получить токен в ФНС РФ. Процедура получения токена подробно рассмотрена в видео в конце статьи.

Приложенная конфигурация тестировалась на платформе 8.3.15.

Описание функций:

Функция ПолучитьАдресПоПроизволнойСтрокеПоиска(Токен, СтрокаПоиска)

возвращает список возможных адресов по строке поиска, при этом в первой строке списка содержит наиболее подходящий вариант для строки поиска.

Параметры функции: токен, произвольная строка поиска (например, "Москва, Арбат, д.1").

Функция возвращает таблицу значений со следующими колонками:

  • "full_name" - представление адреса
  • "object_guid" - идентификатор ГАР (ФИАС)
  • "path" - путь (id адресных элементов через точку, например "211522.95235590.211338.214198.6166221.6166938")
  • "postal_code" - почтовый индекс
  • "okato" - ОКАТО
  • "oktmo" - ОКТМО
  • "cadastral_number" - кадастровый номер адресного объекта

 

Функция ПолучитьАдресПоИдентификаторуГАР(Токен, ИдентификаторГАР)

функция преобразования идентификатора ГАР в адрес.

Параметры функции: токен, идентификатор ГАР (ФИАС)

Функция возвращает структуру:

  • "full_name" - представление адреса
  • "postal_code" - почтовый индекс
  • "okato" - ОКАТО
  • "oktmo" - ОКТМО
  • "cadastral_number" - кадастровый номер

 

Функция ПолучитьСписокРегионов(Токен)

возвращает список регионов РФ.

Параметр: токен.

Функция возвращает таблицу значений:

  • "object_id" - id адресного объекта
  • "object_level_id" - уровень адресного объекта, здесь всегда будет 1 - самый "верхний" уровень
  • "full_name" - представление адреса
  • "region_code" - код региона (например, для Москвы - 77)

 

Функция ПолучитьСписокАдресныхЭлементов(Токен, Путь)

возвращает иерархию адресных элементов начиная от элемента, заданного параметром Путь. Путь - это цепочка id-шников адресных объектов, записанных через точку (например, "211522.95235590.211338").

Параметры: токен, путь.

Функция возвращает таблицу значений, содержащую нижестоящие адресные элементы по отношению к параметру "Путь":

  • "object_id" - id адресного объекта
  • "object_level_id" - уровень адресного объекта
  • "full_name_item" - представление адресного объекта
  • "full_name" - представление адреса целиком, включая путь и текущий адресный элемент
  • "path" - путь для данного адресного элемента
  • "object_guid" - идентификатор ГАР
  • "postal_code" - почтовый индекс
  • "okato" - ОКАТО
  • "oktmo" - ОКТМО
  • "cadastral_number" - кадастровый номер адресного объекта

 

Подробно о функциях и их использовании смотрите видео:

 

адресный классификатор ГАР

См. также

Интеграция Альфа Авто 5 / Альфа Авто 6 и AUTOCRM / Инфотек

Сайты и интернет-магазины WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 1С:Управление торговлей 11 Автомобили, автосервисы Россия Управленческий учет Платные (руб)

Интеграционный модуль обмена между конфигурацией Альфа Авто 5 и Альфа Авто 6 и порталом AUTOCRM. Данный модуль универсален. Позволяет работать с несколькими обменами AUTOCRM разных брендов в одной информационной базе в ручном и автоматическом режиме.

36000 руб.

03.08.2020    16078    13    18    

13

Интеграция 1С — Битрикс24. Обмен задачами

Сайты и интернет-магазины Интеграция WEB-интеграция Платформа 1С v8.3 Конфигурации 1cv8 Управленческий учет Платные (руб)

Интеграция 1С и Битрикс24. Разработка имеет двухстороннюю синхронизацию 1С и Битрикс24 задачами. Решение позволяет создавать пользователя в 1С из Битрикс24 и наоборот. Данная разработка технически подходит под все основные конфигурации линейки продуктов 1С:Предприятие 8.3 (платформа начиная с 8.3.23). При приобретении предоставляется 1 месяц бесплатных обновлений разработки. Доступна демо-версия продукта с подключением Вашего Битрикс24

5040 руб.

04.05.2021    18150    10    15    

16

Автоматическая загрузка файлов (например, прайс-листов) из электронной почты, FTP, HTTP, их обработка и выгрузка на FTP (на сайт) и для других целей

Прайсы WEB-интеграция Ценообразование, анализ цен Файловый обмен (TXT, XML, DBF), FTP Автомобили, автосервисы Оптовая торговля, дистрибуция, логистика Управленческий учет Платные (руб)

Программа с заданным интервалом времени (или по ручной команде) скачивает файлы (например, прайс-листы поставщиков) из различных источников: письма электронной почты, FTP или HTTP-адреса, и сохраняет их в каталог упорядоченной структуры. При этом извлекает файлы из архивов, может переименовывать файлы и менять их формат (csv, xls, txt). Можно настроить выгрузку обработанных файлов на сайт (через FTP-подключение). Программа будет полезна компаниям, у которых есть большое количество поставщиков и/или прайс-листы поставщиков обновляются часто (необязательно прайс-листы, файлы могут быть любого назначения). Собранные таким образом актуальные версии прайс-листов можно выгрузить с помощью программы себе на сайт (или на любой FTP-сервер) или выполнить другие необходимые задачи.

25200 руб.

28.05.2015    85363    26    51    

50

Модуль для обмена "1С:Предприятие 8. УАТ. ПРОФ" с FortMonitor

WEB-интеграция 8.3.8 Конфигурации 1cv8 Автомобили, автосервисы Беларусь Украина Россия Казахстан Управленческий учет Платные (руб)

Расширение предназначено для конфигурации "1С:Предприятие 8. Управление Автотранспортом. ПРОФ". Функционал модуля: 1. Заполнение регистров сведений по подсистеме "Мониторинг", а именно: события по мониторингу, координаты по мониторингу, пробег и расход по мониторингу, текущее местоположение ТС по мониторингу 2. Заполнение путевого листа: пробег по мониторингу, время выезда/заезда, табличная часть ГСМ, места стоянок по геозонам. 3. Отчеты по данным загруженным в регистры сведений. 4. Предусмотрена автоматическая загрузка данных в фоновом режиме (условия работы данной загрузке читайте в описании товара) Модуль работает без включенной константы по настройкам мониторинга. Модуль формы предоставляется с открытым кодом, общий модуль защищен. Любой заинтересованный пользователь, имеет возможность скачать демо-версию расширения.

22656 руб.

25.05.2021    12988    33    8    

12

Интеграция с сервисом vetmanager

WEB-интеграция Платформа 1С v8.3 Бухгалтерский учет 1С:Бухгалтерия 3.0 Бытовые услуги, сервис Платные (руб)

Внешняя обработка разрабатывалась для загрузки документов из Ветменеджер в 1С: Бухгалтерия 3.0

12000 руб.

02.02.2021    16606    43    49    

23
Комментарии
Подписаться на ответы Инфостарт бот Сортировка: Древо развёрнутое
Свернуть все
1. user612295_death4321 01.04.24 06:59 Сейчас в теме
Расскажите про ограничения сервиса.

1. Есть ли лимиты не более N запросов в день/час/минуту?
2. Платный \ Бесплатный?

Если захочется нормализовать большой массив контрагентов, допустим 100 тысяч, как отреагирует сервис.
2. ilyap 17 01.04.24 14:58 Сейчас в теме
(1)
1. 10 тыс запросов в сутки
2. Бесплатный

Про 100 тыс. контрагентов советую вам углубиться в изучение API непосредственно на сайте ФНС, т.к. в нем есть некие сервисы для массовой обработки адресов.
3. gc1c 25.04.24 08:50 Сейчас в теме
Есть ли данные о Геопозиции адреса, широта и долгота, а также временная зона?
Оставьте свое сообщение