Если интеграция доставки выбирает регион только по строке названия, одноимённые населённые пункты могут получить чужие настройки. В справочнике API Маркета используются regionId, тип региона и родительские связи. Метод получения дочерних регионов помогает проверить место выбранной территории в иерархии. Документация проверена 19 октября 2026 года.

Храните соответствие идентификаторов

API возвращает сведения о родительском регионе и его дочерних территориях. Запись региона содержит id, name, type и parent. Это позволяет сопоставлять не просто похожие строки, а конкретный объект географической базы. Сам справочник не подтверждает, что ваш магазин действительно доставляет в найденное место.

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

Не используйте почтовый индекс как автоматическую замену regionId. Это разные идентификаторы из разных систем. Если источник адреса неполон, отправьте запись на уточнение, вместо того чтобы выбирать первый результат с совпадающим названием и молча продолжать обработку.

Проверяйте уровень территории

Город, район и область нельзя считать взаимозаменяемыми только потому, что они относятся к одному направлению доставки. Внутренняя настройка может описывать широкий регион, а конкретный адрес находиться в части, куда курьер не ездит. Проверяйте тип объекта и его родительскую связь.

Если используется выгрузка дочерних территорий, обработайте все предусмотренные страницы ответа. Сохранение первой порции как полного справочника создаёт труднообнаружимые пробелы: часть адресов работает, другая внезапно перестаёт сопоставляться. Завершённость выгрузки должна быть отдельным результатом, доступным для проверки.

Не подменяйте справочником условия доставки

Географическое соответствие и коммерческое обещание покупателю — разные этапы. После выбора территории нужно проверить фактический маршрут, срок и стоимость магазина. Настройка районов на карте разобрана в материале о зонах DBS; она не выводится автоматически из наличия региона в справочнике.

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

При обнаруженной ошибке выделите затронутые заказы и настройки отдельно. Исправление справочника для новых расчётов не доказывает, что старые обещания покупателям стали выполнимыми. Ответственному за доставку нужен список таких исключений до следующего рейса.

Примите обновление на проверочной выборке

Для теста подберите одноимённые населённые пункты, адрес возле границы и ранее проблемную территорию. Сравните внутренний код, regionId, родителя и фактические условия доставки. Правильное совпадение текста без правильного региона тест не проходит.

Храните дату проверки соответствия и причину ручных исправлений. Когда справочник обновляется, пересматривайте изменённые связи, а не перестраивайте всю базу по одному названию. Такой порядок помогает сохранить стабильность маршрутов и объяснить, почему конкретный адрес получил именно эти условия.