.. _Integration_IntegrationApi_WorkingWithContractors_RevokingInvitations:

Отзыв приглашений
#################

| Запрос: ``POST v2/invitations/revoke``
| HTTP-заголовки:

.. code-block::

    Authorization: Bearer access_token
    Content-Type: application/json
    Accept: application/json

Тело запроса:

.. code-block:: JSON

    {
        "BoxId": "string",              // "наш" ящик, из которого мы отзываем приглашение
        "ContractorBoxId": "string"     // идентификатор ящика контрагента
    }

Описание запроса
****************

Запрос позволяет отозвать исходящее приглашение к ЭДО одному контрагенту.

Приглашение отзывается из какого-то "нашего" ящика, т. е. ящика, :ref:`настроенного <Setup_Integration_BasicSetup_Operators>` в Продукте.
Идентификатор "нашего" ящика задается в поле ``BoxId``.

Контрагент, приглашение которому отзывается, задается полем ``ContractorBoxId``.

Когда можно отправлять запрос
*****************************

Отзывать приглашение можно, если текущий статус отношений партнерства с контрагентом - "Приглашение отправлено" (код статуса ``CS``).
Для получения статуса следует запросить данные контрагента.

Ответ на запрос
***************

Отзыв приглашений выполняется асинхронно.
В случае успешного выполнения запроса ставится задача на отзыв приглашения.
Идентификатор задачи не возвращается.

Статус задачи
*************

Отдельный запрос для получения статуса задачи на отзыв не предусмотрен.

По результатам обработки задачи интеграционным модулем для контрагента поступит новый статус.
Для получения статуса следует повторно запросить данные контрагента.

| Если задача была обработана успешно, то поступит статус "Отношение партнерства не установлены" (код статуса ``CX``).
| Если задача была обработана с ошибкой, то поступит статус "Ошибка" (код статуса ``E``).