Регионы
Регионы нужны для адресной структуры компании. Этот справочник хранит субъекты и административные территории, внутри которых затем создаются города, настраиваются ограничения доставки и ведутся связанные адресные данные.
Для бизнеса этот раздел полезен не как “просто география”, а как база для корректной работы checkout, адресных ограничений, пунктов выдачи и других процессов, где важна точная территория.
Импорт и экспорт CSV
В меню CSV можно выгрузить текущую выборку регионов или загрузить подготовленный файл. Экспорт учитывает поиск и сортировку.
| Поле CSV | Описание | Обязательное поле | Пример |
|---|---|---|---|
| id | Идентификатор региона для точного сопоставления. | Нет | 019ff594-2e34-760e-bb4c-c44dc2c95a5c |
| country_ref_type | Тип ссылки на страну: id, name или iso2. | Да | iso2 |
| country_ref | Значение ссылки на страну. | Да | RU |
| fias_id | FIAS ID региона. | Да | 6d1ebb35-70c6-4129-bd55-da0bf1c99d09 |
| kladr_id | KLADR ID региона. | Да | 4700000000000 |
| iso_code | ISO-код региона. | Нет | RU-LEN |
| name | Наименование региона. | Да | Ленинградская |
| name_with_type | Наименование с типом. | Нет | Ленинградская обл |
| type_short | Короткий тип региона. | Нет | обл |
| type_full | Полный тип региона. | Нет | область |
Если id не указан, Omniz ищет регион в указанной стране по FIAS ID, KLADR ID или названию. Конфликт ссылок, несуществующая или неоднозначная страна и повтор уникальных идентификаторов отменяют импорт целиком с указанием строк файла.
Для кого и когда нужен этот документ
Этот документ нужен как основная инструкция по разделу Регионы. Здесь собраны:
- назначение раздела
- смысл полей региона
- связь со странами и городами
- использование в адресных и клиентских сценариях
Откройте эту страницу, если нужно:
- завести регион вручную
- понять, зачем нужны FIAS и KLADR
- проверить адресную структуру перед настройкой checkout
1. Для чего нужен этот раздел
Регион нужен как промежуточный уровень между страной и городом.
Раздел помогает:
- упорядочить города по территориям
- хранить официальные идентификаторы региона
- использовать регионы в адресных ограничениях и настройках доставки
2. Как устроена карточка региона
Основные поля карточки:
- Страна
- Наименование
- Наименование с типом
- FIAS ID
- KLADR ID
- ISO
- Тип (коротко)
- Тип (полностью)
3. Что означают основные поля
Страна
Регион обязательно относится к стране.
Страна выбирается в отдельном окне справочника. В нём можно искать, сортировать и просматривать страницы списка, а также создать или изменить страну без закрытия карточки региона. После создания страна сразу появится в поле.
Наименование
Краткое рабочее имя региона.
Наименование с типом
Полное наименование вместе с типом, например Московская область.
FIAS ID
Это системный адресный идентификатор. Он нужен для точной адресной привязки и интеграций.
KLADR ID
Еще один адресный идентификатор, который помогает поддерживать корректную структуру адресных данных.
ISO
Полезен для интеграций, аналитики и случаев, где нужен стандартный код региона.
Тип (коротко) и Тип (полностью)
Показывают, что именно это за административная единица: область, край, республика и так далее.
4. Где регионы используются дальше
4.1. В справочнике городов
Каждый город привязывается к конкретному региону.
4.2. В CMS-компоненте checkout
Регионы могут участвовать в ограничениях доставки по территориям.
4.3. В адресных и логистических сценариях
Корректная структура регионов помогает поддерживать порядок в адресных данных компании.
5. Что важно понимать про FIAS и KLADR
Для обычного сотрудника это не поля “для красоты”, а служебные идентификаторы, которые помогают системе различать территории без путаницы.
Если компания ведет адресные данные аккуратно, эти поля лучше заполнять корректно и единообразно.
6. Когда стоит редактировать регион осторожно
Если регион уже используется в городах и адресных настройках, менять его нужно внимательно.
Особенно это касается:
- идентификаторов
- страны
- полного наименования
Такие изменения лучше делать осознанно, а не “по ходу”.