Согласование договоров и соглашений
Last updated
Last updated
В Pro.rent есть возможность подключить вашу систему согласования договоров и соглашений. Для этого перейдите в раздел Настройки портала и включите согласование договоров.
Pro.rent поддерживает две метода передачи согласуемых договоров и соглашений в вашу систему:
Путем HTTP-запроса на внешний сервис согласования. Стоит использовать этот метод, если есть endpoint, на который Pro.rent может сделать HTTP-запрос.
Если нет возможности указать endpoint, на который Pro.rent может сделать HTTP-запрос, то вы должны с определенной периодичностью запрашивать список согласуемых документов.
Согласование выполняется в несколько этапов для обоих случаев.
При установке статуса договора или соглашения в На согласовании
, Pro.rent передаст информацию в ваш сервис согласования путем выполнения запроса:
В ответ система ожидает успешный HTTP код 200
и следующие данные:
На обработку запроса система дает 10 секунд, за которые необходимо вернуть HTTP код 200.
Чтобы сообщить об ошибке нужно указать HTTP код ответа 400
.
После успешного ответа Pro.rent установит договору или соглашению статус На согласовании
и отобразит в интерфейсе ссылку на него во внешнем сервисе.
При установке статуса договора или соглашения в На согласовании
, Pro.rent заблокирует дальнешнее изменение статуса договора, и вы должны запросить список документов на согласование путем выполнения запроса:
token
– это токен приложения. Как его получить описано в разделе Доступ по API.
onlynew
отвечает за возврат всех согласуемых на текущий момент документов, или только тех, которые до этого не были приняты вашим сервисом согласования.
В ответ система вернет успешный HTTP код 200
и массив документов для согласования:
После успешного приема документов, необходимо для каждого из них выполнить запрос и уведомить Pro.rent о том, что документы были успешно приняты сервисом согласования:
В ответ система вернет успешный HTTP код 204
.
После согласования договора или соглашения внешний сервис должен вернуть результат в Pro.rent путем выполнения запроса:
Возможные статусы подписания договора вы можете посмотреть в разделе Перечисления. Если согласование еще идет и вы лишь передаете новый номер договора, то можно указать статус «На согласовании».
Запрос на возврат результата согласования можно выполнять несколько раз, если в процессе согласования статус подписания или номер меняются несколько раз.
Пользователь Pro.rent может выбрать отмену согласования договора или соглашения. В этом случае будет выполнен следующий запрос:
Согласование в Pro.rent будет отменено независимо от результата выполнения этого запроса.