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

Электронный документооборот — отправка, получение и подписание документов

## Сценарии

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

### Что зависло у контрагента
Агент соберёт по контрагенту документы за период и назовёт те, где вторая сторона не подписала и не отклонила отправленное.

### Реестр ЭДО для сверки
Агент сведёт входящие и исходящие документы по типам, датам и контрагентам и подготовит реестр под сверку с учётной системой.

### Утренняя сводка по документообороту
Агент по расписанию пришлёт, сколько документов пришло за ночь и что требует подписи сегодня, чтобы ничего не повисло.

## Как подключить

### Оставьте заявку на интеграцию с API Диадока
На diadoc.ru/integrations/api оставьте заявку: менеджер Контура свяжется, откроет Кабинет интегратора и выдаст client_id приложения. Ключи не самообслуживаемые — без заявки их не выпускают.

### Выпустите client_secret в Кабинете интегратора
В Кабинете интегратора, доступ к которому дал менеджер, выпустите client_secret к своему client_id. Пара нужна только для получения токена — сам API её не принимает.

### Получите access_token по OpenID Connect
Обменяйте client_id и client_secret на токен со scope «openid profile email offline_access Diadoc.PublicAPI»: без Diadoc.PublicAPI боевой API откажет, а старый ключ ddauth_api_client_id новым интеграциям не выдают.

### Скопируйте идентификатор ящика организации
Откройте в Диадоке раздел «Входящие документы» и скопируйте из адресной строки 32 символа между https://diadoc.kontur.ru/ и /Folder/Inbox. В API тот же ящик выглядит как 32 символа плюс @diadoc.ru.

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

### Как подключить Контур.Диадок?
Двумя значениями: токеном доступа и идентификатором ящика. Токен получают по OpenID Connect со scope Diadoc.PublicAPI, а идентификатор ящика — это 32 символа из адресной строки раздела «Входящие документы». Ключи выдаёт менеджер Контура по заявке.

### Что агент видит в Диадоке?
Входящие, исходящие и внутренние документы подключённого ящика, их вложения и статусы документооборота, контрагентов и ленту событий — в пределах прав выданного токена.

### Может ли агент подписать документ за меня?
Нет. API Диадока не формирует подпись — КЭП создаётся на вашей стороне. Агент может подготовить черновик и собрать пакет к отправке, но подписание остаётся за человеком с сертификатом.

### Что делать, если организаций несколько?
Ящик задаётся при подключении, поэтому одна организация — одно подключение. Список своих юридических лиц и идентификаторов их ящиков агент покажет из ответа метода GetMyOrganizations.

[Открыть Контур.Диадок](https://diadoc.kontur.ru)