Загрузка файла поступления (multipart)

Загружает xlsx/csv/zip напрямую из браузера PROMANTA в Storage.

Зачем нужен метод

Загружает xlsx/csv/zip напрямую из браузера PROMANTA в Storage. После успеха статус поступления → file_uploaded. Альтернатива для серверных клиентов — upload-url.

Когда использовать

Используется веб-приложением при drag-and-drop файла в карточку поступления.

Эндпоинт

POST /v1/internal/promo-code-incoming/upload

Аутентификация: JWT — заголовок Authorization: Bearer <token>. Пользователь должен иметь доступ к проекту и permission inventory_promo_codes.

Permission: inventory_promo_codes.import

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

(multipart/form-data: file, projectId, incomingId)

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

{
  "success": true,
  "data": {
    "incomingId": "f47ac10b-…",
    "status": "file_uploaded",
    "fileName": "Промокоды_июль.xlsx",
    "fileSizeBytes": 245760,
    "fileHash": "sha256:…"
  }
}

Ошибки

UNAUTHORIZED / ACCESS_DENIED — нет доступа
VALIDATION_ERROR — некорректное тело
NOT_FOUND — сущность не найдена
RATE_LIMIT_EXCEEDED (429) — превышен лимит

cURL

curl -X POST "https://api-external.promanta.ru/v1/internal/promo-code-incoming/upload" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '(see multipart fields)'