Mindbox
Номенклатура

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

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

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

Импорт продуктов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId={`уникальный идентификатор сайта и т.п.`}&operation=ImportRegionalData&csvCodePage=65001&externalSystem={`Идентификатор внешней системы`}&transactionId={`Значение ключа идемпотентности в формате GUID`} HTTP/1.1 Authorization: SecretKey `{Секретный ключ}` Accept: application/xml Content-Type: text/csv;charset=utf-8
  • csvCodePage - идентификатор кодовой страницы Windows для CSV-файла. Предпочтительно использовать 65001 (UTF-8). Опциональный параметр.
  • csvColumnDelimiter - символ, использующийся для разделения колонок в CSV-файле. Опциональный параметр.
  • csvTextQualifier - символ, добавляющийся в начале и в конце значения колонки, позволяя использовать в нём символы, обычно не разрешённые. Опциональный параметр.
  • transactionId - ключ идемпотентности, позволяющий избежать повторного выполнения запроса. Ключ идемпотентности обязательно создавать в формате GUID (рекомендуется версия 4). Для повторных запросов c повторяющимся ключом в ответ вернется статус TransactionAlreadyProcessed. Опциональный параметр.
  • данный сервис разрешает поставить не более 60 импортов в час. После превышения порога вы будете получать 429 Too Many Requests до тех пор, пока количество поставленных задач за час не опустится ниже 60.
  • максимальный размер принимаемого файла 200мб. В случае, если необходимо загрузить больший объем данных, данные нужно разбить на несколько файлов.

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

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

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

Импорт продуктов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId=Test&operation=ImportRegionalData&csvCodePage=65001&externalSystem=sap-erp Authorization: SecretKey ************ Accept: application/xml Content-Type: text/csv;charset=utf-8 ExternalId;Name;IsAvailable;Price;PictureUrl;Url;AreaExternalId;ArrivalDateTimeUtc;MinPrice;ManufacturerName 89;Автомагнитола Kenwood KDC-W707Y;0;;;;123;2025-01-27 16:40:16.404;; 105;Коаксиальная автоакустика Panasonic CJ-A1323N;0;;;;123;2025-01-27 16:40:16.404;; 169;Электрический чайник Philips HD4665/20;1;4390;;;594-msk;2025-01-27 16:40:16.404;; 219;Телевизор Rolsen C21SR74NT;1;;;;594-msk;2025-01-27 16:40:16.404;; 242;Стиральная машина Electrolux EWC 1350;0;;;;594-msk;2025-01-27 16:40:16.404;; 274;Автомагнитола Alpine CDA-9857R;1;;;;Zone11;2025-01-27 16:40:16.404;; 299;Щипцы Rowenta CF2012;1;1660;;;Zone11;2025-01-27 16:40:16.404;;
Last modified on