# Подписание

> Инструменты раздела «Подписание»: 7

Подключение: `https://mcp.legalstack.ru/mcp/signatures` или в составе общего подключения `https://mcp.legalstack.ru/mcp`.

## Отправить документ на подписание

`create_signature_request` · необратимое действие

Описание для модели: Send a document for signing to members or outside people. Signers at once receive real links or codes. A signer is either a team member by member_id or an outside person by name and email. The document text is fixed at this moment.

**Параметры**

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `document_id` | string | да | Document id. Длина: 1–64. |
| `title` | string | да | Request title, usually the document name. Длина: 1–500. |
| `signers` | массив объектов | да | People who sign. Элементов: 1–50. |
| `signers[].member_id` | string | нет | Team member who signs, from list_members. Длина: 1–64. |
| `signers[].name` | string | нет | Name of an outside signer. Длина: 1–200. |
| `signers[].email` | string | нет | Email of an outside signer. Длина: 3–320. |
| `signers[].method` | string | нет | How the signer signs, a code from an email by default. Значения: `Код из письма`, `Код из Telegram`, `УКЭП`, `УНЭП`, `Факсимиле`, `AR-подпись`. |
| `signers[].role` | string | нет | Role of the signer, signs by default. Значения: `Подписант`, `Согласующий`, `Заполняющий`, `Наблюдатель`. |
| `signers[].position` | integer | нет | Turn of the signer when signing in order. Диапазон: 1–100. |
| `order` | string | нет | Signers act all at once or in turn, at once by default. Значения: `Одновременно`, `По очереди`. |
| `message` | string | нет | Message shown to signers. Длина: до 5000. |
| `expires_at` | string | нет | Deadline for signing, YYYY-MM-DDTHH:MM in the team time zone unless an offset is given. |

<details>
<summary>JSON Schema параметров</summary>

```json
{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Document id"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Request title, usually the document name"
    },
    "signers": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "member_id": {
            "description": "Team member who signs, from list_members",
            "type": "string",
            "minLength": 1,
            "maxLength": 64
          },
          "name": {
            "description": "Name of an outside signer",
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "email": {
            "description": "Email of an outside signer",
            "type": "string",
            "minLength": 3,
            "maxLength": 320
          },
          "method": {
            "type": "string",
            "enum": [
              "Код из письма",
              "Код из Telegram",
              "УКЭП",
              "УНЭП",
              "Факсимиле",
              "AR-подпись"
            ],
            "description": "How the signer signs, a code from an email by default"
          },
          "role": {
            "type": "string",
            "enum": [
              "Подписант",
              "Согласующий",
              "Заполняющий",
              "Наблюдатель"
            ],
            "description": "Role of the signer, signs by default"
          },
          "position": {
            "description": "Turn of the signer when signing in order",
            "type": "integer",
            "minimum": 1,
            "maximum": 100
          }
        },
        "additionalProperties": false
      },
      "description": "People who sign"
    },
    "order": {
      "type": "string",
      "enum": [
        "Одновременно",
        "По очереди"
      ],
      "description": "Signers act all at once or in turn, at once by default"
    },
    "message": {
      "description": "Message shown to signers",
      "type": "string",
      "maxLength": 5000
    },
    "expires_at": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}",
      "description": "Deadline for signing, YYYY-MM-DDTHH:MM in the team time zone unless an offset is given"
    }
  },
  "required": [
    "document_id",
    "title",
    "signers"
  ],
  "additionalProperties": false
}
```

</details>

## Удалить запрос на подписание

`delete_signature_request` · необратимое действие

Описание для модели: Delete a signature request. Cannot be restored. To stop a request and keep it use revoke_signature_request.

**Параметры**

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `request_id` | string | да | Signature request id. Длина: 1–64. |

<details>
<summary>JSON Schema параметров</summary>

```json
{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Signature request id"
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}
```

</details>

## Карточка запроса на подписание

`get_signature_request` · только чтение

Описание для модели: Get a signature request with signers and their statuses.

**Параметры**

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `request_id` | string | да | Signature request id. Длина: 1–64. |

<details>
<summary>JSON Schema параметров</summary>

```json
{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Signature request id"
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}
```

</details>

## Подписи под документом

`list_document_signatures` · только чтение

Описание для модели: List signatures already placed on a document.

**Параметры**

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `document_id` | string | да | Document id. Длина: 1–64. |

<details>
<summary>JSON Schema параметров</summary>

```json
{
  "type": "object",
  "properties": {
    "document_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Document id"
    }
  },
  "required": [
    "document_id"
  ],
  "additionalProperties": false
}
```

</details>

## Запросы на подписание

`list_signature_requests` · только чтение

Описание для модели: List signature requests received or sent by the user. The inbox holds requests where the current user signs, sent holds requests the user started.

**Параметры**

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `box` | string | нет | Inbox by default. Значения: `inbox`, `sent`. |
| `status` | string | нет | Request status. Значения: `Ожидает подписания`, `Подписано`, `Завершено`, `Отклонено`, `Срок истёк`, `Отозвано`. |
| `limit` | integer | нет | Maximum number of items to return, 20 by default. По умолчанию: `20`. Диапазон: 1–100. |
| `offset` | integer | нет | Number of items to skip, for paging. По умолчанию: `0`. Диапазон: 0–9007199254740991. |

<details>
<summary>JSON Schema параметров</summary>

```json
{
  "type": "object",
  "properties": {
    "box": {
      "description": "Inbox by default",
      "type": "string",
      "enum": [
        "inbox",
        "sent"
      ]
    },
    "status": {
      "type": "string",
      "enum": [
        "Ожидает подписания",
        "Подписано",
        "Завершено",
        "Отклонено",
        "Срок истёк",
        "Отозвано"
      ],
      "description": "Request status"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of items to return, 20 by default",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "offset": {
      "default": 0,
      "description": "Number of items to skip, for paging",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "additionalProperties": false
}
```

</details>

## Отказаться от подписания

`reject_signature_request` · необратимое действие

Описание для модели: Refuse to sign a document as the current user. The initiator is notified. To cancel a request the user started use revoke_signature_request.

**Параметры**

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `request_id` | string | да | Signature request id. Длина: 1–64. |
| `reason` | string | нет | Reason of the refusal. Длина: 1–2000. |

<details>
<summary>JSON Schema параметров</summary>

```json
{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Signature request id"
    },
    "reason": {
      "description": "Reason of the refusal",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}
```

</details>

## Отозвать запрос на подписание

`revoke_signature_request` · изменяет данные

Описание для модели: Cancel a signature request, only its initiator can. Signers are notified, the request is kept in the list.

**Параметры**

| Параметр | Тип | Обязательный | Описание |
| --- | --- | --- | --- |
| `request_id` | string | да | Signature request id. Длина: 1–64. |
| `reason` | string | нет | Reason shown to signers. Длина: 1–2000. |

<details>
<summary>JSON Schema параметров</summary>

```json
{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Signature request id"
    },
    "reason": {
      "description": "Reason shown to signers",
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    }
  },
  "required": [
    "request_id"
  ],
  "additionalProperties": false
}
```

</details>