Интеграция 1С с Диадок: документы, статусы и контроль обмена

Что должна решать интеграция 1С с Диадоком?

Рабочая интеграция создает проверяемую связь между объектом учета и электронным документооборотом. Она помогает подготовить документ из данных 1С, выбрать получателя и ящик, передать документ на допустимое действие, получить события Диадока и показать сотруднику понятный результат.

До разработки выберите конкретный поток: например, исходящие УПД из одной организации или входящие акты для одного подразделения. Одновременный запуск всех видов документов, баз и ролей затрудняет поиск причины ошибки и не дает надежной контрольной выборки.

Что выбрать: модуль, коннектор или API?

Выбор зависит от конфигурации 1С, размещения базы, поддерживаемых документов, объема операций и требуемой логики. Страница Диадока для 1С публикует актуальные материалы по модулю и коннектору. Совместимость и ограничения нужно проверять для текущей версии, а не переносить из старой инструкции.

API дает больше свободы, но превращает обновление интеграции в ответственность команды. Официальная документация указывает, что API позволяет работать с документами, статусами, событиями, контрагентами и ответными действиями. Для автоматической работы нужно отдельно реализовать получение и обновление токенов, проверку прав и безопасное хранение секретов.

Что проверить до подключения?

Инвентаризация до установки экономит время на диагностике. Команда фиксирует не только название конфигурации, но и реальный поток документов, расширения, права, организации, подразделения, сертификаты, ящики Диадока и ответственных за справочники.

1. Запишите версию платформы, конфигурации, режима совместимости и способ размещения базы.
2. Определите организации и подразделения 1С, которые участвуют в обмене.
3. Составьте перечень видов документов, форматов и ответных действий.
4. Проверьте ящики Диадока, доступ пользователей и права на просмотр, отправку и подпись.
5. Назначьте владельцев сопоставления контрагентов, договоров, номенклатуры и подразделений.
6. Выберите тестовую базу и набор обезличенных либо согласованных контрольных документов.
7. Опишите резервный порядок работы при недоступности 1С, Диадока или канала связи.

Не переносите рабочий закрытый ключ подписи в тестовую среду. Пилот должен воспроизводить структуру данных и права, но доступ к сертификатам, персональным данным и продуктивным ящикам выдают только в необходимом объеме.

Как сопоставить документы и контрагентов?

Сопоставление связывает объекты разных систем устойчивыми идентификаторами. Для документа сохраняют ссылку на объект 1С и идентификаторы Диадока. Номер, дата, сумма и ИНН используются как контрольные признаки, поскольку они могут повториться или измениться при исправлении.

В структурах Диадок API предусмотрен CustomDocumentId, то есть необязательный идентификатор документа во внешней системе. Возможность его применения зависит от выбранного метода и сценария. Даже при наличии внешнего ID сохраняйте серверные идентификаторы Диадока и историю повторных отправок, исправлений и корректировок.

Как построить отправку документов из 1С?

Исходящий поток начинается с готовности учетных данных и заканчивается наблюдаемым состоянием документооборота. Ответ «запрос принят» подтверждает только технический прием запроса. Подпись и отправка должны быть отдельными действиями с проверяемыми правами.

1. Проверьте проведение и допустимость учетного документа по правилам компании.
2. Определите вид электронного документа, формат и требуемые титулы.
3. Сопоставьте организацию, подразделение, контрагента и его ящик.
4. Сформируйте содержимое из зафиксированной версии данных 1С.
5. Выполните предварительную проверку и сохраните ошибки по конкретному документу.
6. Передайте документ на согласование или подпись уполномоченной роли.
7. После отправки сохраните идентификаторы Диадока и начальное состояние.
8. Получайте последующие события до завершения либо появления действия пользователя.

Повтор после сетевой ошибки нельзя выполнять вслепую. Сначала интеграция проверяет, появился ли документ в Диадоке с тем же внешним ключом или контрольными реквизитами. Иначе один учетный документ может породить несколько электронных отправлений.

Как обрабатывать входящие документы?

Входящий электронный документ не следует сразу превращать в проведенную хозяйственную операцию. Сначала система определяет организацию, контрагента, вид документа и возможный учетный объект. Затем сотрудник проверяет расхождения и принимает действие в пределах своих полномочий.

1. Получите новое событие и серверные идентификаторы документа.
2. Проверьте направление, отправителя, тип, формат и состояние подписи.
3. Найдите организацию, подразделение и контрагента по таблице соответствий.
4. Сопоставьте документ с существующим объектом 1С либо создайте черновик по согласованным правилам.
5. Покажите сотруднику различия в реквизитах, суммах, ставках и строках.
6. Зафиксируйте решение: принять, запросить уточнение, отказать или передать ответственному.
7. Отправьте ответное действие и дождитесь его подтвержденного состояния.

Автоматическое создание допустимо для устойчивого сценария с проверенными справочниками и однозначными правилами. Проведение документа требует отдельного контроля: факт доставки сам по себе не подтверждает корректность учетной операции.

Как синхронизировать статусы и события?

Диадок описывает жизненный цикл через несколько признаков: подписи участников, извещения, уточнение, аннулирование, согласование, роуминг и общий статус. Один флаг «подписан» скрывает действия, которые еще требуются от сотрудника или контрагента.

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

Храните исходный технический статус рядом с бизнес-представлением. Тогда новая комбинация признаков останется видимой, а служба поддержки сможет восстановить причину расхождения.

Как учесть электронную подпись и МЧД?

Интеграция не подписывает документ «от имени отдела». Подпись связана с конкретным сертификатом, пользователем, правом и действием. Если сотрудник действует по доверенности, проект учитывает машиночитаемую доверенность, то есть электронный документ о полномочиях представителя.

Справка Диадока для 1С описывает использование МЧД не только при подписании основного документа, но и при связанных действиях, включая отказ, аннулирование, уточнение и извещение. Поэтому проверка доверенности нужна в каждой операции, где подтверждаются полномочия, а не один раз при настройке пользователя.

• назначьте роли, которым разрешены просмотр, согласование и подпись;
• проверьте связь пользователя 1С с пользователем и ящиком Диадока;
• показывайте выбранный сертификат и основание полномочий до подписания;
• обрабатывайте отсутствие, истечение или неподходящие полномочия МЧД как отдельную ошибку;
• не сохраняйте закрытый ключ, PIN-код и полный токен в журнале интеграции;
• фиксируйте автора, время, документ и результат операции без лишних персональных данных.

Юридическую применимость вида подписи и доверенности проверяют для конкретного документа, роли и регламента. Техническая возможность поставить подпись не заменяет проверку полномочий и внутренних правил компании.

Как обрабатывать ошибки и проводить сверку?

Ошибка должна содержать документ, этап, время, попытку, безопасный текст причины и ответственную роль. В API Диадока результат предварительной проверки может различать ошибку, запрещающую отправку, и предупреждение, при котором отправка возможна с ограничениями. Эти состояния нельзя сводить к одному сообщению «обмен не выполнен».

Регламентная сверка сравнивает документы 1С с документами и состояниями Диадока за заданный период. Отчет выделяет записи без пары, несовпадающие статусы, необработанные события, повторные отправки и действия без ответственного. Исправление выполняют через контролируемую команду, а не прямое изменение статуса в таблице.

Как провести пилот и принять интеграцию?

Пилот ограничивают одной базой, организацией, ящиком, видом документа и группой контрагентов. Техническое задание фиксирует варианты обмена, ответственность систем, тестовые данные и критерии результата. Подход к составу документа разобран в статье про техническое задание на разработку.

1. Зафиксируйте исходный ручной маршрут и список контрольных документов.
2. Настройте сопоставления в тестовой копии и проверьте права ролей.
3. Пройдите исходящую отправку, получение, подпись и завершение.
4. Проверьте отказ, уточнение, исправление и аннулирование.
5. Остановите связь после отправки запроса и убедитесь, что повтор не создает дубль.
6. Проверьте отсутствие сопоставления, недействительный доступ и проблему МЧД.
7. Сверьте выборку в 1С, интерфейсе Диадока и журнале интеграции.
8. Зафиксируйте время восстановления, незакрытые ограничения и решение владельца процесса.

Если учетный контур требует доработки, проект можно начать с интеграции 1С с внешними системами: описать объекты, версии, права, ошибки и сверку до выбора конкретного технического варианта.

Частые вопросы