Автоматизация обновления филиалов в Яндекс Бизнесе: работа с XML

Интерфейс Яндекс Бизнеса рассчитан на ручное управление, если у компании менее 30 филиалов. При превышении этого порога ручные правки адресов и графиков ведут к рассинхронизации данных на Яндекс Картах и в Поиске. Справка платформы требует перевода сетевого бизнеса на обновление через XML-файл. Карточки, отсутствующие в загруженном файле, платформа закрывает автоматически.

Когда переходить на автоматизацию

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

Яндекс Бизнес поддерживает три способа управления данными: ручной ввод, автоматический сбор роботом с сайта и прямая загрузка XML или CSV. Сбор роботом неэффективен из-за ошибок парсинга. Загрузка XML-фида из 1С или ERP-системы гарантирует точную передачу атрибутов.

Автоматизация устраняет конкуренцию дублей. Если партнер создает карточку с искаженным названием, централизованный фид перекрывает эти данные при подтвержденных правах на сеть.

Структура XML-файла

Документ формируется на основе корневого атрибута companies с блоками company для каждого филиала. Нарушение структуры одного тега останавливает обработку всего узла.

Уникальный идентификатор передается в теге company-id. Значение присваивает владелец базы, менять его нельзя. Длина строки — до 80 символов. Допустимы цифры, латинские буквы, дефисы, подчеркивания. Пробелы запрещены.

При переезде филиала нужно указать новое значение company-id. Использовать старый идентификатор для новой локации нельзя. Запрещено присваивать освободившиеся номера закрытых точек новым филиалам.

Спецификации тегов описаны в документации. Технический гайд автоматизация филиальной сети в Яндекс Бизнесе через XML раскрывает настройки выгрузки из нестандартных учетных систем.

Требования к адресам и названиям

Название передается в теге name с обязательным указанием языка (например, lang="ru»). Текст должен совпадать с названием сети. Филиальные уточнения запрещены. Конструкции типа «Ромашка на улице Ленина» не проходят модерацию.

Для вывода короткого имени на Яндекс Картах используется тег shortname (до 55 символов). В отдельно согласованных случаях допускается до 75 символов. Внутренние номера допофисов передаются через тег name-other.

Адрес прописывается одной строкой в теге address: регион, город, улица, дом. Исключение — организации на трассах или объекты без номера дома. Указание этажей, номеров помещений и ориентиров в основном адресе вызывает ошибку геокодирования. Дополнительную навигационную информацию выносите в тег address-add.

Рубрики и графики работы

Привязка к деятельности — тег rubric-id. У каждого филиала может быть до трех видов деятельности, но хотя бы один из них должен совпадать с видом деятельности сети. Каждая рубрика прописывается отдельным элементом.

График работы передается в теге working-time. Выходные не указываются. Платформа распознает стандартные сокращения дней недели и временные интервалы.

Тег actualization-date сообщает время последней корректировки данных. Формат записи: ДД.ММ.ГГГГ или UNIX-time в миллисекундах. Если дата не изменилась, Яндекс Бизнес пропускает скачивание информации по узлу.

Фотографии и дополнительные параметры

Визуальный контент передается через тег photos. Элемент содержит ссылку на галерею или отдельные элементы photo с прямыми URL-адресами. Каждое фото размечается атрибутами.

Атрибут alt задает текстовое описание снимка. Система поддерживает внутреннее тегирование через элемент tag. Разметка ускоряет модерацию.

Фид позволяет передавать особенности филиала. Конструкции feature-boolean фиксируют бинарные параметры (наличие Wi-Fi), feature-numeric-single — числовые значения (количество номеров в гостинице).

Специфика партнерских сетей

В модели дистрибуции FMCG партнерские пункты часто меняют арендные площади. Владельцы точек забывают обновлять данные, что снижает локальный трафик.

Централизованный XML-фид решает вопрос контроля. Дистрибьюторы, представляющие сетевой бизнес, не могут создавать дублирующие карточки. Система объединяет их под единым управлением.

Головной офис формирует эталонный фид. Если партнер теряет статус, его company-id удаляется из файла. При следующем обходе робота Яндекс Бизнеса карточка автоматически закрывается.

Если координаты в тегах lon и lat противоречат текстовому адресу, приоритет у координат. Метка устанавливается в точку, адрес корректируется по ближайшему зданию.

Диагностика и проверка файла

Загрузка фида происходит в разделе «Автоматизация» кабинета сети. Блок «Управление филиалами» содержит поле для ссылки на XML-файл. Кнопка «Проверить» запускает валидацию.

Проверка занимает несколько часов. При критических ошибках (незакрытые теги, отсутствие обязательных атрибутов) файл отклоняется целиком. Сообщения об ошибках выводятся в интерфейсе.

При успешной валидации активируется кнопка «Опубликовать». Система формирует окно предпросмотра до 50 точек. Это позволяет оценить корректность геокодирования перед отправкой данных.

Кейс: переход сети автосервисов на XML

Сеть из 45 автосервисов обновляла данные вручную. При изменении графика менеджер тратил два дня на правки.

Алгоритм действий:

1. Разработчики настроили выгрузку из 1С в XML по стандарту Яндекс Бизнеса.
2. Каждому сервису присвоили уникальный company-id.
3. Удалили из названий привязки к метро, оставив брендовое имя в теге name.
4. Вынесли номера боксов из адреса в тег address-add.
5. Разместили файл на сервере по прямой ссылке.
6. Указали ссылку в разделе «Автоматизация» и запустили проверку.

Система проверяет файл несколько часов. После подтверждения через двое суток графики и телефоны обновляются на Яндекс Картах. При смене сезона 1С обновляет тег working-time, и Яндекс забирает изменения автоматически. Для усиления эффекта используйте геотаргетинг в Яндекс Директе для направления трафика на ближайшие точки.

Алгоритм загрузки и модерация

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

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

Кнопка «Посмотреть историю» доступна спустя сутки после первой загрузки. Новые точки появляются в поиске Яндекс Карт через несколько дней после модерации.

Чек-лист готовности фида

1. Файл доступен по прямой ссылке без авторизации.
2. Кодировка — UTF-8.
3. Корневой элемент companies закрыт.
4. Значения company-id уникальны и без пробелов.
5. В теге name только название бренда.
6. Основной адрес в address записан одной строкой.
7. Дополнительная навигация вынесена в address-add.
8. Тег rubric-id содержит идентификатор, совпадающий с рубрикой сети.
9. Страна в теге country указана один раз на весь файл.
10. Дата в actualization-date обновляется при каждом изменении данных.

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