СБИС
Коннектор СБИС (Saby)
Подключение: https://mcp.legalstack.ru/mcp/saby или в составе агрегированного сервера https://mcp.legalstack.ru/mcp.
Имя сервера: legalstack-saby. Инструментов: 31.
saby_add_attachment
⚠ Outward-facing: добавляет вложение к документу в СБИС. Возвращает: объект результата.
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"description": "ID документа"
},
"attachment": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Объект вложения (Название, Файл: { Имя, ДвоичныеДанные })"
}
},
"required": [
"documentId",
"attachment"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_annul_document
⚠ Outward-facing: аннулирует документ в ЭДО СБИС (юридически значимо). Возвращает: текст «Документ аннулирован».
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Идентификатор документа"
},
"comment": {
"description": "Причина аннулирования",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_check_edo
Проверить возможность ЭДО с контрагентом по ИНН. Только чтение. Возвращает: объект с признаком возможности ЭДО.
{
"type": "object",
"properties": {
"inn": {
"type": "string",
"description": "ИНН контрагента"
},
"kpp": {
"description": "КПП",
"type": "string"
}
},
"required": [
"inn"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_create_document
⚠ Outward-facing: создаёт документ во внешней системе СБИС. Возвращает: объект созданного документа.
{
"type": "object",
"properties": {
"document": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Объект документа в формате СБИС (Тип, Подтип, Дата, НашаОрганизация, Контрагент и т.д.)"
}
},
"required": [
"document"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_delete_attachment
⚠ Outward-facing: удаляет вложение документа в СБИС. Возвращает: текст «Вложение удалено».
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"description": "ID документа"
},
"attachmentId": {
"type": "string",
"description": "ID вложения"
}
},
"required": [
"documentId",
"attachmentId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_delete_document
⚠ Outward-facing: удаляет документ в СБИС. Обратимо через saby_restore_document. Возвращает: текст «Документ удалён».
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Идентификатор документа"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_execute_action
⚠ Outward-facing: выполняет действие над документом в ЭДО СБИС (подписать/отправить/отклонить) — юридически значимо. Перед вызовом подготовь подписи через saby_prepare_action. Возвращает: объект результата.
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"description": "ID документа"
},
"action": {
"type": "string",
"description": "Действие"
},
"signatures": {
"description": "Подписи для вложений (если требуются)",
"type": "array",
"items": {
"type": "object",
"properties": {
"attachmentId": {
"type": "string",
"description": "ID вложения"
},
"signatureBase64": {
"type": "string",
"description": "Подпись в base64"
}
},
"required": [
"attachmentId",
"signatureBase64"
]
}
}
},
"required": [
"documentId",
"action"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_find_contragent
Поиск контрагента в СБИС по ИНН или названию. Только чтение. Возвращает: массив контрагентов или текст «Контрагент не найден».
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "ИНН или название контрагента"
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_get_contragent
Сводная информация о контрагенте в СБИС по ИНН. Только чтение. Полные данные — saby_read_contragent. Возвращает: объект контрагента.
{
"type": "object",
"properties": {
"inn": {
"type": "string",
"description": "ИНН контрагента"
},
"kpp": {
"description": "КПП (для уточнения)",
"type": "string"
}
},
"required": [
"inn"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_get_document
Документ СБИС по ID. Только чтение. Возвращает: объект документа.
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Идентификатор документа"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_get_document_link
Ссылка на документ в веб-интерфейсе СБИС. Только чтение. Возвращает: текст-ссылку.
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Идентификатор документа"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_list_attachments
Вложения документа СБИС. Только чтение. Скачать — saby_download_attachment. Возвращает: массив вложений или текст «Вложения не найдены».
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"description": "ID документа"
}
},
"required": [
"documentId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_list_certificates
Сертификаты электронной подписи пользователя в СБИС. Только чтение. Отпечаток нужен для saby_prepare_action/подписания. Возвращает: массив сертификатов или текст «Сертификаты не найдены».
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_list_changes
Список изменений документов СБИС с указанной даты (для инкрементального поллинга). Только чтение. Возвращает: массив изменений или текст «Изменений нет».
{
"type": "object",
"properties": {
"dateFrom": {
"type": "string",
"description": "Дата начала (ISO)"
},
"eventId": {
"description": "ID последнего обработанного события (для инкрементального поллинга)",
"type": "string"
}
},
"required": [
"dateFrom"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_list_contragents
Список контрагентов СБИС с пагинацией. Только чтение. Поиск по ИНН/названию — saby_find_contragent. Возвращает: массив контрагентов или текст «Контрагенты не найдены».
{
"type": "object",
"properties": {
"orgInn": {
"description": "ИНН организации для фильтрации",
"type": "string"
},
"orgKpp": {
"description": "КПП организации",
"type": "string"
},
"page": {
"description": "Номер страницы (с 0)",
"type": "number"
},
"pageSize": {
"description": "Размер страницы (по умолчанию 50)",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_list_documents
Список документов СБИС по типу, фильтр по дате документа. Только чтение. Для входящих/исходящих как в ЛК — saby_list_events. Коды типов см. в параметре type. Возвращает: массив документов или текст «Документы не найдены».
{
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "Код типа документа СБИС: ДокОтгрИсх, ДокОтгрВх, ДоговорИсх, ДоговорВх, СчетИсх, СчетВх, ФактураИсх, ФактураВх, АктСверИсх, АктСверВх, КоррИсх, КоррВх, ЗаказИсх, ЗаказВх, SimpleDoc, CorrIn, CorrOut, ConsignmentNote, ReturnIn, ReturnOut, DeviationActIn, DeviationActOut"
},
"direction": {
"description": "Направление",
"type": "string",
"enum": [
"Входящий",
"Исходящий"
]
},
"dateFrom": {
"description": "Дата начала (ISO)",
"type": "string"
},
"dateTo": {
"description": "Дата конца (ISO)",
"type": "string"
},
"page": {
"description": "Номер страницы (с 0)",
"type": "number"
},
"pageSize": {
"description": "Размер страницы (по умолчанию 20, макс 200)",
"type": "number"
}
},
"required": [
"type"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_list_events
Реестр входящих/отправленных документов СБИС как в личном кабинете. Основной просмотр. Только чтение. Фильтр по дате события (получения/отправки). Фильтр по дате документа и типу — saby_list_documents. Возвращает: массив событий или текст «Документы не найдены».
{
"type": "object",
"properties": {
"section": {
"type": "string",
"enum": [
"Входящие",
"Отправленные"
],
"description": "Раздел реестра"
},
"dateFrom": {
"description": "Дата начала (ISO)",
"type": "string"
},
"dateTo": {
"description": "Дата конца (ISO)",
"type": "string"
},
"page": {
"description": "Номер страницы (с 0)",
"type": "number"
},
"pageSize": {
"description": "Размер страницы (по умолчанию 25, макс 200)",
"type": "number"
}
},
"required": [
"section"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_list_organizations
Список организаций пользователя в СБИС. Только чтение. Если данные устарели — saby_refresh_organizations. Возвращает: массив организаций или текст «Организации не найдены».
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_match_organization
Сопоставить организацию в СБИС по ИНН и КПП. Только чтение. Возвращает: однозначное совпадение либо список кандидатов (филиалы).
{
"type": "object",
"properties": {
"inn": {
"type": "string",
"description": "ИНН организации"
},
"kpp": {
"description": "КПП (для уточнения при нескольких филиалах)",
"type": "string"
}
},
"required": [
"inn"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_prepare_action
Подготовить действие над документом СБИС (подписание/отправка): какие подписи нужны. Шаг 1 перед saby_execute_action. Само действие здесь не выполняется. Возвращает: объект с требуемыми подписями.
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"description": "ID документа"
},
"action": {
"type": "string",
"description": "Действие (например: Подписать, Отправить, Отклонить)"
},
"certificateThumbprint": {
"description": "Отпечаток сертификата для подписания",
"type": "string"
}
},
"required": [
"documentId",
"action"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_read_attachment
Метаданные вложения документа СБИС. Только чтение. Содержимое файла — saby_download_attachment. Возвращает: объект метаданных вложения.
{
"type": "object",
"properties": {
"documentId": {
"type": "string",
"description": "ID документа"
},
"attachmentId": {
"type": "string",
"description": "ID вложения"
}
},
"required": [
"documentId",
"attachmentId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_read_contragent
Полные данные контрагента в СБИС по ИНН. Только чтение. Возвращает: объект контрагента.
{
"type": "object",
"properties": {
"inn": {
"type": "string",
"description": "ИНН контрагента"
},
"kpp": {
"description": "КПП",
"type": "string"
}
},
"required": [
"inn"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_read_organization
Полные данные организации в СБИС по ИНН. Только чтение. Возвращает: объект организации.
{
"type": "object",
"properties": {
"inn": {
"type": "string",
"description": "ИНН организации"
},
"kpp": {
"description": "КПП",
"type": "string"
}
},
"required": [
"inn"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_refresh_organizations
Перечитать организации СБИС с сервера и обновить кеш. Возвращает: массив организаций или текст «Организации не найдены».
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_reject_document
⚠ Outward-facing: отклоняет документ в ЭДО СБИС (видно контрагенту). Возвращает: текст «Документ отклонён».
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Идентификатор документа"
},
"comment": {
"description": "Причина отклонения",
"type": "string"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_resolve
Канонизированные данные сущности СБИС по типу и ИНН. Только чтение. Возвращает: объект с канонизированными полями.
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"counterparty",
"organization"
],
"description": "Тип сущности"
},
"id": {
"type": "string",
"description": "ИНН контрагента (используется как идентификатор в СБИС)"
}
},
"required": [
"type",
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_restore_document
Восстановить удалённый документ в СБИС (отмена saby_delete_document). Возвращает: текст «Документ восстановлен».
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Идентификатор документа"
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_search
Поиск сущности (контрагент/организация) в СБИС по ИНН с канонизацией полей. Только чтение. Сырой поиск контрагента — saby_find_contragent; канонизация по ИНН — saby_resolve. Возвращает: массив с канонизированными полями или текст «Не найдено».
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"counterparty",
"organization"
],
"description": "Тип сущности"
},
"query": {
"type": "string",
"description": "ИНН для поиска (10-12 цифр)"
}
},
"required": [
"type",
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_send_invitation
⚠ Outward-facing: отправляет контрагенту приглашение в ЭДО через СБИС. Возвращает: объект результата.
{
"type": "object",
"properties": {
"contragent": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Контрагент (СвЮЛ: { ИНН, КПП, Название } или СвФЛ: { ИНН, ФИО })"
}
},
"required": [
"contragent"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_status
Статус подключения интеграции СБИС (Saby) и число организаций. Только чтение. Возвращает: текст «подключён (N организаций)» / «не подключён».
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}saby_write_contragent
⚠ Outward-facing: создаёт или обновляет контрагента во внешней системе СБИС. Возвращает: объект результата.
{
"type": "object",
"properties": {
"contragent": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Объект контрагента (СвЮЛ: { ИНН, КПП, Название } или СвФЛ: { ИНН, ФИО })"
}
},
"required": [
"contragent"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}