API Интеграция с Market Radar
Market Radar поддерживает функцию импорта товаров из XML файла. Формат стандартизирован и подробно описан на странице создателя Яндекс.Маркет

Мы добавили несколько новых параметров в этот формат, чтобы расширить обмен с системами учета товаров, а не только с интернет магазинами (как рассчитывал Яндекс)

Функция импорта по XML может быть использована Продавцами для импорта данных из 1С или сайта, а так же Поставщиком для синхронизации остатков и цен с партнерами через Market Radar.

Для того, чтобы Market Radar импортировал товары из вашего XML файла, вы должны разместить его в общем доступе (на сайте, FTP, Google Drive, Dropbox и т.д.) и далее указать ссылку на этот файл. После чего Market Radar будет импортировать файл по этой ссылке раз в 30 минут.

Webhook
Так-же есть возможность вызвать webhook Market Radar для того, чтобы файл по ссылке импортировался немедленно. Это необходимо в тех случаях, когда нет возможности ждать 30 минут до следующей проверки.
Импорт не затрагивает другие товары, которые были созданы до этого вручную до тех пор пока их SKU различаются. Товары с такими же SKU как и у импортируемых товаров будут перезаписаны.

Все товары, которые были импортированы будут отличаться в списке товаров пометкой, например 1C.

Все данные импортируемых товаров перезаписываются по умолчанию. Но можно настроить так, чтобы какие-то параметры записывались единожды, когда товар импортируется первый раз. Список параметров, которые можно защитить от перезаписи:
  • Дилерская цена (purchase)
  • Цена продажи (retail)

Старые товары, которых нет в xml будут помечены как archived и не будут больше выгружаться на торговую площадку. Они все еще будут видны в Маркетрадаре, их можно удалить вручную. Если они появляются в следующей выгрузке, то пометка archived снимается.

Импортированные товары защищены от редактирования вручную. Их Название, Бренд, Дилерскую цену, РРЦ, наличие и остатки на складе нельзя редактировать. Однако можно задавать свою ручную цену, которая будет иметь приоритет над ценой из XML.
Процесс интеграции
1
Регистрация аккаунта
Зарегистрируйтесь на Маркетрадаре, введите все необходимые данные — id магазина, название, email и т.д.
2
Создайте XML
Создайте XML и выложите его в доступ, чтобы Маркетрадар мог его скачивать раз в 30 минут
3
Напишите в поддержку
Свяжитесь с нами, чтобы мы активировали автоматический импорт XML на вашем аккаунте. Для этого достаточно сообщить email или название магазина и дать ссылку на местоположение XML фала.
Пример .xml файла
<yml_catalog date="2021-01-27 18:22:00">  <!-- обязательно -->
<shop type="seller"> <!-- обязательно -->
<name>NG Shop</name> <!-- обязательно -->
<company>ТОО New Gadgets</company> <!-- обязательно -->
<url>http://www.ng.kz/</url>
<currencies> <!-- обязательно -->
	<currency id="KZT" rate="1"/>
</currencies>
<outlets>  <!-- обязательно -->
	<outlet id="e207f6f7-6aee-11eb-0a80-04220012aee1" name="Основной склад" />
	<outlet id="a0ee94a0-67bf-11eb-0a80-00cf000f7906" name="Караганда" />
</outlets>
<prices> <!-- обязательно -->
	<price id="750000000" name="Розничная" />
	<price id="710000000" name="Розничная Астана" />
</prices>
<categories> <!-- обязательно -->
	<category id="000000001" >ТВ, Аудио, Видео</category>
	<category id="000000002" parentId="000000001">Аудиотехника</category>
	<category id="000000003" parentId="000000003">Наушники и гарнитуры</category>
</categories>
<offers> 
	<offer id="00000000213" available="true" group_id="1">
		<url>http://cabinet.ng.kz/p/00000000213</url> <!-- optional -->
		<name>Apple AirPods 2 with Charging Case</name> <!-- обязательно -->
		<vendorCode>AAPLP2</vendorCode> <!-- optional -->
		<categoryId>000000003</categoryId> <!-- обязательно -->
		<picture>http://cabinet.ng.kz/p/00000000213/1.jpg</picture> <!-- optional -->
		<picture>http://cabinet.ng.kz/p/00000000213/2.jpg</picture> <!-- optional -->
		<picture>http://cabinet.ng.kz/p/00000000213/3.jpg</picture> <!-- optional -->
		<vendor>Apple</vendor> <!-- может быть просто No brand --> <!-- обязательно -->
		<prices> 
			<price type="retail" id="750000000" name="Розничная" currency="KZT">52000</price> <!-- обязательно -->
			<price type="retail" id="710000000" name="Розничная Астана" currency="KZT">56000</price> <!-- optional -->
			<price type="purchase" currency="KZT">32000</price> <!-- optional -->
                        <price type="rrp" currency="KZT">56000</price> <!-- optional -->
		</prices>
		<outlets> <!-- обязательно -->
			<outlet id="e207f6f7-6aee-11eb-0a80-04220012aee1" name="Основной склад" instock="0"/>
			<outlet id="a0ee94a0-67bf-11eb-0a80-00cf000f7906" name="Караганда" instock="2"/>
		</outlets>
		<description><![CDATA[<p>Описание товара</p>]]></description>  <!-- optional -->
		<Characteristics> <!-- optional -->
			<Character Name="Тип" Value="Bluetooth"/>
			<Character Name="Вид" Value="Вкладыши"/>
			<Character Name="Вес" Value="4"/>
		</Characteristics>
	</offer>
</offers>
</shop>
</yml_catalog>
Описание параметров
<shop /> — тип аккаунта, нужно оставить seller если вы продавец
<name /> — Название магазина для информации
<company /> — Юрлицо для информации
<url /> — Ссылка на сайт компании
<currencies /> — Список валют в прайсе
<outlets /> — Список всех доступных складов с их guid
<prices /> — Список всех доступных цен с их guid
<categories /> — Категории товаров
<offers /> — Контейнер с товарами
<offer  — товар
	"id" — sku товара, уникальный, не должен меняться со временем. Этот параметр так-же будет уходить на торговые площажки как sku.
	"type" — тип товара, оставить vendor.model
	"available" — Наличие товара
	"group_id" — номер группы товара, в случае если у него есть варианты (цвета, размеры и т.д.)
>
<url /> — Ссылка на товар на вашем сайте или у поставщика. Будет видна в UI Маркетрадара для удобного поиска товара в своей системе
<name /> — Название товара, это же название будет уходить на торговые площадки
<vendor /> — Производитель. Он же будет уходить на торговые площадки и использоваться для фильтрации товаров в каталоге Маркетрадара
<vendorCode /> — Код товара от производителя или артикул
<prices /> — Блок с ценами
<price — Цена
	"type" — тип цены
		retail: розничная, их может быть несколько, уходит на торговую площадку как цена продажи.
		"id" — идентификатор цены, необходимый для выставления разных цен на разные города и разные торговые площадки. Если в качестве идентификатора указать код города, то эта цена автоматически будет задавать цену на тот город. Если планируется только одна цена, то можно указать свободый id, например "almaty". В будущем на Маркетрадаре появится UI для конфигурации привязок id цен к разным городам и торговым площадкам.
		"name" — Название цены, для удобства чтения xml файла
	purchase: дилерская цена, она может быть только одна. Не является обязательной, но рекомендуется т.к. используется для рассчета прибыли на каждой площадке и соответственно поможет автоматически снимать товар чтобы не торговать в минус.
		rrp: МРЦ или РРЦ, может быть только одна. Не является обязательной, но рекомендуется для товаров где нельзя менять цену. Товары, где указана РРЦ будут запрещать любое изменение цены из UI Маркетрадара.
	"currency" — Валюта, в которой представлена цена. На Маркетрадаре есть функция перерасчета цен из любой валюты в KZT в реальном времени опираясь на курсы ЦБ. В итоге цена приходит на Маркетрадар в долларах, а сохраняется уже в тенге.
/>
<outlets /> — Склады и остатки. На Маркетрадаре можно сделать привязку складов к точкам вывоза торговых площадок, таким образом при остутствии или при критическом уровне остатков на каком-то из складов товар будет сниматься с продажи в том регионе.
<outlet  — Склад. Их может быть несколько, либо отсутствовать, в таком случае наличие у товара будет 0 по всем складам
	id — Идентификатор склада. Он может быть привязан на маркетрадаре к складам аккаунта. По умолчанию у каждого аккаунта на маркетрадаре есть один склад "outlet-1". Но можно созать несколько: outlet-2, outlet-3. В данном случае идентификатор склада из XML привязывается к складу на маркетрадаре, например
a0ee94a0-67bf-11eb-0a80-00cf000f7906: outlet-1
a0ee94a0-67bf-11eb-0a80-00cf000f71f30: outlet-2
a0ee94a0-67bf-11eb-0a80-00cf000f64bcd: outlet-3

Если планируется только один склад, достаточно указать любой идентификатор здесь, например "sklad-almaty".
	name — Название склада. Например "Алматы" или "Караганда 2". Название никак не испольщуется в Маркетрадаре, но нужно в XML для удобства чтения, потому что по GUID или ID склада сложно сразу сказать к какому складу относятся остатки.
	instock — количество на складе
/>
<description /> — Текст описания товара может содержать HTML-теги и обязательно должен быть заключён в тег <![CDATA[...]]>. Пример:<description><![CDATA[<p>Сапоги, как сапоги.<br>Материал верха: юфть, юфть с кирзой.<br>Подошва — резина.</p>]]></description>
<Characteristics /> — характеристики товара. Пока не поддерживается на Маркетрадаре, но планируется в скором будущем. Данные характеристики будут уходить на торговые площадки, где продавец сам заполняет зарактеристики своих товаров, например satu.kz
Требования к XML
Размер: До 10 мб

Спецсимволы должны быть экранированы, чтобы не нарушать парсинг XML: Везде где есть текст, там нужно заменять символы ", &, >, < и ' следующим образом
" = &quot;
& = &amp;
> = &gt;
< = &lt;
' = &apos;

Цены не должны содержать символов, только цифры. Значение может быть как целое так и дробное

© All Right Reserved. My company Inc.
e-mail us: hello@company.cc
Made on
Tilda