Карточка поступления и статус импорта

Детальная карточка одного поступления: статус pipeline (draft → file_uploaded → queued → importing → completed), счётчики вставленных/дубликатных строк, ошибки.

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

Детальная карточка одного поступления: статус pipeline (draft → file_uploaded → queued → importing → completed), счётчики вставленных/дубликатных строк, ошибки. Используется в drawer поступления и для polling после запуска импорта.

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

После нажатия «Импортировать» — опрашивайте каждые 5–15 сек, пока status не станет completed или failed.

Эндпоинт

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

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

Permission: inventory_promo_codes.view

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

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "projectId": "a1b2…", "incomingId": "f47ac10b-58cc-4372-a567-0e02b2c3d479" }
}

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

{
  "success": true,
  "data": {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "status": "completed",
    "supplierName": "Промомед",
    "insertedAvailable": 1480,
    "duplicateRows": 10,
    "errorRows": 0,
    "resultSummary": { "inserted": 1480, "duplicates": 10 },
    "completedAt": "2026-07-13T09:20:00Z"
  }
}

Ошибки

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/get" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"data": { "projectId": "a1b2…", "incomingId": "f47ac10b-58cc-4372-a567-0e02b2c3d479" }}'