Создание загрузки

Данные в SellOut+ можно загружать не только из интерфейса портала, но и через API. Это удобно для интеграции с системами, где необходимо регулярно передавать фиксированную структуру данных.

POST <BASE_LOAD_API>/create — метод для создания новой загрузки. С его помощью можно:

  • Загружать один или несколько файлов.

  • Добавлять описание к загрузке.

  • Выбрать тип загрузки.

  • Выбрать конфигурацию.

Параметры метода

Обязательные

  • files — файлы с данными, которые вы хотите загрузить. Это могут быть CSV или другие поддерживаемые форматы. Передаются как вложения в запросе.

Опциональные

Передаются как query-параметр в URL.

  • description — текстовое описание загрузки. Помогает уточнить, что это за данные и для чего они предназначены.

  • id_loadconfiguration — ID предустановленной конфигурации обработки данных.

  • id_loadType — тип загрузки. Используется для определения, как система должна обрабатывать данные:

    • A — добавляет новые данные или обновляет существующие (по умолчанию).

    • R — полностью заменяет данные за указанный период.

Пример

Запрос через curl:

curl -X POST "https://app.sellout.plus/demo/api/load/create?description=Test&id_loadconfiguration=123&id_loadType=A" ^
     -H "Authorization: Bearer <ваш_токен>" ^
     -F "files=@path/to/your/file1.csv" ^
     -F "files=@path/to/your/file2.csv" ^  # если нужно несколько файлов

Успешный ответ:

{
    "ID_Load": 108051
}

Коды ошибок

Код ошибки

Описание

Пример ответ от сервера

403

У пользователя нет прав для создания загрузки.

{
   "status": 403,
   "status_description": "Forbidden",
   "error_message": "You do not have permission"
}

400

Не приложен файл для загрузки.

{
    "status": 400,
    "status_description": "BadRequest",
    "error_message": "You must provide at least one file"
}

500

Внутренняя ошибка сервера.

{
   "status": 500,
   "status_description": "InternalServerError",
   "error_message": "Unexpected error occurred"
}