Контур.Диадок
Connect Kontur.Diadoc to the AI agent: inbound and outbound documents, counterparties, signing statuses
Connect Kontur.Diadoc to the AI agent: inbound and outbound documents, counterparties, signing statuses. The agent shows what awaits a signature and what stalled.
Documentation23 входящих за ночь, 6 из них ждут ответа дольше суток.
Самое старое — УПД от «Северторга» от 14 июля, лежит четвёртый день. Собрал их в один список с контрагентом, типом и датой поступления — подписывать вам, я только подсвечиваю.
Integration 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.
What the agent does in the first 10 minutes
- Shows incoming documents awaiting your signature and flags the ones left unanswered for over a day
- Collects every document with a counterparty over a period and names those the other side never answered
- Sends a morning digest: how many documents arrived overnight and what needs signing today
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.