Определить задачу подключения

Внешняя система может получать разрешённые данные компании и выполнять доступные действия в пределах выданных прав. Сначала определите вместе с исполнителем: какие данные нужны, в какую сторону идёт обмен, кто проверяет результат и что делать при ошибке.

Для отчёта обычно достаточно чтения. Если требуется создание или изменение записей, отдельно согласуйте перечень таких действий. Наличие доступа не означает, что можно обойти согласование, подписание, оплату или складской порядок.

• Назовите подключение понятно: «1С — бухгалтерия», «Отчёты руководителя», «CRM — заявки».
• Назначьте ответственного со стороны компании и исполнителя настройки.
• Выберите небольшой проверочный объём; после сверки расширяйте обмен.
• Для каждой внешней системы используйте отдельный ключ, чтобы можно было остановить одну связь.

Владельцу: создать и передать ключ доступа

1. Откройте «Настройки → Интеграции и API». Создавать и отзывать ключи может только текущий владелец компании.
2. Нажмите «Создать токен». В форме «Новый токен» введите «Название интеграции» и выберите «Срок действия».
3. В «Разрешения» выберите «Чтение данных» либо нужное «Изменение данных». Оставьте только необходимое для согласованной задачи.
4. Нажмите «Создать токен». Сразу скопируйте полный ключ: повторно показать его нельзя.
5. Передайте ключ назначенному исполнителю через согласованный защищённый канал. Краткая видимая часть ключа из таблицы не подходит для подключения.

Управление доступом внешних систем

Проверить подключение до регулярной работы

Проверять токен и проверять бизнес-результат — разные шаги. Успешное подключение не доказывает, что исполнитель правильно сопоставил документы. Если ожидание ответа прервалось, сначала проверьте, не появилась ли запись: повтор без проверки может дать дубль.

1. Исполнитель открывает руководство и API-консоль по ссылкам ниже. Для консоли ему не требуется отдельная роль сотрудника компании.
2. В консоли он добавляет переданный ключ и нажимает «Проверить токен». Нужно получить подтверждение доступа и проверить компанию.
3. Проверьте вместе несколько исходных записей: проект, документ, количество, сумму и статус.
4. Если обмен создаёт записи, сначала выполните согласованное небольшое действие и проверьте его в обычной карточке программы. Только после этого включайте регулярный обмен.

Остановить или заменить доступ

«Забыть» в API-консоли убирает ключ только из открытой страницы. Чтобы остановить доступ внешней системы, нужен именно отзыв в настройках компании. Отзыв не отменяет уже выполненные операции и не удаляет ранее полученные другой системой данные.

1. Откройте список ключей в «Настройки → Интеграции и API». Найдите подключение по названию и статусу.
2. Нажмите «Отозвать» у ненужного ключа. Сообщите ответственному исполнителю, что эту связь больше не следует использовать.
3. Для нового исполнителя либо потерянного ключа создайте отдельный новый ключ и отзовите прежний.
4. После смены владельца компании настройте новые ключи: доступ по ключам прежнего владельца прекращается.

Исправить последствия ошибочного обмена

При отсутствии доступа проверьте статус ключа, права, владельца и выбранную компанию. При временном ограничении количества запросов исполнитель должен уменьшить частоту обмена и дождаться доступного времени. Для поддержки достаточно времени, названия подключения, описания действия и ошибки без полного ключа.

Подробные способы подключения, технические примеры, перечень данных и правила повторов сохранены в отдельном руководстве исполнителя. Пользователю достаточно проверить результат в привычных документах.

1. При повторяющихся ошибках остановите обмен у исполнителя; если доступ больше нельзя оставлять, отзовите его ключ.
2. Найдите созданные или изменённые документы в программе. Сверьте номер, дату, проект и связанные операции.
3. Отменяйте и корректируйте документы по обычному порядку их раздела: оплату, акт, закупку, поступление или расход. Сохраните причины и историю.
4. Пусть исполнитель устранит причину, проверит повторы и соответствие записей. Возобновляйте обмен после сверки небольшого примера.