Docsvision и 1С: согласование договоров, счета и обмен статусами

Чтобы связать Docsvision и 1С, нужно согласовать владельцев данных и правила передачи редакций. На примере договора покажем обмен реквизитами и статусами, защиту от устаревшего согласования и критерии приёмки.

Содержание статьи
  1. Какие задачи разделить между Docsvision и 1С
  2. Назначьте владельцев реквизитов
  3. Пример: редакция договора изменилась после отправки
  4. Как выбрать технический способ обмена
  5. Счета и статусы исполнения — отдельный поток
  6. Обследование договора как цепочки связанных объектов
  7. Версия файла и версия данных карточки
  8. Состояния передачи и понятный интерфейс ошибки
  9. Счета, оплаты и сверка исполнения
  10. Переход с ручной работы и сопровождение
  11. Ошибки и критерии приёмки
  12. Источники и дата проверки

Какие задачи разделить между Docsvision и 1С

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

Пример статьи — передача согласованных реквизитов договора для создания учётной карточки в 1С. Это предлагаемый сценарий, не описание готового универсального модуля. Поддерживаемый SDK, расширения, авторизация и интерфейсы зависят от установленных компонентов и версий Docsvision и 1С.

Назначьте владельцев реквизитов

ДанныеВладелец в учебном сценарииПравило обмена
Файл договора и согласованная редакцияDocsvisionПередавать ссылку и идентификатор версии
Контрагент и учётная организацияСогласованные справочникиСопоставлять ID, не создавать по одному названию
Сумма и валюта согласованияУтверждённая редакцияИзменение значимых условий требует нового решения
Учётный ID и статус обработки1СВернуть в карточку Docsvision
Оплаты и фактическое исполнениеУчётный контурПередавать как отдельные факты, не заменять статус согласования

Статусы «согласован», «подписан» и «исполнен» не синонимы. Техническая отметка в карточке не заменяет проверку подписи и юридические условия. Если они нужны для процесса, опишите их отдельным правилом, с источником подтверждения и ответственным.

Docsvision и 1С: согласованная версия договора
Создание учётной карточки не означает оплату или исполнение договора.

Пример: редакция договора изменилась после отправки

Учебный договор D-42 версии 3 согласован на 120 000 ₽. В 1С создаётся карточка с ID C-900, а связка D-42 / версия 3 / C-900 сохраняется в журнале. Затем инициатор меняет сумму до 150 000 ₽ и получает версию 4. Прежнее согласование версии 3 нельзя автоматически перенести на новую сумму.

Перед отправкой адаптер проверяет актуальную версию и разрешающий статус. При задержанном подтверждении для версии 3 он обновляет историю этой операции, но не помечает версию 4 как обработанную. Для версии 4 требуется отдельное решение и операция обновления по контракту.

{
  "source_card_id": "D-42",
  "approved_version": 3,
  "operation_key": "dv:main:contract:D-42:v3",
  "amount": 120000,
  "currency": "RUB"
}

JSON иллюстрирует контракт собственного адаптера. Это не названия встроенных полей или endpoint Docsvision. В рабочем сообщении нужны также проверенные ссылки на организацию, контрагента и вид договора, но их структура определяется вашей конфигурацией.

Как выбрать технический способ обмена

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

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

Счета и статусы исполнения — отдельный поток

Если после договора интегрируются счета, определите идентичность каждого счёта, связь с договором, валюту и организацию. Один договор может иметь несколько счетов и оплат; сведение их к одному полю «Оплачено» потеряет детализацию. Частичную оплату и сторнирование отражают самостоятельными изменениями.

Не запускайте оплату только по статусу «согласовано», если финансовый процесс требует дополнительных проверок. Для выбора маршрута решения можно использовать таблицу правил DMN, а последовательность действий описать в BPMN.

Обследование договора как цепочки связанных объектов

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

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

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

Версия файла и версия данных карточки

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

Храните ссылку на исходную версию вместе с результатом передачи. В истории D-42 должно быть видно, что C-900 создано по версии 3 на 120 000 ₽, а версия 4 на 150 000 ₽ требует отдельного действия. Позднее подтверждение не должно менять текущий статус без сверки версии. Это особенно важно при нескольких параллельных потоках: файл и реквизиты могут приходить не одновременно.

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

Состояния передачи и понятный интерфейс ошибки

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

Для отказа из-за данных назначьте владельца исправления. Если неизвестен контрагент, задача обычно относится к НСИ, а не к администратору сервера. Если нет прав, нужна уполномоченная техническая роль. Кнопка повторной отправки должна учитывать состояние: при неизвестном исходе сначала ищется прежний результат. Ручной повтор не должен превращаться в новую бизнес-операцию без решения пользователя.

Отдельно отображайте конфликт редакции. Фраза «ошибка интеграции» скрывает, что договор изменился после согласования. Пользователю нужно видеть, какое поле требует нового решения и почему прежняя отправка не применяется к текущему состоянию. Сохранение прошлой успешной операции полезно для истории, но не должно автоматически делать зелёной новую редакцию. Проверяйте этот сценарий на ролях инициатора и согласующего.

Счета, оплаты и сверка исполнения

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

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

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

Переход с ручной работы и сопровождение

На первом этапе можно передавать ограниченный набор реквизитов и оставлять запись черновика под подтверждением сотрудника. Это позволяет проверить сопоставление и убрать повторный ввод без немедленного автоматического проведения. Расширяйте действия после приёмки исходного сценария. Если готовый поддерживаемый модуль закрывает требования, сравните его с собственной разработкой до создания отдельного адаптера.

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

Ошибки и критерии приёмки

СценарийОжидаемое поведение
Повтор той же операцииВозвращается прежний ID без второй карточки
Неизвестный контрагентПонятная ошибка или отдельная заявка НСИ
Новая версия пришла раньше старойСтарая не перезаписывает актуальное решение
1С записала объект, ответ потерялсяПоиск завершённого результата перед повторной записью
Отзыв согласованияОтдельное событие и согласованные действия с уже созданным объектом
Права на файл изменилисьСсылка не даёт обхода прав

В тестовом контуре проведите D-42 через версии 3 и 4, повтор сообщения и потерю ответа. Сверьте сумму, историю решений, файл и учётный ID. Заранее согласуйте отмену: удаление карточки Docsvision не должно бесконтрольно удалять проведённые объекты в 1С.

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

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

Затем проверьте счёт с частичной оплатой и её корректировкой. Убедитесь, что обратный поток изменяет именно учётное исполнение, не выдавая его за новое согласование договора. Фиксируйте ожидаемые суммы и состояние до каждого шага. Этот набор помогает проверить границы потоков без полного развёртывания всех возможных договорных процессов компании.

Источники и дата проверки

Проверено . Docsvision: взаимодействие с внешними системами; Docsvision: документация разработчика.