GetCounteragents (V2)

Предупреждение

Эта версия метода устарела. Используйте новую версию метода GetCounteragents (V3).

Метод GetCounteragents осуществляет поиск контрагентов по указанным параметрам.

GET /V2/GetCounteragents
Query Parameters:

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

  • counteragentStatus – статус контрагента. Необязательный параметр, используется для фильтрации результатов поиска.

  • afterIndexKey – ключ для постраничного получения списка найденных контрагентов, указывающий на начало очередной страницы. Ключ может содержать недопустимые символы, поэтому должен быть закодирован в URL-формат. Необязательный параметр.

  • query – текстовая строка для поиска организации по краткому или полному наименованию ящика контрагента или ИНН. Нельзя указывать одновременно с afterIndexKey.

Request Headers:
Status Codes:

  • 200 OK – операция успешно завершена.

  • 400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.

  • 401 Unauthorized – в запросе отсутствует HTTP-заголовок Authorization или в этом заголовке содержатся некорректные авторизационные данные.

  • 402 Payment Required – у организации с указанным идентификатором myOrgId закончилась подписка на API.

  • 403 Forbidden – доступ к списку контрагентов организации myOrgId с предоставленным авторизационным токеном запрещен.

  • 405 Method Not Allowed – используется неподходящий HTTP-метод.

  • 500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.

Response Body:

Тело ответа содержит список контрагентов организации myOrgId, находящихся в статусе counteragentStatus, представленный структурой CounteragentList.

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

Параметр counteragentStatus предназначен для фильтрации результатов поиска. Если параметр counteragentStatus не задан, метод вернет весь список контрагентов. Значения статусов контрагента описаны в перечислении CounteragentStatus. В качестве параметра counteragentStatus можно передавать следующие значения:

  • IsMyCounteragent,

  • InvitesMe,

  • IsInvitedByMe,

  • Rejected.

Во вложенной структуре Counteragent.Organization поле Departments будет пустым.

Список контрагентов Counteragents в ответе CounteragentList может содержать не больше 100 элементов. Поэтому:

  • Если найденных контрагентов меньше 100, то метод вернет их полностью.

  • Если найденных контрагентов больше 100, то в ответе Counteragents вернутся только первые 100 элементов. При этом параметр TotalCount будет содержать общее количество найденных контрагентов, а параметр TotalCountType покажет, точно ли посчитано значение TotalCount или подсчет был ограничен.

    В этом случае получить весь список найденных контрагентов можно постранично. Для этого вызывайте метод GetCounteragents с теми же параметрами запроса и с указанием параметра afterIndexKey до тех пор, пока список контрагентов не будет вычитан полностью. В качестве параметра afterIndexKey нужно указывать ключ контрагента из поля Counteragent.IndexKey, предварительно закодировав его в URL-формат.

В зависимости от значения параметра afterIndexKey метод работает следующим образом:

  • Если в запросе отсутствует параметр afterIndexKey, то метод вернет начало списка найденных контрагентов.

  • Если в запросе указан параметр afterIndexKey, то метод вернет список контрагентов, следующих за контрагентом с ключом afterIndexKey; контрагент с ключом afterIndexKey в этот список не попадает.