Шановні партнери!

Для Вашої зручності ми раді запропонувати Вам можливість автоматичного обміну даними.
Обмін даними здійснюється через YML / XML файл і може проводитися вручну (скачування файлу та обробка даних вручну) або автоматично (завантаження даних з нашого ресурсу у зручному для Вас форматі та автоматична обробка завантажених даних за допомогою скриптів та програмного забезпечення).

Автоматичний обмін даними дозволить Вам:

– підвищити ефективність виконання замовлень
– скоротити тимчасові витрати на коригування даних про наявність та ціну товару
– повністю виключити участь менеджера у оновленні (актуалізації) інформації про товари
– автоматично додавати нові товари на Ваш сайт

Приклади розвантаження даних для різних форматів

YML формат даних (прайс-лист)

YML (Yandex Market Language) – це стандарт, розроблений Яндексом для прийняття та розміщення інформації в базі даних Яндекс Маркета. YML базується на стандарті XML.

Файл генерується в режимі реального часу під час переходу за посиланням. Після надсилання GET-запиту можливі два варіанти отримання даних: автоматичне завантаження файлу або виведення вмісту файлу до браузера. Прямого доступу до файлу немає.

Якщо у Вас виникають складнощі з отриманням даних, звертайтесь до нас і ми Вам допоможемо налаштувати обмін даних незалежно від того, яку мову програмування ви використовуєте.


<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2017-08-21 15:17:34">
    <shop>
        <name>ExtraDigital.UA</name>
        <company>ООО "Экстрадиджитал"</company>
        <url>https://extradigital.ua</url>
        <platform>ExtraDigital.UA CMS</platform>
        <version>1.6.1.3</version>
        <agency>AlexNDR</agency>
        <email>[email protected]</email>

        <currencies>
            <currency id="UAH" rate="1.000000"/>
        </currencies>

        <categories>
            <category id="20">Aккумуляторы и батарейки</category>
            <category id="39">AA / ААА зарядные устройства</category>
            ...
            <category id="28">Кабели и переходники</category>
            <category id="45" parentId="28">Аудио</category>
            <category id="46" parentId="28">DisplayPort</category>
            ...
        </categories>

        <offers>
            ...
            <offer id="1843" available="true">
                <url>https://extradigital.ua/category/product-url.html</url>
                <price>100.00</price>
                <oldprice>120.00</oldprice>
                <currencyId>UAH</currencyId>
                <categoryId>42</categoryId>
                <picture>https://extradigital.ua/picture-001.jpg</picture>
                <picture>https://extradigital.ua/picture-001.jpg</picture>
                <picture>https://extradigital.ua/picture-003.jpg</picture>
                <store>true</store>
                <pickup>true</pickup>
                <delivery>true</delivery>
                <name>Чехол Ringke Fusion для Samsung Galaxy A3 2017 Rose Gold</name>
                <vendor>Ringke</vendor>
                <description><![CDATA[<p>Тип: Чехол-накладка...]]></description>
                <sales_note></sales_note>
                <manufacturer_warranty>true</manufacturer_warranty>
                <barcode>8809525012671</barcode>
            </offer>
            ...
        </offers>
    </shop>
</yml_catalog>

Опис елементів та їх призначення:

ЭлементАтрибутОписаниеПример
xml version (Float)
encoding (String)
Стандартный XML-заголовок. Начинается с первой строки, с нулевого символа. UTF-8 кодировка. <?xml version="1.0" encoding="UTF-8"?>
yml_catalog date (Date) Корневой элемент документа. Формат YML в качестве корневого использует элемент <yml_catalog>.
Атрибут date соответствует дате и времени генерации YML-файла на стороне сервера ExtaDigital.
Дата представлена в формате: YYYY-MM-DD hh:mm:ii.
<yml_catalog date="2017-08-21 15:17:34">
shop Элемент содержит описание магазина и его товарных предложений.
Currencies - информация о валютах.
Categories - список категорий.
Offers - список товарных предложений.
    name Короткое название магазина. <name>ExtraDigital.UA</name>
    company Полное наименование компании. <company>ООО "Экстрадиджитал"</company>
    url URL главной страницы магазина. <url>https://extradigital.ua</url>
    platform Система управления контентом (CMS). <platform>ExtraDigital.UA CMS</platform>
    version Версия системы управления контентом (CMS). <version>1.6.1.3</version>
    agency Техническая поддержка сайта, разработчик программного обеспечения. <agency>AlexNDR</agency>
    email Контактный адрес разработчика, осуществляющего техподдержку. <email>[email protected]</email>
currencies Список используемых валют. Родительский элемент.
    currency id (String)
rate (Float)
id - указывает код одной или нескольких валют, которые могут быть использованы в YML-файле.
rate - указывает курс валюты к курсу основной валюты, взятой за единицу (валюта, для которой rate="1")
<currency id="UAH" rate="1.000000"/>
categories Содержит список категорий. Родительский элемент.
    category id (Integer)
parentId (Integer)
id - уникальный идентификатор категории (ID родительской категории).
parentId - уникальный идентификатор дочерней категории.
<category id="45" parentId="28">Аудио</category>
offers Список предложений магазина. Каждое предложение описывается в отдельном элементе.
    offer id (Integer)
available (Boolean)
Товарная позиция, дочерний элемент списка предложений.
id - уникальный идентификатор товара.
available - наличие товара. (true/false)
Содержит список элементов товарной позиции.
<offer id="42" available="true">
url
(String)
URL страницы товара на сайте ExtraDigital. <url>https://site/category/product.html</url>
price
(Float)
Цена товарной позиции с учетом дисконта клиента. <price>100.00</price>
oldprice
(Float)
Рекомендуемая розничная цена товарной позиции. <oldprice>120.00</oldprice>
currencyId
(String)
Идентификатор валюты товара (UAH, USD, EUR...) <currencyId>UAH</currencyId>
categoryId
(Integer)
Идентификатор категории, к которой принадлежит товар. <categoryId>42</categoryId>
picture
(String | URL)
URL изображений соответствующего товарного предложения. <picture>https://site/picture-001.jpg</picture>
store
(Boolean)
Возможность купить товар в розничном магазине.
true — товар можно купить в розничных магазинах.
false — возможность покупки в розничных магазинах отсутствует.
<store>true</store>
pickup
(Boolean)
Возможность самовывоза из пунктов выдачи.
true — товар можно забрать в пунктах выдачи.
false — товар нельзя забрать "самовывозом".
<pickup>true</pickup>
delivery
(Boolean)
Возможность курьерской доставки.
true — товар может быть доставлен курьером.
false — товар не доставляется курьером.
<delivery>true</delivery>
name
(String)
Полное наименование товарного предложения. <name>Чехол Ringke Fusion...</name>
vendor
(String)
Производитель товара, торговая марка. <vendor>Ringke</vendor>
description
(String)
Краткое описание товарного предложения. Содержит HTML-теги, длина описания не превышает 350 символов. <description><![CDATA[<p>Тип: Чехол-накладка...]]></description>
sales_notes
(String)
Дополнительная информация, может содержать условия покупки, варианты оплаты, акционные предложения. <sales_notes>Защитная пленка в подарок</sales_notes>
manufacturer_warranty
(Boolean)
Наличие официальной гарантии производителя.
true — товар имеет официальную гарантию.
false — товар не имеет официальной гарантии.
<manufacturer_warranty>true</manufacturer_warranty>
barcode
(Integer)
EAN-13 штрихкод товара, указанный производителем.
Штрихкод может содержать 12 или 13 символов.
<barcode>8809525012671</barcode>

XML формат даних (прайс-лист/каталог товарів)

XML (eXtensible Markup Language) — це мова розмітки даних, що розширюється, призначена для зберігання структурованих даних.

Файл генерується в режимі реального часу під час переходу за посиланням. Після надсилання GET-запиту можливі два варіанти отримання даних: автоматичне завантаження файлу або виведення вмісту файлу до браузера. Прямого доступу до файлу немає.

Якщо у Вас виникають складнощі з отриманням даних, звертайтесь до нас і ми Вам допоможемо налаштувати обмін даних незалежно від того, яку мову програмування ви використовуєте.

<?xml version="1.0" encoding="UTF-8"?>
<products date="2017-08-28 12:35">
    <name>ExtraDigital.UA</name>
    <company>ООО "Экстрадиджитал"</company>
    <url>http://extradigital.ua</url>
    <platform>ExtraDigital.UA CMS</platform>
    <version>1.6.1.3</version>
    <agency>AlexNDR</agency>
    <email>[email protected]</email>
    <currencies>
        <currency id="UAH" rate="1.000000"/>
    </currencies>
    <categories>
        <category id="20">Aккумуляторы и батарейки</category>
        <category id="39">AA / ААА зарядные устройства</category>
        ...
        <category id="28">Кабели и переходники</category>
        <category id="45" parentId="28">Аудио</category>
        <category id="46" parentId="28">DisplayPort</category>
        ...
    </categories>
    <items>
        <item id="1843" available="true">
            <url>https://extradigital.ua/category/product-url.html</url>
            <price>100.00</price>
            <retail_price>120.00</retail_price>
            <currencyId>UAH</currencyId>
            <categoryId>42</categoryId>
            <categoryName>Сумки, чехлы, пленки</categoryName>
            <picture>https://extradigital.ua/picture-001.jpg</picture>
            <picture>https://extradigital.ua/picture-001.jpg</picture>
            <picture>https://extradigital.ua/picture-003.jpg</picture>
            <store>true</store>
            <pickup>true</pickup>
            <delivery>true</delivery>
            <name>Чехол Ringke Fusion для Samsung Galaxy A3 2017 Rose Gold</name>
            <vendor>Ringke</vendor>
            <description><![CDATA[<p>Тип: Чехол-накладка...]]></description>
            <fulldescription><![CDATA[<div class="panel-heading">Особенности:</div>...]]></fulldescription>
            <param name="Тип">Чехол</param>
            <param name="Материал">PC (поликарбонат), TPU (термопласт. полиуретан)</param>
            <param name="Совместимость">Samsung</param>
            <param name="Модель телефона">Samsung Galaxy A3 2017 Duos SM-A320</param>
            <param name="Пленка в комплекте">Нет</param>
            <sales_note></sales_note>
            <manufacturer_warranty>true</manufacturer_warranty>
            <quantity>10+</quantity>
            <barcode>8809525012671</barcode>
            <sku>RCS4331</sku>
        </item>
    </items>
</products>
                

Описание элементов и их назначение:

ЭлементАтрибутОписаниеПример
xml version (Float)
encoding (String)
Стандартный XML-заголовок. Начинается с первой строки, с нулевого символа. UTF-8 кодировка. <?xml version="1.0" encoding="UTF-8"?>
products / price date (Date) Корневой элемент документа. В зависимости от варианта экспортируемых данных, корневой элемент может иметь различные наименования (price, products).
Атрибут date соответствует дате и времени генерации XML-файла на стороне сервера ExtaDigital.
Дата представлена в формате: YYYY-MM-DD hh:mm:ii.
Элемент также содержит описание магазина и его товарных позиций.
Currencies - информация о валютах.
Categories - список категорий.
Items - список товарных позиций.
<products date="2017-08-21 15:17:34">
    name Короткое название магазина. <name>ExtraDigital.UA</name>
    company Полное наименование компании. <company>ООО "Экстрадиджитал"</company>
    url URL главной страницы магазина. <url>https://extradigital.ua</url>
    platform Система управления контентом (CMS). <platform>ExtraDigital.UA CMS</platform>
    version Версия системы управления контентом (CMS). <version>1.6.1.3</version>
    agency Техническая поддержка сайта, разработчик программного обеспечения. <agency>AlexNDR</agency>
    email Контактный адрес разработчика, осуществляющего техподдержку. <email>[email protected]</email>
currencies Список используемых валют. Родительский элемент.
    currency id (String)
rate (Float)
id - указывает код одной или нескольких валют, которые могут быть использованы в YML-файле.
rate - указывает курс валюты к курсу основной валюты, взятой за единицу (валюта, для которой rate="1")
<currency id="UAH" rate="1.000000"/>
categories Содержит список категорий. Родительский элемент.
    category id (Integer)
parentId (Integer)
id - уникальный идентификатор категории (ID родительской категории).
parentId - уникальный идентификатор дочерней категории.
<category id="45" parentId="28">Аудио</category>
items Список товарных позиций. Каждый товар описывается в отдельном элементе.
    item id (Integer)
available (Boolean)
Товарная позиция, дочерний элемент списка предложений.
id - уникальный идентификатор товара.
available - наличие товара. (true/false)
Содержит список элементов товарной позиции.
<item id="42" available="true">
url
(String)
URL страницы товара на сайте ExtraDigital. <url>https://site/category/product.html</url>
price
(Float)
Цена товарной позиции с учетом дисконта клиента. <price>100.00</price>
retail_price
(Float)
Рекомендуемая розничная цена товарной позиции. <retail_price>120.00</retail_price>
currencyId
(String)
Идентификатор валюты товара (UAH, USD, EUR...) <currencyId>UAH</currencyId>
categoryId
(Integer)
Идентификатор категории, к которой принадлежит товар. <categoryId>42</categoryId>
categoryName
(String)
Название категории, к которой принадлежит товар. <categoryName>Сумки, чехлы, пленки</categoryName>
picture
(String | URL)
URL изображений соответствующего товарного предложения. <picture>https://site/picture-001.jpg</picture>
store
(Boolean)
Возможность купить товар в розничном магазине.
true — товар можно купить в розничных магазинах.
false — возможность покупки в розничных магазинах отсутствует.
<store>true</store>
pickup
(Boolean)
Возможность самовывоза из пунктов выдачи.
true — товар можно забрать в пунктах выдачи.
false — товар нельзя забрать "самовывозом".
<pickup>true</pickup>
delivery
(Boolean)
Возможность курьерской доставки.
true — товар может быть доставлен курьером.
false — товар не доставляется курьером.
<delivery>true</delivery>
name
(String)
Полное наименование товарного предложения. <name>Чехол Ringke Fusion...</name>
vendor
(String)
Производитель товара, торговая марка. <vendor>Ringke</vendor>
description
(String)
Краткое описание товарного предложения. Содержит HTML-теги, длина описания не превышает 350 символов. <description><![CDATA[<p>Тип: Чехол-накладка...]]></description>
fulldescription
(String)
Расширенное описание товарного предложения. Содержит HTML-теги, таблицы с характеристиками, ссылки на YouTube.
(Присутствует только в формате выгрузки каталога, прайс-лист не содержит данное поле данных)
<fulldescription><![CDATA[<p>Тип: Чехол-накладка...]]></fulldescription>
param
(String)
name (String) Предназначен для описания характеристик и параметров товара. Несколько параметров, соответствующих одному типу - перечисляются через запятую.
name - название параметра / характеристики
(Присутствует только в формате выгрузки каталога, прайс-лист не содержит данное поле данных)
<param name="Совместимость">Samsung, Apple</param>
sales_notes
(String)
Дополнительная информация, может содержать условия покупки, варианты оплаты, акционные предложения. <sales_notes>Защитная пленка в подарок</sales_notes>
manufacturer_warranty
(Boolean)
Наличие официальной гарантии производителя.
true — товар имеет официальную гарантию.
false — товар не имеет официальной гарантии.
<manufacturer_warranty>true</manufacturer_warranty>
quantity
(Integer | Mixed)
Количество товара, доступное для заказа. Товар, количество которого более 10 единиц - отображается как "10+" <quantity>8</quantity>
barcode
(Integer)
EAN-13 штрихкод товара, указанный производителем.
Штрихкод может содержать 12 или 13 символов.
<barcode>8809525012671</barcode>
sku
(String)
Артикул товара.
Содержит буквы латинского алфавита и цифры. Уникален для каждой товарной позиции.
<sku>RCS4331</sku>
Формат данных может изменяться (дополняться новыми данными) без уведомления. Все новые данные будут сопровождаться описанием (см. выше).

Если Вы желаете получать данные в любом другом формате или Вам необходимы данные, которые не доступны в настоящей версии формата - пожалуйста, сообщите нам об этом и мы обязательно реализуем данную возможность.