Список поставщиков промокодов

Возвращает справочник контрагентов-поставщиков (Промомед, Эркафарм и т.

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

Возвращает справочник контрагентов-поставщиков (Промомед, Эркафарм и т.д.), от которых поступают файлы с кодами. Нужен для выбора поставщика при создании поступления и фильтрации отчётов.

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

При открытии вкладки «Поставщики», при создании поступления (dropdown), при настройке масок импорта.

Эндпоинт

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

Аутентификация: JWT — заголовок Authorization: Bearer <token>. Пользователь должен иметь доступ к проекту и permission inventory_promo_codes.

Permission: inventory_promo_codes.view

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

{
  "meta": { "requestId": "optional-uuid" },
  "data": { "projectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "page": 1, "pageSize": 50, "search": "промомед", "isActive": true }
}

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

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "c219ef09-ae2f-4d08-af11-7cd51006fae4",
        "name": "Промомед",
        "legalName": "АО Промомед",
        "inn": "7701234567",
        "isActive": true,
        "defaultMaskId": "uuid-маски",
        "ingestEmailsCount": 2
      }
    ],
    "page": 1,
    "pageSize": 50,
    "totalCount": 8
  }
}

Ошибки

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

cURL

curl -X POST "https://api-external.promanta.ru/v1/internal/promo-code-suppliers/list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT" \
  -d '{"data": { "projectId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "page": 1, "pageSize": 50, "search": "промомед", "isActive": true }}'