Согласование договоров и соглашений

В Pro.rent есть возможность подключить вашу систему согласования договоров и соглашений. Для этого перейдите в раздел Настройки портала, укажите ссылку на внешний сервис согласования.
Согласование выполняется в несколько этапов.
Этап 1
При установке статуса договора или соглашения в На согласовании, Pro.rent передаст информацию в ваш сервис согласования путем выполнения запроса:
POST {URL вашего сервиса}
HTTP-заголовки
User-Agent: Pro.rent/{версия}
Body
{
    contract: ApiContract, // Сущность договора
    versionId: number, // ID согласуемого соглашения
    resultUrl: string // URL для возврата результата согласования
}
В ответ система ожидает успешный HTTP код 200 и следующие данные:
Body ответа
{
    id: string, // ID согласования во внешнем сервисе
    name: string, // Название сервиса согласования
    url: string, // Ссылка на договор или соглашение в сервисе согласования
    oneCId?: Guid // ID договора в 1С для записи в Pro.rent
}
На обработку запроса система дает 10 секунд, за которые необходимо вернуть HTTP код 200.
Чтобы сообщить об ошибке нужно указать HTTP код ответа  400.
После успешного ответа Pro.rent установит договору или соглашению статус На согласовании и отобразит в интерфейсе ссылку на него во внешнем сервисе.
Этап 2
После согласования договора или соглашения внешний сервис должен вернуть результат в Pro.rent путем выполнения запроса:
POST {resultUrl}
Body
{
    signStatus?: ContractSignStatus, // Не обязательный статус договора
    oneCId?: Guid // ID договора в 1С для записи в Pro.rent
}
Возможные статусы вы можете посмотреть в разделе Перечисления. Если него не указать, то Pro.rent установит статус Нет оригинала.
Отмена согласования
Пользователь Pro.rent может выбрать отмену согласования договора или соглашения. В этом случае будет выполнен следующий запрос:
POST {URL вашего сервиса}
Body
{
    contract: ApiContract, // Сущность договора
    versionId: number, // ID согласуемого соглашения
    cancel: true
}
Согласование в Pro.rent будет отменено независимо от результата выполнения этого запроса.
Last modified 4mo ago