Метод
POST https://varica.ru/api/v2/entity-results
Content-Type: application/json
X-Api-Key: YOUR_API_KEY
Этот метод принимает JSON, потому что результат — короткое структурированное состояние, а не набор данных для верстки.
Тело запроса
{
"source_entity_id": "deal_7821",
"result": "success"
}
| Поле | Обязательное | Допустимые значения |
|---|---|---|
source_entity_id |
да | строка до 255 символов |
result |
да | unknown, success, not_implemented |
Поведение
Сервис находит все generated_pages текущей организации с тем же source_entity_id и обновляет у них result_status. Это нормально, если по одной сделке было создано несколько версий КП.
Ответ
{
"source_entity_id": "deal_7821",
"result": "success",
"updated_pages": 2,
"page_ids": [4012, 4013]
}
Если подходящих страниц нет, это не ошибка интеграции. Сервис вернёт 200 OK, updated_pages: 0 и пустой page_ids.
Смысл статусов
unknown— значение по умолчанию; результата пока нет.success— внешняя система сообщает об успехе по своей логике: продажа, счёт, встреча или другая заранее определённая цель.not_implemented— результат не реализован/не достигнут по модели внешней системы.
VARICA не интерпретирует бизнес-смысл успеха. Его определяет интегратор.