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

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

```text title="Импорт продуктов"
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                         | Идентификатор зоны                            | Обязательно    |


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

```text title="Импорт продуктов"
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;;
```