Mindbox
Импорт категорий продуктов

csv

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

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

Импорт категорий продуктов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId={уникальный идентификатор сайта и т.п.}&operation=DirectCrm.Retail.ImportProductCategories&csvCodePage=65001&externalSystem={Идентификатор внешней системы}&transactionId={Значение ключа идемпотентности в формате GUID} 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мб. В случае, если необходимо загрузить больший объем данных, данные нужно разбить на несколько файлов.

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

ЗаголовокОписание
CategoryExternalIdИдентификатор категории
ParentCategoryExternalIdИдентификатор родительской категории
NameНазвание категории

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

Импорт категорий продуктов
POST https://api.mindbox.ru/v3/operations/bulk?endpointId=Test&operation=DirectCrm.Retail.ImportProductCategories&csvCodePage=65001&externalSystem=sap-erp Authorization: SecretKey ********* Accept: application/xml Content-Type: text/csv CategoryExternalId;ParentCategoryExternalId;Name 1;;Аудио, видео 2;1;ЭЛТ телевизоры 3;1;Телевизоры 4;1157;DVD плееры 5;1156;Домашние кинотеатры 6;1155;Наушники 7;1158;Кронштейны для телевизоров 8;1156;Музыкальные центры 9;1155;MP3-плееры 10;1156;Акустика 12;1156;Магнитолы
Last modified on