После сохранения значения свойства заказа OnPropertyValueEntitySaved
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Scope:
saleКто может подписаться: любой пользователь
Событие OnPropertyValueEntitySaved происходит сразу после создания или изменения значения свойства заказа вручную или методом sale.propertyvalue.modify. Если при сохранении заказа значение не изменилось, событие не отправляется.
События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения
Что получает обработчик
Данные передаются в виде POST-запроса
{
"event": "ONPROPERTYVALUEENTITYSAVED",
"event_handler_id": 1,
"data": {
"FIELDS": {
"ID": 300
}
},
"ts": 1714649632,
"auth": {
"access_token": "s6p6eclrvim6da22ft9ch94ekreb52lv",
"expires_in": 3600,
"scope": "sale",
"domain": "some-domain.bitrix24.com",
"server_endpoint": "https://oauth.bitrix24.tech/rest/",
"status": "F",
"client_endpoint": "https://some-domain.bitrix24.com/rest/",
"member_id": "a223c6b3710f85df22e9377d6c4f7553",
"refresh_token": "4s386p3q0tr8dy89xvmt96234v3dljg8",
"application_token": "51856fefc120afa4b628cc82d3935cce"
}
}
Параметры
Обязательные параметры отмечены *
|
Название |
Описание |
|
event* |
Символьный код события. В данном случае — |
|
event_handler_id* |
Идентификатор обработчика события |
|
data* |
Объект, содержащий информацию о сохраненном значении свойства заказа. Структура описана ниже |
|
ts* |
Дата и время отправки события из очереди событий |
|
auth* |
Объект с параметрами авторизации и данными о портале, на котором произошло событие. Структура описана ниже |
Параметр data
|
Название |
Описание |
|
FIELDS* |
Объект со свойством Структура описана ниже |
Параметр FIELDS
|
Название |
Описание |
|
Идентификатор значения свойства заказа. Для получения всех полей значения свойства заказа по идентификатору используется метод sale.propertyvalue.get |
Параметр auth
Обязательные параметры отмечены *
|
Название |
Описание |
|
access_token |
Токен авторизации OAuth 2.0 |
|
expires_in |
Время в секундах до истечения срока действия токена |
|
scope* |
Скоуп, в рамках которого произошло событие |
|
domain* |
Адрес Битрикс24, на котором произошло событие |
|
server_endpoint* |
Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0 |
|
status* |
Статус приложения, подписавшегося на это событие:
|
|
client_endpoint* |
Общий путь для вызовов методов REST API для Битрикс24, на котором произошло событие |
|
member_id* |
Идентификатор Битрикс24, на котором произошло событие |
|
refresh_token |
Токен продления авторизации OAuth 2.0 |
|
application_token* |
Токен для безопасной обработки событий |
Токены авторизации не всегда передаются в обработчик события. Если хит, инициировавший событие, не удалось привязать к конкретному пользователю Битрикс24, токены не передаются. Обязательно проверяйте содержимое ключа auth в коде.
Рекомендуем хранить токены, полученные ранее при установке приложения. Используйте их при работе с интерфейсом приложения в виде встроек, виджетов и так далее.