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

Общие требования

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

   Например:

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

3. Корневой элемент должен иметь следующий вид:

   <companies></companies>

4. Филиалы описываются с помощью элементов company, которые размещаются внутри корневого элемента. Количество элементов company может быть произвольным.
5. Каждое свойство филиала следует обернуть в отдельный элемент. Подробнее см. в разделе Описание элементов.

   В данном примере выделен сайт:

   <url>http://www.yakor-anapa.ru</url>

6. Основные и дополнительные элементы должны быть расположены так же, как в примере и таблице с описанием элементов.
7. Для каждого филиала обязательно должны быть указаны:

   • уникальный неизменный идентификатор — элемент company-id;
   • название — элемент name;
   • полный адрес местонахождения, с точностью до дома;
   • время работы — элемент working-time;
   • рубрика (вид деятельности);
   • сайт — элемент url;
   • дата актуализации XML-файла — элемент actualization-date;
   • координаты (для филиалов без точного адреса) — элемент coordinates.

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

   Примечание. Индекс передавать не нужно.
8. Если для одного свойства есть несколько значений (например, телефонов), необходимо передавать несколько элементов с одинаковыми именами.
9. В файле можно передавать только те элементы, которые указаны в подразделе Описание элементов.
10. Некоторые элементы могут быть мультиязычными. К ним относятся элементы name, name-other, address, country, address-add, working-time. Атрибут lang может принимать следующие значения:

    • ru — русский язык;
    • ua — украинский язык;
    • by — белорусский язык;
    • kz — казахский язык;
    • en — английский язык.
11. Чтобы информация о сети компаний была полной, передавайте максимальный набор элементов для каждого филиала сети (в том числе дополнительные элементы).
12. Каждый филиал должен быть представлен в отдельной карточке: для каждого филиала должен быть указан свой идентификатор с отдельным набором элементов.
13. В данных не должно быть HTML-элементов. В стандарте XML недопустимы символы с ASCII-кодами в диапазоне значений от 0 до 31 в текстовых полях. Исключением являются значения 9, 10, 13 — табуляция, перевод строки, возврат каретки. Также этот стандарт строго требует заменять в тексте некоторые символы: & на &.

Адрес

Укажите полный адрес одной строкой в элементе address, страну — в элементе country, название торгового центра, бизнес-центра, номер офиса, этаж — в элементе address-add.

<address lang="ru">город Екатеринбург, просп. Ленина, 101, а</address>
<country lang="ru">Россия</country>
<address-add lang="ru">ТЦ Ромашка, 2 этаж, офис 203</address-add>

Рубрика

Чтобы указать рубрику, используйте идентификаторы рубрик Яндекс Бизнеса.

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

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

Эта информация передается с помощью дополнительных элементов. Чтобы получить XML-файл со списком возможных элементов для вашей рубрики:

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

Если есть вопросы по выгрузке файла с дополнительными параметрами, напишите на partner@sprav.yandex.ru.

Пример 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>
        <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>
        <inn>123456789123</inn> 
        <ogrn>9876543219876</ogrn>
        <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 url="http://test.ru/yakor-anapa/19_b.jpg" type="exterior"/>
            <photo url="http://test.ru/yakor-anapa/25_b.jpg"/>
            <photo url="http://test.ru/yakor-anapa/26_b.jpg"/>
            <photo url="http://test.ru/yakor-anapa/17_b.jpg"/>
            <photo url="http://test.ru/yakor-anapa/drink1.jpg" alt="Коктейль в баре отеля" type="food"/>
        </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-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">Якорьбанк, платёжное устройство</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>

Описание элементов

<company-id>770704034</company-id> 

<name lang="ru">Якорь</name>

<shortname lang="ru">Якорь</shortname>

<name-other lang="ru">ИП Иванов</name-other>

<address lang="ru">город Екатеринбург, 
проспект Ленина, 101а</address>

<address lang="ru">проспект Ленина, 101а</address>
 <locality-name lang="ru">город Екатеринбург</locality-name>

<country lang="ru">Россия</country>

<address-add lang="ru">БЦ Бенуа, этаж 5, офис 547</address-add>

<coordinates>
   <lon>34.427524546763365</lon>
   <lat>53.219950313883814</lat>
</coordinates> 

<lon>34.427524546763365</lon> 

<lat>53.219950313883814</lat>

<phone>
   <number>8 (800) 200-23-45</number>
   <ext>555</ext> <type>phone</type>
   <info>секретарь</info>
</phone>

<number>8 (800) 200-23-45</number>

<number>+7 (3456) 23-45-67</number>

<ext>555</ext>

<info>секретарь</info>

<type>phone</type>

<email>info@yakor-anapa.ru</email>

<url>http://www.yakor-anapa.ru</url>

<add-url>http://www.fb.com/anchor-hotel</add-url>

<info-page>http://www.yakor-anapa.ru/branch1/photos</info-page>

<working-time lang="ru">ежедн. 10:00-21:00</working-time>

<working-time lang="ru">пн-пт 9:00-19:00, сб-вс 10:00-18:00
</working-time>

<working-time lang="ru">пн-пт: 10:00-19:00, обед 13:00-14:00; 
сб: 10:30-16:00, обед 13:00-13:30</working-time>

<working-time lang="ru">пн-пт: 08:00-17:00, 
перерыв: 12:00-13:00</working-time>

<working-time lang="ru">круглосуточно</working-time>

<rubric-id>184106414</rubric-id>
<rubric-id>184106394</rubric-id>

<inn>123456789123</inn>

<ogrn>9876543219876</ogrn>

<actualization-date>13.11.2017</actualization-date>

<actualization-date>1511724300000</actualization-date>

<photos gallery-url="http://test.ru/yakor-anapa/gallery">
<photo url="http://test.ru/yakor-anapa/11_b.jpg" 
 alt="Ресторан отеля" type="interior">
<tag>ENTER</tag></photo>
</photos>

<photos gallery-url="http://test.ru/yakor-anapa/gallery">
<photo url="http://test.ru/yakor-anapa/drink1.jpg" 
alt="Коктейль в баре отеля" type="food"/>
</photos>

<photos> 
 <photo url="http://test.ru/yakor-anapa/11_b.jpg" 
  alt="Ресторан отеля" type="interior"/>
 <photo url="http://test.ru/yakor-anapa/11_b.jpg" 
  alt="Ресторан отеля" type="enter"/>
 <photo url="http://test.ru/yakor-anapa/11_b.jpg" 
  alt="Ресторан отеля" type="exterior"/>
</photos>

<feature-boolean name="wi_fi"   value="1"/> 

<feature-enum-single name="theater_type" value="absurdist_theatre"/>

<feature-enum-multiple name="tour_type" value="bus_tour"/>

<feature-numeric-single name="number_of_screen"  value="3"/> 

<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-multiple 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="women_haircut" 
unit="money" unit-value="rub" from="1000" to="3000"/> 

<feature-text-single value="Yakor_free_wi-fi" name="ssid"/>

<company-id>770704034</company-id> 

<name lang="ru">Якорь</name>

<shortname lang="ru">Якорь</shortname>

<name-other lang="ru">ИП Иванов</name-other>

<address lang="ru">город Екатеринбург, 
проспект Ленина, 101а</address>

<address lang="ru">проспект Ленина, 101а</address>
 <locality-name lang="ru">город Екатеринбург</locality-name>

<country lang="ru">Россия</country>

<address-add lang="ru">БЦ Бенуа, этаж 5, офис 547</address-add>

<coordinates>
   <lon>34.427524546763365</lon>
   <lat>53.219950313883814</lat>
</coordinates> 

<lon>34.427524546763365</lon> 

<lat>53.219950313883814</lat>

<phone>
   <number>8 (800) 200-23-45</number>
   <ext>555</ext> <type>phone</type>
   <info>секретарь</info>
</phone>

<number>8 (800) 200-23-45</number>

<number>+7 (3456) 23-45-67</number>

<ext>555</ext>

<info>секретарь</info>

<type>phone</type>

<email>info@yakor-anapa.ru</email>

<url>http://www.yakor-anapa.ru</url>

<add-url>http://www.fb.com/anchor-hotel</add-url>

<info-page>http://www.yakor-anapa.ru/branch1/photos</info-page>

<working-time lang="ru">ежедн. 10:00-21:00</working-time>

<working-time lang="ru">пн-пт 9:00-19:00, сб-вс 10:00-18:00
</working-time>

<working-time lang="ru">пн-пт: 10:00-19:00, обед 13:00-14:00; 
сб: 10:30-16:00, обед 13:00-13:30</working-time>

<working-time lang="ru">пн-пт: 08:00-17:00, 
перерыв: 12:00-13:00</working-time>

<working-time lang="ru">круглосуточно</working-time>

<rubric-id>184106414</rubric-id>
<rubric-id>184106394</rubric-id>

<inn>123456789123</inn>

<ogrn>9876543219876</ogrn>

<actualization-date>13.11.2017</actualization-date>

<actualization-date>1511724300000</actualization-date>

<photos gallery-url="http://test.ru/yakor-anapa/gallery">
<photo url="http://test.ru/yakor-anapa/11_b.jpg" 
 alt="Ресторан отеля" type="interior">
<tag>ENTER</tag></photo>
</photos>

<photos gallery-url="http://test.ru/yakor-anapa/gallery">
<photo url="http://test.ru/yakor-anapa/drink1.jpg" 
alt="Коктейль в баре отеля" type="food"/>
</photos>

<photos> 
 <photo url="http://test.ru/yakor-anapa/11_b.jpg" 
  alt="Ресторан отеля" type="interior"/>
 <photo url="http://test.ru/yakor-anapa/11_b.jpg" 
  alt="Ресторан отеля" type="enter"/>
 <photo url="http://test.ru/yakor-anapa/11_b.jpg" 
  alt="Ресторан отеля" type="exterior"/>
</photos>

<feature-boolean name="wi_fi"   value="1"/> 

<feature-enum-single name="theater_type" value="absurdist_theatre"/>

<feature-enum-multiple name="tour_type" value="bus_tour"/>

<feature-numeric-single name="number_of_screen"  value="3"/> 

<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-multiple 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="women_haircut" 
unit="money" unit-value="rub" from="1000" to="3000"/> 

<feature-text-single value="Yakor_free_wi-fi" name="ssid"/>