BreakWithCounteragent
Метод устарел и будет удален из API после 10 ноября 2026 года. Подробнее в истории изменений. Используйте актуальную версию метода — BreakWithCounteragent (V2).
Метод BreakWithCounteragent разрывает отношения между контрагентами, а также для отзывает или отклоняет приглашения к партнерству без вложения.
Чтобы отозвать приглашение с вложением, сгенерируйте запрос методом GenerateRevocationRequestXml (V2) и отправьте его методом PostMessagePatch (V3).
POST /BreakWithCounteragent
Параметры запроса
myOrgId— идентификатор организации, от имени которой производится разрыв отношения партнерства.counteragentOrgId— идентификатор организации контрагента.comment— текст комментария к операции. Необязательный параметр, длина не более 5000 символов.
Заголовки запроса
Authorization— данные, необходимые для авторизации.
Коды ответа
200— операция успешно завершена.400— данные в запросе имеют неверный формат или отсутствуют обязательные параметры.401— в запросе отсутствует HTTP-заголовокAuthorizationили в этом заголовке содержатся некорректные авторизационные данные.402— у организации с указанным идентификаторомmyOrgIdзакончилась подписка на API.403— доступ к списку контрагентов организацииmyOrgIdс предоставленным авторизационным токеном запрещен или у пользователя нет права работать со списками контрагентов (см. OrganizationUserPermissions.CanManageCounteragents).405— используется неподходящий HTTP-метод.409— метод используется для отзыва приглашения с вложением.500— при обработке запроса возникла непредвиденная ошибка.
Метод доступен только сотрудникам с доступом к ящику и разрешением OrganizationUserPermissions.CanManageCounteragents, которое позволяет видеть списки контрагентов и работать с ними.
Метод работает по следующим правилам:
- Если между организациями
myOrgIdиcounteragentOrgIdесть действующее отношение партнерства (контрагентcounteragentOrgIdнаходится в статусеIsMyCounteragent), оно разрывается. КонтрагентcounteragentOrgIdпереходит в статусIsRejectedByMe. - Если в индексе отношений есть входящий запрос на установление отношения партнерства от организации
counteragentOrgIdк организацииmyOrgId(контрагентcounteragentOrgIdнаходится в статусеInvitesMe), то этот запрос отклоняется. КонтрагентcounteragentOrgIdпереходит в статусIsRejectedByMe. - Если в индексе отношений есть исходящий запрос от организации
myOrgIdк организацииcounteragentOrgId(контрагентcounteragentOrgIdнаходится в статусеIsInvitedByMe), то выполняется отзыв этого запроса. Статус контрагентаcounteragentOrgIdменяется на статус, который был до отправки запроса. - Если партнерских отношений между организациями
myOrgIdиcounteragentOrgIdнет или они уже разорваны, то после вызова метода ничего не произойдет.