Camunda и 1С: как автоматизировать согласование заявки

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

Содержание статьи
  1. Когда Camunda оправдана рядом с 1С
  2. Разделите движок, задачи сотрудников и интеграционный worker
  3. Контракт: заявка, версия и ключ операции
  4. Сбой после записи: почему job может прийти повторно
  5. Разделите бизнес-отказ и технический сбой
  6. Таймеры, отмена и внешние последствия
  7. Как выбрать первый процесс для автоматизации
  8. Пользовательские задачи и версия согласования
  9. Работа worker и восстановление на границе 1С
  10. Асинхронные сообщения и отмена процесса
  11. Версии модели, выпуск и эксплуатация
  12. Как принять пилот
  13. Источники и дата проверки

Когда Camunda оправдана рядом с 1С

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

Статья посвящена архитектуре исполнения на примере Camunda 8. Это не универсальная инструкция установки и не готовый коннектор 1С. Условия размещения, лицензии, способы авторизации и поддержанные компоненты нужно проверить для вашей версии и окружения. Общая нотация разобрана в материале про BPMN закупки.

Разделите движок, задачи сотрудников и интеграционный worker

КомпонентОтветственность
Движок процессаСостояние экземпляра, переходы и ожидания
Пользовательская задачаРешение уполномоченного сотрудника по версии заявки
Job workerИсполнение сервисной задачи и завершение job
Адаптер или сервис 1СПроверка прав, запись документа и восстановление результата
Журнал и наблюдениеСвязь заявки, job, операции и документа

Worker не обязан быть отдельным большим приложением: его можно разместить в сопровождаемом backend. Но состояние job и транзакция 1С не становятся общей транзакцией только из-за одного сервера. Эта граница определяет поведение после сбоя.

Camunda и 1С: исполнение согласованной заявки
Повтор job не должен создавать новый учётный документ.

Контракт: заявка, версия и ключ операции

Пусть REQ-17 версии 2 согласована на 12 000 ₽. Сервисной задаче нужны ссылка на заявку, подтверждённая версия и ключ операции crm:main:REQ-17:v2:create. Организация, контрагент и права получаются из доверенного контекста или проверенных справочников, а не из свободной строки сотрудника.

{
  "request_id": "REQ-17",
  "approved_version": 2,
  "operation_key": "crm:main:REQ-17:v2:create",
  "expected_total_rub": 12000
}

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

Сбой после записи: почему job может прийти повторно

Worker получил job, создал DOC-900 в 1С, но завершение job не дошло до движка. После истечения времени активации задача может снова стать доступной worker. Если тот опять выполнит «создать», появится второй документ.

Для повторной попытки используйте тот же ключ операции и проверяйте прежний результат в принимающем контуре. Если DOC-900 уже создан для REQ-17 версии 2 и того же содержимого, worker возвращает этот ID и завершает job. Простого локального флага «запрос отправлен» недостаточно.

# Псевдокод собственного worker, не API SDK
validate_approved_version(request_id, approved_version)
result = receiver.execute_or_find(operation_key, validated_payload)
verify_result(result, request_id, approved_version)
complete_job(document_id=result.document_id)

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

Разделите бизнес-отказ и технический сбой

СитуацияРеакция по контракту
Потеря сети до подтверждённого результатаОграниченный повтор с прежним ключом и диагностикой
Учётные данные недействительныИсправление доступа; повтор не лечит причину
Не хватает обязательного реквизитаВозврат на исправление или обработка бизнес-ошибки
Согласованная версия устарелаОстановка записи и новое согласование
Документ уже созданВозврат прежнего ID без новой записи

В Camunda технический отказ job и BPMN error имеют разную роль. Бизнес-ошибку нужно моделировать и обрабатывать соответствующим событием в процессе; не превращайте любой HTTP 500 в отказ согласования. Настройте число попыток и интервалы, а исчерпание попыток сделайте видимым ответственному.

Таймеры, отмена и внешние последствия

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

Если ответ 1С приходит асинхронно, связывайте сообщение с экземпляром и версией бизнес-операции, а не только с именем клиента. Проверьте поздний ответ после отмены и два одинаковых подтверждения. Публикация новой версии процесса также не отменяет необходимость сопровождать уже запущенные экземпляры.

Как выбрать первый процесс для автоматизации

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

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

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

Пользовательские задачи и версия согласования

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

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

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

Работа worker и восстановление на границе 1С

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

Подтверждайте job только после проверки нужного результата. Если бизнес-обещание — созданный документ, одного принятия HTTP-запроса недостаточно. При асинхронном получателе моделируйте ожидание подтверждения отдельно. Не удерживайте в памяти worker единственную связь с операцией, которую нужно восстановить после перезапуска. Устойчивые ID и журнал должны позволять продолжить процесс другой разрешённой инстанции обработчика.

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

Асинхронные сообщения и отмена процесса

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

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

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

Версии модели, выпуск и эксплуатация

Изменение BPMN-модели или worker проверяйте на существующих контрактах. Новый обработчик может получить job от процесса старой версии, где ещё нет добавленного обязательного поля. Нужны совместимость, версионирование типа задания или отдельный путь миграции. Не полагайтесь на то, что все экземпляры завершатся одновременно с публикацией новой схемы. Перед выпуском оцените реально активные состояния.

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

Как принять пилот

На тестовой заявке проверьте согласование, отказ, доработку, старую версию, повтор job и потерю ответа после записи. Затем остановите worker и 1С, восстановите их и сверьте ID документов. Успех — правильный бизнес-результат и диагностируемое ожидание, не только завершённый экземпляр на панели.

Фиксируйте время полного маршрута, ручные вмешательства, неопределённые операции и нарушения прав. Наблюдение за потоком описано в статье про мониторинг интеграций. Если спор касается выбора согласующего, вынесите правила в отдельную таблицу решений.

В отдельном испытании остановите worker после получения подтверждённого ID DOC-900, но до завершения job. После возобновления обработчик должен восстановить прежний результат и продолжить процесс с тем же документом. Проверьте число карточек, движения и внешние действия, а не только финальный статус экземпляра. Если восстановление требует ручного решения, оператор должен увидеть понятную задачу со ссылками на проверяемые объекты. Неопределённость нельзя скрывать автоматическим созданием нового заказа. Этот тест напрямую проверяет самое важное аварийное окно интеграции.

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

Проверено . Camunda: job workers и повторная доставка; Camunda: таймеры.