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

Контур.Диадок подключает электронный документооборот к исходящим документам SNABZHENETS+: счетам клиенту, договорам и документам поставки.

После включения интеграции в карточках документов появляется виджет Контур.Диадок. Через него пользователь может отправить сформированный PDF или DOCX контрагенту, увидеть MessageId, EntityId, статус доставки и статус подписи.

Если у клиента одновременно подключены Контур.Диадок и СБИС / SABY ЭДО, в карточке документа отображается единый блок ЭДО с выбором оператора. Пользователь выбирает Контур.Диадок перед отправкой или проверкой статуса, а S+ хранит состояние Диадок отдельно от состояния SABY.

Где используется

Виджет Диадок доступен в:

• карточке исходящего счёта клиенту;
• карточке договора;
• истории документов поставки в логистике.

Если документ связан с контрагентом, S+ подставляет ИНН и КПП. Пользователь может указать BoxId получателя вручную или найти его через Диадок по ИНН/КПП.

Что передаётся

Данные	Направление
PDF или DOCX документа S+	из S+ в Диадок
BoxId отправителя и получателя	из S+ в Диадок
ИНН/КПП контрагента для поиска ящика	из S+ в Диадок
MessageId, EntityId и DocumentId	из Диадок в S+
Статус доставки и подписи	из Диадок в S+

Секреты авторизации, OAuth-токены, внутренние настройки и raw-ответы Диадок не показываются пользователям и не доступны в переменных документов.

Подключение

1. Откройте Интеграции → Маркетплейс.
2. Найдите Контур.Диадок в категории ЭДО и документы.
3. Установите интеграцию и авторизуйтесь через Контур ID.
4. Укажите BoxId ящика вашей организации.
5. Оставьте тип документа Nonformalized, если отправляете обычный PDF/DOCX, или укажите другой TypeNamedId, если ваша схема ЭДО требует формализованный тип.
6. Включите запрос подписи получателя, если документ должен быть подписан контрагентом.
7. Проверьте соединение и включите интеграцию.

Для подключения нужен аккаунт Диадок с доступом к ящику организации. Параметры OIDC-приложения Контур должны быть подготовлены администратором платформы или интегратором.

Отправка документа

1. Откройте счёт, договор или документ поставки.
2. В блоке Контур.Диадок проверьте получателя. Если открыт общий блок ЭДО, сначала выберите вкладку Контур.Диадок.
3. Если BoxId пустой, нажмите поиск по ИНН/КПП или заполните BoxId вручную.
4. Нажмите Отправить.
5. После отправки S+ сохранит MessageId, EntityId, имя файла, дату отправки и статус.

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

Двусторонние статусы

S+ отправляет документ в Диадок и затем получает состояние docflow обратно. В карточке документа отображаются:

• Отправлено;
• Доставлено;
• На подписи;
• Подписано;
• Отказано;
• Ошибка.

Когда счёт отправлен через Диадок, S+ переводит исходящий счёт в статус Отправлен, если он ещё не находится в финальном состоянии.

Когда договор подписан в Диадок, S+ переводит договор в статус Подписан, если договор ещё не закрыт, не отменён и не архивирован.

Переменные документов

Для счетов, договоров и документов поставки доступны переменные:

• diadoc.status;
• diadoc.signatureStatus;
• diadoc.statusText;
• diadoc.senderBoxId;
• diadoc.recipientBoxId;
• diadoc.messageId;
• diadoc.attachmentEntityId;
• diadoc.documentId;
• diadoc.sentAt;
• diadoc.syncedAt;
• diadoc.signedAt.

Их можно использовать в шаблонах и через Variable API. Например:

Статус ЭДО: {{diadoc.statusText|default:документ ещё не отправлен}}
MessageId: {{diadoc.messageId|default:нет}}

Ограничения

• Для отправки нужен доступ пользователя к экспорту соответствующего документа.
• Если у контрагента нет ИНН или Диадок не нашёл ящик, нужно указать BoxId вручную.
• Для формализованных документов тип, функция и версия должны соответствовать правилам Диадок и договорённостям с контрагентом.