ЭДО, отчётность и маркировка

Документооборот подключается в разделе «Интеграции». Общие правила (виды подключения, статусы карточки, «Только чтение», отключение) описаны на странице «Подключение сервисов». Как агент спрашивает перед изменениями, рассказано в «Как агент меняет данные».

Агент работает с правами того сотрудника или ключа, который вы подключили. Квалифицированную подпись с носителя ставите вы. Про 1С и МойСклад отдельные страницы: «1С» и «МойСклад».

СБИС (Saby)

Отправка, получение и подписание документов. Подробнее на странице интеграции.

Что умеет агент

Читает входящие и исходящие документы с вложениями и статусами, проверяет, подключён ли контрагент к ЭДО, собирает пакет к отправке, если у подключения есть права на запись. Серверным сертификатом компании агент подписывает только по вашей прямой команде.

Покажи в @sbis входящие документы, которые ждут нашего решения: контрагент, сумма, дата поступления. Ничего не подписывай.

Открыть в чате

Что нужно заранее

Сотрудник Saby, чья роль открывает нужные разделы. Если в профиле несколько организаций, решите, чьи документы нужны агенту.

Шаги

В карточке «СБИС (Saby)» два способа. Основной:

1

Нажмите «Подключить через Saby»

Войдите на online.sbis.ru логином и паролем нужного сотрудника.

2

Выберите организацию и подтвердите доступ

Если организаций несколько, войдите в ту, чьи документы нужны агенту, и подтвердите согласие на доступ к данным.

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

1

Откройте «Подключения к Saby»

В кабинете online.sbis.ru: «Настройки» → блок «Система» → «Безопасность» → «Подключения к Saby», нажмите кнопку добавления.

2

Заполните карточку приложения

Название и описание любые понятные вам, например «Сам Решу». Выберите тип приложения. Поле адреса внешней системы или IP ограничивает, откуда Saby принимает запросы авторизации; пустое поле пускает с любого адреса.

3

Выдайте права

Сервисный доступ «Разрешен полностью» или «С ограничением по правам» с доступом к документообороту. Тип авторизации «по сервисному ключу». Сохраните.

4

Перенесите три значения в форму

«ID подключения» в «ID приложения», «Защищенный ключ» (раскрывается значком глаза) в «Секрет приложения», сервисный ключ из строки «с авторизацией по сервисному ключу» в «Ключ сервиса».

Какие права выдать

При входе через Saby агент получает права сотрудника: чтобы оставить ему только документооборот, подключайте под сотрудником, чья роль открывает только эти разделы. У сервисного ключа права задаются в карточке приложения.

Как отозвать доступ

Нажмите «Отключить» у нас. Приложение сервисного ключа удаляется в «Подключениях к Saby».

Неполадки

  • Агент не видит документы другой организации: при входе была выбрана другая организация. Подключите нужную через «Добавить ещё».
  • «Не хватает прав»: роль сотрудника или приложения не открывает раздел. Расширьте её в Saby.

Контур.Диадок

Отправка, получение и подписание документов. Подробнее на странице интеграции.

Что умеет агент

Читает входящие и исходящие документы ящика, готовит отправку в пределах прав ключа.

Что нужно заранее

Кабинет интегратора на integrations.kontur.ru: ключи API Диадока выдаются по заявке на diadoc.ru/integrations/api, менеджер Контура открывает кабинет.

Шаги

1

Возьмите client_id и client_secret

Оба значения лежат в Кабинете интегратора. Вставьте их в «ID клиента» и «Секрет клиента».

2

Выпустите refresh-токен

Выберите clientMode «AuthorizationCode», отметьте scope openid, offline_access и Diadoc.PublicAPI и нажмите «Получить refresh-токен». Вставьте его в «Refresh-токен».

3

Скопируйте ID ящика

Откройте «Входящие документы» и скопируйте из адресной строки 32 символа между diadoc.kontur.ru/ и /Folder/Inbox в «ID ящика».

Ограничения

Подключение само регулярно меняет refresh-токен, и прежний сразу перестаёт работать. Не вставляйте этот же токен в другую программу: там он перестанет работать после первого обмена.

Как отозвать доступ

Нажмите «Отключить» у нас. Приложение и его ключи живут в Кабинете интегратора Контура.

Неполадки

  • Refresh-токен не выдают: не отмечен scope offline_access.
  • «Ключи не приняты» после того же токена в другой программе: выпустите новый refresh-токен только для этого подключения.

Контур.Экстерн

Электронная отчётность: черновики, документообороты, организации, сертификаты. Подробнее на странице интеграции.

Что умеет агент

Работает с черновиками и документооборотами отчётности ваших организаций.

Шаги

1

Отправьте заявку

Форма «Отправить заявку» на kontur.ru/extern/api. Менеджер пришлёт письмо с client_id и ссылкой на выпуск ключа.

2

Выпустите ключ

По ссылке из письма на integrations.kontur.ru нажмите «Выпустить ключ».

3

Заполните форму

client_id из письма в «ID клиента», выпущенный ключ в «API-ключ».

Ограничения

Ключ из первого письма работает только на тестовой площадке testkontur.ru. Боевой ключ выпускается так же после договора с Контуром.

Как отозвать доступ

Нажмите «Отключить» у нас. Ключ управляется на integrations.kontur.ru.

Неполадки

  • Отчётность не видна: подключён тестовый ключ. После договора выпустите боевой и нажмите «Ввести ключи заново».

Контур.Фокус

Проверка контрагентов по ИНН и ОГРН: реквизиты, риски, мониторинг. Подробнее на странице интеграции.

Что умеет агент

Проверяет компании и ИП по ИНН и ОГРН перед сделкой.

Шаги

1

Оставьте заявку

На focus.kontur.ru/site/api нажмите «Бесплатная консультация» и укажите ИНН компании. Попросите метод «Реквизиты» (/api3/req): без него запросы вернут отказ по правам.

2

Вставьте ключ из письма

Ключ приходит письмом на адрес из договора, в интерфейсе Фокуса он не показывается. Вставьте его в «API-ключ».

Как отозвать доступ

Нажмите «Отключить» у нас. Ключ выдаёт и закрывает Контур по договору.

Неполадки

  • Отказ по правам: в договоре нет метода «Реквизиты». Проверить ключ можно на focus-api.kontur.ru/api3/req/userform.

Честный ЗНАК

Маркировка товаров: коды маркировки, документы, карточки товаров, остатки. Подробнее на странице интеграции.

Что умеет агент

Читает и проверяет коды маркировки и их статусы, документы, карточки товаров, остатки и готовит списки под подписание. Подача документов в оборот требует УКЭП с вашего носителя, её делаете вы.

Что нужно заранее

  • Участие в ГИС МТ: в «Профиль» → «Данные участника» должна быть ваша товарная группа. Один ИНН, один кабинет.
  • Программа с КриптоПро и ваша УКЭП, чтобы получить токен.

Шаги

1

Получите токен True API

Его выдаёт сам True API, а не кабинет: программа с КриптоПро берёт у True API строку для подписи (/auth/key), подписывает её вашей УКЭП и получает токен в ответ на /auth/simpleSignIn. Так его получают 1С и учётные системы с поддержкой маркировки.

2

Вставьте токен

Вставьте токен в поле «Токен авторизации». Это длинная строка из трёх частей через точку.

Ограничения

  • Кнопка «Сгенерировать токен» в профиле ГИС МТ не подходит: она выдаёт ключ для проверок на кассе, True API его не принимает.
  • Токен True API живёт ограниченное время. Когда он истечёт, агент скажет об этом: выпустите новый и обновите его в подключении.

Как отозвать доступ

Нажмите «Отключить» у нас. Токен сам перестаёт действовать по истечении срока.

Неполадки

  • «Ключи не приняты»: токен истёк. Выпустите новый и нажмите «Ввести ключи заново».
  • Нет данных по товарной группе: группа не добавлена в профиле участника.

ПАРУС 8 (Сервис интеграции)

Обмен с ПАРУС 8 через сервер приложений «Сервис интеграции с WEB API». Подробнее на странице интеграции.

Что умеет агент

Вызывает операции, которые вы объявили в «Функциях сервиса» базы.

Что нужно заранее

Сервер приложений «Сервис интеграции с WEB API», поставленный рядом с базой ПАРУС 8: без него запрос до базы не дойдёт.

Шаги

1

Задайте сервис обмена

В справочнике «Сервисы обмена» создайте сервис и задайте его корень URL.

2

Объявите функции

В справочнике «Функции сервиса» задайте для каждой операции адрес, HTTP-метод и обработчик в базе.

3

Заполните форму

Адрес сервера приложений с портом в «URL сервера», корень сервиса в «Корень сервиса обмена».

Ограничения

Не объявленного в «Функциях сервиса» адреса для сервера нет: он ответит 404.

Как отозвать доступ

Нажмите «Отключить» у нас. Операции убираются из «Функций сервиса».

Неполадки

  • Подключение не проходит: откройте адрес сервера вместе с корнем сервиса в браузере. Живой обмен отвечает страницей с версией сервера приложений и именем сервиса.

Кадровый ЭДО: документы, заявления, сотрудники. Подробнее на странице интеграции.

Что умеет агент

Читает реестры сотрудников и документов, заявления.

Что нужно заранее

Сотрудник с ролью «Кадровик»: у остальных ролей реестры закрыты, а выдачи токена в меню нет. Адрес своего кабинета вида company.hr-link.ru.

Шаги

1

Выпустите токен

Иконка с инициалами справа вверху → «Получить API-токен» → «Скопировать». Вставьте его в «API-токен».

2

Укажите адрес и ID клиента

Адрес кабинета в «URL сервера», идентификатор клиента HRlink в «ID клиента»: его отдаёт вызов GET /api/v2/currentUser на вашем адресе, поле currentUser.clientUsers[].client.id.

Если HRlink выдал вам токен интеграции, вместо токена кадровика заполните «Мастер-токен» и «Пользователь для мастер-токена»: агент работает от имени этого пользователя.

Ограничения

Токен кадровика действует ограниченный срок, потом его выпускают заново.

Как отозвать доступ

Нажмите «Отключить» у нас.

Неполадки

  • Реестры отвечают отказом: токен выпущен не под ролью «Кадровик».
  • Не тот кабинет: общий portal.hr-link.ru вашему кабинету не подходит, укажите свой адрес.

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

Как подключить СБИС, если вход через Saby не подходит?

Подключитесь сервисным ключом своего приложения. В Saby: «Настройки» → блок «Система» → «Безопасность» → «Подключения к Saby», добавьте внешнее приложение с типом авторизации «по сервисному ключу». В форму «Сам Решу» перенесите три значения: «ID подключения» в поле «ID приложения», «Защищенный ключ» в «Секрет приложения», сервисный ключ в «Ключ сервиса».

Какой токен нужен для Честного ЗНАКа?

Токен True API, который выпускается по подписи УКЭП. Кнопка «Сгенерировать токен» в профиле ГИС МТ не подходит: она выдаёт ключ для проверок на кассе. Токен True API живёт ограниченное время, после этого его нужно выпустить заново и обновить в подключении.

Подписывает ли агент документы в ЭДО?

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

Где взять ключи Диадока и Контур.Экстерна?

Ключи API у Контура выдаются по заявке: для Диадока на diadoc.ru/integrations/api, для Экстерна на kontur.ru/extern/api. Менеджер откроет Кабинет интегратора, там выпускаются нужные значения.

Смотрите также

Была ли страница полезна?

Не нашли ответ? Как связаться