Как отправлять УПД покупателям через Контур.Диадок

УПД отгрузки или сделки сам попадает в ваш Диадок — остаётся подписать его своей подписью, и он уйдёт покупателю.

ЭДО — обмен документами в электронном виде через оператора, например Контур.Диадок. Такой УПД с электронными подписями обеих сторон имеет ту же силу, что и бумажный с печатями. CRM формирует электронный УПД (формат ФНС 5.03) и кладёт его в ваш ящик Диадока. Подписывает и отправляет документ человек: ключ электронной подписи (КЭП) остаётся у вас, CRM ничего не подписывает.

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

Ящик вашей организации в Диадоке и доступ к API — это отдельная подписка, её подключает менеджер Контура (заявка на diadoc.ru/integrations/api).
Кабинет интегратора integrations.kontur.ru — там выдают ключи для CRM.
Покупатель должен быть вашим контрагентом в Диадоке: по умолчанию ящики принимают документы только от контрагентов. Пригласите покупателя в самом Диадоке.

Получить ключи

В Кабинете интегратора откройте ваше приложение и скопируйте client_id.
В разделе «API-ключи» нажмите «Выпустить ключ» — это client_secret.
В разделе «Выпуск токенов» выберите scope openid profile email offline_access Diadoc.PublicAPI и получите refresh-токен. Выпускайте его под служебной учётной записью с правом «создание и редактирование документов» в ящике продавца. Право подписи ей не нужно.

Подключить в CRM

Откройте Маркетинг → Маркетплейс интеграций, найдите «Контур.Диадок» в группе «Документы» и нажмите Настроить.
На вкладке Установка вставьте client_id, client_secret и refresh-токен. Площадка — «Рабочая».
Подписант можно не заполнять: в УПД попадёт руководитель из реквизитов юрлица, а у ИП — сам предприниматель.
Нажмите Сохранить, затем Проверить подключение — CRM покажет организации, которые видит в Диадоке.

Отправить УПД

Откройте отгруженную отгрузку или закрытую сделку клиента-юрлица.
В блоке ЭДО · Диадок нажмите Отправить УПД в Диадок.
Нажмите Открыть в Диадоке — документ лежит в «Исходящих» со статусом «Требуется подписать и отправить».
Подпишите его в Диадоке своей КЭП. Подпись и есть отправка: документ уходит покупателю.
Статус в CRM обновляется кнопкой Обновить статус: «Ждёт подписи в Диадоке» → «Отправлен, ждёт подписи покупателя» → «Подписан покупателем».

Если не получилось

Покупателя нет в Диадоке — его нет у оператора по ИНН. Отдайте УПД на бумаге или пригласите покупателя в ЭДО.
Принимает документы только от контрагентов — отправьте покупателю приглашение в Диадоке и после согласия отправьте снова.
Не принял ключи — refresh-токен отозван или выпущен для другой площадки. Выпустите новый и вставьте его в карточку.
Не оплачен доступ к API — подписку на API оформляет менеджер Контура.
Если покупатель отказал в подписи, исправьте документ и отправьте УПД ещё раз. Новый УПД можно отправить и после ошибки.