Города
Города нужны для точной адресной структуры компании. Здесь хранятся как полноценные города, так и другие населенные пункты, которые участвуют в доставке, самовывозе, checkout и адресных ограничениях.
Этот справочник особенно важен там, где компания работает с географией продаж, точками выдачи и настройкой доставки по территориям.
Импорт и экспорт CSV
В меню CSV можно выгрузить текущую выборку городов или загрузить подготовленный файл. Экспорт учитывает поиск и сортировку.
| Поле CSV | Описание | Обязательное поле | Пример |
|---|---|---|---|
| id | Идентификатор города для точного сопоставления. | Нет | 019ba9e9-1bea-736a-95d4-60261458c862 |
| region_ref_type | Тип ссылки на регион: id, name, fias или kladr. | Да | name |
| region_ref | Значение ссылки на регион. | Да | Санкт-Петербург |
| fias_id | FIAS ID города или населённого пункта. | Да | c2deb16a-0330-4f05-821f-1d09c93331e6 |
| kladr_id | KLADR ID города или населённого пункта. | Да | 7800000000000 |
| dadata_level | Тип записи: city или settlement. | Да | city |
| name | Наименование города или населённого пункта. | Да | Санкт-Петербург |
| name_with_type | Наименование с типом. | Нет | г Санкт-Петербург |
| type_short | Короткий тип записи. | Нет | г |
| type_full | Полный тип записи. | Нет | город |
| geo_lat | Широта. | Нет | 59.939001 |
| geo_lon | Долгота. | Нет | 30.315818 |
Если id не указан, Omniz ищет город внутри указанного региона по FIAS ID, KLADR ID или названию. Регион можно указать по идентификатору, названию, FIAS ID или KLADR ID. Конфликт ссылок, несуществующий или неоднозначный регион и повтор уникальных идентификаторов отменяют импорт целиком с указанием строк файла.
Для кого и когда нужен этот документ
Этот документ нужен как основная инструкция по разделу Города. Здесь собраны:
- назначение раздела
- смысл полей города
- различие между городом и населенным пунктом
- связь с пунктами выдачи и checkout
Откройте эту страницу, если нужно:
- завести город или населенный пункт
- разобраться в адресной структуре компании
- проверить, почему город участвует в доставке или самовывозе
1. Для чего нужен этот раздел
Город здесь служит рабочей адресной записью. Он используется при доставке, самовывозе и в других связанных задачах.
Раздел помогает:
- привязывать пункты выдачи к правильным городам
- ограничивать доставку по территориям
- поддерживать корректную адресную базу
2. Как устроена карточка города
Основные поля карточки:
- Регион
- Город или Населённый пункт
- Наименование
- Наименование с типом
- FIAS ID
- KLADR ID
- Тип (коротко)
- Тип (полностью)
- Широта
- Долгота
3. Что означает переключение Город / Населённый пункт
В карточке можно указать уровень записи:
- Город
- Населённый пункт
Компания может работать с городами, посёлками, сёлами и другими населёнными пунктами, если там доступна доставка или выдача заказов.
4. Что означают основные поля
Регион
Каждый город обязательно относится к определенному региону.
Регион выбирается из отдельного каталога в модальном окне. Не закрывая карточку города, в нём можно найти, создать или изменить регион. Таким же способом можно выбрать, создать или изменить страну. В каждом открытом каталоге сохраняются свои поиск, сортировка и текущая страница.
Наименование
Краткое рабочее имя записи.
Наименование с типом
Полное имя с типом, например г. Казань или пос. Лесной.
FIAS ID и KLADR ID
Это служебные идентификаторы для точной адресной структуры.
Широта и Долгота
Координаты помогают корректно описывать населенный пункт и использовать его в связанных сценариях.
5. Где города используются дальше
5.1. В пунктах выдачи
Пункт выдачи обязательно привязывается к городу из этого справочника.
5.2. В CMS-компоненте checkout
Города могут участвовать в ограничениях доставки по конкретным территориям.
5.3. В адресной базе компании
Это основа для корректной работы с адресами, доставкой и самовывозом.
6. Что важно помнить при ручном создании
Если город уже есть в базе, не стоит заводить его повторно с чуть другим написанием.
Перед созданием новой записи полезно проверить:
- нет ли уже такой записи с тем же смыслом
- не заведена ли она как населенный пункт
- правильно ли выбран регион
7. Когда изменения особенно чувствительны
Если город уже используется в пунктах выдачи или checkout-настройках, любые изменения в названии, регионе или идентификаторах нужно делать аккуратно.
Такие изменения влияют на работу сотрудников и оформление заказа покупателем.