VARICA
digital proposal bureau
VARICA / Документация v2

Результат по исходной сущности

POST https://varica.ru/api/v2/entity-results

Метод

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 не интерпретирует бизнес-смысл успеха. Его определяет интегратор.