Договор аренды
"}}}}}},"responses":{"201":{"description":"Созданный шаблон","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Template"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/templates/blanksign":{"post":{"tags":["Шаблоны"],"summary":"Системный пустой шаблон для «Отправить на подпись»","description":"Пустой шаблон для отправки на подпись только вложений, без выбора шаблона. Создаётся при первом обращении, в списках шаблонов не показывается; дальше работает как обычный пустой шаблон.","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"id системного шаблона","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/templatemappings/check":{"get":{"tags":["Сопоставление шаблонов (создать другой документ)"],"summary":"Проверить сопоставление сторон и переменных между шаблоном созданного документа и выбранным шаблоном","description":"Права - создание документов. Шаблон должен быть виден пользователю, документ - доступен пользователю.","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"renderId","required":true,"description":"Созданный документ (источник данных)","schema":{"type":"string"}},{"in":"query","name":"templateId","required":true,"description":"Выбранный шаблон","schema":{"type":"string"}}],"responses":{"200":{"description":"Состояние сопоставления","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateMappingState"}}}},"400":{"description":"У документа нет шаблона или сторон, у выбранного шаблона нет сторон"},"404":{"description":"Документ или шаблон не найден, не виден пользователю или удалён"}}}},"/templatemappings":{"put":{"tags":["Сопоставление шаблонов (создать другой документ)"],"summary":"Сохранить сопоставление сторон и переменных для пары шаблонов","description":"Хранится одно сопоставление на пару (шаблон документа, выбранный шаблон) в рабочем пространстве. Ссылки проверяются по структуре документа и текущей версии шаблона; полнота сопоставления отражается в status ответа.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["renderId","templateId","sides"],"properties":{"renderId":{"type":"string","description":"id созданного документа (источник данных)","example":"62bb25949213f16bcd934440"},"templateId":{"type":"string","description":"id выбранного шаблона","example":"62bb25949213f16bcd934422"},"sides":{"type":"array","description":"Сопоставление по сторонам выбранного шаблона","items":{"$ref":"#/components/schemas/TemplateMappingSide"}}}}}}},"responses":{"200":{"description":"Состояние сопоставления после сохранения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateMappingState"}}}},"400":{"description":"Ссылка на несуществующую сторону или переменную"},"404":{"description":"Документ или шаблон не найден или не виден пользователю"}}}},"/tcrequestsadmin":{"get":{"tags":["Заявки на создание шаблона (админка)"],"summary":"Получить список заявок на создание шаблона","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"wid","description":"Фильтр по id рабочего пространства","schema":{"type":"string"}},{"in":"query","name":"notProcessed","description":"Фильтр по необработанным заявкам","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Возвращается список заявок на создание шаблона","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TcRequestAdmin"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequestsadmin/downloadArchive":{"get":{"tags":["Заявки на создание шаблона (админка)"],"summary":"Скачать заявки на создание шаблона в виде архива","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"wid","description":"Фильтр по id рабочего пространства","schema":{"type":"string"}},{"in":"query","name":"notProcessed","description":"Фильтр по необработанным заявкам","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Возвращаются заявки на создание шаблона в виде архива","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequestsadmin/{id}":{"get":{"tags":["Заявки на создание шаблона (админка)"],"summary":"Получить заявку по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращаются реквизиты","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TcRequestAdmin"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequestsadmin/{id}/download":{"get":{"tags":["Заявки на создание шаблона (админка)"],"summary":"Скачать файл заявки по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается файл","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequestsadmin/{id}/process":{"put":{"tags":["Заявки на создание шаблона (админка)"],"summary":"Пометить заявку как обработанную","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id обработанной заявки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequests":{"get":{"tags":["Заявки на создание шаблона"],"summary":"Получить список заявок на создание шаблона","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список заявок на создание шаблона","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TcRequest"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Заявки на создание шаблона"],"summary":"Создать новую заявку","security":[{"BearerAuth":[]}],"requestBody":{"description":"Данные для загрузки","required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/NewTcRequest"}}}},"responses":{"201":{"description":"Возвращается заявка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TcRequest"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequests/{id}":{"get":{"tags":["Заявки на создание шаблона"],"summary":"Получить заявку по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается заявка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TcRequest"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Заявки на создание шаблона"],"summary":"Удалить заявку по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленной заявки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequests/{id}/download":{"get":{"tags":["Заявки на создание шаблона"],"summary":"Скачать файл заявки по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается файл","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequests/ai":{"post":{"tags":["Заявки на создание шаблона"],"summary":"Создать новую заявку для ИИ (docx, doc, odt, pages, dotx, ott, pdf)","security":[{"BearerAuth":[]}],"requestBody":{"description":"Данные для загрузки","required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/NewTcRequest"}}}},"responses":{"201":{"description":"Возвращается заявка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TcRequest"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tcrequests/ai/processed":{"post":{"tags":["Заявки на создание шаблона"],"summary":"Принять результат разметки файла ИИ (вызывает ИИ-сервис)","description":"Вебхук ИИ-сервиса без авторизации пользователя: подлинность проверяется по полю token тела, которое должно совпадать с секретом интеграции ИИ сервиса (иначе 403). По заявке для ИИ создаётся шаблон из присланного HTML (имя — имя файла заявки без расширения), в заявке сохраняются id шаблона и дата, воркспейс разблокируется, задача ИИ по заявке закрывается.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["token","wsId","tcRequestId","html"],"properties":{"token":{"type":"string","description":"Секретный токен интеграции ИИ (непустая строка)","example":"ai_secret_token"},"wsId":{"type":"string","description":"id воркспейса заявки (ObjectId)","example":"62bb25949213f16bcd934422"},"tcRequestId":{"type":"string","description":"id заявки для ИИ (ObjectId, заявка с флагом ai)","example":"62bb25949213f16bcd934423"},"html":{"type":"string","description":"HTML размеченного шаблона (должен содержать хотя бы один тег)","example":"Договор № 1 от 01.11.2026
"}}}}}},"responses":{"201":{"description":"Возвращаются id заявки и id созданного шаблона","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"id заявки","example":"62bb25949213f16bcd934423"},"templateId":{"type":"string","description":"id созданного шаблона","example":"62bb25949213f16bcd934424"}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"403":{"description":"Неверный токен интеграции ИИ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tasks":{"get":{"tags":["Задачи"],"summary":"Получить список задач","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список задач","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Task"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Задачи"],"summary":"Создать новую задачу","security":[{"BearerAuth":[]}],"requestBody":{"description":"Данные для загрузки","content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/NewTask"}}}},"responses":{"200":{"description":"Возвращается задача","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskWithLogs"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/tasks/positions":{"get":{"tags":["Задачи"],"summary":"Получить список задач по столбцам канбан-доски","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"impossible","description":"Показывать ли колонку impossible","schema":{"type":"string","enum":[true,false]}},{"in":"query","name":"managerid","description":"id ответственного","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается список задач по столбцам канбан-доски","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"position":{"$ref":"#/components/schemas/TaskPosition"},"tasks":{"type":"array","description":"Задачи этого столбца","items":{"$ref":"#/components/schemas/Task"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tasks/{id}":{"get":{"tags":["Задачи"],"summary":"Получить задачу по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращаются реквизиты","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskWithLogs"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"put":{"tags":["Задачи"],"summary":"Обновить задачу","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Задача","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateTask"}}}},"responses":{"200":{"description":"Возвращается задача","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Задачи"],"summary":"Удалить задачу по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленной задачи","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/tasks/{id}/download":{"get":{"tags":["Задачи"],"summary":"Скачать файл задачи по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается файл","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/tasks/{id}/comment":{"post":{"tags":["Задачи"],"summary":"Создать новый комментарий к задаче","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Комментарий","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Сообщение","example":"Комментарий"}}}}}},"responses":{"200":{"description":"Возвращается запись лога задачи","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskLogBase"},{"type":"object","properties":{"taskid":{"type":"string","description":"id задачи","example":"62bb25949213f16bcd934422"},"userid":{"type":"string","description":"id пользователя","example":"62bb25949213f16bcd934422"}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/tariffspublic":{"get":{"tags":["Тарифы (публичные методы)"],"summary":"Получить список тарифов","responses":{"200":{"description":"Возвращается список тарифов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tariff"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить список тарифов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список тарифов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tariff"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Тарифы (админка)"],"summary":"Создать тариф","security":[{"BearerAuth":[]}],"requestBody":{"description":"Тариф","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tariff"}}}},"responses":{"201":{"description":"Возвращается тариф","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tariff"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/{id}":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить тариф","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"id","required":true,"description":"id тарифа","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается тариф","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tariff"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Тарифы (админка)"],"summary":"Обновить тариф","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"id","required":true,"description":"id тарифа","schema":{"type":"string"}}],"requestBody":{"description":"Тариф","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tariff"}}}},"responses":{"200":{"description":"Возвращается тариф","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tariff"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Тарифы (админка)"],"summary":"Удалить тариф","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"id","required":true,"description":"id тарифа","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается id удаленного тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/choose":{"put":{"tags":["Тарифы (админка)"],"summary":"Выбрать тариф","security":[{"BearerAuth":[]}],"requestBody":{"description":"Тариф","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wid":{"type":"string","description":"id воркспейса","example":"62bb25949213f16bcd934422"},"tariffId":{"type":"string","description":"Идентификатор тарифа","example":"tariff_team"},"patternId":{"type":"string","description":"Идентификатор шаблона тарифа","example":"tariff_team_30"},"addUsersCount":{"type":"integer","description":"Количество дополнительных пользователей","example":5},"addAttachmentsSize":{"type":"integer","description":"Количество дополнительных ГБ Хранилища","example":1}}}}}},"responses":{"200":{"description":"Возвращаются данные о выбранном тарифе","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstance"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/choose/trial":{"put":{"tags":["Тарифы (админка)"],"summary":"Принудительно установить триал","security":[{"BearerAuth":[]}],"requestBody":{"description":"Тариф","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"wid":{"type":"string","description":"id воркспейса","example":"62bb25949213f16bcd934422"},"patternId":{"type":"string","description":"Идентификатор шаблона тарифа","example":"tariff_trial_7"}}}}}},"responses":{"200":{"description":"Возвращаются данные о тарифе","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstance"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить список экземпляров тарифов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список экземпляров тарифов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TariffInstanceAdmin"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/{id}":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить экземпляр тарифа","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается экземпляр тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstanceAdmin"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Тарифы (админка)"],"summary":"Изменить экземпляр тарифа (даты, тип тарифа, промокод)","description":"Любые из полей. Смена `patternId` (и `tariffId` вместе с ним) пересчитывает цену, скидку, лимиты и название; применение или отмена промокода пересчитывает цену по текущему шаблону. Оплаченная сумма не меняется (признак оплаты считается как оплачено >= цена). Промокод применяется только скидочных типов; отмена - `promocodeId: null`. Даты не могут пересекаться с другими тарифами рабочего пространства (граница в границу допустима), окончание должно быть позже начала. Заранее посмотреть результат и соседей можно через `POST /tariffsadmin/instances/{id}/preview`.\n","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dtFrom":{"type":"string","description":"Дата и время начала","example":"2023-08-01T00:00:00.000Z"},"dtTo":{"type":"string","description":"Дата, по которую действует экземпляр тарифа","example":"2023-08-21T20:59:59.999Z"},"tariffId":{"type":"string","description":"Новый тариф (нужен `patternId`)","example":"tariff_enterprise"},"patternId":{"type":"string","description":"Новый шаблон тарифа","example":"tariff_enterprise_30"},"promocodeId":{"type":"string","nullable":true,"description":"Промокод со скидкой, который нужно применить; null - отменить применённый","example":"SPRING10"}}}}}},"responses":{"200":{"description":"Возвращается экземпляр тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstanceAdmin"}}}},"400":{"description":"Даты пересекаются с соседним тарифом, окончание не позже начала, промокод не на скидку, тариф отменён"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"description":"Не найден экземпляр, тариф, шаблон или промокод"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Тарифы (админка)"],"summary":"Отменить экземпляр тарифа","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id отмененного экземпляра тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/current":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить список текущих экземпляров тарифов","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/isActive"},{"$ref":"#/components/parameters/currentUsersCountFrom"},{"$ref":"#/components/parameters/currentUsersCountTo"},{"$ref":"#/components/parameters/tariff"},{"$ref":"#/components/parameters/duration"},{"$ref":"#/components/parameters/daysLeftFrom"},{"$ref":"#/components/parameters/daysLeftTo"},{"$ref":"#/components/parameters/loginOrInn"},{"$ref":"#/components/parameters/featured"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/registeredAtFrom"},{"$ref":"#/components/parameters/registeredAtTo"},{"$ref":"#/components/parameters/paidAtFrom"},{"$ref":"#/components/parameters/paidAtTo"},{"$ref":"#/components/parameters/storageUsedFromMb"},{"$ref":"#/components/parameters/appendicesUsedFromMb"}],"responses":{"200":{"description":"Возвращается список экземпляров тарифов","content":{"application/json":{"schema":{"type":"object","properties":{"tariffInstances":{"type":"array","description":"Текущие экземпляры тарифов (по одному на рабочее пространство) на странице выборки","items":{"$ref":"#/components/schemas/TariffCurrentInstanceAdmin"}},"count":{"type":"integer","description":"Количество записей","example":1},"usersCount":{"type":"integer","description":"Количество пользователей сервиса","example":12},"workspacesCount":{"type":"integer","description":"Количество воркспейсов сервиса","example":13}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/current/excel":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить файл Excel с информацией о текущих экземплярах тарифов","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/isActive"},{"$ref":"#/components/parameters/currentUsersCountFrom"},{"$ref":"#/components/parameters/currentUsersCountTo"},{"$ref":"#/components/parameters/tariff"},{"$ref":"#/components/parameters/duration"},{"$ref":"#/components/parameters/daysLeftFrom"},{"$ref":"#/components/parameters/daysLeftTo"},{"$ref":"#/components/parameters/loginOrInn"},{"$ref":"#/components/parameters/featured"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"},{"$ref":"#/components/parameters/registeredAtFrom"},{"$ref":"#/components/parameters/registeredAtTo"},{"$ref":"#/components/parameters/paidAtFrom"},{"$ref":"#/components/parameters/paidAtTo"},{"$ref":"#/components/parameters/storageUsedFromMb"},{"$ref":"#/components/parameters/appendicesUsedFromMb"}],"responses":{"200":{"description":"Возвращается файл xslx","content":{"application/vnd.ms-excel":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/current/crm":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить список текущих экземпляров тарифов с информацией о CRM","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/tariff"},{"$ref":"#/components/parameters/crm"},{"$ref":"#/components/parameters/registerSource"},{"$ref":"#/components/parameters/registeredAtFrom"},{"$ref":"#/components/parameters/registeredAtTo"},{"$ref":"#/components/parameters/paidAtFrom"},{"$ref":"#/components/parameters/paidAtTo"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"}],"responses":{"200":{"description":"Возвращается список экземпляров тарифов с информацией о CRM","content":{"application/json":{"schema":{"type":"object","properties":{"tariffInstances":{"type":"array","description":"Текущие экземпляры тарифов с данными CRM на странице выборки","items":{"type":"object","description":"Текущий экземпляр тарифа рабочего пространства","properties":{"dtFrom":{"type":"string","description":"Начало действия","example":"2023-07-23T10:08:55.254Z"},"dtTo":{"type":"string","description":"Окончание действия","example":"2023-08-21T20:59:59.999Z"},"dtReadonly":{"type":"string","nullable":true,"description":"Окончание действия пробного периода тарифа","example":"2023-08-21T20:59:59.999Z"},"isPaid":{"type":"boolean","description":"Оплачен","example":true},"tariff":{"type":"object","description":"Тариф экземпляра","properties":{"id":{"type":"string","description":"Идентификатор","example":"tariff_team"},"name":{"type":"string","description":"Название","example":"Команда"}}},"workspace":{"description":"Рабочее пространство с данными CRM и регистрации","allOf":[{"$ref":"#/components/schemas/IdObject"},{"type":"object","properties":{"crm":{"$ref":"#/components/schemas/CrmTypeWithYClients"},"createdAt":{"type":"string","description":"Дата создания воркспейса","example":"2023-08-21T20:59:59.999Z"},"registerSource":{"$ref":"#/components/schemas/RegisterSource"},"paymentSummary":{"type":"object","description":"Сводка последней оплаты рабочего пространства","properties":{"amount":{"type":"integer","description":"Сумма","example":10000},"lastPeriodStart":{"type":"string","description":"Дата начала оплаченного периода","example":"2023-08-21T20:59:59.999Z"},"lastPeriodEnd":{"type":"string","description":"Дата окончания оплаченного периода","example":"2023-08-21T20:59:59.999Z"}}}}}]},"user":{"type":"object","description":"Владелец рабочего пространства","properties":{"login":{"type":"string","description":"Логин","example":"user@mail.ru"}}},"accountingdetails":{"type":"object","description":"Реквизиты организации рабочего пространства","properties":{"name":{"type":"string","description":"Название компании","example":"ООО Умные документы"},"phone":{"type":"string","description":"Телефон","example":"+7-999-123-45-67"}}},"payment":{"description":"Последняя оплата экземпляра тарифа","allOf":[{"$ref":"#/components/schemas/TariffInstanceLastTransaction"}]}}}},"count":{"type":"integer","description":"Количество записей","example":1}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/current/crm/excel":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить файл Excel с информацией о текущих экземплярах тарифов и CRM","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/tariff"},{"$ref":"#/components/parameters/crm"},{"$ref":"#/components/parameters/registerSource"},{"$ref":"#/components/parameters/registeredAtFrom"},{"$ref":"#/components/parameters/registeredAtTo"},{"$ref":"#/components/parameters/paidAtFrom"},{"$ref":"#/components/parameters/paidAtTo"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"}],"responses":{"200":{"description":"Возвращается файл xslx","content":{"application/vnd.ms-excel":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/{id}/preview":{"post":{"tags":["Тарифы (админка)"],"summary":"Предпросмотр изменения экземпляра тарифа (ничего не сохраняется)","description":"Тело как у `PUT /tariffsadmin/instances/{id}`. Возвращает значения экземпляра после изменения (цена, лимиты, признак оплаты) и соседние тарифы по датам.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"dtFrom":{"type":"string","format":"date-time","description":"Новое начало действия (не передано — без изменений)","example":"2026-11-01T00:00:00.000Z"},"dtTo":{"type":"string","format":"date-time","description":"Новое окончание действия (не передано — без изменений)","example":"2026-11-30T20:59:59.999Z"},"tariffId":{"type":"string","description":"Новый тариф; при смене тарифа обязателен patternId","example":"tariff_team"},"patternId":{"type":"string","description":"Новый вариант оплаты (паттерн) тарифа — пересчитываются цена и лимиты","example":"tariff_team_30"},"promocodeId":{"type":"string","nullable":true,"description":"Промокод экземпляра; null или пустая строка — снять промокод, не передано — без изменений","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"201":{"description":"Значения после изменения и соседи по датам","content":{"application/json":{"schema":{"type":"object","properties":{"values":{"type":"object","description":"Экземпляр тарифа с применёнными изменениями (поля как в базе, плюс isPaid и amountToPay)"},"dates":{"type":"object","description":"Соседние экземпляры тарифов рабочего пространства относительно новых дат","properties":{"conflicts":{"type":"array","description":"Тарифы рабочего пространства, пересекающиеся с новыми датами (сохранение запрещено)","items":{"$ref":"#/components/schemas/TariffInstanceNeighbour"}},"previous":{"description":"Ближайший предыдущий экземпляр (заканчивается не позже нового начала); нет поля — такого нет","allOf":[{"$ref":"#/components/schemas/TariffInstanceNeighbour"}]},"next":{"description":"Ближайший следующий экземпляр (начинается не раньше нового окончания); нет поля — такого нет","allOf":[{"$ref":"#/components/schemas/TariffInstanceNeighbour"}]}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/{id}/paid":{"put":{"tags":["Тарифы (админка)"],"summary":"Отметить экземпляр тарифа оплаченным или неоплаченным","description":"paid=true доплачивает недостающую сумму (как `/pay`), paid=false обнуляет оплату и дату оплаты.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["paid"],"properties":{"paid":{"type":"boolean","description":"true — отметить оплаченным (доплатить недостающую сумму), false — обнулить оплату и дату оплаты","example":true}}}}}},"responses":{"200":{"description":"Возвращается экземпляр тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstanceAdmin"}}}},"400":{"description":"Тариф отменён или нет признака paid"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/instances/{id}/pay":{"put":{"tags":["Тарифы (админка)"],"summary":"Оплатить экземпляр тарифа","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Оплата","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","description":"Сумма","example":123.56}}}}}},"responses":{"200":{"description":"Возвращается экземпляр тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstanceAdmin"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/{wid}/instances":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить все экземпляры тарифов рабочего пространства (в том числе прошедшие и отменённые)","security":[{"BearerAuth":[]}],"parameters":[{"name":"wid","in":"path","required":true,"description":"id рабочего пространства","schema":{"type":"string"}}],"responses":{"200":{"description":"Список экземпляров тарифов по возрастанию","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TariffInstanceAdmin"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffsadmin/{wid}/instances/relevant":{"get":{"tags":["Тарифы (админка)"],"summary":"Получить список актуальных экземпляров тарифов рабочего пространства","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"wid","required":true,"description":"id воркспейса","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается список экземпляров тарифов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TariffInstance"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs":{"get":{"tags":["Тарифы"],"summary":"Получить список тарифов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список тарифов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tariff"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/instances":{"get":{"tags":["Тарифы"],"summary":"Получить список экземпляров тарифов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список экземпляров тарифов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/TariffInstance"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/instances/{id}":{"delete":{"tags":["Тарифы"],"summary":"Отменить экземпляр тарифа","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id отмененного экземпляра тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/instances/current":{"get":{"tags":["Тарифы"],"summary":"Получить текущий экземпляр тарифа","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается текущий экземпляр тарифа","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TariffInstance"},{"type":"object","properties":{"renewPrice":{"type":"number","description":"Цена продления","example":1000}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/instances/relevant":{"get":{"tags":["Тарифы"],"summary":"Получить список актуальных экземпляров тарифов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список экземпляров тарифов","content":{"application/json":{"schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/TariffInstance"},{"type":"object","properties":{"payment":{"type":"object","description":"Способ оплаты экземпляра тарифа (нет поля — оплата не начата)","properties":{"type":{"$ref":"#/components/schemas/TariffPaymentType"},"filename":{"type":"string","description":"Имя файла","example":"https://safe.forma.today/invoices/64d11d92ec1cdcdb22ec2fa4/64d11ded43a7f1cf81a2c8b0.pdf"}}}}}]}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/instances/current/addusers":{"get":{"tags":["Тарифы"],"summary":"Получить данные о добавлении пользователей в текущий экземпляр тарифа","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"count","required":true,"description":"Количество дополнительных пользователей","schema":{"type":"integer"}}],"responses":{"200":{"description":"Возвращаются данные о выборе тарифа","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TariffPriceResponse"},{"type":"object","properties":{"userPrice":{"type":"number","description":"Цена добавления одного пользователя","example":500},"daysLeft":{"type":"integer","description":"Остаток дней по тарифу","example":5}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Тарифы"],"summary":"Добавить пользователей в текущий экземпляр тарифа","security":[{"BearerAuth":[]}],"requestBody":{"description":"Тариф","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Количество дополнительных пользователей","example":3}}}}}},"responses":{"200":{"description":"Возвращаются данные о тарифе","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstance"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/choose/{tariffId}/{patternId}":{"get":{"tags":["Тарифы"],"summary":"Получить данные о выборе тарифа","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"tariffId","required":true,"description":"id тарифа","schema":{"type":"string"}},{"in":"path","name":"patternId","required":true,"description":"id шаблона","schema":{"type":"string"}},{"in":"query","name":"addUsersCount","description":"Количество дополнительных пользователей","schema":{"type":"integer"}},{"in":"query","name":"addAttachmentsSize","description":"Количество дополнительных ГБ Хранилища","schema":{"type":"integer"}},{"in":"query","name":"shouldCreateCurrentInstance","description":"Станет ли тариф текущим при выборе","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Возвращаются данные о выборе тарифа","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TariffPriceResponse"},{"type":"object","properties":{"dtFrom":{"type":"string","description":"Начало действия","example":"2023-07-23T10:08:55.254Z"},"dtTo":{"type":"string","description":"Окончание действия","example":"2023-08-21T20:59:59.999Z"}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/choose":{"put":{"tags":["Тарифы"],"summary":"Выбрать тариф","security":[{"BearerAuth":[]}],"requestBody":{"description":"Тариф","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tariffId":{"type":"string","description":"Идентификатор тарифа","example":"tariff_team"},"patternId":{"type":"string","description":"Идентификатор шаблона","example":"tariff_team_30"},"addUsersCount":{"type":"integer","description":"Количество дополнительных пользователей","example":5},"addAttachmentsSize":{"type":"integer","description":"Количество дополнительных ГБ Хранилища","example":1},"shouldCreateCurrentInstance":{"type":"boolean","description":"Станет ли тариф текущим при выборе","example":false}}}}}},"responses":{"200":{"description":"Возвращаются данные о выбранном тарифе","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstance"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/tariffs/renew":{"put":{"tags":["Тарифы"],"summary":"Продлить текущий тариф","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращаются данные о новом экземпляре тарифа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TariffInstance"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/systemmessagesadmin":{"get":{"tags":["Системные сообщения (админка)"],"summary":"Получить список системных сообщений","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список системных сообщений","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SystemMessage"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Системные сообщения (админка)"],"summary":"Создать новое системное сообщение","security":[{"BearerAuth":[]}],"requestBody":{"description":"Системное сообщение","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewSystemMessage"}}}},"responses":{"201":{"description":"Возвращается системное сообщение","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemMessage"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/systemmessagesadmin/{id}":{"put":{"tags":["Системные сообщения (админка)"],"summary":"Обновить системное сообщение","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Системное сообщение","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewSystemMessage"}}}},"responses":{"200":{"description":"Возвращается системное сообщение","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemMessage"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Системные сообщения (админка)"],"summary":"Удалить системное сообщение","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленного системного сообщения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/systemmessages/active":{"get":{"tags":["Системные сообщения"],"summary":"Получить активное системное сообщение","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается активное системное сообщение","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemMessage"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/support/error":{"post":{"tags":["Поддержка"],"summary":"Отправить отчет об ошибке","requestBody":{"description":"Отчет об ошибке","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"errorId":{"type":"string","description":"id ошибки","example":"XdsaW0f"},"url":{"type":"string","description":"URL ошибки","example":"/templates"},"message":{"type":"string","description":"Сообщение об ошибке","example":"Сообщение"},"attachment":{"type":"string","description":"Приложение к отчету","example":"Тело запроса"},"wid":{"type":"string","description":"id воркспейса","example":"62bb25949213f16bcd934422"},"uid":{"type":"string","description":"id пользователя","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"200":{"description":"Возвращается флаг успеха","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Флаг успеха","example":true}}}}}},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictattrs":{"get":{"tags":["Строгие переменные"],"summary":"Получить список строгих переменных","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список строгих переменных","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Strictattr"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Строгие переменные"],"summary":"Создать новую переменную","security":[{"BearerAuth":[]}],"requestBody":{"description":"Переменная","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Strictattr"}}}},"responses":{"201":{"description":"Возвращается переменная","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Strictattr"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictattrs/{id}":{"get":{"tags":["Строгие переменные"],"summary":"Получить переменную по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrId"}],"responses":{"200":{"description":"Возвращается переменная","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Strictattr"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Строгие переменные"],"summary":"Обновить переменную","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrId"}],"requestBody":{"description":"Переменная","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewStrictattr"}}}},"responses":{"200":{"description":"Возвращается переменная","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Strictattr"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Строгие переменные"],"summary":"Удалить переменную по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrId"}],"responses":{"200":{"description":"Возвращается id переменной","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictattrs/usedtemplates":{"get":{"tags":["Строгие переменные"],"summary":"Получить список строгих переменных с используемыми общими шаблонами","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список строгих переменных","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"id строгой переменной (номер в виде строки)","example":"101"},"name":{"type":"string","description":"Наименование","example":"Имя кота"},"templates":{"type":"array","description":"Общие шаблоны, в которых используется переменная","items":{"allOf":[{"$ref":"#/components/schemas/IdObject"},{"type":"object","properties":{"name":{"type":"string","description":"Наименование","example":"Договор подряда"}}}]}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictattrsections":{"get":{"tags":["Разделы строгих переменных"],"summary":"Получить список разделов строгих переменных","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список разделов строгих переменных","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StrictattrSection"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Разделы строгих переменных"],"summary":"Создать новый раздел","security":[{"BearerAuth":[]}],"requestBody":{"description":"Папка","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrSection"}}}},"responses":{"201":{"description":"Возвращается раздел переменной","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrSection"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictattrsections/{id}":{"get":{"tags":["Разделы строгих переменных"],"summary":"Получить раздел по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrSectionId"}],"responses":{"200":{"description":"Возвращается раздел","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrSection"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Разделы строгих переменных"],"summary":"Обновить раздел","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrSectionId"}],"requestBody":{"description":"Раздел","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewStrictattrSection"}}}},"responses":{"200":{"description":"Возвращается раздел","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrSection"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Разделы строгих переменных"],"summary":"Удалить раздел по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrSectionId"}],"responses":{"200":{"description":"Возвращается id раздела","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictattrfolders":{"get":{"tags":["Папки строгих переменных"],"summary":"Получить список папок строгих переменных","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список папок строгих переменных","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StrictattrFolder"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Папки строгих переменных"],"summary":"Создать новую папку","security":[{"BearerAuth":[]}],"requestBody":{"description":"Папка","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrFolder"}}}},"responses":{"201":{"description":"Возвращается папка переменной","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrFolder"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictattrfolders/{id}":{"get":{"tags":["Папки строгих переменных"],"summary":"Получить папку по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrFolderId"}],"responses":{"200":{"description":"Возвращается папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrFolder"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Папки строгих переменных"],"summary":"Обновить папку","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrFolderId"}],"requestBody":{"description":"Папка","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewStrictattrFolder"}}}},"responses":{"200":{"description":"Возвращается папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictattrFolder"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Папки строгих переменных"],"summary":"Удалить папку по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/StrictattrFolderId"}],"responses":{"200":{"description":"Возвращается id папки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplatesadmin":{"get":{"tags":["Строгие шаблоны (админка)"],"summary":"Получить список строгих шаблонов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список строгих шаблонов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StrictTemplateWithUploadFlag"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Строгие шаблоны (админка)"],"summary":"Создать новый строгий шаблон","security":[{"BearerAuth":[]}],"requestBody":{"description":"Структура строгого шаблона","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictTemplateContent"}}}},"responses":{"201":{"description":"Возвращается id строгого шаблона","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplatesadmin/{id}/upload":{"post":{"tags":["Строгие шаблоны (админка)"],"summary":"Загрузить файл строгого шаблона","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Файл строгого шаблона (только xlsx)","required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"Файл","format":"binary"}}}}}},"responses":{"201":{"description":"Возвращается id строгого шаблона","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplatesadmin/{id}":{"get":{"tags":["Строгие шаблоны (админка)"],"summary":"Получить строгий шаблон","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается строгий шаблон","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictTemplateWithUploadFlag"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Строгие шаблоны (админка)"],"summary":"Обновить строгий шаблон","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Структура строгого шаблона","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictTemplateContent"}}}},"responses":{"200":{"description":"Возвращается id строгого шаблона","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Строгие шаблоны (админка)"],"summary":"Удалить строгий шаблон","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленного строгого шаблона","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplates":{"get":{"tags":["Строгие шаблоны"],"summary":"Получить список строгих шаблонов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список строгих шаблонов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StrictTemplate"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplates/{id}":{"get":{"tags":["Строгие шаблоны"],"summary":"Получить строгий шаблон","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается строгий шаблон","content":{"application/json":{"schema":{"type":"object","allOf":[{"$ref":"#/components/schemas/IdObject"},{"type":"object","properties":{"name":{"type":"string","description":"Название","example":"КС-3"}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplates/{id}/sides":{"get":{"tags":["Строгие шаблоны"],"summary":"Получить стороны строгого шаблона (для последующего создания документа)","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращаются стороны строгого шаблона","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictTemplateSidesWithCombo"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplates/{id}/render":{"post":{"tags":["Строгие шаблоны"],"summary":"Создание документа по строгому шаблону","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные для создания документа","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Название","example":"Акт 154"},"sideValues":{"$ref":"#/components/schemas/StrictTemplateSideValues"}}}}}},"responses":{"200":{"description":"Возвращается файл xslx","content":{"application/vnd.ms-excel":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/stricttemplates/{id}/render/{renderid}":{"get":{"tags":["Строгие шаблоны"],"summary":"Повторное создание файла строгого документа","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"},{"in":"path","name":"renderid","required":true,"description":"renderid","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается файл xslx","content":{"application/vnd.ms-excel":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Строгие шаблоны"],"summary":"Создание документа на основе другого документа","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"},{"in":"path","name":"renderid","required":true,"description":"renderid","schema":{"type":"string"}}],"requestBody":{"description":"Данные для создания документа","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Название","example":"Акт 154"},"sideValues":{"$ref":"#/components/schemas/StrictTemplateSideValues"}}}}}},"responses":{"200":{"description":"Возвращается файл xslx","content":{"application/vnd.ms-excel":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictrenders":{"get":{"tags":["Строгие документы"],"summary":"Получить список строгих документов","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Название документа и ключевые переменные","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается список документов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StrictRender"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictrenders/{id}":{"get":{"tags":["Строгие документы"],"summary":"Получить строгий документ","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается документ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictRenderContent"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Строгие документы"],"summary":"Удалить строгий документ","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictrenders/{id}/name":{"put":{"tags":["Строгие документы"],"summary":"Переименовать строгий документ","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Новое название документа","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Новое название документа","example":"Новый акт"}}}}}},"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictproductproperties/":{"get":{"tags":["Строгие свойства продуктов"],"summary":"Получить список строгих свойств продуктов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список строгих свойств продуктов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StrictProductProperty"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Строгие свойства продуктов"],"summary":"Создать новое строгое свойство продуктов","security":[{"BearerAuth":[]}],"requestBody":{"description":"Свойство","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictProductProperty"}}}},"responses":{"201":{"description":"Возвращается свойство","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictProductProperty"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/strictproductproperties/{id}":{"put":{"tags":["Строгие свойства продуктов"],"summary":"Обновить свойство","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/IdStrictProductProperty"}],"requestBody":{"description":"Свойство","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewStrictProductProperty"}}}},"responses":{"200":{"description":"Возвращается свойство","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StrictProductProperty"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Строгие свойства продуктов"],"summary":"Удалить свойство по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/IdStrictProductProperty"}],"responses":{"200":{"description":"Возвращается id свойства","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdStrictProductProperty"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/storageadmin/{id}":{"parameters":[{"in":"path","name":"id","required":true,"description":"id воркспейса","schema":{"type":"string"}}],"get":{"tags":["Хранилище файлов (админка)"],"summary":"Объём Хранилища и вложений воркспейса","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Объём","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageRoomUsage"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/storageadmin/{id}/enabled":{"parameters":[{"in":"path","name":"id","required":true,"description":"id воркспейса","schema":{"type":"string"}}],"put":{"tags":["Хранилище файлов (админка)"],"summary":"Включить или выключить «Хранилище файлов» воркспейсу","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","description":"true — включить Хранилище воркспейсу, false — выключить (по умолчанию выключено)","example":true}}}}}},"responses":{"200":{"description":"Объём после изменения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageRoomUsage"}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/storageadmin/{id}/limit":{"parameters":[{"in":"path","name":"id","required":true,"description":"id воркспейса","schema":{"type":"string"}}],"put":{"tags":["Хранилище файлов (админка)"],"summary":"«Лимит хранилища» — общий объём Хранилища и вложений, ГБ","description":"Число через точку, не меньше 1 ГБ (минимальный пакет), округляется до сотых. null или 0 — сброс к умолчанию (Хранилище 0, вложения бесплатно 100 МБ). Значения больше 0 и меньше 1 — ошибка storage.limit.min.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"limitGb":{"type":"number","nullable":true,"minimum":0,"maximum":100000,"description":"Общий лимит, ГБ (не меньше 1, до сотых); null или 0 — сбросить к умолчанию","example":1.5}}}}}},"responses":{"200":{"description":"Объём после изменения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageRoomUsage"}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/storageadmin/{id}/testaccount":{"parameters":[{"in":"path","name":"id","required":true,"description":"id воркспейса","schema":{"type":"string"}}],"put":{"tags":["Хранилище файлов (админка)"],"summary":"Признак «Тестовый аккаунт — без ограничений хранилища»","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","description":"true — отметить воркспейс тестовым аккаунтом (без ограничений хранилища), false — снять отметку","example":true}}}}}},"responses":{"200":{"description":"Объём после изменения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageRoomUsage"}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/storageadmin/{id}/recount":{"parameters":[{"in":"path","name":"id","required":true,"description":"id воркспейса","schema":{"type":"string"}}],"post":{"tags":["Хранилище файлов (админка)"],"summary":"Пересчитать вес вложений воркспейса по файлам на диске","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Счётчик до и после, байты","content":{"application/json":{"schema":{"type":"object","properties":{"before":{"type":"integer","description":"Счётчик вложений до пересчёта, байты","example":52428800},"after":{"type":"integer","description":"Счётчик вложений после пересчёта (по файлам на диске), байты","example":52431001}}}}}}}}},"/storage":{"get":{"tags":["Хранилище файлов"],"summary":"Содержимое папки Хранилища (без folderid — корень)","description":"Возвращает видимые пользователю вложенные папки и файлы, путь для «хлебных крошек» и занятое место. Папки видны по правилам папок шаблонов (группы, «только администраторы»); закрытая папка скрывает всё, что внутри. Право storage:view. Хранилище доступно только воркспейсам, которым его включил администратор сервиса, иначе 403.","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"folderid","required":false,"description":"id папки (24 шестнадцатеричных символа); не передан или пустая строка — корень Хранилища","schema":{"type":"string"},"example":"62bb25949213f16bcd934422"}],"responses":{"200":{"description":"Содержимое папки","content":{"application/json":{"schema":{"type":"object","properties":{"folder":{"type":"object","description":"Текущая папка; нет поля — открыт корень","properties":{"id":{"type":"string","description":"id папки","example":"62bb25949213f16bcd934422"},"name":{"type":"string","description":"Название папки","example":"Договоры 2026"},"groups":{"type":"array","description":"id групп, которым видна папка; пустой — видят все","items":{"type":"string","description":"id группы пользователей"}},"adminAccessOnly":{"type":"boolean","description":"Папка только для администраторов воркспейса","example":false}}},"path":{"type":"array","description":"Путь от корня до текущей папки включительно (для «хлебных крошек»); пустой — корень","items":{"type":"object","properties":{"id":{"type":"string","description":"id папки","example":"62bb25949213f16bcd934422"},"name":{"type":"string","description":"Название папки","example":"Договоры 2026"}}}},"folders":{"type":"array","description":"Вложенные папки, по порядку (position, затем имя)","items":{"$ref":"#/components/schemas/StorageFolder"}},"files":{"type":"array","description":"Файлы папки, по порядку (position, затем имя)","items":{"$ref":"#/components/schemas/StorageFile"}},"usage":{"description":"Занятое место и лимит воркспейса","allOf":[{"$ref":"#/components/schemas/StorageRoomUsage"}]},"canTrash":{"type":"boolean","description":"Пользователь — администратор воркспейса и может работать с Корзиной","example":true},"trash":{"type":"object","description":"Сколько в Корзине (только при canTrash = true)","properties":{"files":{"type":"integer","description":"Файлов в Корзине, включая файлы внутри удалённых папок","example":3},"folders":{"type":"integer","description":"Удалённых папок (только удалённые напрямую, без вложенных)","example":1}}}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено воркспейсу или нет права storage:view"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/tree":{"get":{"tags":["Хранилище файлов"],"summary":"Дерево доступных папок Хранилища","description":"Все видимые пользователю папки в виде дерева (для окон «Переместить» и «Отправить в Хранилище»). Право storage:view.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Папки верхнего уровня с вложенными","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StorageTreeNode"}},"example":[{"id":"62bb25949213f16bcd934422","name":"Договоры 2026","children":[{"id":"62bb25949213f16bcd934424","name":"Аренда"}]}]}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено воркспейсу или нет права storage:view"}}}},"/storage/trash":{"get":{"tags":["Хранилище файлов"],"summary":"Корзина Хранилища","description":"Удалённые напрямую папки и файлы (вложенное в удалённую папку отдельно не показывается) и сколько дней осталось до автоматической очистки. Только администраторы воркспейса (группа с признаком администратора воркспейса), иначе 403.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Содержимое Корзины","content":{"application/json":{"schema":{"type":"object","properties":{"retentionDays":{"type":"integer","description":"Сколько дней элементы хранятся в Корзине до окончательного удаления (настройка сервера STORAGE_TRASH_DAYS, по умолчанию 10)","example":10},"folders":{"type":"array","description":"Удалённые папки","items":{"allOf":[{"$ref":"#/components/schemas/StorageFolder"},{"$ref":"#/components/schemas/StorageTrashMeta"},{"type":"object","properties":{"filesCount":{"type":"integer","description":"Сколько файлов удалено вместе с папкой (на любой глубине)","example":2},"size":{"type":"integer","description":"Общий размер этих файлов, байты","example":508024}}}]}},"files":{"type":"array","description":"Удалённые файлы","items":{"allOf":[{"$ref":"#/components/schemas/StorageFile"},{"$ref":"#/components/schemas/StorageTrashMeta"}]}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или пользователь не администратор воркспейса"}}}},"/storage/trash/restore":{"post":{"tags":["Хранилище файлов"],"summary":"Восстановить элементы из Корзины","description":"Элемент и всё, что удалено вместе с ним, возвращается на прежнее место; если прежней папки уже нет — в корень. При совпадении имени добавляется суффикс «_2», «_3»… Только администраторы воркспейса, право storage:delete.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageItems"}}}},"responses":{"201":{"description":"Восстановлено","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageOk"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или пользователь не администратор воркспейса"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/trash/delete":{"post":{"tags":["Хранилище файлов"],"summary":"Удалить из Корзины навсегда (без items — очистить всю Корзину)","description":"Файлы удаляются с диска, занятое место освобождается. Отменить нельзя. Только администраторы воркспейса, право storage:delete.","security":[{"BearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Удаляемые элементы Корзины (1–500); не передано — очищается вся Корзина","minItems":1,"maxItems":500,"items":{"$ref":"#/components/schemas/StorageItemRef"},"example":[{"type":"file","id":"62bb25949213f16bcd934423"}]}}}}}},"responses":{"201":{"description":"Сколько удалено и сколько места освобождено","content":{"application/json":{"schema":{"type":"object","properties":{"files":{"type":"integer","description":"Удалено файлов","example":1},"folders":{"type":"integer","description":"Удалено папок","example":0},"freed":{"type":"integer","description":"Освобождено места, байты","example":254012}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или пользователь не администратор воркспейса"}}}},"/storage/usage":{"get":{"tags":["Хранилище файлов"],"summary":"Занятое место и лимит Хранилища воркспейса","description":"Право storage:view; Хранилище должно быть подключено воркспейсу, иначе 403.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Занятое место и лимиты","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageRoomUsage"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено воркспейсу"}}}},"/storage/folders":{"post":{"tags":["Хранилище файлов"],"summary":"Создать папку в Хранилище","description":"Имя — до 100 символов: цифры, пробелы, «-», «_», латинские и русские буквы; в одной родительской папке имена не повторяются (без учёта регистра). Право storage:create.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":100,"description":"Название папки (лишние пробелы убираются)","example":"Договоры 2026"},"parentid":{"type":"string","nullable":true,"description":"id родительской папки; null, пустая строка или не передано — папка создаётся в корне","example":"62bb25949213f16bcd934421"},"groups":{"type":"array","description":"id групп пользователей, которым видна папка; пустой или не передан — видят все","items":{"type":"string","description":"id группы пользователей"},"example":["62bb25949213f16bcd934430"]},"adminAccessOnly":{"type":"boolean","description":"Папка только для администраторов воркспейса","example":false}}}}}},"responses":{"201":{"description":"Созданная папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageFolder"}}}},"400":{"description":"Неверные данные (имя недопустимо, папка с таким именем уже есть)"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:create"},"404":{"description":"Родительская папка не найдена или скрыта от пользователя"}}}},"/storage/folders/{id}":{"parameters":[{"$ref":"#/components/parameters/id"}],"put":{"tags":["Хранилище файлов"],"summary":"Изменить папку Хранилища (имя, доступ, перенос)","description":"Не присланные поля не меняются. Перенос в саму себя или во вложенную папку запрещён. Право storage:edit.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","maxLength":100,"description":"Новое название папки (те же ограничения, что при создании)","example":"Договоры 2026"},"parentid":{"type":"string","nullable":true,"description":"Новая родительская папка; null или пустая строка — перенести в корень; не передано — не переносить","example":"62bb25949213f16bcd934421"},"groups":{"type":"array","description":"id групп пользователей, которым видна папка (заменяет прежний список)","items":{"type":"string","description":"id группы пользователей"},"example":["62bb25949213f16bcd934430"]},"adminAccessOnly":{"type":"boolean","description":"Папка только для администраторов воркспейса (false снимает ограничение)","example":false}}}}}},"responses":{"200":{"description":"Изменённая папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageFolder"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:edit"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Хранилище файлов"],"summary":"Удалить папку Хранилища в Корзину","description":"Папка со всем содержимым перемещается в Корзину; место освобождается только при окончательном удалении. Если внутри есть папки, скрытые от пользователя, — ошибка 400. Право storage:delete.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"id удалённой папки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:delete"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/files":{"post":{"tags":["Хранилище файлов"],"summary":"Загрузить файлы в Хранилище","description":"Имя файла приводится к допустимому (недопустимые символы заменяются на «_»), при совпадении в папке добавляется суффикс «_2», «_3»… Если место Хранилища закончилось или Хранилище без объёма — ошибка 400. Право storage:create.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"array","description":"Загружаемые файлы (одно или несколько полей file)","items":{"type":"string","format":"binary","description":"Содержимое файла"}},"folderid":{"type":"string","description":"id папки, куда загрузить; не передано или пустая строка — в корень","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"201":{"description":"Загруженные файлы","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/StorageFile"}}}}},"400":{"description":"Нет файлов, превышен объём Хранилища или Хранилище без объёма"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:create"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/files/{id}":{"parameters":[{"$ref":"#/components/parameters/id"}],"put":{"tags":["Хранилище файлов"],"summary":"Переименовать файл Хранилища","description":"Меняется имя без расширения; в папке не должно быть файла с тем же именем и расширением. Право storage:edit.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name"],"properties":{"name":{"type":"string","maxLength":100,"description":"Новое имя без расширения (цифры, пробелы, «-», «_», латинские и русские буквы)","example":"Договор аренды"}}}}}},"responses":{"200":{"description":"Изменённый файл","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageFile"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:edit"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Хранилище файлов"],"summary":"Удалить файл Хранилища в Корзину","description":"Место освобождается только при окончательном удалении из Корзины. Право storage:delete.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"id удалённого файла","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:delete"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/files/{id}/download":{"parameters":[{"$ref":"#/components/parameters/id"}],"get":{"tags":["Хранилище файлов"],"summary":"Скачать файл Хранилища","description":"Отдаёт содержимое файла с исходным MIME-типом и именем (Content-Disposition attachment). Право storage:view.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Содержимое файла","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:view"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/move":{"put":{"tags":["Хранилище файлов"],"summary":"Переместить папки и файлы в другую папку","description":"Перенос перетаскиванием. Перемещённые элементы встают в конец целевой папки; при совпадении имени файла добавляется суффикс «_2», «_3»… Право storage:edit.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","description":"Перемещаемые элементы (1–500)","minItems":1,"maxItems":500,"items":{"$ref":"#/components/schemas/StorageItemRef"},"example":[{"type":"file","id":"62bb25949213f16bcd934423"}]},"folderid":{"type":"string","nullable":true,"description":"Целевая папка; null, пустая строка или не передано — корень","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"200":{"description":"Перемещено","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageOk"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:edit"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/order":{"put":{"tags":["Хранилище файлов"],"summary":"Задать порядок элементов внутри папки","description":"Позиции присваиваются по порядку items (папки и файлы вместе). Право storage:edit.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["items"],"properties":{"items":{"type":"array","description":"Элементы папки в желаемой последовательности (1–500)","minItems":1,"maxItems":500,"items":{"$ref":"#/components/schemas/StorageItemRef"},"example":[{"type":"folder","id":"62bb25949213f16bcd934424"},{"type":"file","id":"62bb25949213f16bcd934423"}]},"folderid":{"type":"string","nullable":true,"description":"Папка, внутри которой меняется порядок; null, пустая строка или не передано — корень","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"200":{"description":"Порядок сохранён","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageOk"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:edit"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/storage/fromdocument":{"post":{"tags":["Хранилище файлов"],"summary":"Отправить PDF документа в Хранилище","description":"Кнопка «Отправить в Хранилище» в карточке документа: в папку кладётся PDF — подписанный, если документ подписан, иначе текущий вид. Имя файла — название документа. Документ, скрытый от пользователя, отправить нельзя. Учитывается лимит Хранилища. Право storage:create.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","id"],"properties":{"type":{"type":"string","enum":["render","externalInfill"],"description":"Тип документа: render — документ (рендер шаблона, в т.ч. с УКЭП), externalInfill — внешнее заполнение (ПЭП)","example":"render"},"id":{"type":"string","description":"id документа","example":"62bb25949213f16bcd934440"},"folderid":{"type":"string","nullable":true,"description":"Папка Хранилища; null, пустая строка или не передано — корень","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"201":{"description":"Созданный файл","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StorageFile"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Хранилище не подключено или нет права storage:create"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/smsgateway":{"get":{"tags":["SMS gateway"],"summary":"Настройки своего СМС шлюза","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Настройки (секреты — только администраторам WS при включённом режиме)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsGatewaySettings"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}},"put":{"tags":["SMS gateway"],"summary":"Сохранить подключение (администратор WS, режим включён)","description":"Нужен ключ API или логин вместе с паролем (частично заполненное подключение не сохраняется). Для password, apiKey, login и senderName: строка — задать, null — удалить, не передавать — оставить прежнее. Пароль и ключ хранятся зашифрованно. Подключение не заполнено — СМС идут через шлюз сервиса, ПЭП тарифицируются обычно.\n","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"provider":{"type":"string","enum":["smsc"],"description":"Провайдер СМС (только smsc — smsc.ru)","example":"smsc"},"login":{"type":"string","nullable":true,"maxLength":100,"description":"Логин аккаунта smsc.ru; null — удалить, не передан — без изменений","example":"MD_Orsk"},"password":{"type":"string","nullable":true,"maxLength":200,"description":"Пароль аккаунта smsc.ru (нужен вместе с логином); null — удалить, не передан — без изменений","example":"secret-password"},"apiKey":{"type":"string","nullable":true,"maxLength":200,"description":"Ключ API smsc.ru (вместо логина и пароля); null — удалить, не передан — без изменений","example":"4f9c1b2a7d3e8f60"},"senderName":{"type":"string","nullable":true,"pattern":"^[A-Za-z0-9. _-]{0,32}$","description":"Имя отправителя smsc.ru — до 32 символов (латиница, цифры, точка, дефис, подчёркивание, пробел); null — по умолчанию сервиса","example":"DataDoc"}}}}}},"responses":{"200":{"description":"Настройки после сохранения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsGatewaySettings"}}}},"400":{"description":"Режим не включён, подключение заполнено не полностью, неверные данные"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Не администратор рабочего пространства"}}},"delete":{"tags":["SMS gateway"],"summary":"Удалить подключение (СМС снова идут через шлюз сервиса)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Настройки после удаления","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsGatewaySettings"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Не администратор рабочего пространства"}}}},"/smsgateway/check":{"post":{"tags":["SMS gateway"],"summary":"Проверка подключения (запрос баланса smsc.ru, СМС не отправляется)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"ok true и баланс либо ok false и текст ошибки провайдера","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","description":"Провайдер принял учётные данные","example":true},"balance":{"type":"string","description":"Баланс аккаунта smsc.ru (только при ok true)","example":"1250.50"},"currency":{"type":"string","description":"Валюта баланса (только при ok true)","example":"RUR"},"error":{"type":"string","description":"Текст ошибки провайдера (только при ok false)","example":"authorise error"}}}}}},"400":{"description":"Подключение не настроено или режим не включён, нет связи с провайдером"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Не администратор рабочего пространства"}}}},"/workspace/signaturetariffs/my":{"get":{"tags":["Рабочее пространство"],"summary":"Прайс ПЭП воркспейса","description":"Как /workspace/signaturetariffs, но при активном своём СМС шлюзе цена за одну ПЭП особая (по умолчанию 5 руб., SIGNATURE_CUSTOM_SMS_PRICE), скидка за объём применяется как обычно. /workspace/signaturetariffs/price и покупка ПЭП считают так же.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Список ступеней прайса"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/workspaces/{id}/smscustom":{"put":{"tags":["Рабочие пространства"],"summary":"Администратор сервиса включает или выключает «Свой СМС шлюз»","security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"id воркспейса","schema":{"type":"string","example":"62bb25949213f16bcd934422"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["smsCustom"],"properties":{"smsCustom":{"type":"boolean","description":"true — включить режим «Свой СМС шлюз», false — выключить","example":true}}}}}},"responses":{"200":{"description":"Состояние флагов (smsCustom, smsFree, smsCustomActive, smsFreeActive)"},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/workspaces/{id}/smsfree":{"put":{"tags":["Рабочие пространства"],"summary":"Администратор сервиса включает или выключает «Бесплатные СМС» (нужен «Свой СМС шлюз»)","security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"description":"id воркспейса","schema":{"type":"string","example":"62bb25949213f16bcd934422"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["smsFree"],"properties":{"smsFree":{"type":"boolean","description":"true — включить «Бесплатные СМС» (только при включённом «Свой СМС шлюз»), false — выключить","example":true}}}}}},"responses":{"200":{"description":"Состояние флагов"},"400":{"description":"«Свой СМС шлюз» не включён"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signersadmin":{"get":{"tags":["Внешние подписанты (админка)"],"summary":"Внешние подписанты: список и поиск по email/коду/ИНН","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"q","description":"Поиск по части email, кода подписанта, ИНН identity или ФИО, без учёта регистра, до 200 символов","schema":{"type":"string"}},{"in":"query","name":"status","description":"Фильтр: active — не заблокированные, blocked — заблокированные, pinlocked — с паузой пина после неверных вводов","schema":{"type":"string"}},{"in":"query","name":"dateFrom","description":"Дата регистрации подписанта: с этой даты (ISO 8601)","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"dateTo","description":"Дата регистрации подписанта: по эту дату (ISO 8601)","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"from","description":"Индекс первой записи страницы, с 0 (не передан — 0)","schema":{"type":"string"}},{"in":"query","name":"to","description":"Индекс последней записи страницы включительно (не передан — до конца списка)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"items":[{"id":"6720a1c2d3e4f5a6b7c8d9e0","email":"signer01@example.com","name":"Петров Пётр Петрович","code":"GN348K","identities":[{"type":"person","name":"Петров Пётр Петрович","confirmed":false}],"createdAt":"2026-10-31T09:00:00.000Z","lastLoginAt":"2026-10-31T10:00:00.000Z","linksCount":1,"signedCount":3,"blocked":false}],"count":1}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signersadmin/{id}":{"parameters":[{"in":"path","name":"id","description":"id аккаунта подписанта","required":true,"schema":{"type":"string"}}],"get":{"tags":["Внешние подписанты (админка)"],"summary":"Карточка подписанта: связи и документы","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e0","links":[],"documents":[]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signersadmin/{id}/block":{"parameters":[{"in":"path","name":"id","description":"id аккаунта подписанта","required":true,"schema":{"type":"string"}}],"put":{"tags":["Внешние подписанты (админка)"],"summary":"Заблокировать / разблокировать (блокировка закрывает сессии)","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"blocked":true,"reason":"По обращению"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e0","blocked":true}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signersadmin/{id}/pinunlock":{"parameters":[{"in":"path","name":"id","description":"id аккаунта подписанта","required":true,"schema":{"type":"string"}}],"put":{"tags":["Внешние подписанты (админка)"],"summary":"Снять паузу пина","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e0"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers":{"get":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Подписанты воркспейса (связи)","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"status","description":"Фильтр по статусу связи: invited — приглашён, accepted — принята, declined — отклонена, revoked — приглашение отозвано, broken — связь разорвана","schema":{"type":"string"}},{"in":"query","name":"q","description":"Поиск по части email или ИНН подписанта, без учёта регистра, до 200 символов","schema":{"type":"string"}},{"in":"query","name":"from","description":"Индекс первой записи страницы, с 0 (не передан — 0)","schema":{"type":"string"}},{"in":"query","name":"to","description":"Индекс последней записи страницы включительно (не передан — до конца списка)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"items":[{"id":"6720a9b8c7d6e5f4a3b2c1d0","email":"signer01@example.com","status":"accepted","invitedBy":"email","senderName":"ООО Отправитель","invitedAt":"2026-10-31T09:00:00.000Z","acceptedAt":"2026-10-31T09:30:00.000Z","signer":{"code":"GN348K","registered":true,"name":"Петров Пётр Петрович","identity":{"type":"person","name":"Петров Пётр Петрович","confirmed":false}}}],"count":1}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/find":{"get":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Найти подписанта по коду, ИНН (подтверждённые компании) или email","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"code","description":"Код подписанта (например GN348K), до 20 символов. Нужен один из параметров code, email, inn; проверяются в порядке code → email → inn","schema":{"type":"string"}},{"in":"query","name":"inn","description":"ИНН подтверждённой компании или ИП подписанта; у нескольких подписантов одной компании возвращается только компания","schema":{"type":"string"}},{"in":"query","name":"email","description":"Email подписанта","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"found":true,"code":"GN348K","email":"s***1@example.com","companies":[{"name":"ООО Подписант","inn":"7701234567"}],"link":{"id":"6720a9b8c7d6e5f4a3b2c1d0","status":"accepted"}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/agreement":{"get":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Соглашение кабинета у отправителя: принято ли (до первой отправки)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"slug":"soglashenie-pep-kabinet-podpisanta","version":"2026-10-31T09:00:00.000Z","accepted":true,"required":false}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"put":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Отправитель принимает соглашение (редакция, сумма, время, IP, пользователь)","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"version":"2026-10-31T09:00:00.000Z"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"accepted":true,"required":false}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/bycode/{code}":{"parameters":[{"in":"path","name":"code","description":"Код подписанта (например GN348K), до 20 символов","required":true,"schema":{"type":"string"}}],"get":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Страница /docs/КОД/ для вошедшего клиента: связь и профиль (если принята)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"code":"GN348K","exists":true,"link":{"id":"6720a9b8c7d6e5f4a3b2c1d0","email":"signer01@example.com","status":"accepted","invitedBy":"email","senderName":"ООО Отправитель","invitedAt":"2026-10-31T09:00:00.000Z","acceptedAt":"2026-10-31T09:30:00.000Z","signer":{"code":"GN348K","registered":true,"name":"Петров Пётр Петрович","identity":{"type":"person","name":"Петров Пётр Петрович","confirmed":false}}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/invite":{"post":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Пригласить к сотрудничеству: по email, коду, ссылке, ИНН","description":"Нет аккаунта — письмо с регистрацией. Связь привязывается к контрагенту (передан, найден по ИНН или создан).","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"by":"email","email":"signer01@example.com","counteragentId":"6720c1d2e3f4a5b6c7d8e9f0","senderName":"ООО Отправитель"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0","email":"signer01@example.com","status":"invited","invitedBy":"email","senderName":"ООО Отправитель","invitedAt":"2026-10-31T09:00:00.000Z","acceptedAt":"2026-10-31T09:30:00.000Z","signer":{"code":"GN348K","registered":true,"name":"Петров Пётр Петрович","identity":{"type":"person","name":"Петров Пётр Петрович","confirmed":false}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/{id}":{"parameters":[{"in":"path","name":"id","description":"id связи с подписантом (из GET /signers)","required":true,"schema":{"type":"string"}}],"get":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Связь и её документы","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0","email":"signer01@example.com","status":"accepted","invitedBy":"email","senderName":"ООО Отправитель","invitedAt":"2026-10-31T09:00:00.000Z","acceptedAt":"2026-10-31T09:30:00.000Z","signer":{"code":"GN348K","registered":true,"name":"Петров Пётр Петрович","identity":{"type":"person","name":"Петров Пётр Петрович","confirmed":false}},"documents":[{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"sent","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"}]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/{id}/remind":{"parameters":[{"in":"path","name":"id","description":"id связи с подписантом (из GET /signers)","required":true,"schema":{"type":"string"}}],"post":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Повторить письмо-приглашение (раз в час)","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/{id}/revoke":{"parameters":[{"in":"path","name":"id","description":"id связи с подписантом (из GET /signers)","required":true,"schema":{"type":"string"}}],"put":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Отозвать приглашение","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0","email":"signer01@example.com","status":"revoked","invitedBy":"email","senderName":"ООО Отправитель","invitedAt":"2026-10-31T09:00:00.000Z","acceptedAt":"2026-10-31T09:30:00.000Z","signer":{"code":"GN348K","registered":true,"name":"Петров Пётр Петрович","identity":{"type":"person","name":"Петров Пётр Петрович","confirmed":false}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signers/{id}/break":{"parameters":[{"in":"path","name":"id","description":"id связи с подписантом (из GET /signers)","required":true,"schema":{"type":"string"}}],"put":{"tags":["Подписанты: связи и приглашения (пользователь)"],"summary":"Разорвать связь: ждущие подписи документы отзываются, подписанные остаются","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0","email":"signer01@example.com","status":"broken","invitedBy":"email","senderName":"ООО Отправитель","invitedAt":"2026-10-31T09:00:00.000Z","acceptedAt":"2026-10-31T09:30:00.000Z","signer":{"code":"GN348K","registered":true,"name":"Петров Пётр Петрович","identity":{"type":"person","name":"Петров Пётр Петрович","confirmed":false}},"revokedDocuments":2}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments":{"post":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Отправить в кабинет подписанта: документ или комплект","description":"Документ: по шаблону, свой файл («пустой шаблон») или рендер, подписанный клиентом УКЭП ({renderId}). Нет подписей — signature.limitexceeded; связь не принята — signerlink.notaccepted; соглашение не принято — signers.agreement.required.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"linkId":"6720a9b8c7d6e5f4a3b2c1d0","bundleName":"Договор и акт","documents":[{"templateId":"66f1a2b3c4d5e6f7a8b9c0d1","sideValues":[{"tattrValues":{"101":"Петров"},"tableValues":[],"articleValues":[]}]},{"file":{"name":"Акт.pdf","mimetype":"application/pdf","content":"JVBERi0xLjQK..."}}]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"bundle":{"id":"6720b1c2d3e4f5a6b7c8d9e0","name":"Договор и акт"},"documents":[{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","status":"sent","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT"}]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"get":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Документы, отправленные в кабинет","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"linkId","description":"id связи с подписантом — только документы этого подписанта","schema":{"type":"string"}},{"in":"query","name":"status","description":"Фильтр по статусу: sent — отправлен, viewed — просмотрен, signed — подписан, rejected — отклонён, revoked — отозван","schema":{"type":"string"}},{"in":"query","name":"bundleId","description":"id комплекта — только документы этого комплекта","schema":{"type":"string"}},{"in":"query","name":"massId","description":"id массовой отправки — только документы этой отправки","schema":{"type":"string"}},{"in":"query","name":"q","description":"Поиск по части названия документа, без учёта регистра, до 200 символов","schema":{"type":"string"}},{"in":"query","name":"from","description":"Индекс первой записи страницы, с 0 (не передан — 0)","schema":{"type":"string"}},{"in":"query","name":"to","description":"Индекс последней записи страницы включительно (не передан — до конца списка)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"items":[{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"sent","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"}],"count":1}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/mass":{"post":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Массовая отправка нескольким подписантам","description":"Каждому — свой документ/комплект; общий список documents или свой у получателя.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"name":"Рассылка договоров","documents":[{"file":{"name":"Договор.pdf","mimetype":"application/pdf","content":"JVBERi0xLjQK..."}}],"items":[{"linkId":"6720a9b8c7d6e5f4a3b2c1d0"},{"linkId":"6720a9b8c7d6e5f4a3b2c1d1"}]}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720d1e2f3a4b5c6d7e8f9a0","name":"Рассылка договоров","summary":{"recipients":2,"documents":2,"signed":0,"rejected":0,"revoked":0,"pending":2},"items":[]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/bundles/{id}":{"parameters":[{"in":"path","name":"id","description":"id комплекта документов","required":true,"schema":{"type":"string"}}],"get":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Комплект со сводкой","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b1c2d3e4f5a6b7c8d9e0","summary":{"total":3,"signed":2,"rejected":0,"revoked":0,"pending":1},"status":"pending","documents":[{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"sent","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"}]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/bundles/{id}/revoke":{"parameters":[{"in":"path","name":"id","description":"id комплекта документов","required":true,"schema":{"type":"string"}}],"put":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Отозвать ждущие документы комплекта","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b1c2d3e4f5a6b7c8d9e0","status":"revoked"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/mass/{id}":{"parameters":[{"in":"path","name":"id","description":"id массовой отправки","required":true,"schema":{"type":"string"}}],"get":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Массовая отправка: статусы по получателям","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720d1e2f3a4b5c6d7e8f9a0","summary":{"recipients":2,"documents":2,"signed":1,"rejected":0,"revoked":0,"pending":1},"items":[]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/mass/{id}/remind":{"parameters":[{"in":"path","name":"id","description":"id массовой отправки","required":true,"schema":{"type":"string"}}],"post":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Напомнить всем, у кого есть ждущие документы","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720d1e2f3a4b5c6d7e8f9a0","reminded":1}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/mass/{id}/excel":{"parameters":[{"in":"path","name":"id","description":"id массовой отправки","required":true,"schema":{"type":"string"}}],"get":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Выгрузка статусов массовой отправки (XLSX)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/{id}":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"get":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Документ кабинета","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"sent","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08","signer":{"email":"signer01@example.com","code":"GN348K","name":"Петров Пётр Петрович"}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/{id}/revoke":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"put":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Отозвать документ (ждёт подписи)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"revoked","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/{id}/remind":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"post":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"Напомнить подписанту (раз в час)","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b2c3d4e5f6a7b8c9d0e1"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signerdocuments/{id}/archive":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"get":{"tags":["Подписанты: отправка в кабинет (пользователь)"],"summary":"ZIP подписанного","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinetpublic/code/{code}":{"parameters":[{"in":"path","name":"code","description":"Код подписанта (например GN348K), регистр не важен, до 20 символов","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (публичные)"],"summary":"Есть ли подписант с таким кодом (страница /docs/КОД/)","description":"Регистр не важен; без имени и документов; 20 запросов в минуту с IP.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"code":"GN348K","exists":true}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/signercabinetpublic/agreement":{"get":{"tags":["Кабинет подписанта (публичные)"],"summary":"Текущая редакция соглашения о ПЭП кабинета","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"version":"2026-10-31T09:00:00.000Z","slug":"soglashenie-pep-kabinet-podpisanta"}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/signercabinetpublic/availability":{"get":{"tags":["Кабинет подписанта (публичные)"],"summary":"Доступен ли кабинет подписанта (показывать ли его на сайте)","description":"enabled: true, если подпись в кабинете включена глобальной настройкой или хотя бы в одном рабочем пространстве.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean","description":"true — кабинет подписанта включён (глобально или хотя бы в одном рабочем пространстве)"}}},"example":{"enabled":true}}}}}}},"/signercabinet/register":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Регистрация: email (+ пароль при ссылке-приглашении); ссылка подтверждения уходит на email","description":"Пароль принимается только с действующим token ссылки-приглашения (email подтверждается сразу, выдаётся сессия). Без него пароль не сохраняется: его задаёт владелец ссылки подтверждения (POST /signercabinet/register/confirm). Повторная регистрация неподтверждённого email аккаунт не меняет, только отправляет новую ссылку.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"signer01@example.com","name":"Петров Пётр Петрович","lang":"ru"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"email":"signer01@example.com","linkSent":true}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/signercabinet/register/resend":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Повтор кода подтверждения (не чаще раза в минуту)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"signer01@example.com"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"email":"signer01@example.com","codeSent":true}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/signercabinet/register/confirm":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Подтверждение email по ссылке из письма: пароль, аккаунт, код подписанта, сессия","description":"token — из ссылки письма (одноразовый). Пароль задаёт владелец ссылки. Приглашения на этот email привязываются к аккаунту.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"signer01@example.com","token":"9c1e...4b","password":"Password-1"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"token":"4f1c...e9","expiresAt":"2026-11-30T10:00:00.000Z","account":{"id":"6720a1c2d3e4f5a6b7c8d9e0","email":"signer01@example.com","name":"Петров Пётр Петрович","code":"GN348K","lang":"ru","onboarding":{"emailVerified":true,"agreementAccepted":true,"agreementVersion":"2026-10-31T09:00:00.000Z","currentAgreementVersion":"2026-10-31T09:00:00.000Z","agreementRequired":false,"pinSet":true},"pin":{"failures":0},"identities":[{"id":"6720a1c2d3e4f5a6b7c8d9e1","type":"person","name":"Петров Пётр Петрович","confirmed":false}],"mustChangePassword":false}}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/signercabinet/login":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Вход: только email + пароль","description":"Сессия 30 дней, продлевается каждым запросом (заголовок X-Signer-Session-Expires). Вход по одноразовому паролю — mustChangePassword: true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"signer01@example.com","password":"Password-1"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"token":"4f1c...e9","expiresAt":"2026-11-30T10:00:00.000Z","account":{"id":"6720a1c2d3e4f5a6b7c8d9e0","email":"signer01@example.com","name":"Петров Пётр Петрович","code":"GN348K","lang":"ru","onboarding":{"emailVerified":true,"agreementAccepted":true,"agreementVersion":"2026-10-31T09:00:00.000Z","currentAgreementVersion":"2026-10-31T09:00:00.000Z","agreementRequired":false,"pinSet":true},"pin":{"failures":0},"identities":[{"id":"6720a1c2d3e4f5a6b7c8d9e1","type":"person","name":"Петров Пётр Петрович","confirmed":false}],"mustChangePassword":false},"mustChangePassword":false}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/signercabinet/password/reset":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Сброс пароля: одноразовый пароль на email (1 час)","description":"Ответ одинаковый, есть аккаунт или нет.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"signer01@example.com"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"sent":true}}}},"400":{"$ref":"#/components/responses/InvalidData"}}}},"/signercabinet/password":{"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Смена пароля (после одноразового пароля — без старого)","description":"Закрывает остальные сессии и выдаёт новую; письмо о смене пароля.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"password":"Password-2","oldPassword":"Password-1"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"token":"a1b2...","expiresAt":"2026-11-30T10:00:00.000Z"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/logout":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Выход (закрыть сессию)","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/profile":{"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Профиль: шаги (email, соглашение, пин), пауза пина, identities","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e0","email":"signer01@example.com","name":"Петров Пётр Петрович","code":"GN348K","lang":"ru","onboarding":{"emailVerified":true,"agreementAccepted":true,"agreementVersion":"2026-10-31T09:00:00.000Z","currentAgreementVersion":"2026-10-31T09:00:00.000Z","agreementRequired":false,"pinSet":true},"pin":{"failures":0},"identities":[{"id":"6720a1c2d3e4f5a6b7c8d9e1","type":"person","name":"Петров Пётр Петрович","confirmed":false}],"mustChangePassword":false}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Изменить ФИО и язык (email и код подписанта не меняются)","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"name":"Петров Пётр Петрович","lang":"ru"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e0","email":"signer01@example.com","name":"Петров Пётр Петрович","code":"GN348K","lang":"ru","onboarding":{"emailVerified":true,"agreementAccepted":true,"agreementVersion":"2026-10-31T09:00:00.000Z","currentAgreementVersion":"2026-10-31T09:00:00.000Z","agreementRequired":false,"pinSet":true},"pin":{"failures":0},"identities":[{"id":"6720a1c2d3e4f5a6b7c8d9e1","type":"person","name":"Петров Пётр Петрович","confirmed":false}],"mustChangePassword":false}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/agreement":{"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Текущая редакция соглашения о ПЭП и принятая подписантом","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"version":"2026-10-31T09:00:00.000Z","hash":"3a7bd3e2...","slug":"soglashenie-pep-kabinet-podpisanta","required":false}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Принять соглашение (редакция, контрольная сумма, время, IP)","description":"Новая редакция (изменён юридический документ soglashenie-pep-kabinet-podpisanta) — подписант принимает её заново перед подписью.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"version":"2026-10-31T09:00:00.000Z"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"agreement":{"version":"2026-10-31T09:00:00.000Z","hash":"3a7bd3e2...","acceptedAt":"2026-10-31T10:00:00.000Z","ip":"203.0.113.5"}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/pin":{"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Задать или сменить пин (ровно 4 цифры, 0 допустим); смена — с паролем","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"pin":"0412","password":"Password-1"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"pinSet":true}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/pin/reset":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"«Забыл пин»: код на email (30 минут)","security":[{"BearerAuth":[]}],"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"sent":true}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Новый пин по коду из письма (снимает паузу)","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"code":"123456","pin":"0412"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"pinSet":true}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/identities":{"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"От чьего имени подписывает: физлицо, самозанятый, ИП, компания","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":[{"id":"6720a1c2d3e4f5a6b7c8d9e1","type":"person","name":"Петров Пётр Петрович","confirmed":false}]}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Добавить identity физлица или самозанятого","description":"Типы individual (ИП) и entity (компания) здесь не принимаются (signercabinet.identity.bycertificate): их добавляют по УКЭП через GET /signercabinet/identities/company/challenge и POST /signercabinet/identities/company. ИНН, если передан, — 12 цифр.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","name"],"properties":{"type":{"type":"string","enum":["person","selfemployed"],"description":"Тип: person — физлицо, selfemployed — самозанятый"},"name":{"type":"string","description":"ФИО"},"inn":{"type":"string","description":"ИНН, 12 цифр (необязательно)"},"kpp":{"type":"string","maxLength":20,"description":"КПП (необязательно)"}}},"example":{"type":"selfemployed","name":"Петров Пётр Петрович","inn":"770123456789"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignerCabinetIdentity"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e2","type":"selfemployed","name":"Петров Пётр Петрович","inn":"770123456789","confirmed":false}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/identities/{id}":{"parameters":[{"in":"path","name":"id","description":"id identity (от чьего имени подписывает) из GET /signercabinet/identities","required":true,"schema":{"type":"string"}}],"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Изменить название/КПП identity физлица или самозанятого","description":"Компания и ИП (из сертификата и реестра) вручную не меняются — signercabinet.identity.bycertificate.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Новое название или ФИО"},"kpp":{"type":"string","maxLength":20,"description":"КПП; пустая строка удаляет"}}},"example":{"name":"Петров Пётр Петрович","kpp":""}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e2"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}},"delete":{"tags":["Кабинет подписанта (подписант)"],"summary":"Удалить identity (первую — физлицо — нельзя)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e2"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/identities/company/challenge":{"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Текст заявления для подписи УКЭП при добавлении компании или ИП (действует 30 минут)","description":"Текст содержит код и email подписанта, дату и случайную строку; сохраняется в аккаунте до POST /signercabinet/identities/company или до истечения 30 минут. Новый запрос заменяет прежний текст.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Текст заявления: его подписывают УКЭП (откреплённая подпись) в браузере и передают в POST /signercabinet/identities/company"},"expiresAt":{"type":"string","format":"date-time","description":"До какого момента текст действует (30 минут с запроса)"}}},"example":{"text":"Прошу добавить организацию в кабинет подписанта GN348K (vm@datadoc.ru), 2026-11-07T10:00:00.000Z, 9f1c2b3a4d5e6f70","expiresAt":"2026-11-07T10:30:00.000Z"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/identities/company":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Добавить компанию или ИП по УКЭП (руководителя или сотрудника с МЧД)","description":"multipart: откреплённая подпись текста из GET /signercabinet/identities/company/challenge (*.sig, обязательно) и машиночитаемая доверенность (*.xml, если подписывает сотрудник). Тип и ИНН берутся из сертификата (ИНН юрлица — компания; ОГРНИП — ИП) или из МЧД (доверитель); название, КПП, ОГРН, адрес и статус — из реестра (DaData). Ликвидируемая, ликвидированная или банкротящаяся организация не добавляется (signercabinet.identity.liquidated). Identity с тем же ИНН обновляется, а не дублируется. Компания сразу подтверждена (confirmed: true). Ошибки: signercabinet.identity.challenge — текст не запрошен или истёк; signercabinet.identity.confirmfiles — нет файла .sig; signercabinet.identity.notcompany — сертификат не организации и не ИП и нет МЧД.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"array","description":"Файлы: подпись *.sig (обязательно) и МЧД *.xml (необязательно); тип файла определяется по расширению","items":{"type":"string","format":"binary"}}}}}}},"responses":{"200":{"description":"Добавленная (или обновлённая) identity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignerCabinetIdentity"},"example":{"id":"6720a1c2d3e4f5a6b7c8d9e2","type":"entity","name":"ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"ПОДПИСАНТ\"","inn":"7701234567","kpp":"770101001","confirmed":true,"confirmedAt":"2026-11-07T10:05:00.000Z","ogrn":"1027700000000","address":"г Москва, ул Тверская, д 1","registryStatus":"ACTIVE","ownerName":"Петров Пётр Петрович","ownerTitle":"Генеральный директор"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/links":{"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Связи с клиентами (без отозванных приглашений)","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"status","description":"Фильтр по статусу связи: invited — приглашён, accepted — принята, declined — отклонена, revoked — приглашение отозвано, broken — связь разорвана","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":[{"id":"6720a9b8c7d6e5f4a3b2c1d0","status":"invited","senderName":"ООО Отправитель","invitedBy":"email","invitedAt":"2026-10-31T09:00:00.000Z","documents":{"pending":0,"signed":0}}]}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/invites/{key}":{"parameters":[{"in":"path","name":"key","description":"Ключ приглашения из ссылки письма, до 40 символов","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Приглашение по ссылке из письма (страница пригласившего)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0","status":"invited","senderName":"ООО Отправитель","invitedAt":"2026-10-31T09:00:00.000Z"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/links/{id}/accept":{"parameters":[{"in":"path","name":"id","description":"id связи с клиентом (из GET /signercabinet/links)","required":true,"schema":{"type":"string"}}],"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Принять связь (в т.ч. ранее отклонённую)","description":"identityId — для ИП/компании только подтверждённая.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"identityId":"6720a1c2d3e4f5a6b7c8d9e1"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0","status":"accepted","acceptedAt":"2026-10-31T09:30:00.000Z"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/links/{id}/decline":{"parameters":[{"in":"path","name":"id","description":"id связи с клиентом (из GET /signercabinet/links)","required":true,"schema":{"type":"string"}}],"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Отклонить приглашение (можно принять позже, пока не отозвано)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720a9b8c7d6e5f4a3b2c1d0","status":"declined"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents":{"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Документы: ждут подписи / подписанные / отклонённые / все; поиск","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"status","description":"Фильтр: pending — ждут подписи (отправлен, просмотрен), signed — подписанные, rejected — отклонённые, all или не передан — все, кроме отозванных","schema":{"type":"string"}},{"in":"query","name":"q","description":"Поиск по части названия документа или имени отправителя, без учёта регистра, до 200 символов","schema":{"type":"string"}},{"in":"query","name":"linkId","description":"id связи с клиентом — только документы этого клиента","schema":{"type":"string"}},{"in":"query","name":"bundleId","description":"id комплекта — только документы этого комплекта","schema":{"type":"string"}},{"in":"query","name":"from","description":"Индекс первой записи страницы, с 0 (не передан — 0)","schema":{"type":"string"}},{"in":"query","name":"to","description":"Индекс последней записи страницы включительно (не передан — до конца списка)","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"items":[{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"sent","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08","expired":false}],"count":1}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/sign":{"post":{"tags":["Кабинет подписанта (подписант)"],"summary":"Подписать выбранные документы одним вводом пина","description":"До 50 документов, можно разных отправителей. 5 неверных пинов подряд — 423 signercabinet.pin.locked на 1 час.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"ids":["6720b2c3d4e5f6a7b8c9d0e1","6720b2c3d4e5f6a7b8c9d0e2"],"pin":"0412"}}}},"responses":{"201":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"signed":[{"id":"6720b2c3d4e5f6a7b8c9d0e1","signatureId":"2b0c7c1e-1d2f-4a6b-9b0e-6c1c1f7a8e01","signedAt":"2026-10-31T12:00:00.000Z"}],"failed":[{"id":"6720b2c3d4e5f6a7b8c9d0e2","resource":"signercabinet.document.wrongstatus","message":"Документ уже подписан, отклонён или отозван"}]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/{id}":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту (из GET /signercabinet/documents)","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Карточка документа (первый просмотр — статус viewed)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"viewed","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08","attachments":[{"id":"6720b2c3d4e5f6a7b8c9d0f1","name":"Акт.pdf","filename":"Акт.pdf","mimetype":"application/pdf","size":10040}],"bundle":{"id":"6720b1c2d3e4f5a6b7c8d9e0","name":"Договор и акт","summary":{"total":2,"signed":1,"rejected":0,"revoked":0,"pending":1},"status":"pending"},"canSign":true,"expired":false}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/{id}/file":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"PDF на подпись (его SHA-256 — docHash; его подписывает УКЭП)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/{id}/attachments/{attachmentId}":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}},{"in":"path","name":"attachmentId","description":"id приложения (attachments[].id из карточки документа)","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Файл приложения","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/{id}/signed":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Итоговый PDF со штампом (360 дней после окончания оплаты клиента)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/{id}/archive":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"ZIP подписанного (PDF со штампом, исходный PDF, для УКЭП — .sig и МЧД)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/{id}/signqualified":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Подписать УКЭП (свой сертификат или по МЧД)","description":"multipart: откреплённая подпись файла /file (*.sig), МЧД (*.xml) — необязательно.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"files":{"type":"array","description":"Файлы: откреплённая подпись PDF из /file (*.sig, обязательно) и МЧД (*.xml, если подписывает сотрудник по доверенности)","items":{"type":"string","format":"binary"}},"certCode":{"type":"string","description":"Код (отпечаток) сертификата УКЭП, выбранного в браузере; обязательно","example":"A1B2C3D4E5F60718293A4B5C6D7E8F9012345678"},"signerName":{"type":"string","description":"ФИО владельца сертификата (из сертификата, передаёт браузер)","example":"Петров Пётр Петрович"},"companyName":{"type":"string","description":"Организация из сертификата","example":"ООО Подписант"},"companyInn":{"type":"string","description":"ИНН организации из сертификата","example":"7701234567"},"companyKpp":{"type":"string","description":"КПП организации из сертификата","example":"770101001"},"signerType":{"type":"string","enum":["entity","person","individual"],"description":"Тип владельца сертификата: entity — организация, person — физлицо, individual — ИП"},"identityId":{"type":"string","description":"id identity, от имени которой подписывается документ; не передан — identity связи с клиентом","example":"6720a1c2d3e4f5a6b7c8d9e2"}},"required":["certCode"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b2c3d4e5f6a7b8c9d0e1","signatureId":"2b0c7c1e-...","signedAt":"2026-10-31T12:00:00.000Z"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/documents/{id}/reject":{"parameters":[{"in":"path","name":"id","description":"id документа, отправленного подписанту","required":true,"schema":{"type":"string"}}],"put":{"tags":["Кабинет подписанта (подписант)"],"summary":"Отказать с причиной (письмо отправителю)","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"reason":"Неверная сумма"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"rejected","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08","rejectReason":"Неверная сумма"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signercabinet/bundles/{id}":{"parameters":[{"in":"path","name":"id","description":"id комплекта документов","required":true,"schema":{"type":"string"}}],"get":{"tags":["Кабинет подписанта (подписант)"],"summary":"Комплект: документы и сводка (подписано N из M)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"},"example":{"id":"6720b1c2d3e4f5a6b7c8d9e0","name":"Договор и акт","senderName":"ООО Отправитель","summary":{"total":2,"signed":2,"rejected":0,"revoked":0,"pending":0},"status":"signed","documents":[{"id":"6720b2c3d4e5f6a7b8c9d0e1","name":"Договор № 12","senderName":"ООО Отправитель","status":"sent","source":"infill","infillId":"6720b2c3d4e5f6a7b8c9d0a1","urlKey":"Xq3kLm9PzT","linkId":"6720a9b8c7d6e5f4a3b2c1d0","sentAt":"2026-10-31T10:00:00.000Z","docHash":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"}]}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/signtablet":{"get":{"tags":["DataDoc SIGN"],"summary":"Настройки планшета DataDoc SIGN","description":"Читают профиль ЛК и страница планшета (токен по ключу API, POST /auth/apikey). 403, если функция недоступна рабочему пространству (общая настройка signature.tablet.enabled или свойство WS signTabletAccess).","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Настройки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignTabletSettings"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Функция DataDoc SIGN недоступна"}}},"put":{"tags":["DataDoc SIGN"],"summary":"Сохранить режим работы планшета","description":"Не присланное остаётся как было; multiLinkUrl = null удаляет ссылку. Режим multilink требует ссылку.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["lastdocument","multilink"],"description":"Режим планшета — lastdocument (последний документ на подпись «Сигнатурой») или multilink (открыть мульти-ссылку); не передан — без изменений","example":"multilink"},"multiLinkUrl":{"type":"string","nullable":true,"maxLength":2000,"description":"Мульти-ссылка для режима multilink — адрес http(s); null удаляет ссылку; не передан — без изменений","example":"https://datadoc.ru/ru/sign/AbCdEf/"}},"example":{"mode":"multilink","multiLinkUrl":"https://datadoc.ru/ru/sign/AbCdEf/"}}}}},"responses":{"200":{"description":"Настройки после сохранения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignTabletSettings"}}}},"400":{"description":"Неверный режим или адрес; режим multilink без ссылки"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Функция DataDoc SIGN недоступна"}}}},"/signtablet/background":{"post":{"tags":["DataDoc SIGN"],"summary":"Загрузить подложку планшета","description":"Файл (поле file) - JPEG, PNG, WebP, MP4 или WebM до 10 МБ. Новый файл заменяет прежний. Файл отдаётся публично со статического домена (адрес - в настройках).","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary","description":"Файл подложки (JPEG, PNG, WebP, MP4 или WebM, до 10 МБ)"}}}}}},"responses":{"201":{"description":"Настройки после загрузки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignTabletSettings"}}}},"400":{"description":"Нет файла, неверный тип, файл больше 10 МБ"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Функция DataDoc SIGN недоступна"}}},"delete":{"tags":["DataDoc SIGN"],"summary":"Удалить подложку","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Настройки после удаления","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignTabletSettings"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Функция DataDoc SIGN недоступна"}}}},"/signtablet/lastdocument":{"get":{"tags":["DataDoc SIGN"],"summary":"Последний документ пользователя на подпись «Сигнатурой»","description":"Самый новый неподписанный документ владельца токена со способом подписи «Сигнатура» - документ на заполнение и подпись (не мульти-ссылка) или готовый документ, отправленный контрагенту. Ссылка ведёт на стандартную страницу подписания.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Документ","content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string","enum":["externalinfill","render"],"description":"Вид документа — externalinfill (документ на заполнение и подпись) или render (готовый документ, отправленный контрагенту)"},"key":{"type":"string","description":"Ключ ссылки документа (urlKey)"},"name":{"type":"string","description":"Название документа"},"createdAt":{"type":"string","format":"date-time","description":"Дата создания (для готового документа — дата отправки на подпись)"},"url":{"type":"string","description":"Адрес страницы подписания (/<язык>/sign/Текст
"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}":{"get":{"tags":["Документы"],"summary":"Получить документ","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается документ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TemplateRenderFull"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Документы"],"summary":"Удалить рендер","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/name":{"put":{"tags":["Документы"],"summary":"Переименовать документ","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Новое название документа","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Новое название документа","example":"Новый документ"}}}}}},"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/owner":{"put":{"tags":["Документы"],"summary":"Установить ответственного за документ","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Id ответственного","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner":{"type":"string","description":"id папки","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/confirm":{"put":{"tags":["Документы"],"summary":"Установить/снять флаг подписания","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/signed/archive":{"get":{"tags":["Документы"],"summary":"Скачать архив с подписанным документом и сопутствующими файлами","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается zip-архив","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/signed/preview":{"get":{"tags":["Документы"],"summary":"Скачать pdf документа с печатями сторон","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается файл pdf","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/signed/publish":{"put":{"tags":["Документы"],"summary":"Опубликовать документ для подписания второй стороной","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные подписи","required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","description":"Тип подписи","example":"simple"},"signerName":{"type":"string","description":"ФИО подписанта второй стороны","example":"Иванов Иван Иванович"},"signerPhone":{"type":"string","description":"Телефон подписанта второй стороны","example":79999999999}}},{"type":"object","properties":{"type":{"type":"string","description":"Тип подписи","example":"qualified"}}}]},"examples":{"ПЭП":{"value":{"type":"simple","signerName":"Иванов Иван Иванович","signerPhone":79999999999}},"УКЭП":{"value":{"type":"qualified"}}}}}},"responses":{"200":{"description":"Возвращается URL-ключ","content":{"application/json":{"schema":{"type":"object","properties":{"urlKey":{"type":"string","description":"Ключ","example":"dSfAda"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/signed/sms":{"put":{"tags":["Документы"],"summary":"Отправить СМС для подписания ПЭП","description":"Каждая отправленная СМС списывает подпись. Нет подписей (и не действуют «Бесплатные СМС») — ошибка signature.limitexceeded, СМС не отправляется (FOR-2823).","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/signed/email":{"put":{"tags":["Документы"],"summary":"Отправить письмо для подписания УКЭП","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные подписи","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Адрес электронной почты подписанта второй стороны","example":"user@mail.ru"}}}}}},"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/edosigned/archive":{"get":{"tags":["Документы"],"summary":"Скачать архив с подписанным документом из системы ЭДО","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается zip-архив","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/edosigned/send":{"put":{"tags":["Документы"],"summary":"Отправить документ в систему ЭДО","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные подписи","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"counteragentInn":{"type":"string","description":"ИНН контрагента (получателя)","example":1234567890},"counteragentName":{"type":"string","description":"Название контрагента (получателя)","example":"ООО Умные документы"}}}}}},"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/signed/signdata":{"get":{"tags":["Документы"],"summary":"Скачать JSON подписи «Сигнатурой» (рисунок) подписанного документа","description":"Отдаёт файл signature-{id подписи}.json — исходный JSON рисунка подписи (точки, метаданные, геолокация и серверные признаки), тот же, что вложен в итоговый PDF. Только для документа своего воркспейса, подписанного способом «Сигнатура»; иначе 400 (signdraw.notforthisdocument).","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Файл JSON подписи (Content-Disposition attachment)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/renders/{id}/signed/sms/status":{"get":{"tags":["Документы"],"summary":"Статус доставки отправленного СМС для подписания ПЭП","description":"Запрашивает у провайдера (smsc.ru) статус СМС, отправленного методом PUT /renders/{id}/signed/sms. Ничего не отправляет и не списывает. Если СМС ещё не отправлялось — status \"notsent\".","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Статус СМС","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsStatus"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/publicstats":{"get":{"tags":["Статистика сервиса (публичные методы)"],"summary":"Числа сервиса для сайта","description":"Количество всех рабочих пространств (как в списке пространств панели администратора). Считается раз в сутки ночной задачей и отдаётся готовым; первый запрос считает сам, если значения ещё нет.","responses":{"200":{"description":"Числа сервиса","content":{"application/json":{"schema":{"type":"object","properties":{"workspaces":{"type":"integer","description":"Количество рабочих пространств","example":1802},"updatedAt":{"type":"string","format":"date-time","nullable":true,"description":"Когда посчитано","example":"2026-11-09T03:20:00.000Z"}}}}}}}}},"/promocodesadmin":{"get":{"tags":["Промокоды (админка)"],"summary":"Получить список промокодов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список промокодов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Promocode"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Промокоды (админка)"],"summary":"Создать новый промокод","security":[{"BearerAuth":[]}],"requestBody":{"description":"Переменная","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Promocode"}}}},"responses":{"201":{"description":"Возвращается промокод","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Promocode"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/promocodesadmin/{id}":{"get":{"tags":["Промокоды (админка)"],"summary":"Получить промокод по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/PromocodeId"}],"responses":{"200":{"description":"Возвращается промокод","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Promocode"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Промокоды (админка)"],"summary":"Обновить промокод","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/PromocodeId"}],"requestBody":{"description":"промокод","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewPromocode"}}}},"responses":{"200":{"description":"Возвращается промокод","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Promocode"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Промокоды (админка)"],"summary":"Удалить промокод по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/PromocodeId"}],"responses":{"200":{"description":"Возвращается id промокода","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromocodeId"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/promocodes":{"post":{"tags":["Промокоды"],"summary":"Применить промокод","security":[{"BearerAuth":[]}],"requestBody":{"description":"Промокоды","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Id промокода","example":"discount_30"}}}}}},"responses":{"201":{"description":"Возвращается промокод","content":{"application/json":{"schema":{"type":"object","properties":{"promocode":{"description":"Применённый промокод","allOf":[{"$ref":"#/components/schemas/Promocode"}]},"tariffs":{"type":"array","description":"Тарифы рабочего пространства после применения промокода (как в списке тарифов)","items":{"$ref":"#/components/schemas/Tariff"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/promocodes/{id}":{"get":{"tags":["Промокоды"],"summary":"Получить данные промокода","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/PromocodeId"}],"responses":{"200":{"description":"Возвращается промокод","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Promocode"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/promocodes/current":{"get":{"tags":["Промокоды"],"summary":"Получить текущий примененный промокод","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается промокод","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Promocode"},{"type":"object","properties":{"used":{"type":"boolean","description":"Флаг использования","example":false}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/promocodespublic/{id}":{"get":{"tags":["Промокоды (публичные методы)"],"summary":"Получить данные промокода","parameters":[{"$ref":"#/components/parameters/PromocodeId"}],"responses":{"200":{"description":"Возвращается промокод","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Promocode"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/products":{"get":{"tags":["Продукты"],"summary":"Получить список продуктов","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"nameOrVendorCode","description":"Название продукта или его артикул","schema":{"type":"string"}},{"in":"query","name":"category","description":"Массив ID категорий продукта","schema":{"type":"array","items":{"type":"string"}}},{"in":"query","name":"from","description":"Номер записи, от которой осуществлять выборку (0-based)","schema":{"type":"number"}},{"in":"query","name":"to","description":"Номер записи, до которой осуществлять выборку (0-based)","schema":{"type":"number"}}],"responses":{"200":{"description":"Возвращается список продуктов","content":{"application/json":{"schema":{"type":"object","properties":{"products":{"type":"array","description":"Продукты выбранного диапазона","items":{"$ref":"#/components/schemas/Product"}},"count":{"type":"integer","description":"Общее количество продуктов воркспейса","example":12}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Продукты"],"summary":"Создать продукт","security":[{"BearerAuth":[]}],"requestBody":{"description":"Продукт","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewProduct"}}}},"responses":{"200":{"description":"Возвращается продукт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Продукты"],"summary":"Удалить продукты по массиву ID","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"ids","description":"ID продуктов","required":true,"schema":{"type":"array","items":{"type":"string"}}}],"responses":{"200":{"description":"Возвращаются ID удалённых продуктов","content":{"application/json":{"schema":{"type":"array","items":{"type":"string","description":"id объекта","example":"62bb25949213f16bcd934422"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/products/categories":{"get":{"tags":["Продукты"],"summary":"Получить список всех категорий","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список категорий","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Category"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Продукты"],"summary":"Создать категорию продуктов","description":"Создаёт категорию продуктов в текущем воркспейсе. Уникальность названия не проверяется.","security":[{"BearerAuth":[]}],"requestBody":{"description":"Категория","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewCategory"}}}},"responses":{"200":{"description":"Возвращается созданная категория","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/products/categories/{id}":{"get":{"tags":["Продукты"],"summary":"Получить категорию по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается категория","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Продукты"],"summary":"Обновить категорию по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Категория","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewCategory"}}}},"responses":{"200":{"description":"Возвращается категория","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Category"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Продукты"],"summary":"Удалить категорию по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается ID удалённой категории","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/products/batch":{"post":{"tags":["Продукты"],"summary":"Создать продукты из списка","security":[{"BearerAuth":[]}],"requestBody":{"description":"Продукты","required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NewProduct"}}}}},"responses":{"200":{"description":"Возвращается список созданных продуктов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/products/{id}":{"get":{"tags":["Продукты"],"summary":"Получить продукт по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается продукт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Продукты"],"summary":"Обновить данные продукта по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Продукт","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewProduct"}}}},"responses":{"200":{"description":"Возвращается продукт","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Product"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Продукты"],"summary":"Удалить продукт по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается ID удалённого продукта","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/productproperties":{"get":{"tags":["Свойства продуктов"],"summary":"Получить список свойств","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список свойств","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ProductProperty"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Свойства продуктов"],"summary":"Создать свойство продуктов","security":[{"BearerAuth":[]}],"requestBody":{"description":"Свойство","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewProductProperty"}}}},"responses":{"201":{"description":"Возвращается свойство","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductProperty"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/productproperties/{id}":{"get":{"tags":["Свойства продуктов"],"summary":"Получить свойство по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается свойство","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductProperty"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Свойства продуктов"],"summary":"Обновить свойства по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Свойство","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewProductProperty"}}}},"responses":{"200":{"description":"Возвращается категория","content":{"application/json":{"$ref":"#/components/schemas/ProductProperty"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Свойства продуктов"],"summary":"Удалить свойство по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается ID удалённого свойства","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"id документа","example":"62bb25949213f16bcd934422"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/prerenderspublic/{id}":{"get":{"tags":["Пререндеры (публичные методы)"],"summary":"Получить пререндер по id","parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается пререндер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prerender"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/prerenderspublic/{id}/ocr/upload":{"put":{"tags":["Пререндеры (публичные методы)"],"summary":"Загрузить изображение для распознавания (bmp, jpeg, jpg, tif, tiff, gif, png)","parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные для распознавания","required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"Файл","format":"binary"},"sideId":{"type":"string","description":"id стороны для заполнения распознанными данными","example":"sideOne"},"tattrFolderId":{"type":"string","description":"id группы переменных для заполнения распознанными данными","example":100}}}}}},"responses":{"200":{"description":"Возвращается id пререндера","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrerenderId"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/prerenders":{"post":{"tags":["Пререндеры"],"summary":"Создать пререндер","security":[{"BearerAuth":[]}],"requestBody":{"description":"Свойство","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewPrerender"}}}},"responses":{"201":{"description":"Возвращается пререндер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prerender"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/prerenders/{id}":{"get":{"tags":["Пререндеры"],"summary":"Получить пререндер по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается пререндер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prerender"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/prerenders/{id}/sidevalues":{"put":{"tags":["Пререндеры"],"summary":"Обновить значения переменных пререндера","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Свойство","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sideValues":{"$ref":"#/components/schemas/TemplateSideValues"}}}}}},"responses":{"200":{"description":"Возвращается пререндер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prerender"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partnersadmin":{"get":{"tags":["Партнёрская программа (админка)"],"summary":"Получить список рекрутеров","description":"Все рабочие пространства с признаком рекрутера, их ставки, блокировка и сводка. Доступно общему администратору и менеджеру по продажам.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращаются рекрутеры","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"wid":{"type":"string","description":"id рабочего пространства рекрутера","example":"62bb25949213f16bcd934422"},"login":{"type":"string","nullable":true,"description":"Логин владельца (null — владельца нет)","example":"vm@datadoc.ru"},"name":{"type":"string","nullable":true,"description":"Имя владельца (null — не задано)","example":"Иван Петров"},"rateTariff":{"type":"number","nullable":true,"description":"Индивидуальная ставка за тарифы, % (null — общая)","example":null},"rateOther":{"type":"number","nullable":true,"description":"Индивидуальная ставка за прочие услуги, % (null — общая)","example":15},"blocked":{"type":"boolean","description":"true — рекрутер заблокирован","example":false},"summary":{"description":"Сводка рекрутера (null — не удалось рассчитать)","nullable":true,"allOf":[{"$ref":"#/components/schemas/PartnerSummary"}]}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnersAdminForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partnersadmin/withdrawals":{"get":{"tags":["Партнёрская программа (админка)"],"summary":"Получить заявки на вывод всех рекрутеров","description":"До 500 последних заявок по убыванию даты. Доступно общему администратору и менеджеру по продажам.","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"status","description":"Фильтр по статусу. new — новая; processing — в работе; paid — выплачена; rejected — отклонена; не задан — все","schema":{"type":"string","enum":["new","processing","paid","rejected"],"example":"new"}}],"responses":{"200":{"description":"Возвращаются заявки","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PartnerWithdrawal"}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnersAdminForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partnersadmin/withdrawals/{id}":{"put":{"tags":["Партнёрская программа (админка)"],"summary":"Изменить статус заявки на вывод","description":"Сохраняются статус, комментарий (если передан), время и администратор. Доступно общему администратору и менеджеру по продажам.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["status"],"properties":{"status":{"type":"string","description":"Новый статус. new — новая; processing — в работе; paid — выплачена; rejected — отклонена (сумма возвращается в доступное)","enum":["new","processing","paid","rejected"],"example":"paid"},"comment":{"type":"string","maxLength":500,"description":"Комментарий администратора, до 500 символов (не передан — прежний сохраняется)","example":"Выплачено платёжным поручением № 123"}}}}}},"responses":{"200":{"description":"Возвращается изменённая заявка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerWithdrawal"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnersAdminForbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partnersadmin/{id}":{"get":{"tags":["Партнёрская программа (админка)"],"summary":"Получить страницу рекрутера (как её видит рекрутер)","description":"Сводка, оплаты рефералов и заявки на вывод рекрутера. Не рекрутер — 404. Доступно общему администратору и менеджеру по продажам.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/partnerWid"}],"responses":{"200":{"description":"Возвращаются данные страницы рекрутера","content":{"application/json":{"schema":{"type":"object","properties":{"summary":{"$ref":"#/components/schemas/PartnerSummary"},"transactions":{"type":"array","description":"Оплаты рефералов по убыванию даты","items":{"$ref":"#/components/schemas/PartnerTransaction"}},"withdrawals":{"type":"array","description":"Заявки на вывод по убыванию даты","items":{"$ref":"#/components/schemas/PartnerWithdrawal"}}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnersAdminForbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Партнёрская программа (админка)"],"summary":"Изменить ставки и блокировку рекрутера","description":"Сохраняются переданные поля (индивидуальные ставки, блокировка); новые ставки сразу применяются к ещё не выплаченному вознаграждению. Не рекрутер — 404. Доступно общему администратору и менеджеру по продажам.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/partnerWid"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rateTariff":{"type":"number","nullable":true,"minimum":0,"maximum":100,"description":"Индивидуальная ставка за тарифы, % от 0 до 100 (null — общая ставка)","example":25},"rateOther":{"type":"number","nullable":true,"minimum":0,"maximum":100,"description":"Индивидуальная ставка за прочие услуги, % от 0 до 100 (null — общая ставка)","example":null},"blocked":{"type":"boolean","description":"true — заблокировать рекрутера, false — разблокировать","example":false}}}}}},"responses":{"200":{"description":"Возвращается пересчитанная сводка рекрутера","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerSummary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnersAdminForbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partnersadmin/{id}/referrals":{"get":{"tags":["Партнёрская программа (админка)"],"summary":"Получить рефералов рекрутера","description":"Рабочие пространства, применившие промокод рекрутера, постранично. Не рекрутер — 403. Доступно общему администратору и менеджеру по продажам.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/partnerWid"},{"in":"query","name":"limit","description":"Размер страницы (по умолчанию 50, максимум 200)","schema":{"type":"integer","default":50,"maximum":200,"example":50}},{"in":"query","name":"offset","description":"Сколько рефералов пропустить (по умолчанию 0)","schema":{"type":"integer","default":0,"example":0}}],"responses":{"200":{"description":"Возвращается страница рефералов","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"Общее число рефералов","example":14},"limit":{"type":"integer","description":"Применённый размер страницы","example":50},"offset":{"type":"integer","description":"Применённое смещение","example":0},"items":{"type":"array","description":"Рефералы страницы","items":{"$ref":"#/components/schemas/PartnerReferral"}}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnersAdminForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partnersadmin/{id}/referrals/{refwid}":{"get":{"tags":["Партнёрская программа (админка)"],"summary":"Получить карточку реферала рекрутера","description":"Данные реферала со счетами, оплатами и счётчиками использования. Не рекрутер — 403; рабочее пространство не применяло промокод рекрутера — 404. Доступно общему администратору и менеджеру по продажам.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/partnerWid"},{"in":"path","name":"refwid","required":true,"description":"id рабочего пространства реферала (24 шестнадцатеричных символа)","schema":{"type":"string","example":"62bb25949213f16bcd934424"}}],"responses":{"200":{"description":"Возвращается карточка реферала","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerReferralDetails"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnersAdminForbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partner/summary":{"get":{"tags":["Партнёрская программа"],"summary":"Получить сводку рекрутера","description":"Только для рабочего пространства с признаком рекрутера (иначе 403), заблокированному рекрутеру — 403. Оплата тарифа не требуется.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается сводка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerSummary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnerForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partner/transactions":{"get":{"tags":["Партнёрская программа"],"summary":"Получить оплаты рефералов и вознаграждение по ним","description":"Все оплаты рефералов по убыванию даты. Только для незаблокированного рекрутера (иначе 403). Оплата тарифа не требуется.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращаются оплаты","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PartnerTransaction"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnerForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/partner/withdrawals":{"get":{"tags":["Партнёрская программа"],"summary":"Получить заявки на вывод вознаграждения","description":"Заявки рабочего пространства по убыванию даты. Только для незаблокированного рекрутера (иначе 403). Оплата тарифа не требуется.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращаются заявки","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PartnerWithdrawal"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnerForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Партнёрская программа"],"summary":"Создать заявку на вывод вознаграждения","description":"Сумма — не меньше minWithdraw и не больше доступной (иначе 400). Получатель проверяется по ИНН в DaData: должен быть найден, действовать и быть ООО или ИП (иначе 400). Только для незаблокированного рекрутера (иначе 403). Оплата тарифа не требуется.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","inn"],"properties":{"amount":{"type":"number","exclusiveMinimum":true,"minimum":0,"maximum":100000000,"description":"Сумма к выплате, руб. (больше 0, до 100000000; округляется до копеек)","example":1500},"inn":{"type":"string","pattern":"^(\\d{10}|\\d{12})$","description":"ИНН получателя — ООО (10 цифр) или ИП (12 цифр)","example":"7707083893"}}}}}},"responses":{"201":{"description":"Возвращается созданная заявка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PartnerWithdrawal"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/PartnerForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/packs":{"get":{"tags":["Пакеты шаблонов"],"summary":"Получить список пакетов шаблонов","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Имя пакета (поиск по регулярному выражению)","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается список пакетов по заданным условиям","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Pack"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Пакеты шаблонов"],"summary":"Создать новый пакет шаблонов","security":[{"BearerAuth":[]}],"requestBody":{"description":"Пакет шаблонов","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewPack"}}}},"responses":{"201":{"description":"Возвращается пакет","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pack"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/packs/{id}":{"get":{"tags":["Пакеты шаблонов"],"summary":"Получить пакет шаблонов по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается пакет шаблонов","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PackWithPath"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Пакеты шаблонов"],"summary":"Обновить пакет шаблонов","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Пакет шаблонов","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewPack"}}}},"responses":{"200":{"description":"Возвращается пакет шаблонов","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Pack"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Пакеты шаблонов"],"summary":"Удалить пакет шаблонов по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленного пакета шаблонов","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/packs/{id}/sides":{"get":{"tags":["Пакеты шаблонов"],"summary":"Получить стороны пакета шаблона (для последующего рендеринга)","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращаются стороны пакета шаблона","content":{"application/json":{"schema":{"type":"object","properties":{"sides":{"description":"Стороны пакета шаблонов с переменными и комбо-полями","type":"array","items":{"$ref":"#/components/schemas/TemplateSideWithComboattrs"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/packs/{id}/render":{"post":{"tags":["Пакеты шаблонов"],"summary":"Создание документа по пакету шаблона","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Значения сторон и переменных пакета шаблона","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string","enum":["pdf","zip"],"default":"pdf","description":"Формат результата: pdf — PDF документов пакета, zip — архив документов; по умолчанию pdf","example":"pdf"},"sideValues":{"$ref":"#/components/schemas/TemplateSideValues"}}}}}},"responses":{"201":{"description":"Возвращается pdf файл","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/messengerbotsadmin/events":{"get":{"tags":["Боты подписания (админка)"],"summary":"Журнал событий бота подписания (ПЭП через MAX)","description":"Для разбора работы бота администратором сервиса. Новые первыми. Тексты сообщений и коды не хранятся; номер телефона и id пользователя мессенджера показываются только последними 4 символами.","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"infillId","description":"id внешнего заполнения — только события по нему; не передан — все события","schema":{"type":"string","example":"62bb25949213f16bcd934429"}},{"in":"query","name":"limit","description":"Сколько событий вернуть","schema":{"type":"integer","minimum":1,"maximum":100,"default":20,"example":20}}],"responses":{"200":{"description":"События бота","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["max"],"description":"Мессенджер","example":"max"},"kind":{"type":"string","enum":["start","contact","message","signed","push"],"description":"Вид события — start запуск бота, contact пользователь поделился контактом, message сообщение, signed уведомление «Документ подписан», push отправка ботом","example":"start"},"result":{"type":"string","description":"Итог обработки — received, forwarded, forward_failed, ratelimited, contact_requested, foreign_contact, no_documents, code_issued, send_failed, error; для kind = signed — signed_notified, signed_link_only (файл не ушёл), send_failed","example":"code_issued"},"error":{"type":"string","description":"Причина сбоя (стадия и код ответа платформы, без текстов и персональных данных); только при сбое","example":"sendMessage: 403"},"createdAt":{"type":"string","format":"date-time","description":"Время события","example":"2026-11-06T10:15:00.000Z"},"infillId":{"type":"string","description":"id внешнего заполнения, если событие связано с ним","example":"62bb25949213f16bcd934429"},"phoneTail":{"type":"string","description":"Последние 4 цифры подтверждённого телефона (если пользователь делился контактом)","example":"0107"},"userIdTail":{"type":"string","description":"Последние 4 символа id пользователя мессенджера","example":"4821"}}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/messengerbots/max/webhook":{"post":{"tags":["Боты подписания (публичные методы)"],"summary":"Вебхук бота подписания в MAX (ПЭП через мессенджер)","description":"Вызывает платформа мессенджера MAX при событиях бота (запуск бота, сообщение, отправка контакта). Без авторизации пользователя: подлинность проверяется по секрету вебхука в заголовке X-Max-Bot-Api-Secret (сравнивается с переменной окружения MAX_SIGN_WEBHOOK_SECRET или настройкой сервиса messengers.max.webhookSecret); нет или не совпал — 403. Повтор события с тем же id отбрасывается; ошибки обработки не возвращаются платформе (ответ всё равно {ok: true}), а пишутся в журнал событий (GET /messengerbotsadmin/events).\n","parameters":[{"in":"header","name":"X-Max-Bot-Api-Secret","required":true,"description":"Секрет вебхука, заданный при регистрации вебхука в MAX","schema":{"type":"string","example":"webhook-secret"}}],"requestBody":{"required":true,"description":"Событие (Update) платформы MAX как есть; обрабатываются update_type = bot_started и message_created (в т.ч. с вложением-контактом) из личного диалога, сообщения от ботов пропускаются","content":{"application/json":{"schema":{"type":"object","properties":{"update_type":{"type":"string","description":"Тип события MAX (bot_started, message_created и др.)","example":"bot_started"},"timestamp":{"type":"integer","description":"Время события MAX (мс)","example":1762423200000},"chat_id":{"type":"integer","description":"id чата (для bot_started)","example":123456789},"user":{"type":"object","description":"Пользователь, запустивший бота (для bot_started)","example":{"user_id":987654321,"is_bot":false}},"payload":{"type":"string","description":"Параметр запуска бота из ссылки (для bot_started) — по нему находится документ на подпись","example":"abc123"},"message":{"type":"object","description":"Сообщение (для message_created) — sender, recipient.chat_id, body.mid, body.text, body.attachments","example":{"sender":{"user_id":987654321},"recipient":{"chat_id":123456789},"body":{"mid":"mid.0000","text":"Привет"}}}}}}}},"responses":{"200":{"description":"Событие принято","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean","description":"Всегда true","example":true}}}}}},"403":{"description":"Нет секрета вебхука или он неверный"}}}},"/mchds":{"post":{"tags":["Машиночитаемая доверенность (МЧД)"],"summary":"Создать запись об МЧД","security":[{"BearerAuth":[]}],"requestBody":{"description":"XML-файл МЧД","required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"Файл","format":"binary"}}}}}},"responses":{"201":{"description":"Возвращается информация об МЧД","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mchd"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"get":{"tags":["Машиночитаемая доверенность (МЧД)"],"summary":"Получить список всех МЧД текущего пользователя","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список МЧД","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Mchd"}}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mchds/{guid}":{"delete":{"tags":["Машиночитаемая доверенность (МЧД)"],"summary":"Удалить запись об МЧД","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/guid"}],"responses":{"200":{"description":"Возвращается GUID МЧД","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MchdGuid"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mchds/{guid}/description":{"put":{"tags":["Машиночитаемая доверенность (МЧД)"],"summary":"Обновить описание МЧД","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/guid"}],"requestBody":{"description":"Описание МЧД","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string","description":"Описание доверенности","example":"Иванов Иван Иванович | ИНН 1234567890 по доверенности d4158e30-f9da-496e-9fe4-bc10edd44ff2 | выдана 01.08.2025 | действует до 31.12.2025 | ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ \"УМНЫЕ ДОКУМЕНТЫ\" | ИНН 1234567890"}}}}}},"responses":{"200":{"description":"Возвращается информация об МЧД","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mchd"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/managerspublic/{id}":{"get":{"tags":["Менеджеры (публичные методы)"],"summary":"Получить менеджера по id","parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается менеджер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Manager"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/managersadmin":{"get":{"tags":["Менеджеры (админка)"],"summary":"Получить список менеджеров","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список менеджеров","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Manager"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Менеджеры (админка)"],"summary":"Создать менеджера","security":[{"BearerAuth":[]}],"requestBody":{"description":"Менеджер","required":true,"content":{"multipart/form-data":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewManager"},{"type":"object","properties":{"file":{"type":"string","description":"Файл","format":"binary"}}}]}}}},"responses":{"200":{"description":"Возвращается менеджер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Manager"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Нет прав — метод доступен только администратору сервиса (COMMON_ADMIN)"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/managersadmin/{id}":{"get":{"tags":["Менеджеры (админка)"],"summary":"Получить менеджера по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается менеджер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Manager"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Менеджеры (админка)"],"summary":"Обновить менеджера","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Менеджер","required":true,"content":{"multipart/form-data":{"schema":{"allOf":[{"$ref":"#/components/schemas/NewManager"},{"type":"object","properties":{"file":{"type":"string","description":"Файл","format":"binary"}}}]}}}},"responses":{"200":{"description":"Возвращается менеджер","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Manager"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Нет прав — метод доступен только администратору сервиса (COMMON_ADMIN)"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Менеджеры (админка)"],"summary":"Удалить менеджера","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленного менеджера","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Нет прав — метод доступен только администратору сервиса (COMMON_ADMIN)"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/managersadmin/{id}/timeslots/{timeslotId}":{"put":{"tags":["Менеджеры (админка)"],"summary":"Разблокировать таймслот для менеджера","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"},{"$ref":"#/components/parameters/timeslotId"}],"responses":{"200":{"description":"Возвращается id менеджера","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Менеджеры (админка)"],"summary":"Заблокировать таймслот для менеджера","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"},{"$ref":"#/components/parameters/timeslotId"}],"responses":{"200":{"description":"Возвращается id менеджера","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/managers":{"get":{"tags":["Менеджеры"],"summary":"Получить список менеджеров","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список менеджеров","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Manager"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mailingsadmin":{"get":{"tags":["Рассылки (админка)"],"summary":"Получить список рассылок","description":"Рассылки по убыванию даты создания, постранично. Доступно только общему администратору.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/mailingFrom"},{"in":"query","name":"to","description":"Конец страницы (не включительно) — вернётся to − from записей (целое ≥ 0, по умолчанию 50)","schema":{"type":"integer","minimum":0,"default":50,"example":50}}],"responses":{"200":{"description":"Возвращаются рассылки страницы и общее число","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Рассылки страницы","items":{"$ref":"#/components/schemas/Mailing"}},"count":{"type":"integer","description":"Общее число рассылок","example":12}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/MailingsForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Рассылки (админка)"],"summary":"Создать черновик рассылки","description":"Создаётся рассылка в статусе draft; автор — текущий администратор. Доступно только общему администратору.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailingSaveBody"}}}},"responses":{"201":{"description":"Возвращается созданная рассылка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Mailing"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/MailingsForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mailingsadmin/config":{"get":{"tags":["Рассылки (админка)"],"summary":"Получить настройки отправки рассылок","description":"Тестовый режим, скорость отправки и наличие ключей RuSender по доменам (из настроек сервиса). Доступно только общему администратору.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращаются настройки отправки","content":{"application/json":{"schema":{"type":"object","properties":{"testMode":{"type":"boolean","description":"true — задана настройка mailing.onlyRecipients, письма уходят только на адреса из неё","example":true},"onlyRecipients":{"type":"string","description":"Шаблоны разрешённых адресов через запятую (* — любой текст); пустая строка — ограничения нет","example":"vm@datadoc.ru,vm+*@datadoc.ru"},"ratePerMinute":{"type":"number","description":"Скорость отправки, писем в минуту (настройка mailing.ratePerMinute)","example":60},"domains":{"type":"array","description":"Домены отправителя и их ключи RuSender","items":{"type":"object","properties":{"domain":{"$ref":"#/components/schemas/MailingDomain"},"key":{"type":"string","description":"Пара ключей RuSender домена. reserve — резервная, primary — основная","enum":["reserve","primary"],"example":"reserve"},"configured":{"type":"boolean","description":"true — у пары заданы и токен, и id (можно запускать рассылку с этим доменом)","example":true}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/MailingsForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mailingsadmin/recipients/count":{"post":{"tags":["Рассылки (админка)"],"summary":"Посчитать получателей рассылки","description":"Сколько адресов получит рассылка с такими условиями: подтверждённые e-mail владельцев (или всех пользователей) рабочих пространств нужных типов, по одному письму на адрес, без тестовых логинов; в тестовом режиме — только адреса из mailing.onlyRecipients. Доступно только общему администратору.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/MailingRecipientsBody"},{"type":"object","required":["recipientTypes"]}]}}}},"responses":{"201":{"description":"Возвращается число получателей","content":{"application/json":{"schema":{"type":"object","properties":{"count":{"type":"integer","description":"Число уникальных адресов","example":120},"testMode":{"type":"boolean","description":"true — действует тестовый режим (число посчитано только по разрешённым адресам)","example":false}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/MailingsForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mailingsadmin/preview":{"post":{"tags":["Рассылки (админка)"],"summary":"Предпросмотр письма рассылки","description":"Полный HTML письма — тело очищается от недопустимых тегов, получает стили писем DataDoc и вставляется в шапку и подвал; переменная имени заменяется именем текущего администратора. Ничего не сохраняется. Доступно только общему администратору.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["html"],"properties":{"html":{"type":"string","maxLength":500000,"description":"Тело письма из редактора (до 500000 символов)","example":"Здравствуйте, Имя!
"}}}}}},"responses":{"201":{"description":"Возвращается полный HTML письма","content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string","description":"Готовый HTML письма с шапкой и подвалом","example":"Здравствуйте, Иван!
"}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/MailingsForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mailingsadmin/test":{"post":{"tags":["Рассылки (админка)"],"summary":"Отправить тестовое письмо","description":"Отправляет письмо на указанный адрес через пару ключей RuSender выбранного домена; имя для переменной — у пользователя с таким логином, иначе текст по умолчанию. Тема, имя отправителя и непустое тело обязательны. Ошибка RuSender возвращается как 400. Доступно только общему администратору.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/MailingEmailBody"},{"type":"object","required":["email","subject","domain","fromLocal","fromName","html"],"properties":{"email":{"type":"string","format":"email","description":"Адрес, на который отправить тестовое письмо","example":"vm@datadoc.ru"}}}]}}}},"responses":{"201":{"description":"Письмо отправлено; возвращается адрес","content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Адрес, на который ушло письмо","example":"vm@datadoc.ru"}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/MailingsForbidden"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/mailingsadmin/images":{"post":{"tags":["Рассылки (админка)"],"summary":"Загрузить изображение для тела письма","description":"jpg, png или gif (по сигнатуре файла) до 500 КБ. Имя файла — md5 содержимого; файл публично доступен на сайте как /i/…
"},"updatedAt":{"type":"string","format":"date-time","description":"Дата и время последнего изменения документа","example":"2026-10-30T10:00:00.000Z"}}}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/legaldocumentsadmin":{"get":{"tags":["Юридические документы (админка)"],"summary":"Список юридических документов (без тел)","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Список документов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/LegalDocument"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}},"post":{"tags":["Юридические документы (админка)"],"summary":"Создать документ","description":"HTML тела очищается на сервере (без скриптов, фреймов, обработчиков событий и javascript-ссылок). Адрес занят, недопустим или совпадает со страницей сайта — 400","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewLegalDocument"}}}},"responses":{"201":{"description":"Созданный документ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalDocument"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/legaldocumentsadmin/slug":{"get":{"tags":["Юридические документы (админка)"],"summary":"Свободный адрес из названия (транслит кириллицы)","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","required":true,"description":"Название документа, из которого строится адрес (транслит)","schema":{"type":"string"},"example":"Тестовый юридический документ"},{"in":"query","name":"id","description":"Редактируемый документ (его собственный адрес не считается занятым)","schema":{"type":"string"}}],"responses":{"200":{"description":"Адрес","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","description":"Свободный адрес страницы (не занят другим документом и не совпадает со страницей сайта; при совпадении добавляется -2, -3…)","example":"testovii-yuridicheskii-dokument"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/legaldocumentsadmin/{id}":{"parameters":[{"in":"path","name":"id","required":true,"description":"id юридического документа","schema":{"type":"string"}}],"get":{"tags":["Юридические документы (админка)"],"summary":"Документ с телами","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Документ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalDocument"}}}},"404":{"$ref":"#/components/responses/NotFound"}}},"put":{"tags":["Юридические документы (админка)"],"summary":"Изменить документ (переданные поля)","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewLegalDocument"}}}},"responses":{"200":{"description":"Документ после изменения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LegalDocument"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Юридические документы (админка)"],"summary":"Удалить документ","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Документ удалён","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/langbase/suggestfio/firstname":{"get":{"tags":["Языковые функции"],"summary":"Подсказки по имени","parameters":[{"in":"query","name":"query","description":"Запрос","schema":{"type":"string","example":"иван"}}],"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"string","example":"Иван"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/langbase/suggestfio/middlename":{"get":{"tags":["Языковые функции"],"summary":"Подсказки по отчеству","parameters":[{"in":"query","name":"query","description":"Запрос","schema":{"type":"string","example":"иван"}}],"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"string","example":"Иванович"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/langbase/suggestfio/familyname":{"get":{"tags":["Языковые функции"],"summary":"Подсказки по фамилии","parameters":[{"in":"query","name":"query","description":"Запрос","schema":{"type":"string","example":"иван"}}],"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"string","example":"Иванов"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/langbase/suggestfmsunit":{"get":{"tags":["Языковые функции"],"summary":"Подсказки по \"Паспорт выдан\"","parameters":[{"in":"query","name":"query","description":"Поиск по коду или значению","schema":{"type":"string","example":"310-001"}},{"in":"query","name":"id","description":"Поиск по коду","schema":{"type":"string","example":"310-001"}},{"in":"query","name":"value","description":"Поиск по значению","schema":{"type":"string","example":"ленинград"}}],"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","properties":{"id":{"type":"string","description":"Код подразделения","example":"310-001"},"value":{"type":"string","description":"Название подразделения («Паспорт выдан»)","example":"ОТДЕЛЕНИЕМ № 4 ОУФМС РОССИИ ПО БЕЛГОРОДСКОЙ ОБЛ. В Г. БЕЛГОРОД"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/landing/contact":{"post":{"tags":["Лендинг"],"summary":"Отправка в amoCRM данных формы обратной связи","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Название формы","example":"Обратный звонок"},"clientEmail":{"type":"string","description":"Email клиента","example":"some@mail.ru"},"clientPhone":{"type":"string","description":"Телефон клиента","example":79999999999},"companyName":{"type":"string","description":"Название компании","example":"ООО Рога и Копыта"},"companySize":{"type":"string","description":"Размер компании","example":100},"clientFullName":{"type":"string","description":"ФИО клиента","example":"Александр Александрович Александров"},"areaOfActivityId":{"type":"string","description":"id сферы деятельности","example":"64d12317bfd535ac3ad7ab92"},"employeeRole":{"type":"string","description":"Должность работника","example":"Директор"},"registerQuery":{"$ref":"#/components/schemas/RegisterQuery"}}}}}},"responses":{"200":{"description":"Уведомление об успешном создании формы","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Успешная отправка формы","example":true}}}}}},"500":{"$ref":"#/components/responses/InternalError"}}}},"/landing/resume":{"post":{"tags":["Лендинг"],"summary":"Отправка резюме на почту из формы обратной связи","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"ФИО соискателя","example":"Раст Питон Ноджеэсович"},"phone":{"type":"string","description":"Телефон клиента из формы обратной связи","example":79882850385},"comment":{"type":"string","description":"Поле \"О себе\"","example":"Хочу очень работать"},"resume":{"type":"string","description":"Ссылка на резюме","example":"ссылка.на/резюме"}}}}}},"responses":{"200":{"description":"Уведомление об успешной отправке резюме","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Успешная отправка отправка резюме","example":true}}}}}}}}},"/folders":{"get":{"tags":["Папки"],"summary":"Получить список корневых папок","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список корневых папок","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RootFolder"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Папки"],"summary":"Создать новую папку","security":[{"BearerAuth":[]}],"requestBody":{"description":"Папка","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewChildFolder"}}}},"responses":{"201":{"description":"Возвращается папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChildFolder"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/all":{"get":{"tags":["Папки"],"summary":"Получить дерево папок","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается дерево всех папок","content":{"application/json":{"schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/RootFolder"},{"type":"object","properties":{"children":{"type":"array","description":"Дочерние папки (рекурсивно; поля нет, если дочерних папок нет)","items":{"$ref":"#/components/schemas/ChildFolder"}}}}]}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/allcontent":{"get":{"tags":["Папки"],"summary":"Получить дерево папок и шаблонов","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"favorite","description":"Флаг по избранному","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Возвращается дерево всех папок и шаблонов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RootFolderOrTemplateTree"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/{id}":{"get":{"tags":["Папки"],"summary":"Получить список дочерних папок по id родительской","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается список папок","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ChildFolder"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Папки"],"summary":"Обновить папку","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Папка","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewChildFolder"}}}},"responses":{"200":{"description":"Возвращается папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChildFolder"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Папки"],"summary":"Удалить папку по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленной папки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/content":{"get":{"tags":["Папки"],"summary":"Получить список корневых папок и шаблонов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список корневых папок и шаблонов","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/FolderType"},{"type":"object","properties":{"items":{"type":"array","description":"Папки и шаблоны корневого уровня","items":{"$ref":"#/components/schemas/ChildFolderOrTemplate"}},"path":{"type":"array","description":"Путь от корня до папки (для корня всегда пустой)","items":{},"maxItems":0}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/content/{id}":{"get":{"tags":["Папки"],"summary":"Получить список папок и шаблонов в папке","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается список папок и шаблонов в папке","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RootFolder"},{"$ref":"#/components/schemas/FolderType"},{"type":"object","properties":{"items":{"type":"array","description":"Папки и шаблоны внутри папки (видимые пользователю)","items":{"$ref":"#/components/schemas/ChildFolderOrTemplate"}},"path":{"type":"array","description":"Путь от корня до родительской папки (родительские папки по порядку)","items":{"$ref":"#/components/schemas/RootPath"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/contentByName/{name}":{"get":{"tags":["Папки"],"summary":"Получить список папок и шаблонов в папке по translatedName","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"name","required":true,"description":"translatedName объекта","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается список папок и шаблонов в папке","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RootFolder"},{"$ref":"#/components/schemas/FolderType"},{"type":"object","properties":{"items":{"type":"array","description":"Папки и шаблоны внутри папки (видимые пользователю)","items":{"$ref":"#/components/schemas/ChildFolderOrTemplate"}},"path":{"type":"array","description":"Путь от корня до родительской папки (родительские папки по порядку)","items":{"$ref":"#/components/schemas/RootPath"}}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/search":{"get":{"tags":["Папки"],"summary":"Поиск шаблонов и папок","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Имя шаблона или папки (поиск по регулярному выражению)","schema":{"type":"string"}},{"in":"query","name":"folderid","description":"id папки","schema":{"type":"string"}},{"in":"query","name":"limit","description":"Лимит количества возвращаемых элементов","schema":{"type":"integer"}},{"in":"query","name":"external","description":"Включить в поиск общие папки и шаблоны","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Возвращается список шаблонов и папок в папке и ее подпапках по заданным условиям","content":{"application/json":{"schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/ChildFolderOrTemplate"},{"type":"object","properties":{"external":{"type":"string","description":"Флаг общего шаблона или папки","example":true}}}]}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/favorites":{"get":{"tags":["Папки"],"summary":"Получить список избранных папок и шаблонов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список избранных папок и шаблонов","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ChildFolderOrTemplate"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/favorites/{id}":{"put":{"tags":["Папки"],"summary":"Добавить папку в избранное","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChildFolder"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Папки"],"summary":"Удалить папку из избранного","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChildFolder"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/folders/{id}/copy":{"post":{"tags":["Папки"],"summary":"Скопировать папку","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Папка назначения","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"folderid":{"type":"string","description":"id папки","example":"62bb25949213f16bcd934422"}}}}}},"responses":{"201":{"description":"Возвращается папка","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChildFolder"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/facsimiles":{"get":{"tags":["Факсимиле"],"summary":"Получить список факсимиле","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список всех факсимиле","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Facsimile"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Факсимиле"],"summary":"Загрузить факсимиле","security":[{"BearerAuth":[]}],"requestBody":{"description":"Данные для загрузки","required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"Файл","format":"binary"}}}}}},"responses":{"200":{"description":"Возвращается созданный факсимиле","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Facsimile"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/facsimiles/{id}":{"get":{"tags":["Факсимиле"],"summary":"Получить факсимиле по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается факсимиле","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Facsimile"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Факсимиле"],"summary":"Удалить факсимиле по ID","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается ID удалённого факсимиле","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID удалённого факсимиле","example":"64da1c4e77f778b212b041c4"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}":{"get":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Получить шаблон для внешнего заполнения по ключу","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается элемент внешнего заполнения","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ExternalInfillReuseConfig"},{"type":"object","properties":{"name":{"type":"string","description":"Название документа (с подставленными значениями и номером для многоразовой ссылки)","example":"Документ"},"sides":{"type":"array","description":"Стороны версии шаблона документа (переменные для заполнения)","items":{"$ref":"#/components/schemas/TemplateSideWithComboattrs"}},"blocksTree":{"$ref":"#/components/schemas/TemplateBlocksTree"},"attachments":{"$ref":"#/components/schemas/ExternalInfillAttachments"},"isReady":{"type":"boolean","description":"Статус документа","example":true},"sideValues":{"$ref":"#/components/schemas/ExternalInfillSideValues"},"entity":{"$ref":"#/components/schemas/ExternalInfillEntity"},"signature":{"$ref":"#/components/schemas/ExternalInfillSignatureShort"}}}]}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Внести данные в элемент внешнего заполнения по ключу","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"description":"Данные для создания","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"sideValues":{"$ref":"#/components/schemas/ExternalInfillSideValues"},"signature":{"type":"object","description":"Данные подписанта (если документ отправляется на подпись)","properties":{"signer":{"$ref":"#/components/schemas/ExternalInfillSigner"}}}}}}}},"responses":{"200":{"description":"Возвращается статус элемента внешнего заполнения","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/IdObject"},{"$ref":"#/components/schemas/Key"},{"type":"object","properties":{"isReady":{"type":"boolean","description":"Статус документа","example":true},"isChild":{"type":"boolean","description":"Флаг дочернего элемента внешнего заполнения","example":true},"attachments":{"$ref":"#/components/schemas/ExternalInfillAttachments"}}}]}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/attachments/{attachmentId}":{"get":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Скачать вложение по ключу и id","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}},{"in":"path","name":"attachmentId","required":true,"description":"id вложения","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается файл","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/attachments":{"get":{"tags":["Внешнее заполнение (публичные методы)"],"parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"summary":"Скачать все вложения по ключу как zip-архив","responses":{"200":{"description":"Возвращается файл","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Загрузить вложения","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"description":"Данные для загрузки","content":{"multipart/form-data":{"schema":{"type":"object","additionalProperties":{"type":"string","format":"binary","description":"Файл"},"example":{"b2bb25949213f16bcd934422":"(binary)","b2bb25949213f16bcd934423":"(binary)"}}}}},"responses":{"201":{"description":"Возвращается ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Key"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/sms":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Отправить SMS для подписания","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Key"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/signerphone":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Подписант меняет свой номер телефона (подпись через MAX)","description":"Работает, только если в воркспейсе включена настройка signChangePhone, подпись запрошена (статус SIGN_REQUESTED) и способ подписи — мессенджер MAX; для СМС номер менять нельзя (400 signsettings.changephonesms). Выданный на старый номер код и подтверждения старого номера сбрасываются, новый код приходит на новый номер. Метод защищён ключом безопасности: в теле нужно поле sch (без него или с просроченным ключом — 403); при вызове по API-ключу sch не нужен.","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["phone"],"properties":{"phone":{"type":"string","description":"Новый номер телефона подписанта (символы + - ( ) и пробелы отбрасываются, остаётся 6–13 цифр)","example":"+79991050107"},"sch":{"type":"string","description":"Ключ безопасности (защита от автоматических запросов): HTML-строка, которую формирует страница подписанта; сервер берёт текст пятого тега pre и проверяет, что ключ действителен (выдан не более 3 минут назад)","example":"a
b
c
d
ключ безопасности"}}}}}},"responses":{"200":{"description":"Номер изменён, возвращается ключ документа","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Key"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"403":{"description":"Нет или неверный ключ безопасности sch"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/qrcode":{"get":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Получить QR-код ссылки на страницу документа","description":"QR-код ведёт на страницу подписания и проверки документа на лендинге (вида https://datadoc.ru/ru/sign/{key}/). Ответ — строка data URL с PNG-картинкой.","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"responses":{"200":{"description":"QR-код (PNG в формате data URL)","content":{"application/json":{"schema":{"type":"string","description":"Картинка QR-кода в формате data URL (data:image/png;base64,...)","example":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/previewname":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Получить название документа по введённым значениям (предпросмотр)","description":"Подставляет переданные значения переменных в название документа (шаблон названия с переменными и номер документа). Для многоразовой ссылки (reusable) название строится с нумерацией будущего дочернего документа. Ничего не сохраняет.","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["sideValues"],"properties":{"sideValues":{"$ref":"#/components/schemas/ExternalInfillSideValues"}}}}}},"responses":{"200":{"description":"Название документа","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Название документа с подставленными значениями","example":"Договор № 15 с Ивановым И.И."}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/signaccept":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Подписание документа","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"description":"Данные","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","description":"Код подтверждения","example":123456}}}}}},"responses":{"200":{"description":"Возвращается ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Key"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/signreject":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Отказ в подписании документа","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Key"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/signcomment":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Подписание документа","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"description":"Данные","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"comment":{"type":"string","description":"Комментарии","example":"Не подписываю"}}}}}},"responses":{"200":{"description":"Возвращается ключ","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Key"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/pdf":{"get":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Скачивание pdf заполненного документа","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается файл","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/preview":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Предпросмотр заполнения","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"description":"Данные для предпросмотра","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"format":{"type":"string","description":"Формат документа для предпросмотра","enum":["html","pdf"],"example":"html"},"sideValues":{"$ref":"#/components/schemas/ExternalInfillSideValues"}}}}}},"responses":{"200":{"description":"Возвращается html или pdf в зависимости от указанного формата","content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string","description":"HTML документа с подставленными значениями (если документ изменён отправителем в предпросмотре — сохранённый изменённый HTML)","example":"
test
"}}}},"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/sign":{"get":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Получить данные подписи","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращаются данные подписи","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/IdObject"},{"type":"object","properties":{"name":{"type":"string","description":"Название документа","example":"Документ"},"isChild":{"type":"boolean","description":"Флаг дочернего элемента внешнего заполнения","example":true},"signature":{"description":"Подпись документа (ПЭП)","allOf":[{"$ref":"#/components/schemas/ExternalInfillSignatureShort"},{"type":"object","properties":{"signVerificationCode":{"type":"string","description":"Код из СМС","example":123456}}}]}}}]}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/signdraw":{"put":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Подписание документа сигнатурой (рисунок)","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"description":"Рисунок подписи (ПЭП «Сигнатура»)","required":true,"content":{"application/json":{"schema":{"type":"object","required":["data","image"],"properties":{"data":{"type":"object","description":"JSON рисовалки (точки signaturePoints, метаданные, геолокация; версия схемы 1)"},"image":{"type":"string","description":"PNG рисунка (data URL или base64)","example":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg=="}}}}}},"responses":{"200":{"description":"Подпись принята","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","description":"Ключ документа","example":"902fd2c03ba52ca302dccb3e5546543e"},"signatureId":{"type":"string","description":"ID записи подписи (имя файла JSON подписи — signature-{signatureId}.json)","example":"672c8f1e9213f16bcd934422"},"sha256":{"type":"string","description":"SHA-256 сохранённого JSON подписи (hex)","example":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08"},"pressure":{"type":"boolean","description":"Сервер нашёл силу нажатия в точках рисунка"},"geolocation":{"type":"boolean","description":"В данных рисунка передана геолокация подписанта"}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/signdata":{"get":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"JSON подписи сигнатурой подписанного документа","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON подписи (файл)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillspublic/{key}/sendemail":{"post":{"tags":["Внешнее заполнение (публичные методы)"],"summary":"Отправить подписанный документ на email (итоговая страница подписанта, только способ «Сигнатура»)","description":"Публичный метод по ключу документа. Доступен только для подписанного документа со способом подписи draw («Сигнатура»). Письмо — штатное письмо о подписанном документе с PDF во вложении; отправляется один раз на документ (повтор — 409).","parameters":[{"in":"path","name":"key","required":true,"description":"Ключ","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["email"],"properties":{"email":{"type":"string","format":"email","description":"Адрес подписанта (проверяется формат, до 254 символов)","example":"vm@datadoc.ru"}}}}}},"responses":{"201":{"description":"Письмо отправлено","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","description":"Ключ документа","example":"902fd2c03ba52ca302dccb3e5546543e"},"email":{"type":"string","description":"Адрес, на который отправлено письмо","example":"vm@datadoc.ru"}}}}}},"400":{"$ref":"#/components/responses/InvalidData"},"404":{"description":"Документ не найден"},"409":{"description":"Документ по этой ссылке уже отправлялся на email (письмо отправляется один раз)"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/editeddocument":{"get":{"tags":["Внешнее заполнение"],"summary":"Получить HTML документа, изменённого пользователем в предпросмотре","description":"Если документ не менялся (в GET /externalinfills/{id} edited = false) — 404.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается изменённый документ","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID элемента внешнего заполнения","example":"64d5e8685186ca28a0567747"},"html":{"type":"string","description":"HTML документа, сохранённый после правки в предпросмотре","example":"Текст
"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills":{"get":{"tags":["Внешнее заполнение"],"summary":"Получить список всех документов для внешнего заполнения","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Название заполнения","schema":{"type":"string"}},{"in":"query","name":"fromCreatedAt","description":"Дата создания от","schema":{"type":"string"}},{"in":"query","name":"toCreatedAt","description":"Дата создания до","schema":{"type":"string"}},{"in":"query","name":"fromReadAt","description":"Дата чтения от","schema":{"type":"string"}},{"in":"query","name":"toReadAt","description":"Дата чтения до","schema":{"type":"string"}},{"in":"query","name":"fromSignedAt","description":"Дата подписания от","schema":{"type":"string"}},{"in":"query","name":"toSignedAt","description":"Дата подписания до","schema":{"type":"string"}},{"in":"query","name":"hasSignature","description":"Флаг наличия подписи","schema":{"type":"boolean"}},{"in":"query","name":"signatureStatus","description":"Статус подписи","schema":{"$ref":"#/components/schemas/ExternalInfillSignatureStatus"}},{"in":"query","name":"reusable","description":"Флаг многоразового внешнего заполнения","schema":{"type":"boolean"}},{"in":"query","name":"from","description":"Номер записи, с которой осуществлять выборку (0-based)","schema":{"type":"number"}},{"in":"query","name":"to","description":"Номер записи, до которой осуществлять выборку (0-based)","schema":{"type":"number"}}],"responses":{"200":{"description":"Возвращаются все предзаполненные документы","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Элементы внешнего заполнения (страница выборки from–to)","items":{"allOf":[{"$ref":"#/components/schemas/ExternalInfillShort"},{"type":"object","properties":{"signature":{"$ref":"#/components/schemas/ExternalInfillSignatureShort"}}}]}},"count":{"type":"integer","description":"Количество записей","example":1}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Внешнее заполнение"],"summary":"Создать элемент внешнего заполнения","security":[{"BearerAuth":[]}],"requestBody":{"description":"Данные для создания","required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ExternalInfillReuseConfig"},{"type":"object","properties":{"templateId":{"type":"string","description":"ID шаблона по которому создаётся элемент внешнего заполнения","example":"64d5e8685186ca28a0567747"},"name":{"type":"string","description":"Наименование","example":"Название документа"},"entityId":{"type":"string","description":"ID организации, собирающей ПД для заполнения","example":"64d5e8685186ca28a0567741"},"sideValues":{"$ref":"#/components/schemas/ExternalInfillSideValues"},"signature":{"type":"object","description":"Запрос подписи ПЭП (без него документ создаётся без подписи)","properties":{"signer":{"$ref":"#/components/schemas/ExternalInfillSigner"},"omitEntityStamp":{"type":"boolean","description":"Флаг отмены рендеринга печати создателя заполнения","example":true}}},"editedHtml":{"type":"string","description":"HTML документа, изменённый пользователем в предпросмотре (необязательно). Если передан, документ строится из него (значения уже подставлены), а не из шаблона; шаблон не меняется. HTML очищается (script, iframe, формы, on*-атрибуты, внешние картинки удаляются), размер не больше ~5 МБ. Если у группы пользователя включён запрет редактирования (право previewEditing:denied), ответ 403 (permission.previewediting). Сохраняется вместе с документом: признак edited в ответе, сам HTML — GET /externalinfills/{id}/editeddocument. Только для отправки на подпись (ПЭП, signature.signer) и не для многоразовой ссылки (reusable) — иначе 400","example":"Договор № 15 от 07.11.2026
"},"attachmentNames":{"type":"array","description":"Список имен вложений","items":{"type":"string","example":"attachment"}},"attachmentContents":{"type":"array","description":"Загружаемые приложения. Картинки (jpeg, png, webp, gif, bmp, tiff) и PDF (в том числе многостраничные) добавляются в конец итогового PDF в порядке перечисления; на каждой странице приложения справа вверху выводится «Приложение к документу № {номер, если есть} / от {дата, если есть} / {caption, если задан}», справа внизу — «Приложение — страница X из Y» (при нескольких приложениях — «Приложение N — страница X из Y»)","items":{"type":"object","properties":{"caption":{"type":"string","maxLength":255,"description":"Необязательная подпись приложения (без разметки), например «Генеральный план объекта»","example":"Генеральный план объекта"},"name":{"type":"string","description":"Название","example":"attachment"},"filename":{"type":"string","description":"Имя файла","example":"test.txt"},"mimetype":{"type":"string","description":"Тип файла","example":"text/plain"},"content":{"type":"string","description":"Содержимое файла в base64","example":"0YLQtdGB0YI="}}}}}}]}}}},"responses":{"201":{"description":"Возвращается элемент внешнего заполнения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfill"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}":{"get":{"tags":["Внешнее заполнение"],"summary":"Получить элемент внешнего заполнения по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается элемент внешнего заполнения","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ExternalInfillShort"},{"type":"object","properties":{"version":{"type":"integer","description":"Версия шаблона","example":0},"externalUserEmail":{"type":"string","description":"Email внешнего пользователя","example":"test@mail.ru"},"attachments":{"$ref":"#/components/schemas/ExternalInfillAttachments"},"sideValues":{"$ref":"#/components/schemas/ExternalInfillSideValues"},"sides":{"type":"array","description":"Стороны версии шаблона документа с заполненными данными переменных","items":{"$ref":"#/components/schemas/TemplateSideWithFilledTattrs"}},"blocksTree":{"$ref":"#/components/schemas/TemplateBlocksTree"},"edited":{"type":"boolean","description":"Документ изменён пользователем в предпросмотре (HTML — GET /externalinfills/{id}/editeddocument)","example":false},"entity":{"description":"Организация, собирающая данные для заполнения","allOf":[{"$ref":"#/components/schemas/IdObject"},{"type":"object","properties":{"name":{"type":"string","description":"Наименование","example":"ООО Вектор"},"inn":{"type":"string","description":"ИНН","example":1234567890},"kpp":{"type":"string","description":"КПП","example":12345678},"email":{"type":"string","description":"Email","example":"test@mail.ru"},"phone":{"type":"string","description":"Телефон","example":79012345678}}}]},"signature":{"$ref":"#/components/schemas/ExternalInfillSignatureShort"}}}]}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Внешнее заполнение"],"summary":"Обновить элемент внешнего заполнения","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные для обновления","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Наименование","example":"Название документа"},"reuseActive":{"type":"boolean","description":"Является ли многоразовое внешнее заполнение активным","example":true}}}}}},"responses":{"200":{"description":"Возвращается элемент внешнего заполнения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfill"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Внешнее заполнение"],"summary":"Удалить элемент внешнего заполнения","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается ID удалённого предзаполненного документа","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"ID удалённого элемента","example":"64d8e0120f6123c8a3360dd1"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/copy":{"post":{"tags":["Внешнее заполнение"],"summary":"Дублировать внешнее заполнение","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"201":{"description":"Возвращается элемент внешнего заполнения","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExternalInfill"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/attachments/{attachmentId}":{"get":{"tags":["Внешнее заполнение"],"summary":"Скачать вложение по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"},{"in":"path","name":"attachmentId","required":true,"description":"id вложения","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается файл","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/attachments":{"get":{"tags":["Внешнее заполнение"],"summary":"Скачать все вложения по id как zip-архив","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается файл","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Внешнее заполнение"],"summary":"Загрузить вложения","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные для загрузки","content":{"multipart/form-data":{"schema":{"type":"object","additionalProperties":{"type":"string","format":"binary","description":"Файл"},"example":{"b2bb25949213f16bcd934422":"(binary)","b2bb25949213f16bcd934423":"(binary)"}}}}},"responses":{"201":{"description":"Возвращается элемент внешнего заполнения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfill"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/email":{"put":{"tags":["Внешнее заполнение"],"summary":"Отправить письмо для заполнения","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Данные для отправки","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","description":"Email","example":"test@mail.ru"}}}}}},"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/sms":{"put":{"tags":["Внешнее заполнение"],"summary":"Отправить SMS для подписания","description":"Каждая отправленная СМС списывает подпись. Нет подписей (и не действуют «Бесплатные СМС») — ошибка signature.limitexceeded, СМС не отправляется (FOR-2823).","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/signdata":{"get":{"tags":["Внешнее заполнение"],"summary":"Скачать JSON подписи «Сигнатурой» (рисунок) подписанного документа","description":"Отдаёт файл signature-{id подписи}.json — исходный JSON рисунка подписи (точки, метаданные, геолокация и серверные признаки), тот же, что вложен в итоговый PDF. Только для документа своего воркспейса, подписанного способом «Сигнатура»; иначе 400 (signdraw.notforthisdocument).","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Файл JSON подписи (Content-Disposition attachment)","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfills/{id}/sms/status":{"get":{"tags":["Внешнее заполнение"],"summary":"Статус доставки отправленного СМС для подписания","description":"Запрашивает у провайдера (smsc.ru) статус СМС, отправленного методом PUT /externalinfills/{id}/sms. Ничего не отправляет и не списывает. Если СМС ещё не отправлялось — status \"notsent\".","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Статус СМС","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SmsStatus"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillentitiesadmin/{wid}":{"get":{"tags":["Внешнее заполнение - организации (админка)"],"summary":"Получить список организаций по wid","parameters":[{"in":"path","name":"wid","required":true,"description":"ID воркспейса","example":"65576f45c1433e2251e97a45","schema":{"type":"string"}}],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список организаций","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Внешнее заполнение - организации (админка)"],"summary":"Создать новую организацию","parameters":[{"in":"path","name":"wid","required":true,"description":"ID воркспейса","example":"65576f45c1433e2251e97a45","schema":{"type":"string"}}],"security":[{"BearerAuth":[]}],"requestBody":{"description":"Организация","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewExternalInfillEntityWithApprovedFlag"}}}},"responses":{"201":{"description":"Возвращается организация","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillentitiesadmin/{wid}/{id}":{"delete":{"tags":["Внешнее заполнение - организации (админка)"],"summary":"Удалить организацию по id","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"wid","required":true,"description":"ID воркспейса","example":"65576f45c1433e2251e97a45","schema":{"type":"string"}},{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленной организации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillentitiesadmin/{wid}/{id}/approved":{"put":{"tags":["Внешнее заполнение - организации (админка)"],"summary":"Изменить флаг подтверждения","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"wid","required":true,"description":"ID воркспейса","example":"65576f45c1433e2251e97a45","schema":{"type":"string"}},{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Организация","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"approved":{"type":"boolean","description":"Флаг подтверждения","example":true}}}}}},"responses":{"200":{"description":"Возвращается организация","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillentities":{"get":{"tags":["Внешнее заполнение - организации"],"summary":"Получить список организаций","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список организаций","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Внешнее заполнение - организации"],"summary":"Создать новую организацию","security":[{"BearerAuth":[]}],"requestBody":{"description":"Организация","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewExternalInfillEntityWithApprovedFlag"}}}},"responses":{"201":{"description":"Возвращается организация","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillentities/{id}":{"get":{"tags":["Внешнее заполнение - организации"],"summary":"Получить организацию по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается организация","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Внешнее заполнение - организации"],"summary":"Обновить организацию","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Организация","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewExternalInfillEntity"}}}},"responses":{"200":{"description":"Возвращается организация","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Внешнее заполнение - организации"],"summary":"Удалить организацию по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленной организации","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/externalinfillentities/{wid}/{id}":{"get":{"tags":["Внешнее заполнение - организации"],"summary":"Получить организацию по id в воркспейсе (публичный метод)","parameters":[{"in":"path","name":"wid","required":true,"description":"id воркспейса","schema":{"type":"string"}},{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается организация","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExternalInfillEntity"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/documents":{"get":{"tags":["Документы (рендеры и внешние заполнения)"],"summary":"Получить список всех документов без подписи (рендеров и внешних заполнений)","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Название и ключевые переменные (в случае документов и строгих документов)","schema":{"type":"string"}},{"in":"query","name":"confirmed","description":"Флаг подтверждения","schema":{"type":"boolean"}},{"in":"query","name":"fromConfirmedAt","description":"Дата/время подтверждения документа от","schema":{"type":"string"}},{"in":"query","name":"toConfirmedAt","description":"Дата/время подтверждения документа до","schema":{"type":"string"}},{"$ref":"#/components/parameters/fromCreatedAt"},{"$ref":"#/components/parameters/toCreatedAt"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"}],"responses":{"200":{"description":"Возвращаются все документы","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Документы выбранного диапазона — документы по шаблону, внешние заполнения и строгие документы (вид — в поле type)","items":{"anyOf":[{"allOf":[{"$ref":"#/components/schemas/RenderBase"},{"type":"object","properties":{"confirmed":{"type":"boolean","description":"Флаг подписи","example":true},"confirmedAt":{"type":"string","description":"Дата и время подписи","example":"2022-07-16T13:10:43.284+00:00"}}}]},{"$ref":"#/components/schemas/ExternalInfillBase"},{"$ref":"#/components/schemas/StrictRenderBase"}]}},"count":{"type":"integer","description":"Количество записей","example":1}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/documents/signed":{"get":{"tags":["Документы (рендеры и внешние заполнения)"],"summary":"Получить список всех документов с подписью (рендеров и внешних заполнений)","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Название и ключевые переменные (в случае документов)","schema":{"type":"string"}},{"in":"query","name":"primaryType","description":"Тип подписи первой стороны","schema":{"type":"string","enum":["simple","qualified"],"example":"simple"}},{"in":"query","name":"counterType","description":"Тип подписи второй стороны","schema":{"type":"string","enum":["simple","qualified","edo","null"],"example":"simple"}},{"in":"query","name":"status","description":"Статус(ы) подписи","schema":{"type":"array","items":{"allOf":[{"$ref":"#/components/schemas/TemplateRenderSignatureStatus"},{"$ref":"#/components/schemas/ExternalInfillSignatureStatus"}]}},"explode":false},{"in":"query","name":"fromSignedAt","description":"Дата подписания от","schema":{"type":"string"}},{"in":"query","name":"toSignedAt","description":"Дата подписания до","schema":{"type":"string"}},{"$ref":"#/components/parameters/fromCreatedAt"},{"$ref":"#/components/parameters/toCreatedAt"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"}],"responses":{"200":{"description":"Возвращаются все документы","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","description":"Документы с подписью выбранного диапазона — документы по шаблону и внешние заполнения (вид — в поле type)","items":{"anyOf":[{"allOf":[{"$ref":"#/components/schemas/RenderBase"},{"type":"object","properties":{"signature":{"type":"object","description":"Подпись документа по шаблону","properties":{"status":{"$ref":"#/components/schemas/TemplateRenderSignatureStatus"},"primary":{"description":"Подпись первой стороны (отправителя)","allOf":[{"$ref":"#/components/schemas/TemplateRenderListSideSignature"}]},"counter":{"description":"Подпись второй стороны (контрагента)","allOf":[{"$ref":"#/components/schemas/TemplateRenderListSideSignature"}]}}}}}]},{"allOf":[{"$ref":"#/components/schemas/ExternalInfillBase"},{"type":"object","properties":{"signature":{"type":"object","description":"Подпись внешнего заполнения","properties":{"status":{"description":"Статус подписи: SIGN_REQUESTED — ждёт подписи, SIGNED — подписан, REJECTED — отклонён","allOf":[{"$ref":"#/components/schemas/ExternalInfillSignatureStatus"}]},"signedAt":{"type":"string","description":"Дата подписи","example":"2024-10-27T13:38:25.156+00:00"},"signer":{"type":"object","description":"Подписант","properties":{"name":{"type":"string","description":"ФИО подписанта","example":"Иванов Иван Иванович"}}},"entity":{"type":"object","description":"Организация-отправитель","properties":{"name":{"type":"string","description":"Наименование отправителя","example":"ООО Умные документы"}}}}}}}]}]}},"count":{"type":"integer","description":"Количество записей","example":1}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/documents/signed/archive":{"post":{"tags":["Документы (рендеры и внешние заполнения)"],"summary":"Скачать ZIP-архив PDF подписанных ПЭП одной страницы списка /documents/signed (не более 100 документов)","description":"Фильтры - те же, что у списка /documents/signed, тип подписи ПЭП обязателен (primaryType=simple). Берётся страница from..to (включительно, не более 100 записей),\nв архив попадают только подписанные ПЭП этой страницы (тот же файл, что при обычном скачивании подписанного PDF). Имена файлов - названия документов,\nзапрещённые символы заменяются на «_», одинаковые имена получают «_2», «_3». Нужны права signedExternalInfills:view и pepArchive:download\n(у группы «Администраторы» преференция есть всегда). Архив отдаётся в ответе, без временных ссылок.\n","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["primaryType","from","to"],"properties":{"primaryType":{"type":"string","enum":["simple"],"description":"Тип подписи первой стороны — только simple (ПЭП), иначе 400 signedarchive.peponly","example":"simple"},"counterType":{"type":"string","enum":["simple"],"description":"Тип подписи второй стороны — только simple (ПЭП); необязательный фильтр","example":"simple"},"name":{"type":"string","description":"Название и ключевые переменные","example":"Договор 203"},"status":{"type":"string","description":"Статус(ы) подписи через запятую (значения как у фильтра status списка /documents/signed)","example":"DOUBLE_SIGNED,SIGNED"},"fromCreatedAt":{"type":"string","description":"Дата создания от (ISO 8601)","example":"2026-10-01T00:00:00.000Z"},"toCreatedAt":{"type":"string","description":"Дата создания до (ISO 8601)","example":"2026-10-31T23:59:59.999Z"},"fromSignedAt":{"type":"string","description":"Дата подписания от (ISO 8601)","example":"2026-10-01T00:00:00.000Z"},"toSignedAt":{"type":"string","description":"Дата подписания до (ISO 8601)","example":"2026-10-31T23:59:59.999Z"},"from":{"type":"integer","description":"Номер первой записи страницы (0-based)","example":0},"to":{"type":"integer","description":"Номер последней записи страницы (0-based, включительно; to - from < 100)","example":99}}}}}},"responses":{"200":{"description":"Возвращается ZIP-архив (signed_pep.zip)","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Нет права signedExternalInfills:view или преференции pepArchive:download"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/documents/signed/excel":{"get":{"tags":["Документы (рендеры и внешние заполнения)"],"summary":"Выгрузить документы с подписью в файл XLSX с теми же фильтрами, что у списка /documents/signed","description":"Выгружаются все найденные документы (без страниц, если не переданы from/to). Колонки и их заголовки берутся из ресурса signeddocuments.excelcolumns\n(строки «ключ ширина заголовок»; ключи name, companyName, createdAt, readAt, filledAt, signedAt, signerName, url).\nПодписант внешней стороны заполняется только для ПЭП, ссылка - только для подписанных документов. Нужно право signedExternalInfills:view.\n","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Название и ключевые переменные (в случае документов)","schema":{"type":"string"}},{"in":"query","name":"primaryType","description":"Тип подписи первой стороны","schema":{"type":"string","enum":["simple","qualified"]}},{"in":"query","name":"counterType","description":"Тип подписи второй стороны","schema":{"type":"string","enum":["simple","qualified","edo","null"]}},{"in":"query","name":"status","description":"Статус(ы) подписи через запятую","schema":{"type":"string"}},{"in":"query","name":"fromSignedAt","description":"Дата подписания от","schema":{"type":"string"}},{"in":"query","name":"toSignedAt","description":"Дата подписания до","schema":{"type":"string"}},{"in":"query","name":"tzOffset","description":"Смещение часового пояса пользователя в минутах, как его возвращает Date.getTimezoneOffset() (по умолчанию -180, Москва)","schema":{"type":"integer","example":-180}},{"$ref":"#/components/parameters/fromCreatedAt"},{"$ref":"#/components/parameters/toCreatedAt"},{"$ref":"#/components/parameters/from"},{"$ref":"#/components/parameters/to"}],"responses":{"200":{"description":"Возвращается файл XLSX (signatures.xlsx)","content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Нет права signedExternalInfills:view"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/cleanname":{"post":{"tags":["API dadata.ru"],"summary":"Стандартизация ФИО","requestBody":{"description":"ФИО","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"ФИО для обработки","example":"Срегей владимерович иванов"}}}}}},"responses":{"200":{"description":"Стандартизированные данные","content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","description":"Исходное ФИО одной строкой","example":"Срегей владимерович иванов"},"result":{"type":"string","description":"Стандартизованное ФИО одной строкой","example":"Иванов Сергей Владимирович"},"result_genitive":{"type":"string","description":"ФИО в родительном падеже (кого?)","example":"Иванова Сергея Владимировича"},"result_dative":{"type":"string","description":"ФИО в дательном падеже (кому?)","example":"Иванову Сергею Владимировичу"},"result_ablative":{"type":"string","description":"ФИО в творительном падеже (кем?)","example":"Ивановым Сергеем Владимировичем"},"surname":{"type":"string","description":"Фамилия","example":"Иванов"},"name":{"type":"string","description":"Имя","example":"Сергей"},"patronymic":{"type":"string","description":"Отчество","example":"Владимирович"},"gender":{"type":"string","description":"Пол","example":"М"},"qc":{"type":"integer","description":"Код проверки","example":1}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/suggestparty":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по организациям","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":"Сбербанк"}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/suggest/party/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/suggestfio/firstname":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по имени","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":"Иван"}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/suggest/name/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/suggestfio/middlename":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по отчеству","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":"Иван"}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/suggest/name/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/suggestfio/familyname":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по фамилии","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":"Иван"}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/suggest/name/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/findbank":{"post":{"tags":["API dadata.ru"],"summary":"Поиск банка","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":44525225}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/find-bank/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/suggestbank":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по банку","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":"Сбер"}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/suggest/bank/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/suggestaddress":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по адресу","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":"Моск"}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/suggest/address/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/suggestfmsunit":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по \"Паспорт выдан\"","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Запрос для обработки","example":"772-053"}}}}}},"responses":{"200":{"description":"Массив подсказок","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","example":"См. https://dadata.ru/api/suggest/fms_unit/"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/dadata/cities":{"post":{"tags":["API dadata.ru"],"summary":"Подсказки по городам","requestBody":{"description":"Запрос","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Название города","example":"Москва"}}}}}},"responses":{"200":{"description":"Массив городов","content":{"application/json":{"schema":{"type":"array","description":"Массив подсказок","items":{"type":"object","properties":{"title":{"type":"string","description":"Название города","example":"Москва"},"area":{"type":"string","description":"Район, в котором находится населённый пункт","example":"Верхошижемский район"},"region":{"type":"object","description":"Объект региона (области)","properties":{"title":{"type":"string","description":"Название региона (области)","example":"Кировская область"}}},"country":{"type":"object","description":"Объект страны","properties":{"title":{"type":"string","description":"Название страны","example":"Россия"}}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/crmleads":{"post":{"tags":["CRM: данные лида (пользователь)"],"summary":"FOR-2367: сохранить данные лида CRM, полученные виджетом","description":"Данные хранятся в рабочем пространстве пользователя 7 дней. Повторная запись того же лида (crm + entityId + entityType) заменяет данные, сохраняет id и продлевает срок хранения.","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveCrmLead"}}}},"responses":{"200":{"description":"Сохранённая запись","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmLead"}}}},"400":{"description":"Неверные данные (ресурсы crmlead.crm.invalid, crmlead.entityid.invalid, crmlead.entitytype.invalid, crmlead.account.invalid, crmlead.data.invalid, crmlead.data.toolarge)"},"401":{"description":"Нет авторизации"},"500":{"$ref":"#/components/responses/InternalError"}}},"get":{"tags":["CRM: данные лида (пользователь)"],"summary":"FOR-2367: данные лида CRM по CRM и id лида","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"crm","description":"Тип CRM лида","required":true,"schema":{"$ref":"#/components/schemas/CrmLeadType"}},{"in":"query","name":"entityId","description":"id лида (сделки) в CRM, до 64 символов","required":true,"schema":{"type":"string"},"example":"27461057"},{"in":"query","name":"entityType","description":"Тип сущности в CRM, с учётом регистра (не передан — пустая строка)","schema":{"type":"string"},"example":"leads"}],"responses":{"200":{"description":"Запись лида","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmLead"}}}},"400":{"description":"Неверные параметры"},"401":{"description":"Нет авторизации"},"404":{"description":"Лид не сохранён в рабочем пространстве или срок хранения истёк"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/crmleads/{id}":{"get":{"tags":["CRM: данные лида (пользователь)"],"summary":"FOR-2367: данные лида CRM по id записи (для страницы ЛК)","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"id","description":"id записи лида (поле id из ответа POST /crmleads)","required":true,"schema":{"type":"string"},"example":"672a1f3e9b1c2d0012a3b4c5"}],"responses":{"200":{"description":"Запись лида","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmLead"}}}},"400":{"description":"Неверный id"},"401":{"description":"Нет авторизации"},"404":{"description":"Записи нет в рабочем пространстве пользователя (в том числе запись другого пространства) или срок хранения истёк"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/crm/activate":{"post":{"tags":["CRM"],"summary":"Активировать интеграцию с CRM","requestBody":{"description":"Данные пользователя","required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"crm":{"$ref":"#/components/schemas/CrmType"},"user_data":{"type":"object","description":"Данные главного пользователя","properties":{"id":{"type":"string","description":"id главного пользователя в CRM","example":1234567890},"name":{"type":"string","description":"ФИО главного пользователя","example":"Иванов Иван Иванович"},"email":{"type":"string","description":"Email главного пользователя","example":"user@mail.ru"},"phone":{"type":"string","description":"Телефон главного пользователя","example":79999999999}}},"user_data_sign":{"type":"string","description":"Хеш для валидации запроса","example":"adafd23849f37f49ae23efd56c2a2acb0d6df5f2"}}}}}},"responses":{"201":{"description":"Возвращается URL-токен","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UrlToken"}}}},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents":{"get":{"tags":["Контрагенты"],"summary":"Получить список контрагентов","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"filter","description":"Фильтр по полям контрагента","schema":{"type":"string"}},{"in":"query","name":"selfowned","description":"Признак \"мой контрагент\"","schema":{"type":"boolean"}},{"$ref":"#/components/parameters/type"},{"$ref":"#/components/parameters/sort"},{"in":"query","name":"from","description":"Номер записи, с которой осуществлять выборку (0-based)","schema":{"type":"integer"}},{"in":"query","name":"to","description":"Номер записи, до которой осуществлять выборку (0-based)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Возвращается список контрагентов","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Контрагенты"],"summary":"Создать нового контрагента","security":[{"BearerAuth":[]}],"requestBody":{"description":"Контрагент","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewCounteragent"}}}},"responses":{"201":{"description":"Возвращается контрагент","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Counteragent"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/batch":{"post":{"tags":["Контрагенты"],"summary":"Создать новых контрагентов пакетом","security":[{"BearerAuth":[]}],"requestBody":{"description":"Контрагенты","required":true,"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/NewCounteragent"}}}}},"responses":{"201":{"description":"Возвращаются контрагенты","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Counteragent"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/{id}":{"get":{"tags":["Контрагенты"],"summary":"Получить контрагента по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается контрагент","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Counteragent"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Контрагенты"],"summary":"Обновить контрагента","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Контрагент","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewCounteragent"}}}},"responses":{"200":{"description":"Возвращается контрагент","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Counteragent"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Контрагенты"],"summary":"Удалить контрагента по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленного контрагента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/favorites":{"get":{"tags":["Контрагенты"],"summary":"Получить список избранных контрагентов","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Возвращается список избранных контрагентов","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/favorites/{id}":{"put":{"tags":["Контрагенты"],"summary":"Добавить контрагента в избранное","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается контрагент","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Counteragent"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Контрагенты"],"summary":"Удалить контрагента из избранного","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается контрагент","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Counteragent"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/excel":{"get":{"tags":["Контрагенты"],"summary":"Получить файл Excel с информацией о контрагентах","description":"Нужны права counteragents:view и counteragentsXlsx:download (преференция группы «Скачивать контрагентов XLSX»; по умолчанию включена у всех групп, у группы администраторов — всегда). Без них ответ 403 с текстом ресурса permission.group («У вашей группы недостаточно прав»)","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/type"},{"$ref":"#/components/parameters/sort"}],"responses":{"200":{"description":"Возвращается файл xslx","content":{"application/vnd.ms-excel":{"schema":{"type":"string","format":"binary"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"description":"Нет права counteragents:view или преференции counteragentsXlsx:download (ресурс permission.group)"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/baseattrs":{"get":{"tags":["Контрагенты"],"summary":"Получить список базовых переменных контрагентов","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/type"}],"responses":{"200":{"description":"Возвращается список переменных","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CounteragentBaseattr"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Контрагенты"],"summary":"Создать новую базовую переменную контрагента","security":[{"BearerAuth":[]}],"requestBody":{"description":"Контрагент","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentBaseattr"}}}},"responses":{"201":{"description":"Возвращается переменная контрагента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentBaseattr"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/baseattrs/{type}/{id}":{"delete":{"tags":["Контрагенты"],"summary":"Удалить базовую переменную контрагента","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"type","required":true,"description":"Тип","example":"entity","schema":{"$ref":"#/components/schemas/CounteragentType"}},{"in":"path","name":"id","required":true,"description":"id переменной","example":101,"schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается переменная контрагента","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentBaseattr"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/matching":{"get":{"tags":["Контрагенты"],"summary":"Правила «Как определяем контрагентов» по типам","description":"Читают все пользователи; менять может администратор рабочего пространства (editable). Пока рабочее пространство не сохранило свои правила, действует базовый набор (isDefault).","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Правила по типам и базовый набор","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentMatching"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/matching/{type}":{"put":{"tags":["Контрагенты"],"summary":"Сохранить правила «Как определяем контрагентов» типа","description":"Только администратор рабочего пространства (иначе 403 permission.onlyadmin). Списки блоков заменяются целиком. Изменения действуют с текущего момента, существующие карточки не меняются.","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"type","required":true,"description":"Тип контрагента: entity — юрлицо, person — физлицо, individual — ИП","schema":{"$ref":"#/components/schemas/CounteragentType"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentMatchingRules"},"example":{"required":[["304","2006"],["305","2006"]],"match":[["2006","2009"],["2006"],["302"],["304"],["305"]]}}}},"responses":{"200":{"description":"Правила по типам после сохранения","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentMatching"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"description":"Пользователь не администратор рабочего пространства (permission.onlyadmin)"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Контрагенты"],"summary":"Вернуть базовый набор правил «Как определяем контрагентов» для типа","description":"Удаляет собственные правила рабочего пространства для типа, после чего действует базовый набор (isDefault). Только администратор рабочего пространства (иначе 403 permission.onlyadmin).","security":[{"BearerAuth":[]}],"parameters":[{"in":"path","name":"type","required":true,"description":"Тип контрагента: entity — юрлицо, person — физлицо, individual — ИП","schema":{"$ref":"#/components/schemas/CounteragentType"}}],"responses":{"200":{"description":"Правила по типам после сброса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentMatching"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"403":{"description":"Пользователь не администратор рабочего пространства (permission.onlyadmin)"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/counteragents/duplicates":{"get":{"tags":["Контрагенты"],"summary":"Поиск дублей","description":"Карточки типа, которые по правилам «Как определяем» считаются одной карточкой, по группам (временный фильтр справочника).","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"type","required":true,"description":"Тип контрагента: entity — юрлицо, person — физлицо, individual — ИП","schema":{"$ref":"#/components/schemas/CounteragentType"}},{"in":"query","name":"filter","description":"Фильтр по полям контрагента (строка поиска)","schema":{"type":"string"}},{"$ref":"#/components/parameters/sort"},{"in":"query","name":"from","description":"Номер записи, с которой осуществлять выборку (0-based)","schema":{"type":"integer"}},{"in":"query","name":"to","description":"Номер записи, до которой осуществлять выборку (0-based)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Карточки-дубли","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CounteragentDuplicates"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/converters/doctohtml":{"post":{"tags":["Конвертеры"],"summary":"Конвертировать doc в html","security":[{"BearerAuth":[]}],"requestBody":{"description":"Данные для конвертации","required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/File"}}}},"responses":{"200":{"description":"Возвращается html","content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":"string","description":"HTML-содержимое документа (тело без обёртки html/body, после фильтрации и с проставленными стилями по умолчанию)","example":"test"},"border":{"type":"object","description":"Поля страницы по умолчанию","properties":{"top":{"type":"string","description":"Отступ вверху","example":"2.00cm"},"bottom":{"type":"string","description":"Отступ внизу","example":"2.00cm"},"left":{"type":"string","description":"Отступ слева","example":"2.00cm"},"right":{"type":"string","description":"Отступ справа","example":"1.00cm"}}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/converters/doctopdf":{"post":{"tags":["Конвертеры"],"summary":"Конвертировать docx (doc) в pdf","security":[{"BearerAuth":[]}],"requestBody":{"description":"Файл для конвертации","required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/File"}}}},"responses":{"200":{"description":"Возвращается pdf","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/converters/pdftodoc/external":{"post":{"tags":["Конвертеры"],"summary":"Конвертировать pdf в docx через внешний сервис","security":[{"BearerAuth":[]}],"requestBody":{"description":"Данные для конвертации","required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/File"}}}},"responses":{"200":{"description":"Возвращается docx (файл response.docx)","content":{"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{"schema":{"type":"string","format":"binary"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"},"502":{"description":"Ошибка сервиса","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/converters/pdftodoc/external-test":{"post":{"tags":["Конвертеры"],"summary":"Конвертировать pdf в docx встроенным конвертером","description":"Конвертация PDF в DOCX конвертером внутри приложения, независимо от настройки режима сервера (нужно для сравнения результата с внешним сервисом на реальных файлах). Ответ — файл response.docx.","security":[{"BearerAuth":[]}],"requestBody":{"description":"PDF-файл для конвертации","required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/File"}}}},"responses":{"200":{"description":"Возвращается docx","content":{"application/vnd.openxmlformats-officedocument.wordprocessingml.document":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Файл не передан (validation.file.notfound) или конвертация не удалась (rendering.error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/statics/defaultStyle":{"post":{"tags":["Статические файлы"],"summary":"Записать файл стилей","security":[{"BearerAuth":[]}],"requestBody":{"description":"Файл","required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","description":"Файл","format":"binary"}}}}}},"responses":{"201":{"description":"Возвращается ссылка на файл","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"Адрес загруженного файла стилей","example":"http://safe.forma.today/default-style.css"}}}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/cattrs":{"get":{"tags":["Пользовательские переменные"],"summary":"Получить список переменных","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","description":"Имя переменной (поиск по регулярному выражению)","schema":{"type":"string"}},{"in":"query","name":"type","description":"Тип переменной (поиск по точному совпадению)","schema":{"$ref":"#/components/schemas/CattrType"}}],"responses":{"200":{"description":"Возвращается список переменных по заданным условиям","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Cattr"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}},"post":{"tags":["Пользовательские переменные"],"summary":"Создать новую переменную","security":[{"BearerAuth":[]}],"requestBody":{"description":"Переменная","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewCattr"}}}},"responses":{"201":{"description":"Возвращается переменная","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cattr"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/cattrs/{id}":{"get":{"tags":["Пользовательские переменные"],"summary":"Получить переменную по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается переменная","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cattr"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Пользовательские переменные"],"summary":"Обновить переменную","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"description":"Переменная","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NewCattr"}}}},"responses":{"200":{"description":"Возвращается переменная","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cattr"}}}},"400":{"$ref":"#/components/responses/AlreadyExists"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}},"delete":{"tags":["Пользовательские переменные"],"summary":"Удалить переменную по id","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"responses":{"200":{"description":"Возвращается id удаленной переменной","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IdObject"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/cattrs/similars":{"get":{"tags":["Пользовательские переменные"],"summary":"Получить список переменных, похожих на заданную","security":[{"BearerAuth":[]}],"parameters":[{"in":"query","name":"name","required":true,"description":"Имя переменной","example":"нумбер паспарта","schema":{"type":"string"}}],"responses":{"200":{"description":"Возвращается список переменных, похожих на заданный","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","description":"Тип переменной","example":"strictattr"},"id":{"type":"string","description":"id переменной","example":1005},"name":{"type":"string","description":"Наименование переменной","example":"Номер паспорта"},"distance":{"type":"number","description":"Расстояние между переменной и заданной","example":0.25}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/PaymentRequired"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/buttonsettings":{"get":{"tags":["Настройки воркспейса"],"summary":"Настройка видимости кнопок воркспейса","description":"Читают все пользователи воркспейса. Пока функция недоступна (available false), списки пустые - все кнопки видны.","security":[{"BearerAuth":[]}],"responses":{"200":{"description":"Настройки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ButtonSettings"},"example":{"available":true,"hiddenButtons":{"render":["downloadDocx","massRender"],"document":["downloadDocx"]},"editable":true}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}},"put":{"tags":["Настройки воркспейса"],"summary":"Сохранить скрытые кнопки","description":"Меняет администратор воркспейса; списки заменяются целиком. Неизвестный код кнопки - 400 (buttonsettings.invalid), функция недоступна - 400 (buttonsettings.unavailable).","security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["hiddenButtons"],"properties":{"hiddenButtons":{"$ref":"#/components/schemas/HiddenButtons"}}}}}},"responses":{"200":{"description":"Сохранённые настройки","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ButtonSettings"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"description":"Пользователь не в группе администраторов воркспейса"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/workspaces/{id}/buttons":{"put":{"tags":["Рабочие пространства"],"summary":"Свойство воркспейса «Настройка видимости кнопок» (администратор сервиса)","description":"default - как в общей настройке сервиса workspaces.buttons.enabled (по умолчанию выключена), enabled / disabled - явно для воркспейса.","security":[{"BearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/id"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["buttonsAccess"],"properties":{"buttonsAccess":{"type":"string","enum":["default","enabled","disabled"],"description":"default — по общей настройке сервиса workspaces.buttons.enabled, enabled — включена воркспейсу, disabled — выключена","example":"enabled"}}}}}},"responses":{"200":{"description":"Сохранённое значение","content":{"application/json":{"example":{"id":"6ad973f3669f6e7194c48199","buttonsAccess":"enabled"}}}},"400":{"$ref":"#/components/responses/InvalidData"},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/boxlicensespublic/check":{"post":{"tags":["Лицензии коробки (публичные методы)"],"summary":"Проверить лицензию коробки по коду (коробка)","description":"Вызывает сервер коробки (on-prem версии), без авторизации: активация, продление и периодическая проверка лицензии — один и тот же метод, он же источник подписанного времени вендора. Первая успешная проверка привязывает код к установке (installId); с другой установки код вернёт reason = bound, пока администратор не сбросит привязку. Ответ всегда подписан ключом вендора (Ed25519), коробка не доверяет неподписанному. Ограничение частоты по IP — при превышении 429; если на сервере не задан ключ подписи — 503.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["code","installId"],"properties":{"code":{"type":"string","minLength":8,"maxLength":64,"description":"Код лицензии (регистр и разделители не важны)","example":"ABCDE-FGHJK-LMNPQ-RS234"},"installId":{"type":"string","minLength":8,"maxLength":100,"description":"id установки (сервера) коробки","example":"9b1d4c7e-0000-4a00-8000-123456789abc"},"version":{"type":"string","maxLength":40,"description":"Версия коробки (сохраняется для администратора)","example":"1.4.0"}}}}}},"responses":{"200":{"description":"Подписанный ответ о лицензии","content":{"application/json":{"schema":{"type":"object","properties":{"valid":{"type":"boolean","description":"Лицензия действует для этой установки","example":true},"reason":{"type":"string","enum":["notfound","notstarted","expired","revoked","bound"],"description":"Причина отказа (только при valid = false) — notfound код не найден, notstarted срок ещё не начался, expired срок истёк, revoked отозвана, bound код привязан к другой установке","example":"expired"},"time":{"type":"string","format":"date-time","description":"Время вендора (ISO)","example":"2026-11-07T10:00:00.000Z"},"timeSignature":{"type":"string","description":"Подпись (base64) текста \"time: