Новые поступления для площадки

Метаданные завершённых поступлений, релевантных вашему каталогу: кто поставил, сколько кодов доступно площадке.

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

Метаданные завершённых поступлений, релевантных вашему каталогу: кто поставил, сколько кодов доступно площадке. Без файлов и секретов поставщика.

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

Планирование акций после поставки от Промомед.

Эндпоинт

POST /v1/platform/incoming/list

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

Scope: platform:incoming:read

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

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "page": 1, "pageSize": 50, "completedSince": "2026-07-01" }
}

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

{
  "success": true,
  "data": {
    "items": [
      {
        "incomingId": "f47ac10b-…",
        "supplierName": "Промомед",
        "documentDate": "2026-07-13",
        "insertedAvailable": 1480,
        "codesAvailableForPlatform": 1480,
        "completedAt": "2026-07-13T09:20:00Z"
      }
    ],
    "totalCount": 3
  }
}

Ошибки

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

cURL

curl -X POST "https://api-external.promanta.ru/v1/platform/incoming/list" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -d '{"data": { "page": 1, "pageSize": 50, "completedSince": "2026-07-01" }}'