История поступлений поставщика

Журнал всех поставок данного поставщика: когда загружали файлы, сколько кодов принято, статусы.

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

Журнал всех поставок данного поставщика: когда загружали файлы, сколько кодов принято, статусы. Нужен бухгалтерии и IT для сверки с ERP и расследования расхождений.

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

Ежедневный отчёт «что мы отправляли в PROMANTA», поиск старого documentNumber, мониторинг failed импортов.

Типовой сценарий

Фильтруйте по периоду documentDateFrom/To.
Статус completed — успешные поставки.
Сверяйте insertedAvailable с вашей ERP.

Эндпоинт

POST /v1/supplier/incoming/list

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

Scope: supplier:incoming:read

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

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "page": 1, "pageSize": 50, "status": "completed", "documentDateFrom": "2026-07-01", "documentDateTo": "2026-07-31" }
}

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

{
  "success": true,
  "data": {
    "items": [
      {
        "incomingId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "documentNumber": "PM-2026-07-001",
        "documentDate": "2026-07-13",
        "status": "completed",
        "insertedAvailable": 1480,
        "completedAt": "2026-07-13T09:25:00Z"
      },
      {
        "incomingId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "documentNumber": "PM-2026-06-015",
        "documentDate": "2026-06-28",
        "status": "failed",
        "insertedAvailable": 0,
        "completedAt": "2026-06-28T14:10:00Z"
      }
    ],
    "page": 1,
    "pageSize": 50,
    "totalCount": 12
  },
  "meta": { "requestId": "req-001", "serverTime": "2026-07-13T12:00:00Z" }
}

Ошибки

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

cURL

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