Статус импорта поступления

Поставщик узнаёт, завершился ли импорт и сколько кодов вставлено / отброшено как дубликаты.

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

Поставщик узнаёт, завершился ли импорт и сколько кодов вставлено / отброшено как дубликаты. Критичен для SLA: ERP ждёт completed перед закрытием акта.

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

Poll каждые 10–30 сек после import, максимум до completed/failed.

Эндпоинт

POST /v1/supplier/incoming/get

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

Scope: supplier:incoming:read

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

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

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

{
  "success": true,
  "data": {
    "incomingId": "f47ac10b-…",
    "documentNumber": "PM-2026-07-001",
    "status": "completed",
    "counters": {
      "totalRows": 1500,
      "insertedAvailable": 1480,
      "duplicateRows": 10,
      "errorRows": 2
    },
    "completedAt": "2026-07-13T09:25:00Z"
  }
}

Ошибки

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

cURL

curl -X POST "https://api-external.promanta.ru/v1/supplier/incoming/get" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"data": { "incomingId": "f47ac10b-…" }}'