Appearance
Запрос интеграции
Если нужного сервиса нет в маркете, администратор может отправить запрос через экран «Предложить интеграцию» в /app/settings/integrations?view=request.
Запросы помогают продуктовой команде планировать новые подключения и понимать, какие данные важны клиентам. Отправка запроса не означает автоматическое добавление интеграции в roadmap и не создает внешних обязательств по срокам.
Поля формы
| Поле | Обязательно | Описание |
|---|---|---|
Название сервиса | Да | Название внешнего сервиса или продукта |
Категория | Да | Категория маркета: 1С и ERP, ЭДО, банки, BI и др. |
Сайт сервиса | Нет | Публичный URL сервиса с протоколом, например https://example.com |
Зачем нужна интеграция | Да | Бизнес-сценарий: что нужно автоматизировать |
Какие данные нужно синхронизировать | Да | Сущности и направления обмена: поставщики, PO, счета, статусы |
Приоритет | Да | Низкий, Средний или Высокий |
API
Эндпоинт: POST /api/v1/integrations/requests
Создает запрос интеграции от текущего пользователя и текущего портала.
Тело запроса
json
{
"serviceName": "Новый оператор ЭДО",
"categorySlug": "edo-documents",
"serviceUrl": "https://example.com",
"reason": "Нужно автоматически получать входящие счета и УПД в закупочную воронку.",
"syncData": "Счета: чтение; Поставщики: чтение; Статусы подписания: чтение.",
"priority": "HIGH"
}Поля
| Поле | Тип | Ограничения |
|---|---|---|
serviceName | string | 2–180 символов |
categorySlug | string | 2–120 символов |
serviceUrl | string | Необязательно, URL с протоколом, до 1000 символов |
reason | string | 8–4000 символов |
syncData | string | 4–4000 символов |
priority | LOW | MEDIUM | HIGH | Приоритет запроса |
Ответ
json
{
"id": "d3bb8e4d-0000-0000-0000-000000000000",
"serviceName": "Новый оператор ЭДО",
"categorySlug": "edo-documents",
"priority": "HIGH",
"status": "NEW",
"createdAt": "2026-05-07T10:00:00.000Z"
}Статусы запроса
| Статус | Значение |
|---|---|
NEW | Запрос создан и ожидает просмотра |
REVIEWING | Запрос изучается командой |
PLANNED | Интеграция запланирована |
DECLINED | Запрос отклонен или не подходит продукту |
DONE | Интеграция реализована или закрыта другим способом |
Когда отправлять запрос
Отправляйте запрос, если сервис нужен для регулярного закупочного процесса, обмена документами, аналитики, склада, платежей или уведомлений. Чем точнее описаны данные и сценарий, тем проще оценить интеграцию.