DeleteCounteragentGroup
Удаляет группу контрагентов.
- POST /DeleteCounteragentGroup
- Query Parameters:
boxId – идентификатор ящика организации.
counteragentGroupId – идентификатор группы контрагентов.
- Request Headers:
Authorization – данные, необходимые для авторизации.
- Status Codes:
200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок
Authorization
или в этом заголовке содержатся некорректные авторизационные данные.402 Payment Required – у указанного ящика закончилась подписка на API.
403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен или запрос сделан не от имени администратора.
404 Not Found – не найдена группа контрагентов с указанным идентификатором.
405 Method Not Allowed – используется неподходящий HTTP-метод.
409 Conflict – нельзя удалить группу по умолчанию.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.
Метод доступен только администраторам с доступом к ящику и разрешением OrganizationUserPermissions.CanManageCounteragents, которое позволяет видеть списки контрагентов и работать с ними.
После удаления группы все контрагенты, находящиеся в ней, будут перемещены в группу «По умолчанию».
Примеры использования
Пример HTTP-запроса:
POST /DeleteCounteragentGroup?boxId={{boxId}}&counteragentGroupId=db0c29b8-bbd3-42a0-aa8b-beba1aeabdf4 HTTP/1.1
Host: diadoc-api.kontur.ru
Authorization: Bearer {{access_token}}
См. также
- Инструкции:
- Методы для работы с группами контрагентов:
AddCounteragentToGroup — добавляет контрагента в группу
CreateCounteragentGroup — создает группу контрагентов
DeleteCounteragentGroup — удаляет группу контрагентов
GetCounteragentGroup — возвращает данные группы контрагентов по указанному идентификатору
GetCounteragentGroups — возвращает список групп контрагентов
GetCounteragentsFromGroup — возращает список контрагентов, состоящих в указанной в группе
UpdateCounteragentGroup — изменяет данные группы контрагентов