Перейти к основному содержимому

BreakWithCounteragent

warning

Метод устарел и будет удален из API после 10 ноября 2026 года. Подробнее в истории изменений. Используйте актуальную версию метода — BreakWithCounteragent (V2).

Метод BreakWithCounteragent разрывает отношения между контрагентами, а также для отзывает или отклоняет приглашения к партнерству без вложения.

Чтобы отозвать приглашение с вложением, сгенерируйте запрос методом GenerateRevocationRequestXml (V2) и отправьте его методом PostMessagePatch (V3).

POST /BreakWithCounteragent

Параметры запроса

  • myOrgId — идентификатор организации, от имени которой производится разрыв отношения партнерства.
  • counteragentOrgId — идентификатор организации контрагента.
  • comment — текст комментария к операции. Необязательный параметр, длина не более 5000 символов.

Заголовки запроса

Коды ответа

  • 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 нет или они уже разорваны, то после вызова метода ничего не произойдет.

Оцените материал страницы

Нашли ошибку или столкнулись с проблемой?

СКБ Контурс 1988 года