Содержание статьи
- Какие задачи разделить между Docsvision и 1С
- Назначьте владельцев реквизитов
- Пример: редакция договора изменилась после отправки
- Как выбрать технический способ обмена
- Счета и статусы исполнения — отдельный поток
- Обследование договора как цепочки связанных объектов
- Версия файла и версия данных карточки
- Состояния передачи и понятный интерфейс ошибки
- Счета, оплаты и сверка исполнения
- Переход с ручной работы и сопровождение
- Ошибки и критерии приёмки
- Источники и дата проверки
Какие задачи разделить между Docsvision и 1С
Интеграция Docsvision и 1С полезна, когда документ согласуют в одном контуре, а учётные действия выполняют в другом. Начните с границ: где живёт актуальный файл, кто владеет реквизитами и какой статус разрешает операцию. Двустороннее копирование всех полей обычно делает конфликт менее заметным, а не решает его.
Пример статьи — передача согласованных реквизитов договора для создания учётной карточки в 1С. Это предлагаемый сценарий, не описание готового универсального модуля. Поддерживаемый SDK, расширения, авторизация и интерфейсы зависят от установленных компонентов и версий Docsvision и 1С.
Назначьте владельцев реквизитов
| Данные | Владелец в учебном сценарии | Правило обмена |
|---|---|---|
| Файл договора и согласованная редакция | Docsvision | Передавать ссылку и идентификатор версии |
| Контрагент и учётная организация | Согласованные справочники | Сопоставлять ID, не создавать по одному названию |
| Сумма и валюта согласования | Утверждённая редакция | Изменение значимых условий требует нового решения |
| Учётный ID и статус обработки | 1С | Вернуть в карточку Docsvision |
| Оплаты и фактическое исполнение | Учётный контур | Передавать как отдельные факты, не заменять статус согласования |
Статусы «согласован», «подписан» и «исполнен» не синонимы. Техническая отметка в карточке не заменяет проверку подписи и юридические условия. Если они нужны для процесса, опишите их отдельным правилом, с источником подтверждения и ответственным.
Пример: редакция договора изменилась после отправки
Учебный договор 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: документация разработчика.