Группы местоположений: как использовать

Группа местоположений — это именованный набор городов и регионов, который в 1С-Битрикс можно один раз собрать и переиспользовать в ограничениях служб доставки и в налогах. Вместо того чтобы в каждой службе перечислять сотни городов, вы ссылаетесь на группу — и меняете состав зоны в одном месте.

Что такое группа местоположений

Местоположения в Битрикс образуют иерархию: страна → регион (область) → район → город → село. Это удобно для адресов, но неудобно, когда нужно описать произвольную зону — например «города-миллионники», «Московская агломерация» или «регионы с самовывозом». Такие наборы не совпадают с одной веткой дерева, поэтому для них и придуманы группы.

Группа — это плоский список ссылок на конкретные местоположения. Технически в новой модели за неё отвечает сущность Bitrix\Sale\Location\GroupTable, у группы есть символьный код (CODE) и языкозависимое название. Одно и то же местоположение может входить в несколько групп одновременно — это не эксклюзивная принадлежность, а метка.

Где создаются группы

Управление группами живёт в разделе Магазин → Настройки → Местоположения → Группы местоположений. Раздел доступен, когда включена новая модель местоположений и загружена база городов; если у вас чистый справочник, сначала выполните импорт базы регионов.

На странице списка вы видите все созданные группы с их кодами и количеством входящих местоположений. Отсюда же группа создаётся, редактируется и удаляется. Работа с группами требует прав на модуль sale (Интернет-магазин), поэтому доступ к ним обычно есть у администраторов и контент-менеджеров магазина.

• Список групп — обзор всех зон и быстрый переход к редактированию;
• Карточка группы — название, код и состав (набор местоположений);
• Поиск местоположений — тот же автодополняющий виджет, что и в остальных настройках магазина.

Как создать группу и наполнить её

Порядок действий предельно прямой:

1. Откройте Группы местоположений → Добавить группу.
2. Задайте название (по-русски, для менеджеров) и код (латиницей, например MSK_AGGLOMERATION) — по коду на группу удобно ссылаться в API и импортах.
3. В блоке выбора местоположений начните вводить название города или региона — сработает поиск по базе. Добавляйте нужные пункты по одному.
4. Сохраните группу.

Добавлять можно как отдельные города, так и целые регионы. Обратите внимание: если вы кладёте в группу область, в неё попадает именно это местоположение-регион, а не автоматически все города внутри него. Когда нужна вся ветка — добавляйте её осознанно, либо перечисляйте города точечно, в зависимости от того, как настроены сами службы доставки.

Использование в ограничениях доставки

Главный сценарий групп — ограничения служб доставки. Откройте службу в Магазин → Доставка, перейдите на вкладку Ограничения и добавьте ограничение по местоположению. В этом ограничении Битрикс позволяет указывать не только отдельные города и регионы, но и заранее собранные группы местоположений.

Логика простая: покупатель на оформлении заказа выбрал город → система проверяет, входит ли этот город в разрешённые местоположения или группы службы → если да, служба показывается и считает стоимость, если нет — скрывается. За проверку отвечает ограничение Bitrix\Sale\Delivery\Restrictions\ByLocation.

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

Налоги и зоны продаж

Второй практический сценарий — налоговые зоны. В разделе Магазин → Налоги ставки НДС и других налогов привязываются к местоположениям покупателя. Когда география ставок сложнее, чем «одна страна — одна ставка», группа помогает описать набор регионов с особым режимом и переиспользовать его вместо ручного перечисления.

Сравним подходы к описанию зоны:

Ключевая ценность одна и та же: изменение зоны делается в одной точке, а не размазано по десяткам настроек служб и налогов.

Практика и типичные ошибки

Несколько правил, которые экономят время на сопровождении:

• Осмысленные коды. SPB_LO или MILLIONNIKI читаются понятнее, чем автогенерённые. Код виден в API и выгрузках.
• Одна зона — одна группа. Не дублируйте один и тот же набор под разными именами; иначе смысл переиспользования теряется.
• Проверяйте после импорта. При переимпорте базы местоположений внутренние идентификаторы городов могут поменяться — после крупного обновления справочника пробегитесь по составу групп.
• Не путайте с избранными. Избранные местоположения — это подсказки-ускорители в поле выбора города, а группы — инструмент для правил доставки и налогов. Задачи разные.

Итог

Группы местоположений — это способ один раз описать произвольную географическую зону и переиспользовать её в ограничениях служб доставки и в налогах. Они снимают дублирование: состав зоны редактируется в одном месте и автоматически применяется везде, где на группу ссылаются. Создаются группы в Магазин → Настройки → Местоположения → Группы местоположений, а работают через ограничение по местоположению у служб доставки.

Если у магазина десятки служб, сложная карта тарифов и региональные налоги, грамотная система групп и зон превращает хаос настроек в управляемую структуру. Мы в B2Bsite проектируем такие схемы доставки и местоположений под реальную логистику и поддерживаем их актуальность по мере роста географии — от первичной настройки до интеграций с внешними службами.