Интеграция с Контур Диадок
Отправка документов в Диадок
Данное активити отвечает за автоматическую передачу документов из Битрикс24 в систему электронного документооборота Контур.Диадок. Оно используется внутри бизнес-процессов и позволяет исключить ручную загрузку файлов в ЭДО.
Назначение
Активити берёт документы из указанного поля в CRM (лид, сделка, контакт, компания) и передаёт их в Контур.Диадок с необходимыми параметрами:
- От имени вашей организации;
- На имя выбранного контрагента;
- С указанием пользователя, который должен подписать документ в Диадоке.
Поддерживается работа как с одиночными файлами, так и с множественными — активити корректно обрабатывает оба типа.
Входные параметры
| Параметр | Описание |
|---|---|
| ИНН контрагента | ИНН организации, которой отправляются документы. Используется как один из идентификаторов при передаче |
| ФНС ИД контрагента | Уникальный идентификатор контрагента в системе ЭДО. Может быть получен через активити «Проверить контрагента по ИНН» |
| ИНН вашей компании | ИНН организации, от имени которой происходит отправка. Это важно для корректной идентификации в Диадок |
| Документы | Поле с файлами, которые необходимо передать. Поддерживаются как одиночные, так и множественные значения (множественные поля Битрикс24) |
| Документы из генератора документов | Если вы будете отправлять документы из генератора документов, укажите список документов для отправки (через запятую) |
| Идентификатор подписанта | ID пользователя в системе Диадок, на которого переводим документ для подписания |
Результаты выполнения
| Параметр | Описание |
|---|---|
| DiaDocMessageId | Идентификатор сообщения отправленного в Диадок |
| DiaDocDocumentIds | ID документов отправленных в Диадок |
| DocumentURLs | URL документа отправленного в Диадок |
Как использовать возвращаемые значения
- DocumentURLs — можно передать в уведомление или письмо сотруднику, чтобы он мог сразу перейти к документу в Диадоке
- DiaDocDocumentIds — использовать для логирования и отслеживания статуса документа в дальнейшем
- DiaDocMessageId — пригодится при интеграции с внешними системами или расширенном аудите
Как работает
- Бизнес-процесс запускает активити
- Из указанного поля CRM подтягиваются документы
- На основе заданных параметров формируется и отправляется пакет в Диадок
- Документы загружаются в систему и становятся доступными для подписания ответственным лицом
Рекомендации по использованию
- Перед запуском этого активити убедитесь, что контрагент уже есть в системе Диадок — используйте для этого проверку через соответствующее активити
- ФНС ИД и Идентификатор подписанта — обязательны для корректной маршрутизации документа внутри Диадок
- Если вы отправляете документы в зависимости от условий сделки или стадии, добавьте логику ветвления в бизнес-процесс
Пример сценария
- Менеджер переходит на стадию "Подписание договора"
- Активити проверяет наличие контрагента и получает его ФНС ИД
- Документы из поля "Файлы договора" передаются в Диадок
- Ответственный сотрудник получает задачу подписания — и всё это без ручных действий