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.
- General requirements
- Address
- Category
- Additional parameters
- Example of an XML file
- Element descriptions
- File verification
General requirements
- The XML file must be UTF-8 encoded.
The standard XML header must start from the first line, from the zero character.
For example:<?xml version="1.0" encoding="UTF-8"?>
- The root element must look as follows:
<companies></companies>
- Branches are described using
company
elements that are nested in the root element. There can be any number ofcompany
elements. 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>
- Main and additional elements should be arranged in the same way as in the example and in the element description table.
- 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.Note. You don't have to pass the postal code. - If a property has multiple values (for example, phone numbers), pass several elements with the same name.
- You can pass only elements specified in the Description of the elements section.
Some elements may be multilingual. These include the
name
,name-other
,address
,country
,address-add
, andworking-time
elements. Thelang
attribute can take the following values:ru
— Russian.ua
— Ukrainian.by
— Belarusian.kz
— Kazakh.
- To ensure that the information about your chain is complete, pass the maximum set of elements for each branch (including additional elements).
- Each branch should be in a separate profile. A branch should have its own ID with a separate set of elements.
- 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. | |
name | Name of the branch. Specified without quotation marks, case-sensitive. Multilingual element. | |
name-other | Alternative name of the branch (if there are several names, each one is specified in a separate element). Multilingual element. | |
address | The branch address (on one line). Multilingual element. Note. If the element contains only the street name and house number, use the locality-name element specifying the city, town or village. | |
country | Country. Specified in full, without abbreviations. Multilingual element. | |
address-add | Additional address information that doesn't apply to other elements. Multilingual element. | |
coordinates | Compound element. Coordinates (latitude and longitude). | |
lon | Longitude. Use a dot as as the decimal delimiter. | |
lat | Latitude. Use a dot as as the decimal delimiter. | |
phone | Compound element. Phone number (if there are several phone numbers, specify each one in a separate element). | |
number | The landline or mobile phone number. The format is [country code] ([city code]) [phone number]. | |
ext | Extension, without comments, words, or delimiters. | |
info | Information about the phone number, such as "director" or "reception". Note. This element shouldn't contain information about the phone type. | |
type | Phone type. One of three possible values:
| |
email | Email address (if there are several addresses, specify each one in a separate element). | |
url | The main website of the chain. Specified in lowercase, in full, including http:// or https://. | |
add-url | Additional website of the chain (such as links to social media pages or branch pages). Note. The URL of the page with chain information on the partner's website is specified in the info-page element. | |
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://. Note. The address must contain the domain name of the partner's website. | |
working-time | Business hours. Days off and non-working days aren't specified. Multilingual element. | |
rubric-id | ID of the category to which this branch belongs (if there are several categories, each one is specified in a separate element). Note. 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. | |
inn | Company's INN (TIN) | |
ogrn | Company's OGRN (business registration number) | |
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:
| |
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 The
| |
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-enum-single | Branch property. | Theater type — Theater of the Absurd: |
feature-enum-multiple | Branch property. If there are several properties, each one is specified in a separate element. | Tour type — Bus tour: |
feature-numeric-single | A branch property with a numeric value. | The branch has three TVs: |
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-in-units-single | A branch property whose value is defined in units. | The minimum order amount for delivery is 300 rubles: |
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-range-single | A branch property that has a range value. | The branch has an events hall for 15-20 seats: |
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-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-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-text-single | A branch property in text format. | The free Wi-Fi login in the Anchor hotel is “ssid” |
Name | Description | Example |
---|---|---|
company-id | Unique branch ID (assigned by the chain owner). Can contain numbers and Latin letters. | |
name | Name of the branch. Specified without quotation marks, case-sensitive. Multilingual element. | |
name-other | Alternative name of the branch (if there are several names, each one is specified in a separate element). Multilingual element. | |
address | The branch address (on one line). Multilingual element. Note. If the element contains only the street name and house number, use the locality-name element specifying the city, town or village. | |
country | Country. Specified in full, without abbreviations. Multilingual element. | |
address-add | Additional address information that doesn't apply to other elements. Multilingual element. | |
coordinates | Compound element. Coordinates (latitude and longitude). | |
lon | Longitude. Use a dot as as the decimal delimiter. | |
lat | Latitude. Use a dot as as the decimal delimiter. | |
phone | Compound element. Phone number (if there are several phone numbers, specify each one in a separate element). | |
number | The landline or mobile phone number. The format is [country code] ([city code]) [phone number]. | |
ext | Extension, without comments, words, or delimiters. | |
info | Information about the phone number, such as "director" or "reception". Note. This element shouldn't contain information about the phone type. | |
type | Phone type. One of three possible values:
| |
email | Email address (if there are several addresses, specify each one in a separate element). | |
url | The main website of the chain. Specified in lowercase, in full, including http:// or https://. | |
add-url | Additional website of the chain (such as links to social media pages or branch pages). Note. The URL of the page with chain information on the partner's website is specified in the info-page element. | |
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://. Note. The address must contain the domain name of the partner's website. | |
working-time | Business hours. Days off and non-working days aren't specified. Multilingual element. | |
rubric-id | ID of the category to which this branch belongs (if there are several categories, each one is specified in a separate element). Note. 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. | |
inn | Company's INN (TIN) | |
ogrn | Company's OGRN (business registration number) | |
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:
| |
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 The
| |
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-enum-single | Branch property. | Theater type — Theater of the Absurd: |
feature-enum-multiple | Branch property. If there are several properties, each one is specified in a separate element. | Tour type — Bus tour: |
feature-numeric-single | A branch property with a numeric value. | The branch has three TVs: |
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-in-units-single | A branch property whose value is defined in units. | The minimum order amount for delivery is 300 rubles: |
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-range-single | A branch property that has a range value. | The branch has an events hall for 15-20 seats: |
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-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-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-text-single | A branch property in text format. | The free Wi-Fi login in the Anchor hotel is “ssid” |
File verification
On the XSD validator page of the Yandex.Webmaster service, you can check the file you prepared.
Choose the Business 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.