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

GetCounteragent (V2)

warning

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

Метод GetCounteragent возвращает информацию о контрагенте.

GET /V2/GetCounteragent

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

  • myOrgId — идентификатор организации, для которой осуществляется поиск контрагента.
  • counteragentOrgId — идентификатор организации-контрагента.

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

Коды ответа

  • 200 — операция успешно завершена.
  • 400 — данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
  • 401 — в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.
  • 402 — у организации с указанным идентификатором myOrgId закончилась подписка на API.
  • 403 — доступ к списку контрагентов организации myOrgId с предоставленным авторизационным токеном запрещен.
  • 404 — партнерские отношения между организациями myOrgId и counteragentOrgId не установлены.
  • 405 — используется неподходящий HTTP-метод.
  • 500 — при обработке запроса возникла непредвиденная ошибка.

Тело ответа

Тело ответа содержит информацию о контрагенте с идентификатором counteragentOrgId для организации myOrgId, представленную структурой Counteragent. Вложенная в нее структура Counteragent.Organization.Departments содержит только видимые подразделения и их родительские подразделения.

Метод доступен только сотрудникам с доступом к ящику.

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

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

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