# ЭДО, отчётность и маркировка Документооборот подключается в разделе **«Интеграции»**. Общие правила (виды подключения, статусы карточки, «Только чтение», отключение) описаны на странице [«Подключение сервисов»](/help/integrations). Как агент спрашивает перед изменениями, рассказано в [«Как агент меняет данные»](/help/trust). Агент работает с правами того сотрудника или ключа, который вы подключили. Квалифицированную подпись с носителя ставите вы. Про 1С и МойСклад отдельные страницы: [«1С»](/help/onec) и [«МойСклад»](/help/moysklad). ## СБИС (Saby) Отправка, получение и подписание документов. Подробнее на [странице интеграции](/integrations/sbis). ### Что умеет агент Читает входящие и исходящие документы с вложениями и статусами, проверяет, подключён ли контрагент к ЭДО, собирает пакет к отправке, если у подключения есть права на запись. Серверным сертификатом компании агент подписывает только по вашей прямой команде. ### Что нужно заранее Сотрудник Saby, чья роль открывает нужные разделы. Если в профиле несколько организаций, решите, чьи документы нужны агенту. ### Шаги В карточке **«СБИС (Saby)»** два способа. Основной: ### Нажмите «Подключить через Saby» Войдите на online.sbis.ru логином и паролем нужного сотрудника. ### Выберите организацию и подтвердите доступ Если организаций несколько, войдите в ту, чьи документы нужны агенту, и подтвердите согласие на доступ к данным. Если вход через аккаунт не подходит, под кнопкой есть строка **«Другой способ подключения»**: сервисный ключ своего приложения. ### Откройте «Подключения к Saby» В кабинете online.sbis.ru: **«Настройки» → блок «Система» → «Безопасность» → «Подключения к Saby»**, нажмите кнопку добавления. ### Заполните карточку приложения Название и описание любые понятные вам, например «Сам Решу». Выберите тип приложения. Поле адреса внешней системы или IP ограничивает, откуда Saby принимает запросы авторизации; пустое поле пускает с любого адреса. ### Выдайте права Сервисный доступ **«Разрешен полностью»** или **«С ограничением по правам»** с доступом к документообороту. Тип авторизации **«по сервисному ключу»**. Сохраните. ### Перенесите три значения в форму «ID подключения» в **«ID приложения»**, «Защищенный ключ» (раскрывается значком глаза) в **«Секрет приложения»**, сервисный ключ из строки «с авторизацией по сервисному ключу» в **«Ключ сервиса»**. ### Какие права выдать При входе через Saby агент получает права сотрудника: чтобы оставить ему только документооборот, подключайте под сотрудником, чья роль открывает только эти разделы. У сервисного ключа права задаются в карточке приложения. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Приложение сервисного ключа удаляется в «Подключениях к Saby». ### Неполадки - **Агент не видит документы другой организации**: при входе была выбрана другая организация. Подключите нужную через **«Добавить ещё»**. - **«Не хватает прав»**: роль сотрудника или приложения не открывает раздел. Расширьте её в Saby. ## Контур.Диадок Отправка, получение и подписание документов. Подробнее на [странице интеграции](/integrations/diadoc). ### Что умеет агент Читает входящие и исходящие документы ящика, готовит отправку в пределах прав ключа. ### Что нужно заранее Кабинет интегратора на integrations.kontur.ru: ключи API Диадока выдаются по заявке на diadoc.ru/integrations/api, менеджер Контура открывает кабинет. ### Шаги ### Возьмите client_id и client_secret Оба значения лежат в Кабинете интегратора. Вставьте их в **«ID клиента»** и **«Секрет клиента»**. ### Выпустите refresh-токен Выберите clientMode «AuthorizationCode», отметьте scope openid, offline_access и Diadoc.PublicAPI и нажмите «Получить refresh-токен». Вставьте его в **«Refresh-токен»**. ### Скопируйте ID ящика Откройте «Входящие документы» и скопируйте из адресной строки 32 символа между diadoc.kontur.ru/ и /Folder/Inbox в **«ID ящика»**. ### Ограничения Подключение само регулярно меняет refresh-токен, и прежний сразу перестаёт работать. Не вставляйте этот же токен в другую программу: там он перестанет работать после первого обмена. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Приложение и его ключи живут в Кабинете интегратора Контура. ### Неполадки - **Refresh-токен не выдают**: не отмечен scope offline_access. - **«Ключи не приняты»** после того же токена в другой программе: выпустите новый refresh-токен только для этого подключения. ## Контур.Экстерн Электронная отчётность: черновики, документообороты, организации, сертификаты. Подробнее на [странице интеграции](/integrations/kontur-extern). ### Что умеет агент Работает с черновиками и документооборотами отчётности ваших организаций. ### Шаги ### Отправьте заявку Форма «Отправить заявку» на kontur.ru/extern/api. Менеджер пришлёт письмо с client_id и ссылкой на выпуск ключа. ### Выпустите ключ По ссылке из письма на integrations.kontur.ru нажмите «Выпустить ключ». ### Заполните форму client_id из письма в **«ID клиента»**, выпущенный ключ в **«API-ключ»**. ### Ограничения Ключ из первого письма работает только на тестовой площадке testkontur.ru. Боевой ключ выпускается так же после договора с Контуром. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Ключ управляется на integrations.kontur.ru. ### Неполадки - **Отчётность не видна**: подключён тестовый ключ. После договора выпустите боевой и нажмите **«Ввести ключи заново»**. ## Контур.Фокус Проверка контрагентов по ИНН и ОГРН: реквизиты, риски, мониторинг. Подробнее на [странице интеграции](/integrations/kontur-focus). ### Что умеет агент Проверяет компании и ИП по ИНН и ОГРН перед сделкой. ### Шаги ### Оставьте заявку На focus.kontur.ru/site/api нажмите «Бесплатная консультация» и укажите ИНН компании. Попросите метод «Реквизиты» (/api3/req): без него запросы вернут отказ по правам. ### Вставьте ключ из письма Ключ приходит письмом на адрес из договора, в интерфейсе Фокуса он не показывается. Вставьте его в **«API-ключ»**. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Ключ выдаёт и закрывает Контур по договору. ### Неполадки - **Отказ по правам**: в договоре нет метода «Реквизиты». Проверить ключ можно на focus-api.kontur.ru/api3/req/userform. ## Честный ЗНАК Маркировка товаров: коды маркировки, документы, карточки товаров, остатки. Подробнее на [странице интеграции](/integrations/chestnyznak). ### Что умеет агент Читает и проверяет коды маркировки и их статусы, документы, карточки товаров, остатки и готовит списки под подписание. Подача документов в оборот требует УКЭП с вашего носителя, её делаете вы. ### Что нужно заранее - Участие в ГИС МТ: в **«Профиль» → «Данные участника»** должна быть ваша товарная группа. Один ИНН, один кабинет. - Программа с КриптоПро и ваша УКЭП, чтобы получить токен. ### Шаги ### Получите токен True API Его выдаёт сам True API, а не кабинет: программа с КриптоПро берёт у True API строку для подписи (`/auth/key`), подписывает её вашей УКЭП и получает токен в ответ на `/auth/simpleSignIn`. Так его получают 1С и учётные системы с поддержкой маркировки. ### Вставьте токен Вставьте токен в поле **«Токен авторизации»**. Это длинная строка из трёх частей через точку. ### Ограничения - Кнопка **«Сгенерировать токен»** в профиле ГИС МТ не подходит: она выдаёт ключ для проверок на кассе, True API его не принимает. - Токен True API живёт ограниченное время. Когда он истечёт, агент скажет об этом: выпустите новый и обновите его в подключении. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Токен сам перестаёт действовать по истечении срока. ### Неполадки - **«Ключи не приняты»**: токен истёк. Выпустите новый и нажмите **«Ввести ключи заново»**. - **Нет данных по товарной группе**: группа не добавлена в профиле участника. ## ПАРУС 8 (Сервис интеграции) Обмен с ПАРУС 8 через сервер приложений «Сервис интеграции с WEB API». Подробнее на [странице интеграции](/integrations/parus-exchange). ### Что умеет агент Вызывает операции, которые вы объявили в «Функциях сервиса» базы. ### Что нужно заранее Сервер приложений «Сервис интеграции с WEB API», поставленный рядом с базой ПАРУС 8: без него запрос до базы не дойдёт. ### Шаги ### Задайте сервис обмена В справочнике «Сервисы обмена» создайте сервис и задайте его корень URL. ### Объявите функции В справочнике «Функции сервиса» задайте для каждой операции адрес, HTTP-метод и обработчик в базе. ### Заполните форму Адрес сервера приложений с портом в **«URL сервера»**, корень сервиса в **«Корень сервиса обмена»**. ### Ограничения Не объявленного в «Функциях сервиса» адреса для сервера нет: он ответит 404. ### Как отозвать доступ Нажмите **«Отключить»** у нас. Операции убираются из «Функций сервиса». ### Неполадки - **Подключение не проходит**: откройте адрес сервера вместе с корнем сервиса в браузере. Живой обмен отвечает страницей с версией сервера приложений и именем сервиса. ## HRlink КЭДО Кадровый ЭДО: документы, заявления, сотрудники. Подробнее на [странице интеграции](/integrations/hrlink). ### Что умеет агент Читает реестры сотрудников и документов, заявления. ### Что нужно заранее Сотрудник с ролью «Кадровик»: у остальных ролей реестры закрыты, а выдачи токена в меню нет. Адрес своего кабинета вида company.hr-link.ru. ### Шаги ### Выпустите токен Иконка с инициалами справа вверху → «Получить API-токен» → «Скопировать». Вставьте его в **«API-токен»**. ### Укажите адрес и ID клиента Адрес кабинета в **«URL сервера»**, идентификатор клиента HRlink в **«ID клиента»**: его отдаёт вызов `GET /api/v2/currentUser` на вашем адресе, поле `currentUser.clientUsers[].client.id`. Если HRlink выдал вам токен интеграции, вместо токена кадровика заполните **«Мастер-токен»** и **«Пользователь для мастер-токена»**: агент работает от имени этого пользователя. ### Ограничения Токен кадровика действует ограниченный срок, потом его выпускают заново. ### Как отозвать доступ Нажмите **«Отключить»** у нас. ### Неполадки - **Реестры отвечают отказом**: токен выпущен не под ролью «Кадровик». - **Не тот кабинет**: общий portal.hr-link.ru вашему кабинету не подходит, укажите свой адрес.