### Yandex E-com Search Offer Feed Example

Source: https://github.com/yandex/yandex-ecom-search/blob/main/docs.md

This XML snippet demonstrates the structure for a single product offer within a Yandex e-commerce search feed. It includes essential fields like product ID, name, URL, price, currency, category, vendor, pictures, a detailed description, custom parameters, and delivery/pickup options.

```xml
<offers>
    <offer id="110101000017">
        <name>Умная колонка Яндекс Станция 2 с Алисой, песочный, 30Вт</name>
        <url>https://yetanothershop.ru/products/yandex_stantsiia_2_umnaia_kolonka_pesochnyi</url>
        <price>17990</price>
        <currencyId>RUR</currencyId>
        <categoryId>10101</categoryId>
        <vendor>Яндекс</vendor>
        <vendorCode>YNDX-00051E</vendorCode>
        <picture>https://yetanothershop.ru/pictures/yandex_stantsiia_2_umnaia_kolonka_pesochnyi_1.jpeg</picture>
        <picture>https://yetanothershop.ru/pictures/yandex_stantsiia_2_umnaia_kolonka_pesochnyi_2.jpeg</picture>
        <picture>https://yetanothershop.ru/pictures/yandex_stantsiia_2_umnaia_kolonka_pesochnyi_3.jpeg</picture>
        <description>
            <![CDATA[
                <p>Умная колонка второго поколения — с новым дизайном, звуком, центром управления умного дома и Алисой. Любимая музыка с чистым и глубоким звучанием, без искажений.</p>
                <p>Поддержка единого международного протокола Zigbee — чтобы умный дом быстрее отзывался на команды и работал даже без интернета.</p>
                <p>А также Алиса, которая вам помогает, запоминает, что вам нравится, и учится выражать эмоции.</p>
            ]]>
        </description>
        <param name="Цвет">Песочный</param>
        <param name="Голосовой помощник">Алиса</param>
        <param name="Язык голосового помощника">русский</param>
        <param name="Суммарная мощность" unit="Вт">30</param>
        <param name="Минимальная воспроизводимая частота" unit="Гц">65</param>
        <param name="Максимальная воспроизводимая частота" unit="кГц">20</param>
        <param name="Диаметр широкополосного динамика" unit="мм">63.5</param>
        <param name="Отношение сигнал/шум" unit="дБ">108</param>
        <param name="Количество микрофонов">4</param>
        <barcode>2009084317286</barcode>
        <store>true</store>
	    <pickup>true</pickup>
	    <delivery>true</delivery>
        <delivery-options>
            <option cost="300" days="1" order-before="18"/>
        </delivery-options>
        <pickup-options>
            <option cost="0" days="0"/>
        </pickup-options>
    </offer>
    <offer id="5410103000014">
        <name>Беспроводная кнопка, Яндекс, Zigbee, YNDX-00524</name>
        <url>https://yetanothershop.ru/products/knopochnyi_vykliuchatel_knopka_yandex</url>
        <price>1990</price>
        <currencyId>RUR</currencyId>
        <categoryId>10103</categoryId>
        <vendor>Яндекс</vendor>
        <vendorCode>YNDX-00524</vendorCode>
        <picture>https://yetanothershop.ru/pictures/knopochnyi_vykliuchatel_knopka_yandex_1.jpeg</picture>
        <picture>https://yetanothershop.ru/pictures/knopochnyi_vykliuchatel_knopka_yandex_2.jpeg</picture>
        <picture>https://yetanothershop.ru/pictures/knopochnyi_vykliuchatel_knopka_yandex_3.jpeg</picture>
        <description>
            <![CDATA[
                <p>Работает от батареек и может стать удобным дверным звонком или единственной кнопкой для запуска и выключения разных устройств. Компактную кнопку легко установить где угодно, будь то дверной косяк или прикроватный столик. Свяжите кнопку с разными устройствами и создавайте сценарии в приложении Дом с Алисой. Попробуйте установить кнопку как дверной звонок — и она будет передавать сигнал на Яндекс Станцию и сообщение в приложение Дом с Алисой, когда к вам придут. Или поставьте беззвучный режим, если не хотите, чтобы вас беспокоили непрошенные гости. Если связать кнопку с другими устройствами умного дома и разместить в прихожей, вы сможете выключать всё одним нажатием, когда уходите из дома. А ещё удобно положить кнопку рядом с кроватью и, например, выключать свет и задвигать шторы, не вставая. С кнопкой получится настроить до трёх разных сценариев: по однократному, двойному и длительному нажатию. Для подключения датчика к Умному дому с Алисой нужна Станция, поддерживающая протокол Zigbee. Если ваша Станция без Zigbee, для подключения вам понадобится Хаб Яндекса для устройств.</p>
            ]]>
        </description>
        <param name="Линейка">Алиса</param>
        <param name="Монтаж">Открытый</param>
        <param name="Ориентация монтажа">Горизонтальная и вертикальная</param>
        <param name="Тип крепления">Приклеивание</param>
        <param name="Управление">Нажимная кнопка</param>
        <param name="Материал">Металл, пластик</param>
    </offer>
</offers>
```

--------------------------------

### XML Delivery Options Structure

Source: https://github.com/yandex/yandex-ecom-search/blob/main/docs.md

Example XML structure for specifying delivery options. The 'option' tag defines a single delivery method with cost, days, and an optional order-before time.

```XML
<delivery-options>
    <option cost="300" days="4" order-before="18"/>
</delivery-options>
```

--------------------------------

### XML Categories Structure

Source: https://github.com/yandex/yandex-ecom-search/blob/main/docs.md

Example XML structure for defining product categories with parent-child relationships. Each category has a unique ID, and can optionally reference a parent category via parentId.

```XML
<categories>
    <category id="1">Книги</category>
    <category id="2" parentId="1">Детективы</category>
    <category id="3" parentId="1">Боевики</category>
    <category id="4">Видео</category>
    <category id="5" parentId="4">Комедии</category>
    <category id="6">Принтеры</category>
    <category id="7">Оргтехника</category>
</categories>
```

--------------------------------

### Promos API Documentation

Source: https://github.com/yandex/yandex-ecom-search/blob/main/docs.md

Details the structure for the 'promos' tag, used to describe promotional offers and coupon codes. It covers required attributes like promo ID, type, dates, URL, promo code text, discount, and product eligibility.

```APIDOC
promos:
  Description: Block containing data about promotional codes and offers.
  Attributes:
    promo:
      Description: Data for a specific promotional code or offer.
      Required: Yes, if the 'promos' block is present.
      Attributes:
        id: (Required, String) Unique identifier for the promo within the feed.
        type: (Required, String) Type of promotion, e.g., "promo code". Only one type is supported.
        start-date: (Required, String) Start date of the promotion in RFC3339 format.
        end-date: (Required, String) End date of the promotion in RFC3339 format.
        url: (Required, String) URL linking to the promotion details on the store's website.
        promo-code: (Required, String) The actual text of the promo code (max 20 characters).
        discount: (Required, String) The discount amount, specified with a 'unit' attribute (e.g., 'percent' or currency).
        purchase:
          Description: Information about products participating in the promotion.
          Required: Yes, if the promo is active.
          Attributes:
            product:
              Description: Refers to offers eligible for the promotion.
              Required: Yes, if 'purchase' is present.
              Attributes:
                offer-id: (Required, String) The identifier of the offer that the promotion applies to.
  Common Errors:
    - Missing 'promos' block when promotions exist.
    - Non-unique promo IDs.
    - Incorrect date formats (not RFC3339).
    - End date before start date.
    - Invalid URL format.
    - Promo code exceeding 20 characters.
    - Incorrect discount specification.
    - Empty 'purchase' tag or missing 'offer-id'.
```

--------------------------------

### Delivery Options API Documentation

Source: https://github.com/yandex/yandex-ecom-search/blob/main/docs.md

Defines the structure and attributes for the 'delivery-options' tag, which specifies courier delivery methods. It includes details on cost, delivery duration, and order cut-off times, along with common errors.

```APIDOC
delivery-options:
  Description: Contains information about delivery methods.
  Tags:
    option:
      Description: Describes a single delivery method (e.g., courier).
      Attributes:
        cost: (Required, Integer) Delivery cost in currency. Use 0 for free delivery.
        days: (Required, Integer) Delivery time in business days (0-31).
        order-before: (Optional, Integer) The hour (1-23) by which an order must be placed to meet the specified delivery time.
      Common Errors:
        - Incorrect cost or delivery days.
        - Using '—' instead of '-' for ranges (though '-' is not explicitly used here, it's a general range error).
        - Incorrect format for order-before (e.g., HH:MM:SS instead of just hour).
  Notes:
    - The 'delivery-options' element can contain up to 5 'option' elements.
    - Each 'option' should differ in delivery time or price.
    - The system uses the first 'option' listed in the output.
    - If 'delivery-options' is set at the 'shop' level, it applies to all offers unless overridden at the offer level.
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.