Автоматизация филиальной сети в Яндекс Бизнесе через XML: технический гайд

Ручное редактирование 35 карточек филиалов занимает 14 часов в месяц. При изменении графика работы процесс растягивается на три дня из-за модерации каждого адреса. Яндекс Бизнес поддерживает загрузку данных через XML для сетей от 30 филиалов. Метод заменяет ручной ввод, исключает ошибки и передает в геосервисы единый стандарт информации.

Когда автоматизация необходима

Используйте автоматическую выгрузку при наличии более 30 адресов. Ручное управление через интерфейс подходит сетям с небольшим количеством филиалов (меньше 30), в которых информация меняется редко. Выгрузка из 1С, SAP или Axapta автоматизирует передачу данных.

Для старта объедините филиалы в сеть через подтверждение прав и заявку в поддержку. В разделе «Информация о сети» настройте источник данных.

Яндекс Бизнес поддерживает три способа обновления: ручной интерфейс, XML/CSV файлы или парсинг сайта роботом. Парсинг неэффективен из-за ошибок и задержек. Формат XML — рекомендуемый. Он передает фото, расширенные параметры и гарантирует актуальность карточек в Яндекс Картах, Навигаторе и Поиске.

Технические требования к фиду

Файл формируется по схеме XML Schema Definition. Система отклонит документ при нарушении кодировки или синтаксиса. Внутри тегов запрещены HTML-атрибуты. Текстовые поля не принимают символы с ASCII-кодами 0-31.

Исключения: табуляция (код 9), перевод строки (код 10), возврат каретки (код 13). Амперсанд & заменяется на &. Данные передаются на одном языке, за исключением мультиязычных элементов с атрибутом lang.

Корневой элемент — companies. Каждая точка продаж передается через company.

Метод обновления	Рекомендуемый объем	Возможности автоматизации
Ручной интерфейс	До 30 филиалов	Отсутствуют
XML файл	От 30 филиалов	Полная интеграция, передача фото
Парсинг сайта	Любой	Низкая точность, задержки

Сравнение способов загрузки данных.

Работа с company-id

Идентификатор company-id закрепляется за адресом навсегда. Это уникальный код, который генерирует владелец. Система использует его для сопоставления фида с карточками в геосервисах.

Значение содержит цифры, латинские буквы, дефис или подчеркивание. Пробелы запрещены. Максимальная длина — 80 символов. Валидные примеры: 68, 3-04-020, moscow_15, e915dac6f6f14c.

В файле не допускаются дубликаты идентификаторов. При переезде магазина старому адресу присваивается статус закрытого, для нового места создается свежий company-id. Использовать ID закрытых локаций повторно нельзя.

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

Заполнение названия и адреса

Название в теге name передается без кавычек, капслока и спецсимволов. Регистр учитывается. Модерация требует совпадения с названием сети на сайте без гео-уточнений. «Ромашка» — корректно, «Ромашка на Ленина» — отказ.

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

Адрес записывается в address одной строкой: регион, город, улица, дом. Лишняя информация (этажи, офисы, ориентиры) не допускается. Дополнительная навигация указывается в address-add. Если здание отсутствует в картах, координаты задаются широтой и долготой.

Тег XML	Назначение	Обязательность
name	Бренд без топонимов	Да
shortname	Имя для карты (до 55 символов)	Нет
name-other	Уточнения	Нет
address	Адрес одной строкой	Да
address-add	Этаж, офис, ТЦ	Нет

Мультиязычность и атрибуты

Специфические параметры (парковка, пандус, способы оплаты) передаются через дополнительные теги. Список доступных атрибутов скачивается в личном кабинете: раздел «Автоматизация» — «Управление филиалами» — «Выгрузить признаки».

Ошибки в атрибутах не блокируют публикацию файла, информация по ним просто не опубликуется. Каждая особенность оборачивается в feature-boolean или feature-text-single. При нескольких значениях передаются дублирующие теги.

Язык контента определяется атрибутом lang. Пример: <address lang="en">Ekaterinburg, prosp. Lenina, 101</address>.

Синхронизация данных

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

Файл размещается на сервере по статической ссылке, указанной в личном кабинете. Робот Яндекса скачивает документ периодически. Полная синхронизация обычно занимает несколько суток.

Отсутствие точки в фиде ведет к автоматическому закрытию карточки. Новые локации отправляются на проверку. Регулярная актуализация данных поддерживает статус «Информация подтверждена владельцем».

Для сетевого продвижения критична корректность координат и статусов из XML.

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

Сеть из 45 точек перешла на автообновление:

1. Выгрузили список филиалов из кабинета.
2. Присвоили каждому адресу company-id (формат optika_01).
3. Сформировали XML, очистив названия от гео-приписок.
4. Настроили генерацию фида из ERP.
5. Разместили файл по статической ссылке.
6. Добавили ссылку в раздел «Информация о сети».

Результат: информация обновляется в течение нескольких суток. Ручное редактирование отключено.

Чек-лист перед отправкой

1. Файл доступен без авторизации.
2. Кодировка UTF-8.
3. Амперсанд заменен на &.
4. Нет HTML-тегов и символов ASCII 0-31.
5. Корневой тег companies.
6. Уникальный company-id без пробелов.
7. Тег name без приписок.
8. Адрес без этажей и офисов.
9. Страна прописана в country.
10. Атрибут lang для мультиязычных полей.
11. Признаки соответствуют рубрике.
12. Закрытые точки удалены из файла.

FAQ

Как удалить филиал?

Удалите блок с филиалом из XML. При синхронизации карточка закроется.

Что делать с дублями сетей?

Скройте лишнюю структуру через меню «Организации» — «Скрыть из Личного кабинета».

Можно ли совмещать методы?

Используйте только один метод внесения изменений. Данные в файле имеют больший приоритет, чем данные в Личном кабинете.

Как добавить другой язык?

Используйте атрибут lang для элементов.