BreakWithCounteragent¶
Метод BreakWithCounteragent
разрывает отношения между контрагентами, а также для отзывает или отклоняет приглашения к партнерству без вложения.
Чтобы отозвать приглашение с вложением, сгенерируйте запрос методом GenerateRevocationRequestXml и отправьте его методом PostMessagePatch.
- POST /BreakWithCounteragent¶
- Query Parameters:
myOrgId – идентификатор организации, от имени которой производится разрыв отношения партнерства.
counteragentOrgId – идентификатор организации контрагента.
comment – текст комментария к операции. Необязательный параметр, длина не более 5000 символов.
- Request Headers:
Authorization – данные, необходимые для авторизации.
- Status Codes:
200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок
Authorization
или в этом заголовке содержатся некорректные авторизационные данные.402 Payment Required – у организации с указанным идентификатором
myOrgId
закончилась подписка на API.403 Forbidden – доступ к списку контрагентов организации
myOrgId
с предоставленным авторизационным токеном запрещен или у пользователя нет права работать со списками контрагентов (см. OrganizationUserPermissions.CanManageCounteragents).405 Method Not Allowed – используется неподходящий HTTP-метод.
409 Conflict – метод используется для отзыва приглашения с вложением.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.
Пользователь имеет право запрашивать и производить действия со списком контрагентов организации myOrgId
, если у него есть доступ к ящику этой организации.
Метод работает по следующим правилам:
Если между организациями
myOrgId
иcounteragentOrgId
есть действующее отношение партнерства (контрагентcounteragentOrgId
находится в статусеIsMyCounteragent
), оно разрывается. КонтрагентcounteragentOrgId
переходит в статусIsRejectedByMe
.Если в индексе отношений есть входящий запрос на установление отношения партнерства от организации
counteragentOrgId
к организацииmyOrgId
(контрагентcounteragentOrgId
находится в статусеInvitesMe
), то этот запрос отклоняется. КонтрагентcounteragentOrgId
переходит в статусIsRejectedByMe
.Если в индексе отношений есть исходящий запрос от организации
myOrgId
к организацииcounteragentOrgId
(контрагентcounteragentOrgId
находится в статусеIsInvitedByMe
), то выполняется отзыв этого запроса. Статус контрагентаcounteragentOrgId
меняется на статус, который был до отправки запроса.Если партнерских отношений между организациями
myOrgId
иcounteragentOrgId
нет или они уже разорваны, то после вызова метода ничего не произойдет.