Как обновлять данные сети через файл XML

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

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

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

Требования к файлу

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

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

    Например:

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

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

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

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

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

    Пример
    <address lang="ru">город Екатеринбург, просп. Ленина, 101, а</address>
<address lang="en">Ekaterinburg, prosp. Lenina, 101, a</address>

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

  5. В данных не должно быть HTML‑признаков. В стандарте XML недопустимы символы с ASCII‑кодами в диапазоне значений от 0 до 31 в текстовых полях. Исключениями являются значения 9 (табуляция), 10 (перевод строки), 13 (возврат каретки). Также по стандарту XML нужно заменять символ & на &amp;.

Описание признаков

Признак

Описание

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

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

companies

Корневой признак.

Н/п

Да

company

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

Н/п

Да

company-id

Уникальный неизменный идентификатор филиала (присваивается владельцем сети). Может содержать произвольный набор цифр и латинских букв.

Нет

Да

name

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

Да

Да

shortname

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

Да

Нет

name-other

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

Да

Нет

address

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

Да

Да

country

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

Да

Нет

address-add

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

Да

Нет

phone

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

Нет

Да

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

number

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

ext

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

info

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

type

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

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

email

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

Нет

Нет

url

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

Нет

Да

add-url

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

Нет

Нет

info-page

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

Нет

Нет

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 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>
    <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-anapa.ru</email>
    <url>http://www.yakor-anapa.ru</url>
    <add-url>http://www.yakoranapa.ru</add-url>
    <info-page>http://www.test.ru/yakor-anapa</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.ru/yakor-anapa/gallery">
      <photo url="http://test.ru/yakor-anapa/11_b.jpg" alt="Ресторан отеля" 
      type="interior"></photo>
      <photo url="http://test.ru/yakor-anapa/19_b.jpg">
        <tag>EXTERIOR</tag>
      </photo>
      <photo url="http://test.ru/yakor-anapa/25_b.jpg"></photo>
      <photo url="http://test.ru/yakor-anapa/26_b.jpg"></photo>
      <photo url="http://test.ru/yakor-anapa/17_b.jpg"></photo>
      <photo url="http://test.ru/yakor-anapa/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">Россия, Республика Татарстан, Зеленодольский район, село Нурлаты, улица Гагарина, 46</address>
    <phone>
      <ext/><type>phone</type>
      <number>+7 (800) 999-99-90</number>
      <info/>
    </phone>
    <url>http://www.yakorbank.ru/</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>

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

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

  • Самостоятельно на своем компьютере с помощью схемы (XML Schema Definition).

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

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

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

  1. На странице сети перейдите в раздел Филиалы.

  2. В блоке Управление филиалами выберите Файл.

  3. Добавьте ссылку на подготовленный файл, выберите тип XML и нажмите Проверить. Проверка файла может занять несколько часов.

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

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

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

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

Чат с поддержкой



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

   



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

Правовые документы

Условия размещения. Приоритетное размещение в Бизнесе
  • статус;
  • название;
  • телефоны;
  • сайты;
  • вид деятельности;
  • услуги;
  • электронная почта;
  • график работы;
  • режим работы на дату.
  • Данные о ваших филиалах будут всегда актуальны во всех сервисах и мобильных приложениях Яндекса. Ваши потенциальные клиенты смогут легко добраться до ближайшего филиала с помощью Яндекс Карт, Яндекс Навигатора, найти филиал в Поиске и других сервисах Яндекса.
  • Вы можете полностью автоматизировать передачу данных о филиалах, настроив выгрузку данных из своей базы 1С, ERP (SAP, Axapta) или других систем.
  • Через XML‑файл вы можете передавать полную информацию о филиалах, в том числе фотографии и дополнительные параметры.

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

Корневой признак.

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

Уникальный неизменный идентификатор филиала (присваивается владельцем сети). Может содержать произвольный набор цифр и латинских букв.

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

Короткое название филиала для отображения около меток в Картах, до 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