Обновление данных через XML-файл

Если в вашей сети более 30 филиалов, рекомендуем обновлять данные в Яндекс Бизнесе с помощью XML‑файла.

Данные о ваших филиалах обновятся на основе информации из файла XML:

  • Новые филиалы добавятся в базу и будут отображаться в сервисах с указанными атрибутами.
  • Карточки филиалов, сведения о которых не добавлены в XML‑файл, будут закрыты.

Шаг 1. Подготовьте XML‑файл

Требования к содержанию

Внимание

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

Модераторы проверяют соответствие данных в файле и на сайте:

  • Адрес
    Юридические адреса не нужно добавлять.

  • Телефон
    Номера должны быть идентичны.
    Добавляйте только те номера, которые есть на сайте. Если номера (в том числе подменного) нет на сайте, удалите номер из файла или укажите его на сайте.

  • Режим работы
    Если есть организации с ограниченным доступом, укажите это при передаче файла.

  • Рубрика
    Основная рубрика на сайте и в файле должны совпадать.
    Рубрики должны быть совместимы по смыслу.

    Правильно: Шиномонтаж, Автосервис
    Неправильно: Шиномонтаж, Кондитерская

  • Количество филиалов.

  • Отсутствие дублей — одинаковых адресов и координат у двух разных организаций.

    Исключения

    Список рубрик, у которых могут быть одинаковые адреса, но при этом должны быть разные координаты (различия более чем на 30 метров):

    • Банкоматы
    • Постаматы
    • Вендоматы
    • Терминалы

Соответствие сайту организации желательно для следующих атрибутов:

  • Добавочный телефон
  • Вторичные рубрики
  • Праздники и нерабочие дни
  • Расположение и входы

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

  1. XML‑файл должен быть создан в кодировке UTF‑8.

  2. Файл не пустой.

  3. Нет пустых элементов.

  4. Стандартный XML‑заголовок должен начинаться с первой строки, с нулевого символа. Например:

    <?xml version="1.0" encoding="UTF-8"?>

  5. Соблюдается правильная структура XML.

    Файл можно проверить:

    • С помощью валидатора Вебмастера.
      Выберите схему валидации документа — Бизнес и источник XML‑данных для валидации — файл, ссылку или текст.
    • Самостоятельно на своем компьютере с помощью схемы (XML Schema Definition).

  6. В данных не должно быть HTML‑атрибутов.

  7. Не допускаются символы с ASCII‑кодами в диапазоне значений от 0 до 31 в текстовых полях.

    Примечание

    Исключения: значения 9 (табуляция), 10 (перевод строки), 13 (возврат каретки).

  8. Символы & заменены на &amp;.

  9. Для описания филиалов используйте набор обязательных и дополнительных атрибутов. Каждую особенность филиала оборачивайте в отдельный атрибут (см. Пример файла).
    Если для одного атрибута есть несколько значений (например телефонов), передавайте несколько атрибутов с одинаковыми именами.

  10. Нет двух и более одинаковых company-id в XML-файле.

  11. Данные XML-файла должны быть на одном языке. Исключение составляют мультиязычные атрибуты (см. Описание атрибутов).

    Мультиязычный атрибут ― атрибут в XML-файле со значениями на нескольких языках.

    Язык определяется атрибутом lang. Для каждого нового языка указывайте элемент с соответствующим значением атрибута lang на отдельной строке.

    Пример
    <address lang="ru">город Ташкент, просп. Ленина, 101, а</address>
<address lang="uz">Toshkent shahri, Lenin koʻchasi, 101-a</address>

    Актуальные значения lang вы найдете в схеме XML. Чтобы добавить другие языки, обратитесь в службу поддержки.

Описание атрибутов

Атрибут

Описание

Мультиязычный элемент

Обязательное поле

companies

Корневой атрибут.

Н/п

Да

company

Описание филиала. Размещается внутри корневого атрибута. Количество атрибута company может быть произвольным.

Н/п

Да

company-id

Уникальный идентификатор филиала, присваивается владельцем сети.

Требования к значению:

  • может содержать цифры, латинские буквы, дефис и символ подчеркивания;
  • не может содержать пробел;
  • максимальная длина — 80 символов.

Примеры: 68, 3-04-020, moscow_15, e915dac6f6f14c.

Требования к использованию:

  • нельзя изменять значение на протяжении всей работы филиала по указанному адресу;
  • при переезде филиала нужно указать новое значение;
  • нельзя использовать одно значение для нескольких филиалов;
  • нельзя использовать для новых филиалов значения, которые были удалены при закрытии или переезде другого филиала.

Нет

Да

name

Название конкретного филиала. Указывается без кавычек, капслока, спецсимволов, с учетом регистра.

Должно совпадать с названием сети и не содержать филиальных уточнений — как на сайте. Уточнения можно записывать только в элемент name-other.

Правильно: Ромашка
Неправильно: Ромашка на улице Ленина

Да

Да

shortname

Короткое название филиала для отображения около меток в Картах — до 55 символов. В отдельно согласованных случаях допускается до 75 символов. Указывается без кавычек, с учётом регистра.

Да

Нет

name-other

Уточнения для филиала ("Допофис №1") или альтернативное название филиала (если названий несколько, указывайте каждое из них в отдельном элементе). Указывается без кавычек, с учетом регистра.

Обязательно укажите язык: <name-other lang="uz">.

Да

Нет

address

Полный адрес филиала — регион, город, улица, дом (исключения: села, заправки, организации на трассах, нет дома в Картах). Если у филиала нет полной адресной информации, адрес может быть указан частично, но он не должен противоречить указанным в файле координатам.

Записывается одной строкой.

Правильно: Toshkent, Shota Rustaveli ko'chasi, 72k2
Неправильно: Toshkent, Shota Rustaveli ko'chasi

Если элемент содержит только название улицы и номер дома, используйте элемент locality‑name с указанием населенного пункта.

Не должно быть лишней информации: этажей, офисов, ориентиров.

Да

Да

country

Страна. Прописывайте название страны полностью, без сокращений.

Только одна страна для одного файла. Для разных стран нужно создать отдельные сети и обновлять их разными файлами.

Да

Нет

address-add

Дополнительная информация к адресу, которая не относится к другим элементам (название ТЦ/ТРК/ТРЦ, этаж, офис, помещение, бутик, вход).

Например, ТЦ Ромашка, 2 этаж, офис 203 / Вход со двора.

Пишите коротко и понятно. Подробнее о требованиях см. в разделе Комментарий к адресу.

Не используйте скобки и кавычки.

Да

Нет

phone

Номер телефона организации. (если номеров несколько, то каждый указывается в отдельном элементе).

Составной элемент. Внутри есть обязательные элементы.

<phone>
    <number>8 (800) 123-45-67</number>
    <type>phone</type>
</phone>

Нет

Да

Элементы, вложенные в phone

number

Номер стационарного или мобильного телефона. Указывается в формате: [код страны] ([код города]) [номер телефона].

Да

ext

Добавочный номер, без пояснений, слов и разделителей.

info

Информация о номере, например: директор, секретарь. Не указывайте в этом элементе информацию о типе телефона.

type

Тип телефона. Допустимые значения:

  • phone — телефон;
  • fax — факс;
  • phone‑fax — телефон‑факс.

Да

email

Адрес электронной почты (если адресов несколько, укажите каждый из них в отдельном элементе).

Нет

Нет

url

Основной сайт сети (без соцсетей). Указывается в нижнем регистре, полностью, включая http:// или https://.

Для соцсетей заведите атрибут add-url. Для филиалов можно использовать региональные сайты.

В ссылках не должно быть UTM-меток.

Нет

Да

add-url

Дополнительный сайт сети (например, ссылки на страницы в социальных сетях). Адрес страницы с информацией о филиале на сайте сети указывайте в элементе info‑page.

Нет

Нет

info-page

Адрес страницы с информацией о филиале на сайте сети. Убедитесь, что адрес содержит доменное имя сайта сети. Указывается в нижнем регистре, полностью, включая http:// или https://.

Нет

Нет

working-time

Часы работы. Выходные, нерабочие дни не указываются.

Общий график работы (без разного времени для подразделений).

Пример
<working-time lang="ru">ежедн. 11:30-21:30 перерыв 14:00-14:30, перерыв 16:30-17:00</working-time>

Если есть праздничные дни — нужен отдельный элемент scheduled-working-time с точными датами.

Да

Да

scheduled-working-time

График работы в праздничные дни.

Нет

rubric-id

Идентификатор рубрики, к которой относится данный филиал.

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

Нет

Да

actualization-date

Дата актуализации. Соответствует времени последней актуализации данных.

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

Содержимое может быть указано в формате:

  • ДД.ММ.ГГГГ;
  • UNIX‑time — указывается в миллисекундах от 00:00:00.000 01.01.1970.

Нет

Да

coordinates

Составной элемент. Координаты по широте и долготе.

Нет

Да (если адрес неточный)

Элементы, вложенные в coordinates

lon

Координата по долготе. В качестве разделителя целой и дробной части используется точка.

Координаты не должны противоречить адресу. Расхождение адресов и координат допускается только при отсутствии адресной информации на Яндекс Картах.

Координаты должны попадать на здание в Яндекс Картах. Не попадание координат на здание допускается, если здания нет на Яндекс Картах.

Да (если адрес неполный)

lat

Координата по широте. В качестве разделителя целой и дробной части используется точка.

Координаты не должны противоречить адресу. Расхождение адресов и координат допускается только при отсутствии адресной информации на Яндекс Картах.

Координаты должны попадать на здание в Яндекс Картах. Не попадание координат на здание допускается, если здания нет на Яндекс Картах.

Да (если адрес неполный)

photos

Ссылка на галерею или страницу на сайте сети со всеми фотографиями. Если фотографий несколько, каждую из них указывайте в отдельном элементе photo. Может содержать следующие атрибуты:

  • alt — текстовое описание фотографии в свободной форме;
  • type — тип фотографии. Может принимать единственное значение — interior (интерьер).

Нет

Нет

Элементы, вложенные в photos

tag

Тег фотографии. Задается внутри элемента photos. Допустимые значения:

  • INTERIOR — интерьер;
  • EXTERIOR — экстерьер;
  • ENTER — вход;
  • LOGO — логотип;
  • FOOD — блюда и напитки;
  • GOODS — товары;
  • MENU — меню кафе или ресторана;
  • ACCESSIBILITY — пандусы, подъемники для людей с ограниченными возможностями и другое;
  • DEVICES — электронные устройства;
  • SERVICES — услуги.

feature-boolean

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

  • 0 — нет;
  • 1 — да.

Нет

Нет

feature-enum-single

Особенность филиала.

Нет

Нет

feature-enum-multiple

Особенность филиала. Если особенностей несколько, каждую из них указывайте в отдельном элементе.

Нет

Нет

feature-numeric-single

Особенность филиала с числовым значением.

Нет

Нет

feature-numeric-multiple

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

Нет

Нет

feature-in-units-single

Особенность филиала, значение которой определено в единицах измерения.

Нет

Нет

feature-in-units-multiple

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

Нет

Нет

feature-range-single

Особенность филиала, имеющая диапазонное значение.

Нет

Нет

feature-range-in-units-single

Особенность филиала, имеющая диапазонное значение в единицах измерения.

Нет

Нет

feature-range-in-units-multiple

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

Нет

Нет

feature-text-single

Особенность филиала в текстовом формате.

Нет

Нет

Дополнительные атрибуты

Через XML‑файл вы можете передавать дополнительные атрибуты для вашей сети или филиала. Например, указать, есть ли возле вашего торгового центра парковка или в какой валюте можно получить деньги в вашем банкомате.

Чтобы получить XML‑файл со списком возможных атрибутов для вашего вида деятельности:

  1. На странице сети перейдите в раздел Автоматизация.
  2. В блоке Управление филиалами выберите Файл.
  3. Нажмите Выгрузить данные → Выгрузить признаки.

Примечание

Ошибки при заполнении атрибутов не помешают публикации XML-файла в целом, но информация по этим атрибутам не опубликуется.

Пример файла

Примечание

Чтобы открыть описание атрибута из примера файла, нажмите название любого подчеркнутого атрибута.

<?xml version="1.0" encoding="UTF-8"?> 
<companies>
  <company>
    <company-id>770704034</company-id>
    <name lang="ru">Якорь</name>
    <shortname lang="ru">Якорь</shortname>
    <address lang="ru">город Ташкент, просп. Ленина, 101, а</address>
    <country lang="ru">Узбекистан</country>
    <country lang="uz">Oʻzbekiston</country>
    <address-add lang="ru">ТЦ Ромашка, 2 этаж, офис 203</address-add>
    <phone>
      <number>+7 (343) 375-13-99</number>
      <ext>555</ext>
      <info>секретарь</info>
      <type>phone</type>
    </phone>
    <phone>
      <type>phone</type>
      <number>+7 (800) 200-23-45</number>
      <info/>
    </phone>
    <email>info@yakor.uz</email>
    <url>http://www.yakor.uz</url>
    <add-url>http://www.yakor.uz</add-url>
    <info-page>http://www.test.uz/yakor</info-page>
    <working-time lang="ru">ежедн. 10:00-21:00</working-time>
    <rubric-id>184106414</rubric-id>
    <rubric-id>184106394</rubric-id>
    <actualization-date>1511724300</actualization-date>
    <photos gallery-url="http://test.uz/yakor/gallery">
      <photo url="http://test.uz/yakor/11_b.jpg" alt="Ресторан отеля" 
      type="interior"></photo>
      <photo url="http://test.uz/yakor/19_b.jpg">
        <tag>EXTERIOR</tag>
      </photo>
      <photo url="http://test.uz/yakor/25_b.jpg"></photo>
      <photo url="http://test.uz/yakor/26_b.jpg"></photo>
      <photo url="http://test.uz/yakor/17_b.jpg"></photo>
      <photo url="http://test.uz/yakor/drink1.jpg" alt="Коктейль в баре отеля">
        <tag>FOOD</tag>
      </photo>
    </photos>
    <feature-boolean name="internet" value="1"/>
    <feature-enum-single name="star" value="five"/>
    <feature-numeric-single name="room_number" value="15"/>
    <feature-enum-multiple name="hotel_type" value="art_hotel"/>
    <feature-numeric-multiple name="license_number" value="004555"/>
    <feature-in-units-single name="minimum_order" unit="money" unit-value="rub" value="300"/>
    <feature-in-units-multiple name="ats_by_type" unit="apartment_type" unit-value="single" value="200"/>
    <feature-range-single name="number_seats_banquet_hall" from="15" to="20"/>
    <feature-range-in-units-single name="tickets" unit="money" unit-value="rub" from="100" to="150"/>
    <feature-range-in-units-single name="price_1_min" unit="money" unit-value="rub" from="7" to="10"/>
    <feature-range-in-units-multiple name="tea" unit="money" unit-value="rub" from="100" to="300"/>
    <feature-text-single value="Yakor_free_wi-fi" name="ssid"/>
  </company>
  <company>
    <company-id>7707040070</company-id>
    <name lang="ru">Якорьбанк</name>
    <shortname lang="ru">Якорьбанк</shortname>
    <name-other lang="ru">Филиал-2</name-other>
    <address lang="ru">Узбекистан, город Ташкент, улица Паркент, 74</address>
    <phone>
      <ext/><type>phone</type>
      <number>+998 99 999 99 90</number>
      <info/>
    </phone>
    <url>http://www.yakorbank.uz/</url>
    <working-time lang="ru">будни 8:30-18:00, сб 9:00-14:30</working-time>
    <rubric-id>184106974</rubric-id>
    <actualization-date>23.09.2019</actualization-date>
    <coordinates>
      <lon>48.295532</lon>
      <lat>55.616051</lat>
    </coordinates>
  </company>
</companies>

Шаг 2. Загрузите файл на свой сайт

Загрузите файл на свой сайт по обновляемой ссылке. Данные должны быть доступны по протоколу HTTP или HTTPS.

Шаг 3. Укажите ссылку на файл в Яндекс Бизнесе

  1. На странице сети перейдите в раздел Автоматизация.
  2. В блоке Управление филиалами выберите Файл.
  3. Добавьте ссылку на подготовленный файл, выберите тип XML и нажмите Проверить. Проверка файла может занять несколько часов.
  4. Если проверка файла прошла успешно, нажмите кнопку Опубликовать. В открывшемся окне проверьте изменения в филиалах. На карте может быть показано до 50 филиалов с изменениями.
  5. Нажмите Все верно, начать загрузку в базу. Данные из файла пройдут модерацию и будут загружены в базу Яндекс Бизнеса. При большом объеме данных загрузка может занять несколько суток.

Если в результате проверки файла будут обнаружены ошибки, вы увидите сообщение об этом. Исправьте ошибки и снова отправьте файл на проверку.

Чтобы посмотреть изменения в филиалах, загруженные в базу Яндекс Бизнеса из файла, нажмите Посмотреть историю. Кнопка будет доступна спустя сутки после первой загрузки.

Новые филиалы и другие изменения будут доступны в Яндекс Картах в течение нескольких дней.

Письмо в поддержку



Также вы можете перейти на сервис

   



Полезные ссылки

Альтернативное название филиала (если названий несколько, указывайте каждое из них в отдельном элементе). Указывается без кавычек, с учетом регистра.

Корневой атрибут.

Описание филиала. Размещается внутри корневого атрибута. Количество атрибута company может быть произвольным.

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

Название филиала. Указывается без кавычек, с учетом регистра.

Короткое название филиала для отображения около меток в Картах, до 25 символов. Указывается без кавычек, с учетом регистра.

Адрес филиала (одной строкой). Мультиязычный элемент. Если элемент содержит только название улицы и номер дома, используйте элемент locality‑name с указанием населенного пункта.

Страна. Прописывайте название страны полностью, без сокращений.

Дополнительная информация к адресу, которая не относится к другим элементам (название ТЦ/ТРК/ТРЦ, этаж, офис, помещение, бутик, вход). Например, ТЦ Ромашка, 2 этаж, офис 203. Не включает подробное описание маршрута до адреса (100 метров от метро строго на север, синее здание справа от сквера Пушкина). Не используйте скобки и кавычки.

Составной элемент. Номер телефона (если номеров несколько, то каждый указывается в отдельном элементе).

Номер стационарного или мобильного телефона. Указывается в формате: [код страны] ([код города]) [номер телефона].

Добавочный номер, без пояснений, слов и разделителей.

Информация о номере, например: директор, секретарь. Не указывайте в этом элементе информацию о типе телефона.

Тип телефона. Допустимые значения:

  • phone — телефон;

  • fax — факс;

  • phone‑fax — телефон‑факс.

Адрес электронной почты (если адресов несколько, укажите каждый из них в отдельном элементе).

Общий сайт сети. Указывается в нижнем регистре, полностью, включая http:// или https://.

Дополнительный сайт сети (например, ссылки на страницы в социальных сетях). Адрес страницы с информацией о филиале на сайте сети указывайте в элементе info‑page.

Адрес страницы с информацией о филиале на сайте сети. Убедитесь, что адрес содержит доменное имя сайта сети. Указывается в нижнем регистре, полностью, включая http:// или https://.

Часы работы. Выходные, нерабочие дни не указываются.

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

Дата актуализации. Соответствует времени последней актуализации данных. Используется для того, чтобы не скачивалась информация, полученная при предыдущей проверке. Содержимое может быть указано в формате:

  • ДД.ММ.ГГГГ;

  • UNIX‑time — указывается в миллисекундах от 00:00:00.000 01.01.1970.

Ссылка на галерею или страницу на сайте сети со всеми фотографиями. Если фотографий несколько, каждую из них указывайте в отдельном элементе photo. Может содержать следующие атрибуты:

  • alt — текстовое описание фотографии в свободной форме;

  • type — тип фотографии. Может принимать единственное значение — interior (интерьер).

Тег фотографии. Задается внутри элемента photos. Допустимые значения:

  • INTERIOR — интерьер;
  • EXTERIOR — экстерьер;
  • ENTER — вход;
  • LOGO — логотип;
  • FOOD — блюда и напитки;
  • GOODS — товары;
  • MENU — меню кафе или ресторана;
  • ACCESSIBILITY — пандусы, подъемники для людей с ограниченными возможностями и другое;
  • DEVICES — электронные устройства;
  • SERVICES — услуги.

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

  • 0 — нет;
  • 1 — да.

Особенность филиала.

Особенность филиала с числовым значением.

Особенность филиала. Если особенностей несколько, каждую из них указывайте в отдельном элементе.

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

Особенность филиала, значение которой определено в единицах измерения.

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

Особенность филиала, имеющая диапазонное значение.

Особенность филиала, имеющая диапазонное значение в единицах измерения.

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

Особенность филиала в текстовом формате.

Составной элемент. Координаты по широте и долготе.

Координата по долготе. В качестве разделителя целой и дробной части используется точка.

Координата по широте. В качестве разделителя целой и дробной части используется точка.

Предыдущая
Обновление данных вручную
Следующая
Обновление данных через CSV-файл