How to update chain information

You can update chain information manually or with XML and CSV files.

Add a branch to the chain

  1. On the Businesses page, click next to the name of the chain and select Add a branch to the chain.

  2. In the window that opens, select a branch from the list and click Add to chain.

You can also add a branch in the chain card. To do so, go to Branches and click Add branch.

Create a branch

  1. On the Businesses page, click next to the name of the chain and select Create branch.

  2. In the window that opens, enter the address, phone number, and business hours for the branch.

You can also create a branch in the chain card. To do so, go to Branches and click Create branch.

Edit branch information

You can edit branch-information in the Branches section. To do this:

  1. Go to the chain page and select the desired branches or the entire chain in the Branches section.

  2. Click Edit and select the data from the list that you want to change.

  3. In the window that opens, you can add or delete information about branches. For example, if you select Phones and delete a phone number from the suggested list, it will be deleted in all the branches you selected.

You can also edit photos and other data in the branch card. To do this:

  1. Go to the branch card.

  2. Click Edit data.

  3. Make the changes.

  4. Click Save.

Remove a branch

  1. Go to Branches.

  2. Select one or more branches.

  3. Click Exclude from chain or Delete.

    Exclude from chain: The branch will be excluded from the chain and closed on Yango Maps, and you will lose access to its card.

    Delete: The branch will remain part of the chain but will be closed on Yango Maps, and you will lose access to its card.

If you have more than 30 branches in your chain, we recommend updating chain information in Yango for Business using XML files.

Data about your branches will be updated based on the information in the XML file. New branches will be added to the database and shown in services with their attributes. Branch cards whose details weren't added to the XML file will be closed.

Step 1. Prepare an XML file

Each branch must have its own identifier (company-id) and set of attributes. For example, the X branch ID is <company-id>1234</company-id>, while the Y branch ID is <company-id>5678</company-id>.

To ensure that the information about your chain is complete, pass the maximum set of attributes for each branch (including additional attributes).

File 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 elements must look like this:

    <companies></companies>
    
  4. Branches are described using company attributes nested in the root element. There can be any number of company attributes.

  5. Each branch property should be wrapped in a separate attribute.

  6. Main and additional attributes should be arranged the same as in the example. You can only pass these attributes.

  7. Each branch description must contain the company-id, name, address, rubric-id, working-time, url, actualization-date, coordinates, and phone attributes.

    To allow users to edit the information about your company, enter the phone number in the phone attribute.

  8. If a property has multiple values (for example, phone numbers), pass multiple attributes with the same name.

  9. Some attributes may be multilingual. These include name, name-other, address, country, address-add, and working-time.

    You can find the current lang values in the XML schema. To add other languages, contact support.

  10. The data shouldn't contain HTML attributes. The XML standard doesn't allow ASCII characters in the 0-31 value range in text fields. The exceptions are values 9 (tab), 10 (newline), and 13 (carriage return). This standard also requires replacing the & symbol with &.

Additional attributes

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

Here's how to get an XML file with a list of possible attributes for your type of business:

  1. On the chain page, go to Branches.

  2. Under Branch management, choose File.

  3. Click Download data → Download attributes.

If you have questions about downloading the file with additional parameters, contact us.

Sample file
How to view an attribute description

Click any highlighted attribute to open its description.

<?xml version="1.0" encoding="UTF-8"?> 
<companies>
  <company>
    <company-id>770704034</company-id>
    <name lang="en">Anchor</name>
    <shortname lang="en">Anchor</shortname>
    <address lang="en">London, 101a Baker Street</address>
    <country lang="en">United Kingdom</country>
    <address-add lang="en">Roza Business Center, 2nd floor, office 203</address-add>
    <phone>
      <number>020 1234 5678</number>
      <ext>555</ext>
      <info>secretary</info>
      <type>phone</type>
    </phone>
    <phone>
      <type>phone</type>
      <number>034 2202 3303</number>
      <info/>
    </phone>
    <email>info@anchor.com</email>
    <url>http://www.anchor.com</url>
    <add-url>http://www.anchor.com</add-url>
    <info-page>http://www.test.com/anchor</info-page>
    <working-time lang="en">daily 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.com/anchor/gallery">
      <photo url="http://test.com/anchor/11_b.jpg" alt="Hotel restaurant" 
      type="interior"></photo>
      <photo url="http://test.com/anchor/19_b.jpg">
        <tag>EXTERIOR</tag>
      </photo>
      <photo url="http://test.com/anchor/25_b.jpg"></photo>
      <photo url="http://test.com/anchor/26_b.jpg"></photo>
      <photo url="http://test.com/anchor/17_b.jpg"></photo>
      <photo url="http://test.com/anchor/drink1.jpg" alt="Cocktail at the hotel bar">
        <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="gbp"  value="30"/>
    <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="gbp" from="10" to="15"/>
    <feature-range-in-units-single name="price_1_min" unit="money" unit-value="gbp" from="7" to="10"/>
    <feature-range-in-units-multiple name="tea" unit="money" unit-value="gbp" from="100" to="300"/>
    <feature-text-single value="Anchor_free_wi-fi" name="ssid"/>
  </company>
  <company>
    <company-id>7707040070</company-id>
    <name lang="en">Anchorbank</name>
    <shortname lang="en">Anchorbank</shortname>
    <name-other lang="en">Anchorbank, ATM</name-other>
    <address lang="en">United Kingdom, Merseyside County, Liverpool, 46 Matthew Street</address>
    <phone>
      <ext/><type>phone</type>
      <number>040 9988 7444</number>
      <info/>
    </phone>
    <url>http://www.anchorbank.com/</url>
    <working-time lang="en">Weekday 8:30-18:00, Sat 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>

The file can be checked manually on your computer using the schema (XML Schema Definition).

Step 2. Upload the file to your website

Upload the file to your website using an updatable link. The data must be accessible via HTTP or HTTPS.

  1. On the chain page, go to Branches.

  2. Under Branch management, choose File.

  3. Add a link to the file, select the XML type, and click Check. Checking the file may take several hours.

  4. If the file is verified successfully, click Publish. In the window that opens, check the changes in the branches. The map can show up to 50 branches with changes. Click Yes, start the upload. The file data will be moderated and uploaded to the Yango for Business database. If the file is large, the data upload may take several days.

    If errors are found when checking the file, you'll see an error message. Fix the errors and re-submit the file for review.

To view the branch changes uploaded to the Yango for Business database from the file, click Upload history. The button will be available 24 hours after the first upload.

Yango Maps will show new branches and other changes in a few days.

CSV is a text format designed to represent tabular data. The first row contains column names, with the data itself in the following rows. The contents of the columns are separated from each other by a comma.

File data must be UTF-8 encoded.

You can download an example of a CSV file.

To see the example in LibreOffice, import the text: select UTF-8 encoding, comma as a delimiter, and double quotes as a text qualifier.

To see the example in Excel, open it in Data → Get external data → From text. Select UTF-8 encoding, comma as a delimiter, and double quotes as a text qualifier.

Step 1. Prepare a CSV file

To set up automatic daily updates for branch data, create a CSV file. The data must be UTF-8 encoded.

Attribute

Description

name

Name of the branch. Specified without quotation marks, case-sensitive.

Mandatory attribute.

country

Country. Specified in full, without abbreviations.

Mandatory attribute.

address

The full address for the branch, including the building number.

Mandatory attribute.

address-add

Additional address information.

phone

A phone number with the country and area code. If there are multiple phone numbers, separate them with a semicolon (;).

Mandatory attribute.

rubric-id

The ID of the business category this branch belongs to. If there are multiple business categories, separate them with commas. Branches can have up to three business categories, but at least one of them should match the chain category.

Mandatory attribute.

url

The chain's main website. Specified in lowercase, in full, including http:// or https://.

Mandatory attribute.

add-url

An additional website for the chain (for example, a link to a social media page).

working-time

Business hours. Non-working days aren't listed.

Mandatory attribute.

lat

Geographical latitude of the branch location. Use a dot as the decimal delimiter.

lon

Geographical longitude of the branch location. Use a dot as the decimal delimiter.

Step 2. Upload the file to the website

Upload the file to your website using an updatable link. The data must be accessible via HTTP or HTTPS.

  1. On the chain page, go to Branches.

  2. Under Branch management, choose File.

  3. Add a link to the file, select the CSV type, and click Check. Checking the file may take several hours.

  4. If the file is verified successfully, click Publish. In the window that opens, check the changes in the branches. The map can show up to 50 branches with changes. Click Yes, start the upload. The file data will be moderated and uploaded to the Yango for Business database. If the file is large, the data upload may take several days.

    If errors are found when checking the file, you'll see an error message. Fix the errors and re-submit the file for review.

To view the branch changes uploaded to the Yango for Business database from the file, click Upload history. The button is available within 24 hours of the first upload.

To update the data once, save the file in CSV or XSLX format and send it using the form. Include your business's email address and phone number in the message. If we have any questions about the uploaded file, we will contact you.

The new data will appear in Yango Maps within a few days so long as the file is properly formatted.

Contact support