Импорт продуктов

csv

Описание метода

Осуществляется с помощью POST-запроса. Адрес запроса можно получить в системе Майндбокс. Идентификаторы продуктов в импорте должны совпадать с идентификаторами продуктов, передаваемых в заказах и действиях с продуктом.

Импорт продуктов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId=`{уникальный идентификатор сайта и т.п.}`&operation=ImportProducts&csvCodePage=65001&externalSystem=`{Идентификатор внешней системы}`&transactionId=`{Значение ключа идемпотентности в формате GUID}`

Authorization: SecretKey `{Секретный ключ}`
Accept: application/json
Content-Type: text/csv;charset=utf-8

csvCodePage - идентификатор кодовой страницы Windows для CSV-файла. Предпочтительно использовать 65001 (UTF-8).
csvColumnDelimiter - символ, использующийся для разделения колонок в CSV-файле.
csvTextQualifier - символ, опционально добавляющийся в начале и в конце значения колонки, позволяя использовать в нём символы, обычно не разрешённые.
brand - опциональный параметр, обязательный для передачи на мультибрендовых проектах.
transactionId - ключ идемпотентности, позволяющий избежать повторного выполнения запроса. Ключ идемпотентности обязательно создавать в формате GUID (рекомендуется версия 4). Для повторных запросов c повторяющимся ключом в ответ вернется статус TransactionAlreadyProcessed.
данный сервис разрешает поставить не более 60 импортов в час. После превышения порога вы будете получать 429 Too Many Requests до тех пор, пока количество поставленных задач за час не опустится ниже 60.
максимальный размер принимаемого файла 200мб. В случае, если необходимо загрузить больший объем данных, данные нужно разбить на несколько файлов.

Описание полей

Заголовок	Описание
Пример: WebsiteId	Идентификатор продукта. Обязательное поле
Name	Наименование
Description	Описание
Categories (Пример: CategoryWebsiteId)	Идентификатор категории продукта. Через запятую можно передать несколько категорий.
GroupId	Идентификатор группы продуктов
IsAvailable	Доступен ли продукт в данный момент
Url	Ссылка на страницу с описанием продукта на сайте
PictureUrl	Ссылка на изображение продукта
Price	Цена продукта
OldPrice	Старая цена продукта
MinPrice	Минимальная цена продукта
ArrivalDateTimeUtc	Дата и время поступления продукта в формате UTC
ManufacturerName	Название производителя
CostPrice	Себестоимость продукта

Пример запроса

Импорт продуктов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId=Test&operation=ImportProducts&csvCodePage=65001&externalSystem=sap-erp

Authorization: SecretKey ***********
Accept: application/xml
Content-Type: text/csv;charset=utf-8

WebsiteId;Name;CategoriesWebsite;ManufacturerName;IsAvailable;Price;CostPrice;Url;PictureUrl;ArrivalDateTimeUtc;MinPrice
89;Автомагнитола Kenwood KDC-W707Y;50;Kenwood;;;;;;
105;Коаксиальная автоакустика Panasonic CJ-A1323N;40;Panasonic;;;;;;
169;Электрический чайник Philips HD4665/20;27;Philips;1;4390;;;;
219;Телевизор Rolsen C21SR74NT;3;Rolsen;;;;;;
242;Стиральная машина Electrolux EWC 1350;18;Electrolux;;;;;;
274;Автомагнитола Alpine CDA-9857R;50;Alpine;;;;;;
299;Щипцы Rowenta CF2012;1221;Rowenta;1;1660;;;;

Last modified on November 6, 2026

xml Импорт региональных данных продуктов