Supplier incoming history

Journal of all supplier deliveries for ERP reconciliation.

Why this method exists

Journal of all supplier deliveries for ERP reconciliation.

When to use

Daily reconciliation, find past documentNumber, monitor failures.

Typical workflow

Filter by date range.
status=completed for success.
Reconcile insertedAvailable with ERP.

Endpoint

POST /v1/supplier/incoming/list

Authentication: X-Api-Key header (prefix bk_sup_). Do not send projectId or actor id in body — they come from the key.

Scope: supplier:incoming:read

Request example

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

Response example

{
  "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" }
}

Errors

UNAUTHORIZED / ACCESS_DENIED — access denied
VALIDATION_ERROR — invalid body
NOT_FOUND — resource not found
RATE_LIMIT_EXCEEDED (429) — rate limit

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" }}'