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

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

## Scenarios

### Documents awaiting a signature
The agent shows inbound documents with no response yet and singles out the ones sitting for more than a day, with counterparty, type and arrival date.

### What has stalled on the other side
The agent gathers the documents for a counterparty over a period and names the ones the other party has neither signed nor rejected.

### An EDI register for reconciliation
The agent consolidates inbound and outbound documents by type, date and counterparty and prepares a register ready to reconcile against your accounting system.

### Morning document flow digest
The agent sends you on schedule how many documents arrived overnight and what needs signing today, so nothing is left hanging.

## How to connect

### Request Diadoc API integration access
Submit the form at diadoc.ru/integrations/api: a Kontur manager will contact you, open the Integrator Cabinet and issue your application's client_id. Keys are not self-service — nothing is issued without this request.

### Issue a client_secret in the Integrator Cabinet
In the Integrator Cabinet the manager granted you, issue a client_secret for your client_id. The pair is only used to obtain a token — the API itself does not accept it.

### Get an access_token via OpenID Connect
Exchange client_id and client_secret for a token with the scope «openid profile email offline_access Diadoc.PublicAPI»: without Diadoc.PublicAPI the production API rejects it, and the legacy ddauth_api_client_id key is no longer issued.

### Copy your organization's box identifier
Open «Входящие документы» (Incoming documents) in Diadoc and copy the 32 characters between https://diadoc.kontur.ru/ and /Folder/Inbox in the address bar. In the API the same box reads as those 32 characters plus @diadoc.ru.

## FAQ

### How do I connect Kontur.Diadoc?
With two values: an access token and a box identifier. The token is obtained via OpenID Connect with the Diadoc.PublicAPI scope, and the box identifier is the 32 characters from the address bar of the Inbound documents section. Kontur issues the keys through a manager on request.

### What can the agent see in Diadoc?
Inbound, outbound and internal documents of the connected box, their attachments and document flow statuses, counterparties and the event feed — within the rights of the issued token.

### Can the agent sign a document for me?
No. The Diadoc API does not create signatures — a qualified electronic signature is produced on your side. The agent can prepare a draft and assemble a package for sending, but signing stays with the person holding the certificate.

### What if there are several organisations?
The box is fixed at connection time, so one organisation means one connection. The agent will list your legal entities and their box identifiers from the GetMyOrganizations response.

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