Incoming document details and import status

Single incoming document with import pipeline status and row counters.

Why this method exists

Single incoming document with import pipeline status and row counters.

When to use

Poll after import until completed or failed.

Endpoint

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

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…", "incomingId": "f47ac10b-58cc-4372-a567-0e02b2c3d479" }
}

Response example

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

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