image
0
UA
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 буде проігноровано.


Повернутись на головну