Updating the catalog and assortment via the link

You can not read, but watch

To automatically transfer changes to the Market, you can create special files with product data and make them available by link. The market will download the file every 30 minutes — and thus receive all updates.

You will need files in the YML (Yandex Market Language) format — these are XML files designed according to Yandex rules.

With their help, you can:

Task	What parameters are passed in the file
Add products to the catalog and update information about them	Product characteristics and prices
Manage the placement of goods in stores	Terms of placement in individual stores

It is better to use a separate YML file to solve each of the tasks.

You can configure auto-update so that not all the characteristics and conditions of placement are updated through YML files, but only selected individual ones. This feature is made in case different control methods are convenient for you for different characteristics and conditions.

Step 1. Prepare the files and set up automatic updates

To prepare the files, use description of the YML format. Configure the store's software so that all changes are included in the files automatically.

Files can be packaged in a ZIP or gzip archive.

Rules for using the file to add products

• The file may contain incomplete information about the products. If any parameters or products have been deleted from the file, the value for them will not change. For example, if there was an item in the file earlier <offer> if it was deleted in the updated file, then the product will remain unchanged in the catalog. You can delete an item from the catalog only in your account.
• An empty value changes the parameter. For example, if in the parameter <barcode> previously, a barcode was specified, and after the update, the value in the file became empty, then the barcode of the product will disappear.

Rules for using the file to transfer the terms of placement

• The file should contain all the products that the store is selling now — if there is no product, it will disappear from the showcase. In order for the product to be returned, it is not enough to add it to the file and wait for the update. In addition, you need to make sure that in the field Hide from the showcase not specified Yes, and in the settings of the file in the cabinet, an update is enabled for this field.
• All the parameters of the terms of sale that you plan to set must be filled in for each product. If you do not pass the parameter, its value will be deleted on the Market. The parameter values that came with the last update will be updated.
• An empty value changes the parameter. For example, if in the parameter <pickup> Previously, it was indicated that it was possible to receive the product at the pick-up point, and after updating the value in the file became empty, then this option will disappear from the product.
• It is very important to specify the attribute correctly date — it is described in rules of compilation The YML file. Without date The balance data will not be updated.

How to check YML files

To check the finished YML file, upload it manually in the dashboard. Use an unarchived file for verification.

1. Open the section Products → Catalog.
2. Click A lot of goods and choose All products at once or With the terms of placement.
3. Upload the file to the Market. The market will perform a technical check of the file and, if it finds errors, will offer you to download a list of them.

Step 2. Make each file available via a link

The Market robot will regularly follow these links. Requirements for them:

• HTTP or HTTPS.
• If the domain is in Russian letters, then only HTTP.
• No longer than 512 characters.
• The file on the link should be downloaded in 150 seconds. If your software generates it on request, make sure that the file creation and download take less than 150 seconds. If it turns out that there is more, generate the file in advance. For example, with each database update or according to a schedule — at least once a day.

Step 3. Add links to files to your account

How to add a link to a file to add products

Use one common file for the cabinet to add products.

1. Choose Products → Auto-updating the catalog.
2. Click Add a link to a file and choose Products.
3. Insert the link in its entirety, along with http or https. Enter your username and password if you need them.
4. If necessary, select the characteristics that will be updated via the YML file. By default, everything is updated.
5. Click Check the file. The robot will try to download the file from the link and check it. If something is wrong, you will see information about the error.
6. Save the link if no errors are found in the file.

How to add a link to a file to manage the placement conditions

1. Choose Products → Auto-updating the catalog.

2. Click Add a link to a file, select Terms of placement in the store and the store for which you want to set up conditions.

3. Insert the link in its entirety, along with http or https. Enter your username and password if you need them.

4. If necessary, select the placement conditions that will be updated via the YML file. By default, everything is updated.

5. Click Check the file. The robot will try to download the file from the link and check it. If something is wrong, you will see information about the error.

6. Save the link if no errors are found in the file.

   For FBY and FBS stores you can add only one link to the file to update the placement conditions. If you need a new file, delete the old one or replace the link to it in your account.

An example of working with auto-update

The seller has one DBS and one FBS store on the Market. Their leftovers are different. In order not to change everything manually in the cabinet, the seller turned on auto-update. He created three files — "catalog.yml", "assortment-dbs.yml" and "assortment-fbs.yml" — and made them available by link. He uses the first file to add products to the catalog. Using the "assortment-dbs.yml" file, the seller transfers the balances for the DBS store, and through the "assortment-fbs.yml" file updates the balances according to the FBS model.

Why did the Market download my data less often?

In some cases, the Market will download the file from the link less often.

The market will download the file once a day if:

• You have not completed the connection to the Market within 30 days.
• The file has not been changed for more than 1 day.
• Your store has been offline for more than 7 days.

The market will stop downloading the file altogether if your store has been offline for more than a month.

Starting the download manually

You can manually start downloading the file. For example, if you need to transfer data quickly without waiting for regular updates.

To do this, click the three dots next to the desired file and select Launch the update. This can be done no more than three times an hour.