Получение API-токена

API-токен — ключ доступа к REST API Консоль.Про. Он нужен для настройки интеграции с CRM, 1С, собственным сервером или другой внешней системой.

Токен создаётся в личном кабинете компании и передаётся в заголовке HTTP-запросов к https://api.konsol.pro/

Обзор возможностей API и ссылка на документацию — в статье «Возможности и документация API». Методы и примеры запросов — на docs.konsol.pro.

Кто может получить API-токен

Создавать и управлять API-токенами могут только сотрудники с ролями:

• Админ
• Оунер (владелец кабинета)

Сотрудники с другими ролями (Бухгалтер, Менеджер, кастомные роли) не видят раздел «Интеграции» и не могут выпустить токен.

Как выдать сотруднику роль Админа — см. «Как добавить сотрудников».

Зачем нужен API-токен

API-токен потребуется для настройки интеграции — без него внешняя система не сможет обращаться к API Консоль.

Типичные сценарии:

• автоматическая выгрузка актов и пачек из 1С или CRM;
• приглашение исполнителей и получение статусов регистрации;
• запрос баланса и выписок по счёту компании;
• модуль 1С — в настройках обработки указывается тот же API-токен (64 символа).

Как получить API-токен

API-токен создаётся в личном кабинете:

• Нажмите на название компании в верхнем левом углу экрана.
• Перейдите на вкладку «Интеграции».

• Нажмите «+ Создать API-токен».
• Введите название токена (например, «1С» или «CRM»).
• При необходимости добавьте IP-адреса, с которых будет доступ к API, и нажмите Enter после каждого адреса.
• Нажмите «Сгенерировать».

• После генерации скопируйте значение токена из появившегося сообщения или через ⋮ → Скопировать.

При создании токена учитывайте:

• Длина токена — 64 символа. Копируйте полностью, не обрезайте.
• IP-адреса — указывать необязательно. Если адреса ещё не известны, токен можно создать без них.
• IP сервера — если запросы идут с удалённого сервера, указывайте IP сервера, а не вашего компьютера.
• Название — произвольное; помогает различать токены для разных интеграций.

Обратите внимание: если вы планируете отправлять запросы к API с удалённого сервера, необходимо указывать IP-адрес этого сервера, а не вашего устройства.

Сохраните токен в надёжном месте. После закрытия окна полное значение можно снова получить только через ⋮ → Скопировать в списке токенов.

Можно ли создать несколько токенов

Да. Вы можете создавать отдельный токен для каждой интеграции (1С, CRM, тестовый сервер и т. п.).

Список всех токенов отображается на вкладке «Интеграции».

Управление токеном

Нажмите три точки (⋮) возле нужного токена:

• Изменить — название и список IP-адресов;
• Скопировать — скопировать значение токена (64 символа);
• Удалить — отозвать токен (интеграция с этим ключом перестанет работать).

Частые вопросы

Не вижу раздел «Интеграции»

Раздел доступен только ролям Админ и Оунер. Попросите администратора кабинета создать токен или выдать вам соответствующую роль.

«Ваш IP не имеет доступ к текущему токену»

IP-адрес запроса не входит в whitelist токена.

Что сделать: откройте ⋮ → Изменить и добавьте IP сервера, с которого идут запросы. Для интеграции с 1С — это IP сервера 1С, а не рабочего места бухгалтера.

«Необходимо передать действующий токен в заголовке запроса»

Токен не передан, обрезан при копировании или указан неверно.

Что сделать: скопируйте токен заново через ⋮ → Скопировать и проверьте заголовок авторизации по документации.

API-токен — это не «токен банка»

• API-токен (64 символа) — доступ к REST API Консоль.
• Токен банка (Тинькофф, Альфа и др.) — партнёр для чеков самозанятых в «Мой налог».

Это разные сущности. API-токен настраивается в «Интеграции», токен банка — в процессе подключения самозанятых к «Мой налог».

Нужно проверить конкретный запрос к API

Напишите в чат поддержки и приложите:

• метод и URL запроса;
• тело запроса (payload);
• полный текст ошибки из ответа API.

Подробнее о типовых ошибках — в статье «Возможности и документация API».