Запуск импорта файла поставщика

Запускает разбор файла по маске импорта и загрузку кодов на склад PROMANTA.

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

Запускает разбор файла по маске импорта и загрузку кодов на склад PROMANTA. После completed коды доступны площадкам (по catalog rules) и приходит webhook incoming.completed.

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

После успешного PUT на uploadUrl. Обязателен заголовок Idempotency-Key — повтор при таймауте не создаст дубль.

Эндпоинт

POST /v1/supplier/incoming/import

Аутентификация: API-ключ в заголовке X-Api-Key (префикс bk_sup_). projectId и actor id в body не передаются — берутся из ключа.

Scope: supplier:incoming:write

Idempotency-Key: обязателен (заголовок). Повтор с тем же ключом вернёт кэшированный ответ.

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

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "incomingId": "f47ac10b-…", "options": { "skipUsedRows": true } }
}

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

{
  "success": true,
  "data": {
    "incomingId": "f47ac10b-…",
    "status": "queued",
    "importJobId": "job-uuid",
    "fileHash": "sha256:…"
  }
}

Ошибки

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

cURL

curl -X POST "https://api-external.promanta.ru/v1/supplier/incoming/import" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Idempotency-Key: unique-key-001" \
  -d '{"data": { "incomingId": "f47ac10b-…", "options": { "skipUsedRows": true } }}'