Как разбить адрес в 1С на составные части

Задача разбить адрес в 1С возникает регулярно: нужно вывести город в отчёт, сгруппировать контрагентов по регионам, заполнить отдельные поля печатной формы или выгрузить данные во внешнюю систему, где адрес хранится по частям. Проблема в том, что в карточке контрагента или физического лица адрес обычно выглядит как единая строка вида «450000, Республика Башкортостан, г. Уфа, ул. Ленина, д. 5, кв. 12».

Способ разбора зависит от того, как адрес хранится в базе. В типовых конфигурациях на БСП (Управление торговлей, Бухгалтерия, ERP, ЗУП) адреса контактной информации хранятся не простой строкой, а в структурированном формате — XML или JSON, где каждый элемент адреса уже разложен по полям. В самописных решениях и старых базах адрес может быть обычной строкой, и тогда приходится разбирать её вручную через функции работы со строками.

Ниже разобраны оба сценария: работа со структурированным адресом через штатные механизмы БСП и ручной разбор строки, когда типовые средства недоступны. Также приведены готовые фрагменты кода, проверка результата и типичные ошибки.

Как адрес хранится в типовых конфигурациях 1С

В конфигурациях на базе Библиотеки стандартных подсистем контактная информация (адреса, телефоны, email) хранится в табличной части «КонтактнаяИнформация» справочников — контрагентов, физических лиц, организаций, партнёров. У каждой строки есть поля «Значение» (структурированное представление в JSON или XML) и «ЗначенияПолей» (старый формат XML), а также «Представление» — та самая строка, которую видит пользователь.

Ключевой момент: «Представление» — это производная строка, собранная из структурированного значения. Разбирать её обратно по запятым — плохая идея, потому что формат представления зависит от настроек и может меняться. Правильный путь — работать с полем «Значение», где адрес уже разложен по элементам: субъект РФ, район, город, населённый пункт, улица, дом, корпус, квартира.

Способ 1: разбор адреса через РаботаСАдресами (БСП)

Штатный способ получить части адреса — обратиться к общему модулю РаботаСАдресами (в старых версиях БСП — УправлениеКонтактнойИнформацией или КонтактнаяИнформацияСлужебный). Модуль содержит функции преобразования значения контактной информации в структуру, из которой читаются отдельные поля.

Типовой алгоритм: получить строку контактной информации нужного вида (например, «Юридический адрес»), взять её поле «Значение», преобразовать в структуру и прочитать нужные свойства. Пример кода:

// Получаем контактную информацию контрагента
Для Каждого СтрокаКИ Из Контрагент.КонтактнаяИнформация Цикл
Если СтрокаКИ.Вид = Справочники.ВидыКонтактнойИнформации.ЮрАдресКонтрагента Тогда

// Преобразуем JSON в структуру адреса
АдресСтруктурой = РаботаСАдресами.СведенияОбАдресе(СтрокаКИ.Значение);

Регион   = АдресСтруктурой.СубъектРФ;
Город    = АдресСтруктурой.Город;
Улица    = АдресСтруктурой.Улица;
Индекс   = АдресСтруктурой.Индекс;

// Дом, корпус, квартира лежат во вложенной коллекции
Для Каждого Строение Из АдресСтруктурой.Здания Цикл
НомерДома = Строение.Номер;
КонецЦикла;

КонецЕсли;
КонецЦикла;

Точный состав свойств структуры зависит от версии БСП: в одних релизах есть «Здания» и «Помещения» как коллекции, в других поля называются иначе. Чтобы увидеть реальный состав, достаточно в отладчике посмотреть значение, возвращаемое функцией СведенияОбАдресе, на конкретной базе.

Способ 2: чтение JSON-значения напрямую

Если функции БСП по какой-то причине недоступны (например, доработка внешней обработки без привязки к конкретной версии), JSON-значение адреса можно прочитать стандартными средствами платформы — объектом ЧтениеJSON. Это универсальный подход, работающий на любой современной платформе 8.3.

Функция РазобратьАдресJSON(ЗначениеКИ)

Результат = Новый Структура("Регион, Город, Улица, Индекс", "", "", "", "");

ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(ЗначениеКИ);
ДанныеАдреса = ПрочитатьJSON(ЧтениеJSON); // структура/соответствие
ЧтениеJSON.Закрыть();

// Поля зависят от формата; типичные имена:
// area — регион, city — город, street — улица, zipCode — индекс
Если ТипЗнч(ДанныеАдреса) = Тип("Соответствие") Тогда
Результат.Регион = ДанныеАдреса.Получить("area");
Результат.Город  = ДанныеАдреса.Получить("city");
Результат.Улица  = ДанныеАдреса.Получить("street");
Результат.Индекс = ДанныеАдреса.Получить("zipCode");
КонецЕсли;

Возврат Результат;

КонецФункции

Имена полей в JSON соответствуют формату XDTO-пакета контактной информации и могут отличаться: например, населённый пункт передаётся в поле locality, район — district, дом — houseNumber. Надёжнее всего один раз вывести JSON конкретного адреса в сообщение и посмотреть фактические имена полей.

ЧтениеJSON = Новый ЧтениеJSON;
ЧтениеJSON.УстановитьСтроку(СтрокаКИ.Значение);
ДанныеАдреса = ПрочитатьJSON(ЧтениеJSON);
ЧтениеJSON.Закрыть();
Регион = ДанныеАдреса.Получить("area");

Способ 3: разбор адреса-строки через СтрРазделить

Когда адрес хранится простой строкой (самописная конфигурация, импорт из Excel, старые данные), остаётся разбор по разделителю. В современной платформе для этого есть функция СтрРазделить(), в старых режимах совместимости — цикл по СтрПолучитьСтроку после замены запятых на символ перевода строки.

Функция РазбитьАдресСтроку(АдресСтрокой)

Части = СтрРазделить(АдресСтрокой, ",");

Результат = Новый Массив;
Для Каждого Часть Из Части Цикл
Результат.Добавить(СокрЛП(Часть));
КонецЦикла;

Возврат Результат; // [0] — индекс, [1] — регион, [2] — город и т.д.

КонецФункции

Главная проблема этого способа — непредсказуемость порядка и количества частей. В одном адресе может быть район, в другом — нет; индекс может отсутствовать; внутри названия города запятых нет, но встречаются сокращения «г.», «ул.», «д.», которые приходится отдельно вырезать функциями СтрЗаменить или регулярными выражениями. Поэтому разбор строки стоит считать запасным вариантом и всегда сопровождать проверкой количества полученных частей.

Как получить дом, корпус и квартиру

Мелкие элементы адреса — самая неоднородная часть. В структурированном формате номер дома хранится в коллекции «Здания» (тип здания: дом, владение, строение), корпус и литера могут быть отдельными элементами, а квартира — в коллекции «Помещения» (квартира, офис, комната). Обходить их нужно циклом, суммируя или выбирая по типу.

При разборе строки номера дома и квартиры обычно находятся в последних частях массива и содержат префиксы «д.», «к.», «кв.», «оф.». Практичный приём — идти по массиву с конца и забирать части, пока встречаются эти маркеры, а всё остальное считать улицей и населённым пунктом. Это устойчивее, чем жёсткая привязка к позициям.

Проверка результата и обработка нестандартных адресов

После разбора обязательно проверяйте результат на реальных данных. Минимальный набор проверок: все ли части заполнены, не попал ли индекс в поле города (это происходит при отсутствии запятой после индекса), не осталось ли в полях служебных сокращений «г.», «ул.». Для массовой обработки полезно собирать статистику: сколько адресов разобрано полностью, сколько — с пропусками, сколько — не удалось разобрать.

Отдельная категория — адреса, введённые вручную в свободной форме или загруженные из внешних источников. У них поле «Значение» может быть пустым, а «Представление» — произвольным текстом. Такие записи разумно выводить в отдельный список для ручной обработки, а не пытаться разобрать автоматически любой ценой: ошибочно разбитый адрес хуже, чем помеченный как нестандартный.

Что выбрать в разных ситуациях

Выбор способа определяется источником данных и задачей. Для типовой конфигурации всегда начинайте со штатных функций БСП — это самый устойчивый к обновлениям вариант. Для внешних обработок, которые должны работать на разных базах, надёжнее чтение JSON платформенными средствами. Разбор строки оставьте для импорта устаревших и внешних данных.

Частые вопросы