Права роли ключа
У каждого ключа интеграции есть своя роль — она создаётся вместе с ключом и видна в настройках компании. Её переключатели доступов меняют, что вернётся в ответе и какие операции пройдут внутри разрешённых маршрутов.
Два уровня доступа
Заголовок раздела «Два уровня доступа»Запрос ключа проходит две независимые проверки.
| Уровень 1 — маршрут | Уровень 2 — право роли | |
|---|---|---|
| Где проверяется | на входе, до выполнения метода | внутри метода, который отвечает на запрос |
| Что проверяет | пара «HTTP-метод + шаблон пути» есть в списке маршрутов ключа | конкретный переключатель доступа в роли ключа |
| Источник списка | общий шаблон, одинаковый у всех компаний | роль ключа, редактируется в интерфейсе |
| Если не прошло | 403 access denied |
поле обнулено, фильтр сброшен или отказ по бизнес-правилу |
Что включено сразу
Заголовок раздела «Что включено сразу»При создании ключа его роль получает ровно два права:
| Раздел → группа | Право |
|---|---|
| Товары → Каталог | Просмотр и поиск товаров в каталоге |
| Клиенты → Все клиенты | Возможность просмотра списка клиентов |
Каталог и клиенты входят в список маршрутов ключа, эти два переключателя на ответы не влияют. Все остальные сняты — из-за этого часть методов работает не полностью.
Карта: переключатель доступа → метод → что будет без него
Заголовок раздела «Карта: переключатель доступа → метод → что будет без него»Ниже — все места, где право роли меняет поведение метода, доступного ключу.
| Раздел → группа | Право | Метод ключа | Что будет без права |
|---|---|---|---|
| Товары → Каталог | Возможность просмотра цен поставки продуктов | GET /v2/products |
в каждом товаре supply_price = 0, supply_currency = "" — и в корне, и внутри shop_prices |
| Товары → Каталог | Возможность просмотра цен поставки продуктов | POST /v2/product-search-with-filters |
фильтр по цене поставки молча сбрасывается: supply_price_from / supply_price_to обнуляются, выборка приходит нефильтрованной |
| Товары → Каталог | Возможность просмотра остатка всех магазинов | POST /v2/product-search-with-filters |
shop_ids из запроса игнорируется — выборка идёт только по магазинам, привязанным к ключу |
| Товары → Трансфер | Возможность создавать трансферы | POST /v2/transfer |
запрос будет принят, но черновик не создастся: асинхронный отказ 403, user has no permission to create transfer, код 2007 |
| Товары → Заказы | Возможность возврата заказа | POST /v2/supplier-order с returned_supplier_order_id |
обычный заказ создастся, возврат — нет: асинхронный отказ 400, user has no permission to return supplier order, код 2029 |
| Продажи → Новая продажа | Возможность удалять отложки | DELETE /v2/order/:id, если продажа отложена |
асинхронный отказ 400, no permission to delete parked order, код 20116; обычные продажи удаляются как раньше |
Как выдать право
Заголовок раздела «Как выдать право»-
Настройки → Настройки компании → Ключи интеграции.
-
Открыть роль нужного ключа.

-
Отметить требуемые действия в нужной секции и сохранить.

Права кэшируются на 20 минут; изменение роли сбрасывает кэш.
Дополнительные материалы
Заголовок раздела «Дополнительные материалы»- Что может ключ интеграции — полный список маршрутов, уровень 1
- 403 и 404 — разбор отказов
- Аутентификация и права — как устроена модель доступа целиком