List promo incoming documents

All incoming documents in project — Promo incoming tab equivalent.

Why this method exists

All incoming documents in project — Promo incoming tab equivalent.

When to use

Incoming journal, status filters, import SLA monitoring.

Endpoint

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

Authentication: JWT via Authorization: Bearer <token>. User must have project access and inventory_promo_codes permission.

Permission: inventory_promo_codes.view

Request example

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

Response example

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "supplierId": "c219ef09-ae2f-4d08-af11-7cd51006fae4",
        "supplierName": "Промомед",
        "documentNumber": "PM-2026-07-001",
        "documentDate": "2026-07-13",
        "status": "completed",
        "fileName": "Промокоды_июль.xlsx",
        "insertedAvailable": 1480,
        "duplicateRows": 10,
        "completedAt": "2026-07-13T09:20:00Z"
      }
    ],
    "page": 1,
    "pageSize": 50,
    "totalCount": 24
  }
}

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/internal/promo-code-incoming/list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"data": { "projectId": "a1b2…", "page": 1, "pageSize": 50, "supplierId": "c219ef09-…", "status": "completed", "documentDateFrom": "2026-07-01", "documentDateTo": "2026-07-31" }}'