Updating data via XML files

If you have more than 30 branches in your chain, you can update Yandex Business Directory data using XML files. You can transmit all the information about branches, including photos and additional parameters.

To pass information, create an XML file and upload it to your website using an updatable link. The data must be accessible via HTTP or HTTPS protocol.

The transmitted data must comply with the XML format specification.

  1. General requirements
  2. Address
  3. Category
  4. Additional parameters
  5. Example of an XML file
  6. Element descriptions
  7. File verification

General requirements

  1. The XML file must be UTF-8 encoded.
  2. The standard XML header must start from the first line, from the zero character.

    For example:
    <?xml version="1.0" encoding="UTF-8"?>
  3. The root element must look as follows:
    <companies></companies>
  4. Branches are described using company elements that are nested in the root element. There can be any number of company elements.
  5. Each branch property should be wrapped in a separate element. For more information, see Description of elements.

    In this example, the site is wrapped:

    <url>http://www.yakor-anapa.ru</url>
  6. Main and additional elements should be arranged in the same way as in the example and in the element description table.
  7. For each branch, you should specify:
    • A unique ID in the company-id element.
    • The name in the name element.
    • The full location address, including the building number.
    • The opening hours in the working-time element.
    • The site in the url element.
    • The date when the XML file was updated in the actualization-date element.
    • Coordinates (for branches without an exact address) in the coordinates element.

    To allow users to edit the information about your organization, enter the phone number in the phone element.

    Примечание. You don't have to pass the postal code.
  8. If a property has multiple values (for example, phone numbers), pass several elements with the same name.
  9. You can pass only elements specified in the Description of the elements section.
  10. Some elements may be multilingual. These include the name, name-other, address, country, address-add, and working-time elements. The lang attribute can take the following values:

    • ru — Russian.
    • ua — Ukrainian.
    • by — Belarusian.
    • kz — Kazakh.
  11. To ensure that the information about your chain is complete, pass the maximum set of elements for each branch (including additional elements).
  12. Each branch should be in a separate profile. A branch should have its own ID with a separate set of elements.
  13. The data shouldn't contain HTML elements. The XML standard doesn't allow ASCII characters in the 0 to 31 value range in text fields. The exceptions are values 9, 10, 13, tab, newline, and carriage return. This standard also requires replacing some symbols in the text: & with &.

Address

Specify the full address in one line in the address element, the country in the country element, and the name of the shopping or business center, office number, or floor in the address-add element.

<address lang="en">Yekaterinburg, Lenin Avenue, 101, а</address>
<country lang="en">Russia</country>
<address-add lang="en">Romashka Mall, 2nd floor, office 203</address-add>​

Category

To specify a category, use Yandex Business Directory category IDs.

Additional parameters

You can pass additional parameters for your chain or branch using an XML file. For example, you can specify if there is parking available near your shopping center or which currency can be withdrawn from your ATM.

This information is passed in additional elements. To get an XML file with a list of possible elements for your category, write to partner@sprav.yandex.ru.

Example of an XML file

<?xml version="1.0" encoding="UTF-8"?> 
<companies>
    <company>
        <company-id>770704034</company-id>
        <name lang="en">Anchor</name>
        <address lang="en">Yekaterinburg Lenin Avenue, 101, a</address>
        <country lang="en">Russia</country>
        <address-add lang="en">Romashka Mall, 2nd floor, office 203</address-add>
        <phone>
            <number>+7 (343) 375-13-99</number>
            <ext>555</ext>
            <info>secretary</info>
            <type>phone</type>
        </phone>
        <phone>
            <ext /><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="en">every day. 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="Hotel restaurant" 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="Cocktail in bar hotel" 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>
</companies>

Element descriptions

Name Description Example
company-id Unique branch ID (assigned by the chain owner). Can contain numbers and Latin letters.
<company-id>770704034</company-id> 
name Name of the branch. Specified without quotation marks, case-sensitive. Multilingual element.
<name lang="en">Anchor</name>
name-other Alternative name of the branch (if there are several names, each one is specified in a separate element). Multilingual element.
<name-other lang="en">SP Ivanov</name-other>
address The branch address (on one line). Multilingual element.
Примечание. If the element contains only the street name and house number, use the locality-name element specifying the city, town or village.
<address lang="en">Yekaterinburg, Lenin Avenue, 101a</address>  
<address lang="en">Lenin Avenue, 101а</address><locality-name lang="en">Yekaterinburg</locality-name>
country Country. Specified in full, without abbreviations. Multilingual element.
<country lang="en">Russia</country>
address-add Additional address information that doesn't apply to other elements. Multilingual element.
<address-add lang="en">Benua business center, 5th floor, office 547</address-add>
coordinates Compound element. Coordinates (latitude and longitude).
<coordinates><lon>34.427524546763365</lon> <lat>53.219950313883814</lat></coordinates> 
lon Longitude. Use a dot as as the decimal delimiter.
<lon>34.427524546763365</lon> 
lat Latitude. Use a dot as as the decimal delimiter.
<lat>53.219950313883814</lat>
phone Compound element. Phone number (if there are several phone numbers, specify each one in a separate element).
<phone><number>8 (800) 200-23-45</number><ext>555</ext> <type>phone</type><info>secretary</info></phone>
number The landline or mobile phone number. The format is [country code] ([city code]) [phone number].
<number>8 (800) 200-23-45</number>
<number>+7 (3456) 23-45-67</number>
ext Extension, without comments, words, or delimiters.
<ext>555</ext>
info Information about the phone number, such as "director" or "reception".
Примечание. This element shouldn't contain information about the phone type.
<info>секретарь</info>
type Phone type. One of three possible values:
  • phone — Phone number.
  • fax — Fax number.
  • phone-fax — Phone/fax number.
<type>phone</type>
email Email address (if there are several addresses, specify each one in a separate element).
<email>info@yakor-anapa.ru</email>
url The main website of the chain. Specified in lowercase, in full, including http:// or https://.
<url>http://www.yakor-anapa.ru</url>
add-url Additional website of the chain (such as links to social media pages or branch pages).
Примечание. The URL of the page with chain information on the partner's website is specified in the info-page element.
<add-url>http://www.yakor-anapa.ru/branche1.html</add-url>
info-page URL of the page with chain information on the Yandex Business Directory partner's website. Specified in lowercase, in full, including http:// or https://.
Примечание. The address must contain the domain name of the partner's website.
<info-page>http://leclick.ru/restaurant/russia/moscow/svetliy/photos</info-page>
working-time Business hours. Days off and non-working days aren't specified. Multilingual element.
<working-time lang="en">every day. 10:00-21:00</working-time>
<working-time lang="en">Mon-Fri 9:00-19:00, Sa-Su 10:00-18:00</working-time>
rubric-id ID of the category to which this branch belongs (if there are several categories, each one is specified in a separate element).
Примечание. A branch may have up to three categories, but at least one of them should match the chain category.
To get a list of categories, write to partner@sprav.yandex.ru.
<rubric-id>184106414</rubric-id>
<rubric-id>184106394</rubric-id>
inn Company's INN (TIN)
<inn>123456789123</inn>
ogrn Company's OGRN (business registration number)
<ogrn>9876543219876</ogrn>
actualization-date

Date updated. Corresponds to the time of the last update. Used to avoid downloading information received during the previous check.

The content can be specified in the following format:

  • DD.MMM.YYYY.
  • UNIX time. Specified in milliseconds from 00:00:00.000 01.01.1970.
<actualization-date>13.11.2017</actualization-date>
<actualization-date>1511724300</actualization-date>
photos

A link to the gallery or a page on the chain website with all photos. If there are several photos, each one is specified in a separate photo element.

The photo element can contain the following attributes:

  • alt — Text description of the photo in free form.
  • type — Photo type.
    • exterior — Exterior.
    • interior — Interior.
    • food — Food, drinks.
<photos gallery-url="http://test.ru/yakor-anapa/gallery">
<photo url="http://test.ru/yakor-anapa/11_b.jpg" alt="Hotel restaurant" type="interior"/>
</photos>
<photos gallery-url="http://test.ru/yakor-anapa/gallery">
<photo url="http://test.ru/yakor-anapa/drink1.jpg" alt="Cocktail in hotel bar" type="food"/>
</photos>
Additional elements
feature-boolean Branch property. Can have two values: 1 (Yes) or 0 (No). If there are several properties, each one is specified in a separate element.

The branch has a Wi-Fi network:

<feature-boolean name="wi_fi"   value="1"/> 
feature-enum-single Branch property.

Theater type — Theater of the Absurd:

<feature-enum-single name="theater_type" value="absurdist_theatre"/>
feature-enum-multiple Branch property. If there are several properties, each one is specified in a separate element.

Tour type — Bus tour:

<feature-enum-multiple name="tour_type" value="bus_tour"/>
feature-numeric-single A branch property with a numeric value.

The branch has three TVs:

<feature-numeric-single name="number_of_screen"  value="3"/> 
feature-numeric-multiple A branch property with a numeric value. If there are several properties, each one is specified in a separate element.

The license number:

<feature-numeric-multiple name="license_number" value= "004555"/>
feature-in-units-single A branch property whose value is defined in units.

The minimum order amount for delivery is 300 rubles:

<feature-in-units-single name="minimum_order"  unit="money"  unit-value="rub"  value="300"/> 
feature-in-units-multiple A branch property whose value is defined in units. If there are several properties, each one is specified in a separate element.

The hotel has 200 single rooms:

<feature-in-units-multiple name="ats_by_type"  unit="apartment_type"  unit-value="single" value="200"/>
feature-range-single A branch property that has a range value.

The branch has an events hall for 15-20 seats:

<feature-range-single name="number_seats_banquet_hall" from="15"  to="20"/> 
feature-range-multiple A branch property that has a range value. If there are several properties, each one is specified in a separate element.

The ticket price is from 100 to 150 rubles:

<feature-range-multiple name="tickets"  unit="money" unit-value="rub" from="100" to="150"/>
feature-range-in-units-single A branch property that has a range value in units.

The price per minute is 7-10 rubles:

<feature-range-in-units-single name="price_1_min"  unit="money" unit-value="rub" from="7" to="10"/> 
feature-range-in-units-multiple A branch property that has a range value in units. If there are several properties, each one is specified in a separate element.

The price for a women's haircut with styling is from 1000 to 3000 rubles.

<feature-range-in-units-multiple name="women_haircut" unit="money" unit-value="rub" from="1000" to="3000"/> 
feature-text-single A branch property in text format.

The free Wi-Fi login in the Anchor hotel is «ssid»

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

File verification

On the XSD validator page of the Yandex.Webmaster service, you can check the file you prepared.

Choose the Справочник (Yandex Business Directory) document validation scheme, then choose the XML data source for validation (file, link or text).

After verification, send us the file link to enable daily data updates.