0
RU
Froomo
XML Feed

XML Feed

Требования к xml файлу

Чтобы разместить товары на маркетплейсе FROOMO, продавцу необходимо подготовить прайс-лист товаров в формате XML (YML). Это структурированный формат передачи данных о ваших товарах. Как правило, вы работаете в своей системе учета (CMS вашего сайта, PriceCreator, Prom и т.д.) и можете экспортировать данные о своих товарах в необходимом для FROOMO формате.

На этой странице описаны требования к структуре XML. О том, как получить прайс-лист (экспортировать информацию о своих товарах) описано по ссылке.

Технические требования:

  • url-адрес на xml прайс-лист должен быть статическим и не изменяться;
  • запрещено изменять артикулы товаров после добавления на сайт FROOMO;
  • допустимая кодировка данных — UTF-8;
  • стандарт XML не допускает использование непечатных символов с ASCII кодами от 0 до 31 (за исключением символов с кодами 9, 10, 13 — табуляция, перенос строки, возврат каретки);
  • символы ", &, >, <, ' нужно заменять эквивалентными кодами.

Символ в тексте Код в XML
"  &quot;
&  &amp;
>  &gt;
<  &lt;
'  &apos;

*Требование касается только написания текста и не касается написания тегов


Пример XML

<?xml version="1.0" encoding="UTF-8"?>
<xml_catalog date="2022-07-20 14:58">
        <company_name></company_name >
        <offers>

                <offer available="true">
                <vendor>Biocyte</vendor>
                <article>00000441</article>
                <out_of_prod></out_of_prod>
                <price>1210</price>
                <special_price>900</special_price>
               <special_date_start>01.04.2023</special_date_start>
               <special_date_end>21.04.2023</special_date_end>
                <currencyId>UAH</currencyId>
                <name>Keto Slim Nuit</name>
                <product_name_short>наименование для РРО</product_name_short>
                <stock_quantity>40</stock_quantity>
            </offer>

                 <offer available="true">
                <vendor>Biocyte</vendor>
                <article>00000447</article>
                <out_of_prod/>
                <price>1910</price>
                <special_price/>
                 <special_date_start/>
                 <special_date_end/>
                <currencyId>UAH</currencyId>
                <name>Keto Slim</name>
                <product_name_short/>
                <stock_quantity>40</stock_quantity>
            </offer>

        </offers>
</xml_catalog>

Описание тегов и элементов данных в xml

Тег / Элемент Описание Примечание
xml_catalog Корневой элемент формата XML. Атрибут date указывает дату и время генерации или изменения XML. Дата должна быть в формате YYYY-MM-DD hh:mm.
company_name Наименование вашей компании. Наименование компании необходимо указать в точности так как оно указано на сайте FROOMO
offers Список предложений магазина. Открывается после тега </company_name>. Закрывается перед тэгом </xml_catalog>.
offer Информация о товарной позиции.

Каждую разновидность товара нужно передавать отдельным уникальным offer (цвет, размер, объем, комплектация и т.п.).

Каждый товар описывается в отдельном элементе offer;

Атрибут available указывает наличие товара: true — товар налицо, false— нет в наличии.
out_of_prod Отметка о том что товар снят с производства.

Атрибут out_of_prod указывает на то что товар снят с производства: true — товар более не производится, false— производится на регулярной основе.

Данная отметка повлечет за собой изменения в карточке товара. Карточка будет доступна по прямой ссылке, но не будет отображаться в поиске и товарной выдаче. На карточке товара не будет отображена цена и его невозможно будет купить.

Рекомендуем указывать данный атрибут после полной продажи товарного остатка.
price Стоимость товара. Может быть указана дробная цена, разделитель целой и дробной части - точка. На сайте цена будет округлена до целой гривны согласно правил математического округления.
special_price Акционная цена. Указывается в период действия акции. При наличии special_price значение price выводится перечеркнутым.
special_date_start Дата начала акции. Дата должна быть в формате YYYY-MM-DD ,начиная с указанной даты special_price вступит в силу.
special_date_end Дата окончания акции. Дата должна быть в формате YYYY-MM-DD, начиная с указанной даты special_price утратит свою силу.
currencyId Код валюты, в которой указана цена товара. UAH
name Название товарной позиции в прайс-листе поставщика. Не выводится на сайт в качестве названия.
vendor Бренд товара. Торговая марка / производитель.
article Артикул товара. Каждая позиция должна иметь уникальный article, нумерация разрешена, допускается использование символов: Aa-Zz и 0-9, не допускается использование кириллицы и пробелов; article должен оставаться неизменным, запрещается изменять article, если товар уже добавлен на сайт FROOMO.
stock_quantity Остаток товара. Целое цифровое значение. Товар будет в наличии пока этот параметр больше 0. При этом значение атрибута available тега offer будет проигнорирован.


Вернуться на главную