Как программно обновить сделку в Битрикс24 с сохранением истории изменений

При разработке интеграций с Битрикс24 часто возникает задача программного обновления сделок через ядро CRM. Однако простое использование CCrmDeal::Update не всегда приводит к появлению изменений в истории сущности. В этой заметке я расскажу, как правильно обновлять сделки, чтобы все изменения фиксировались в таймлайне.

Проблема

При стандартном обновлении сделки:

изменения могут не отобразиться в истории, хотя сами поля успешно обновляются.

Решение

Нужно использовать метод с дополнительными параметрами:

Ключевые параметры

Альтернативный вариант

Если нужно добавить комментарий в историю или создать кастомное событие:

Важные замечания

1. Права доступа — убедитесь, что пользователь имеет права на изменение сделки и запись в историю
2. Пользовательские поля — для них обязательно используйте префикс UF_CRM_
3. Проверка результата — всегда проверяйте результат выполнения метода

Правильное использование этих параметров гарантирует, что все программные изменения сделок будут отображаться в истории, что критически важно для аудита и отслеживания работы с CRM.