@frihet/mcp-server

Перечисляет HR, операционные и финансовые аномалии, обнаруженные системой. Фильтрует по типу (duplicate_clock_in, overtime_spike, missing_clock_out, expense_outlier и т.д.), серьезности (низкая/средняя/высокая/критическая) или периоду. Полезно для ежедневной проверки HR и аудитов соответствия. / Перечисляет обнаруженные аномалии (HR/операционные/финансовые) с опциональными фильтрами.

Применяет депозит к счёту-фактуре или помечает его как использованный. Переводит статус депозита в 'applied'. Пример: id='dep_abc123', invoiceId='inv_xyz' / Применяет депозит к счёту-фактуре или помечает его как использованный.

Применяет проценты за просрочку к просроченному счёту. Рассчитывает проценты на основе Директивы ЕС о просрочке платежа (8% по умолчанию) или автоматически рассчитывает по дням просрочки. Создаёт дебет-ноту, привязанную к исходному счёту. / Начисляет проценты за просрочку по просроченному счёту. Рассчитывает проценты согласно Европейской директиве о просрочке (8% по умолчанию) или автоматически рассчитывает по дням задержки. Создаёт дебет-ноту, привязанную к исходному счёту.

Регистрирует отметку о начале рабочего дня сотрудника. Опционально фиксирует настроение (отслеживание самочувствия сотрудника) и местоположение (удалённая работа/офис/объект). Возвращает запись посещаемости со статусом 'open'. Используйте вместе с attendance_clock_out для закрытия записи. / Регистрирует отметку о приходе. Опционально фиксирует настроение и местоположение.

Закрывает открытую запись учёта посещаемости. Отмечает clockOutAt и вычисляет durationMinutes. Идемпотентность: отметка о выходе для уже закрытой записи не даёт эффекта. / Закрывает открытую запись отметки. Вычисляет продолжительность в минутах.

Применяет категорию к банковской транзакции для ручной классификации. Категории сопоставляются с категориями расходов для отслеживания налоговых вычетов. Пример: id='tx_abc', category='supplies', notes='Office paper Q1' / Присваивает категорию банковской транзакции. Категории сопоставляются с категориями расходов для контроля налоговых вычетов.

Создает нового клиента/заказчика. Требуется как минимум имя. Клиенты используются при создании счетов и предложений. Пример: name='Acme Corp', email='billing@acme.com', taxId='B12345678', address={street:'Main St 1', city:'Madrid', country:'ES'} / Создает нового клиента. Требуется как минимум имя. Клиенты используются при создании счетов и предложений.

Добавляет новое контактное лицо клиенту. Требуется как минимум имя. Пример: clientId='abc123', name='Ana Garcia', email='ana@acme.com', role='CTO', isPrimary=true / Добавляет новый контакт клиенту. Требуется как минимум имя.

Добавляет заметку клиенту. Заметки - свободные текстовые записи, которые помогают сохранять контекст. Не включайте пароли, учётные данные, данные платёжных карт, медицинские данные или официальные/государственные идентификаторы. Пример: clientId='abc123', content='Предпочитает счета на английском языке. Оплата NET 30.' / Добавляет заметку клиенту. Не включайте пароли, учётные данные, данные карт, медицинские данные или официальные идентификаторы.

Создаёт кредит-ноту (фактуру-ректификативу) для существующего счёта. Отменяет весь счёт или его часть для соблюдения требований. Испанский рынок: генерирует ректификативу R1-R5, совместимую с VeriFactu. Другие рынки: стандартная кредит-нота с отрицательными суммами.

Записывает новый депозит от клиента. Требует clientId и сумму. Полезно для отслеживания авансовых платежей, предоплат и гарантийных депозитов. Пример: clientId='abc123', amount=500, currency='EUR', description='Project retainer' / Регистрирует новый депозит клиента. Требует clientId и сумму. Полезно для авансов, удержаний и гарантийных депозитов.

Записывает новый расход. Требуются описание и сумма. Полезен для отслеживания бизнес-расходов, вычитаемых расходов и платежей поставщикам. Пример: description='Office supplies', amount=49.99, category='office', vendor='Amazon', taxDeductible=true, paidDate='2026-03-15' / Записывает новый расход. Требуются описание и сумма. Полезен для отслеживания затрат, вычитаемых расходов и платежей поставщикам.

Создаёт новый счёт. Требует имя клиента и хотя бы одну позицию. Номер счёта генерируется автоматически. По умолчанию статус — черновик, дата — сегодня. Пример: clientName='Acme Corp', items=[{description:'Consulting', quantity:10, unitPrice:150}], taxRate=21, irpfRate=15 / Создаёт новый счёт. Требует имя клиента и хотя бы одну позицию. Номер генерируется автоматически. По умолчанию статус — черновик, дата — сегодня. Поддерживает удержание IRPF (для самозанятых в Испании), эквивалентный сбор, серию, аванс и глобальную скидку.

Создаёт новый продукт или услугу в каталоге. Требуется название и цена за единицу. Продукты можно использовать при создании счетов и предложений для более быстрого ввода данных. Пример: name='Web Design', unitPrice=1500, taxRate=21, description='Full website redesign' / Создаёт новый продукт или услугу в каталоге. Требуется название и цена за единицу. Продукты можно использовать при создании счетов и смет для быстрого ввода данных.

Создает новую смету/оценку для клиента. Требует имя клиента и хотя бы одну позицию. Сметы можно позже преобразовать в счета. По умолчанию статус 'черновик'. Пример: clientName='Acme Corp', items=[{description:'Design', quantity:1, unitPrice:3000}], validUntil='2026-04-30' / Создает новую смету. Требует имя клиента и хотя бы одну позицию. Сметы можно позже преобразовать в счета.

Создаёт новый шаблон регулярного счёта. Указывает частоту (ежедневно/еженедельно/ежемесячно/ежеквартально/ежегодно), клиента-получателя, строки и опциональную дату начала. Первый экземпляр счёта генерируется в ближайшую запланированную дату выполнения. Пример: clientId='cli_abc', frequency='monthly', templateName='Servicio mensual', lineItems=[{description:'SaaS', quantity:1, unitPrice:299}] / Создаёт новый шаблон регулярного счёта. Указывает частоту, клиента-получателя, строки и опциональную дату начала. Первый экземпляр генерируется в ближайшую запланированную дату.

Создаёт новую бронь вручную (не через синхронизацию каналов). Требует идентификатор объекта, даты заезда/выезда и количество гостей. При необходимости укажите идентификатор гостя или встроенные данные гостя для создания нового гостя. / Создаёт новую бронь вручную. Требует объект, даты и количество гостей.

Записывает временную запись для проекта. Требуются projectId, часы (десятичные) и дата. Установите billable=true, чтобы включить в выставление счетов клиенту. Пример: projectId='proj_abc', hours=2.5, description='Frontend review', billable=true, date='2026-05-10' / Записывает временную запись для проекта. Требуются projectId, часы (десятичные) и дата. Установите billable=true, чтобы включить в выставление счетов клиенту.

Создаёт нового поставщика/вендора. Требует как минимум название. Поставщики используются при отслеживании расходов и заказов на покупку. Пример: name='Office Supplies Ltd', email='billing@office.com', taxId='B87654321', address={street:'Gran Via 1', city:'Madrid', country:'ES'} / Создаёт нового поставщика. Требует как минимум имя. Поставщики используются при регистрации расходов и заказов на покупку.

Регистрирует именованную конечную точку webhook. Необходимо указать имя, URL и события, для которых нужно получать уведомления, а также события, на которые следует подписаться. Доступные события: invoice.created, invoice.updated, invoice.paid, expense.created, expense.updated, client.created, client.updated, quote.created, quote.updated, quote.accepted. Пример: name='Invoice events', url='https://example.com/webhook', events=['invoice.created','invoice.paid'], secret='my-secret' / Регистрирует новую конечную точку webhook. Указывает URL и события для подписки.

Окончательно удаляет клиента по его ID. Это действие нельзя отменить. Предупреждение: это может повлиять на существующие счета и сметы, связанные с этим клиентом.

Навсегда удаляет контакт из клиента. Это действие не может быть отменено. / Навсегда удаляет контакт из клиента. Это действие не может быть отменено.

Окончательно удаляет заметку у клиента. Это действие нельзя отменить. / Окончательно удаляет заметку у клиента. Это действие нельзя отменить.

Навсегда удаляет депозит по его ID. Это действие невозможно отменить. / Навсегда удаляет депозит по его ID. Это действие отменить нельзя.

Удаляет расход навсегда по его ID. Это действие нельзя отменить. / Удаляет расход навсегда по его ID. Это действие нельзя отменить.

Удаляет счет по его ID. Требует confirm=true. Только счет в статусе ЧЕРНОВИК удаляется навсегда. Отправленный/оплаченный/просроченный счет НЕ уничтожается: серверная часть ОТМЕНЯЕТ его (status=cancelled), чтобы цепочка хэшей VeriFactu осталась нетронутой, и документ остается читаемым через get_invoice. Результат сообщает, что именно произошло, в outcome ("deleted" или "cancelled"). / Удаляет счет по его ID. Требует confirm=true. Только счет в статусе ЧЕРНОВИК удаляется навсегда. Выставленный/оплаченный счет НЕ уничтожается: он ОТМЕНЯЕТСЯ (status=cancelled), чтобы сохранить цепочку хэшей VeriFactu, и остается читаемым через get_invoice.

Удаляет товар навсегда по его ID. Это действие нельзя отменить.

Удаляет расценку по её ID. Требует confirm=true. ТОЛЬКО чистый черновик без признаков доставки, ответа, вложений или конверсии удаляется безвозвратно; защищённый черновик отклоняется и остаётся без изменений. Отправленная/принятая/отклонённая/истёкшая расценка НЕ уничтожается: бэкенд ОТМЕНЯЕТ её (status=cancelled) по тому же неразрушающему пути, что и счета, и она остаётся доступной для чтения через get_quote. В результате в outcome сообщается, что произошло ("deleted" или "cancelled"). / Удаляет расценку по её ID. Требует confirm=true. ТОЛЬКО чистый черновик без признаков доставки, ответа, вложений или конверсии удаляется безвозвратно; защищённый черновик отклоняется и остаётся без изменений. Отправленная/принятая/отклонённая/истёкшая расценка НЕ уничтожается: бэкенд ОТМЕНЯЕТ её (status=cancelled) по тому же неразрушающему пути, что и счета, и она остаётся доступной для чтения через get_quote. В результате в outcome сообщается, что произошло ("deleted" или "cancelled").

Удаляет шаблон recurring-инвойса навсегда. Это НЕ удаляет уже созданные инвойсы — только сам шаблон и запланированные повторные запуски. Требуется confirm=true, чтобы предотвратить случайное удаление.

Мягко удаляет запись времени по ID. Требуется confirm=true для предотвращения случайного удаления. Удалённые записи исключаются из отчётов по биллингу, но сохраняются для аудита. / Удаляет (soft-delete) запись времени по её ID. Требует confirm=true для предотвращения случайных удалений. Удалённые записи исключаются из отчётов по биллингу, но сохраняются для аудита.

Навсегда удаляет поставщика по его ID. Это действие нельзя отменить. Предупреждение: это может повлиять на существующие расходы, ссылающиеся на этого поставщика. / Навсегда удаляет поставщика по его ID. Это действие нельзя отменить. Предупреждение: это может повлиять на существующие расходы, ссылающиеся на этого поставщика.

Навсегда удаляет вебхук по его ID. Уведомления прекратятся немедленно.

Дублирует существующий счёт для нового периода. Копирует все позиции, данные клиента, налоговую ставку и примечания. Удаляет исходный идентификатор, номер документа, статус и временные метки. Новый счёт начинается как 'черновик' с сегодняшней датой (или указанной датой). Идеально подходит для повторяющихся счетов - дублируйте счёт за прошлый месяц и скорректируйте при необходимости. / Дублирует существующий счёт для нового периода. Копирует позиции, клиента, налоги и примечания. Новый счёт начинается как 'черновик' с сегодняшней датой.

Экспортирует счет-фактуру как XML электронного счета-фактуры в указанном формате. Поддерживает Facturae (ES B2G), XRechnung-CII (DE), XRechnung-UBL (DE), профили Factur-X (FR), FatturaPA (IT), PEPPOL-BIS-3 (EU network), UBL и CII (общие). Для Facturae установите signed=true, чтобы получить XML с подписью XAdES для отправки в FACe/AEAT. Возвращает подписанный URL для скачивания, действительный в течение 24 часов.

Экспортирует бухгалтерские данные в формате DATEV EXTF для импорта в DATEV Kanzlei-Rechnungswesen или совместимые системы. Возвращает подписанный URL для скачивания, действительный в течение 24 часов. Поддерживаемые форматы EXTF: • extf-buchungsstapel - проводки журнала (Buchungsstapel) - самый распространённый, используйте для отчёта о прибылях и убытках/налогов • extf-debitoren - данные дебиторской задолженности (Debitoren-/Kreditorenstamm AR) • extf-kreditoren - данные кредиторской задолженности (Debitoren-/Kreditorenstamm AP) Кодировка вывода всегда CP1252 согласно спецификации DATEV EXTF. Диапазон дат: periodStart и periodEnd должны быть датами в формате ISO 8601 (ГГГГ-ММ-ДД). Если бэкенд экспорта DATEV не развёрнут для этого рабочего пространства, возвращает честный ответ 'unavailable' - никогда не подделывает URL файла.

Опрашивает статус подачи счета FACe (Испания B2G). Возвращает текущий код состояния портала FACe, описание и номер registro. Распространенные коды состояния FACe: • 1200 — Registrada / Registered (подача получена) • 1300 — En proceso de contabilización / In accounting (обрабатывается) • 1400 — Contabilizada / Accounted (учтена, ожидает оплаты) • 2400 — Anulada / Cancelled • 3100 — Rechazada / Rejected (проверьте rejectionReason) / Consulta el estado de un envío a FACe. Devuelve el código de estado, descripción y número de registro.

Отправляет счёт в формате Facturae на испанский портал FACe (Punto General de Entrada de Facturas Electrónicas) B2G. В счёте должен быть указан получатель с кодами административных единиц DIR3 (órgano gestor, unidad tramitadora, oficina contable). Возвращает номер регистрации (registro), который можно использовать с face_status для опроса портала. Режимы: • mock — только локальная симуляция, без сетевых вызовов (безопасно для разработки/тестирования) • sandbox — тестовый стенд FACe (требуются учётные данные для sandbox) • production — рабочий SOAP-эндпоинт FACe (по умолчанию) / Отправляет счёт Facturae на портал FACe испанского государства. Требует коды DIR3 у получателя (órgano gestor, unidad tramitadora, oficina contable). Возвращает номер регистрации для запроса статуса с помощью face_status.

Рассчитывает AIEM (Arbitrio sobre Importaciones y Entrega de Mercancias) для товаров, импортируемых или производимых на Канарских островах. Возвращает применимую ставку AIEM, налоговую базу и сумму к уплате для указанного продукта. AIEM - канарская надбавка к IGIC для защиты местных производств. Пример: ncCode='8471', amount=1000, description='Ordenadores portatiles'. / Рассчитывает AIEM для товаров, импортируемых или производимых на Канарских островах. Возвращает применимую ставку, налоговую базу и сумму. AIEM защищает местную канарскую промышленность.

Создайте новое правило автоматической категоризации банковских транзакций. Правила применяются автоматически к подходящим входящим транзакциям. Правило состоит из условий (логика И) и действий (присвоить категорию, тег или клиента). Пример: name='Mercadona groceries', условие description содержит 'MERCADONA', действие category='groceries'. / Создайте новое правило автоматической категоризации банковских транзакций. Правила применяют условия (логика И) и действия (категория, тег, клиент).

Перечисляет все правила автоматической категоризации банковских транзакций для workspace. Правила автоматически категоризируют транзакции, соответствующие условиям (описание, сумма, контрагент). Возвращает имя правила, условия, действия (категория/тег/назначение клиента) и статус активности. / Перечисляет правила автоматической категоризации банковских транзакций workspace. Возвращает имя, условия, действия (категория/тег/клиент) и активный статус.

Утверждает проводку в Главной книге, ожидающую проверки. Устанавливает статус проводки 'approved' и записывает утверждающего + временную метку в журнал аудита. Требует роль gestor/admin. Это действие из ОБЛАСТИ ДОВЕРИЯ — перепроверьте ID проводки перед вызовом. Пример: entryId='gl_2026_q1_042'. / Утверждает проводку, ожидающую проверки. Требует роль gestor/admin. Действие из области доверия.

Получает полную историю аудита для записи Главной книги — все переходы состояний (создано, отправлено, утверждено, отклонено), кто действовал и когда. Используйте это для проверки истории утверждений или аудита соответствия. Пример: entryId='gl_2026_q1_042'. / Получает полную историю аудита бухгалтерской записи. Показывает все переходы состояний, кто действовал и когда.

Отклоняет проводку Главной книги, ожидающую проверки, с обязательным указанием причины. Устанавливает статус проводки 'rejected' и записывает отклонившего + причину в аудиторский след. Требует роль gestor/admin. Это действие TRUST AREA. Пример: entryId='gl_2026_q1_042', reason='Importe incorrecto, revisar factura F-2026-042'. / Отклоняет ожидающий бухгалтерский асъенто с обязательной причиной. Требует роль gestor/admin.

Получает сводку предполагаемого платежа IRPF для подачи Modelo 130 (для фрилансеров/самозанятых в Испании). Возвращает квартальный чистый доход, вычитаемые расходы, предыдущие платежи и сумму к уплате. Пример: period='2026-Q1' / Получает сводку авансового платежа IRPF по Modelo 130 (для самозанятых). Возвращает чистый доход, вычитаемые расходы, предыдущие платежи и сумму к уплате.

Получает годовую информационную сводку по удержаниям из арендного дохода для IRPF (Modelo 180, Испания). Возвращает общие удержания по каждому арендатору, объекту недвижимости и годовой итог. Пример: period='2025' / Получает годовую сводку удержаний по аренде для Modelo 180. Возвращает общие удержания по арендатору, объекту недвижимости и годовой итог.

Получает сводку Modelo 200 — годовую декларацию по налогу на прибыль (Impuesto sobre Sociedades) для испанских SL и SA. Возвращает налогооблагаемую базу, вычеты, налоговую ставку, удержания, произведённые авансовые платежи (M202) и итоговую сумму к уплате/возврату. Срок подачи: 25 дней после 6 месяцев с конца финансового года (обычно 25 июля для декабря). Пример: year='2025'. / Сводка Modelo 200 — годовая декларация Impuesto sobre Sociedades для SL/SA. Возвращает налогооблагаемую базу, вычеты, ставку, удержания, авансовые платежи и сумму.

Получает сводку Modelo 202 — рассрочка платежей (pagos fraccionados) для Impuesto sobre Sociedades. Три ежегодных платежа: апрель (1P), октябрь (2P), декабрь (3P). Возвращает сумму каждого платежа, дату оплаты, статус платежа и совокупную сумму по сравнению с прогнозом M200. Пример: год='2026', платеж='1P'. / Краткое описание Modelo 202 — pagos fraccionados Impuesto sobre Sociedades. Три срока: апрель (1P), октябрь (2P), декабрь (3P). Возвращает суммы, сроки и статус платежа.

Получает квартальную сводку по IVA (НДС) для подачи Modelo 303 в Испании. Возвращает суммарные итоги по налоговым ставкам, НДС к вычету, сумму к уплате и срок подачи. Пример: period='2026-Q1' / Получает квартальную сводку по IVA для Modelo 303 в Испании. Возвращает суммарные итоги по налоговым ставкам, вычитаемый IVA, сумму к уплате и срок подачи.

Получает годовой информативный свод операций, превышающих €3 005 на одного контрагента (Modelo 347, Испания). Возвращает итоги по каждому контрагенту для клиентов и поставщиков, превышающих порог. Пример: period='2025' / Получает годовой свод операций с третьими лицами, превышающих 3 005 € (Modelo 347). Возвращает итоги по каждому клиенту/поставщику, превышающему порог.

Получает годовой сводный отчёт по IVA для подачи Modelo 390 в Испании. Возвращает итоги за год по ставкам, общий вычитаемый IVA и годовой баланс. Пример: period='2025' / Получает годовой сводный отчёт по IVA для Modelo 390. Возвращает годовые итоги по типу, общий вычитаемый IVA и годовой результат.

Получает сводку IGIC Modelo 415 — годовую декларацию об операциях с третьими лицами, превышающих €3 005. Канарский эквивалент Modelo 347 (полуостровная Испания). Возвращает список контрагентов, итоги операций и срок подачи. Пример: year='2025'. / Сводка Modelo 415 IGIC — годовая декларация об операциях с третьими лицами > €3 005. Канарский эквивалент Modelo 347. Возвращает список контрагентов, итоги и срок.

Получает сводку IGIC Modelo 418 — ежемесячная декларация IGIC для крупных предприятий (grandes empresas) на Канарских островах. Возвращает ежемесячный собранный IGIC, вычитаемый IGIC, чистую сумму к уплате и любой перенос. Применяется, когда годовой оборот превышает порог grandes empresas. Пример: period='2026-04'. / Сводка Modelo 418 IGIC — ежемесячная декларация для крупных предприятий на Канарских островах. Возвращает IGIC repercutido, soportado, cuota a ingresar y saldo a compensar.

Получает сводку IGIC Modelo 425 — годовую сводку IGIC для предприятий Канарских островов. Возвращает совокупный собранный IGIC, вычитаемый IGIC, чистую сумму к уплате и статус подачи. Пример: year='2025'. / Сводка Modelo 425 IGIC — годовая сводка IGIC для предприятий Канарских островов. Возвращает начисленный IGIC, вычитаемый IGIC, чистую квоту и статус подачи.

Добавляет кастомный домен в клиентский портал Frihet для брендирования. Возвращает DNS-записи (CNAME), которые нужно настроить у регистратора до верификации. Пример: domain='portal.miempresa.com'.

Удаляет пользовательский домен из клиентского портала Frihet. Портал вернётся к стандартному поддомену Frihet. Пример: domain='portal.miempresa.com'. / Удаляет пользовательский домен из клиентского портала Frihet. Портал вернётся к стандартному поддомену Frihet.

Проверяет распространение DNS для пользовательского домена портала, добавленного через frihet_portal_domain_add. Возвращает статус проверки (pending/verified/failed) и любые ошибки DNS. Распространение DNS может занимать до 48 часов — повторите попытку, если статус 'pending'. Пример: domain='portal.miempresa.com'. / Проверяет распространение DNS пользовательского домена портала. Возвращает статус (pending/verified/failed). Распространение может занимать до 48 часов.

Генерирует временную одноразовую ссылку-приглашение для самостоятельной регистрации потенциального клиента. Клиент переходит по ссылке, чтобы зарегистрировать данные своей компании (CIF, адрес, контакт) без необходимости ручного ввода данных управляющим. Требуется роль gestor/admin. Пример: email='cliente@empresa.com', expiresInHours=72. / Генерирует ссылку для самостоятельной регистрации потенциального клиента. Клиент заполняет свои данные без необходимости ручного ввода со стороны gestor. Требуется роль gestor/admin.

Проверяет номер НДС ЕС (CIF intracomunitario) через систему VIES (VAT Information Exchange System). Возвращает название компании, адрес и статус действительности из официального реестра ЕС. Необходим для соблюдения требований внутриевропейского выставления счетов — всегда проверяйте перед добавлением клиента из ЕС. Пример: vatNumber='ES12345678A', countryCode='ES'. / Проверяет внутриевропейский номер НДС (CIF) через систему VIES ЕС. Возвращает название, адрес и статус действительности из официального европейского реестра.

Получает отчет по старению дебиторской задолженности, объединяющий данные всех клиентов управляющего — общие суммы по категориям (текущая / 30–60 / 60–90 / 90+ дней просрочки), разбивка по рабочему пространству и топ просроченных счетов. По умолчанию работает для аутентифицированного управляющего; передайте ownerUid, чтобы запросить данные для конкретного управляющего (требуется расширенный уровень доступа). Полезно для приоритизации взысканий и составления списков для напоминаний в конце месяца. / Obtiene un informe de antiguedad de saldos cruzando todos los clientes del gestor — totales por tramo (al dia / 30-60 / 60-90 / 90+ dias), desglose por espacio y top vencidas. Util para priorizar reclamaciones y listas de cobro de fin de mes.

Отправляет сообщение в контекстном потоке между гестором (бухгалтером) и клиентом. Потоки привязываются к запросу документа, элементу подачи или фискальному обязательству — контекст сохраняется, поэтому обе стороны видят, о чём сообщение. Полезно для запроса недостающего документа, ответа на вопрос клиента или комментирования презентации. Пример: workspaceId='ws_abc', parentType='documentRequest', parentId='dr_q3_iva', body='Не хватает банковской выписки за сентябрь'. / Отправляет сообщение в контекстном потоке между гестором и клиентом. Потоки привязываются к запросу документа, презентации или фискальному обязательству — обе стороны видят, к чему относится сообщение. Полезно для запроса документов, ответа на вопросы или комментирования презентаций.

Выводит список сообщений в треде gestor/cliente, начиная с самых новых. Использует before (идентификатор сообщения или временная метка ISO) для пагинации назад по истории. Возвращает до limit сообщений плюс флаг hasMore, чтобы агент знал, когда остановиться.

Отправляет один и тот же шаблон запроса документа до 500 клиентских рабочих пространств за один вызов. Каждый созданный запрос запускает обработчик уведомлений для каждого клиента (email + в приложении). Соблюдает allowGestoriaCommunications=false в документе пользователя клиента (отказ). Использует periodOverrides для подстановки значений времени выполнения (квартал/год/месяц) в переменные шаблона. Возвращает результат для каждого клиента с количеством успехов, ошибок и общей продолжительностью по стене. Область соответствия: RGPD: получатели уже должны предоставить доступ бухгалтеру. Пример: templateId='tpl_iva_q', clientWorkspaceIds=['ws_a','ws_b','ws_c'], periodOverrides={quarter:3, year:2026}. / Отправляет тот же шаблон до 500 клиентских пространств за одну операцию. Уважает отказ allowGestoriaCommunications=false.

Создаёт reusable шаблон запроса документа, который gestor может массово отправлять в несколько рабочих пространств клиентов. Тело шаблона поддерживает интерполяцию переменных в виде обычного текста (например, {{quarter}}, {{year}}). dueDateOffsetDays задаёт срок выполнения запроса относительно даты массовой отправки. attachmentRequired=true требует от клиентов загрузить файл перед отметкой о выполнении. Пример: name='НДС квартальный', title='Документация НДС {{quarter}}/{{year}}', description='Приложите банковские выписки и выставленные счета за {{quarter}}', dueDateOffsetDays=14, attachmentRequired=true. / Создаёт reusable шаблон запроса документа, который gestor может массово отправлять в несколько рабочих пространств клиентов.

Получает один подключённый банковский счёт по ID. Возвращает alias, IBAN (последние 4 цифры), валюту, текущий баланс и метку времени последней синхронизации. / Получает один подключённый банковский счёт по ID. Возвращает alias, IBAN (последние 4 цифры), валюту, текущий баланс и метку времени последней синхронизации.

Получает полный контекст бизнеса — профиль, настройки по умолчанию, лимиты тарифа, недавнюю активность, основных клиентов и сводку за текущий месяц. Вызывайте этот инструмент ПЕРВЫМ в любой сессии, чтобы понять бизнес пользователя. Возвращает всё, что нужно ИИ-агенту для оказания персонализированной помощи без многократных запросов. / Получает полный контекст бизнеса — профиль, лимиты тарифа, недавнюю активность, основных клиентов и сводку за текущий месяц. Вызовите это ПЕРВЫМ в любой сессии.

Получает одного клиента по его ID. Возвращает полные контактные данные. / Получает клиента по его ID. Возвращает все контактные данные.

Получает один депозит по его ID. / Получает один депозит по его ID.

Опрашивает статус рабочего процесса отправки электронного счета. Возвращает текущий шаг, ack ID (сетевое подтверждение) и URL-адреса для загрузки после завершения. Опрашивайте каждые 5–10 секунд, пока статус не станет 'succeeded', 'failed' или 'cancelled'. Если серверная часть статуса не развернута для этого рабочего пространства, возвращает честный ответ 'unavailable' - никогда не выдуманный статус. / Запрашивает статус рабочего процесса отправки электронного счета. Возвращает текущий шаг, ack ID (сетевое подтверждение) и URL-адреса для загрузки после завершения. Опрашивайте каждые 5–10 секунд, пока статус не станет 'succeeded', 'failed' или 'cancelled'. Если серверная часть статуса не развернута для этого рабочего пространства, возвращает честный ответ 'unavailable' - никогда не выдуманный статус.

Получает один расход по его ID. / Получает один расход по его ID.

Получает один счет по его ID. Возвращает полный счет, включая строки счета, итоги и статус. / Получает счет по его ID. Возвращает полный счет, включая позиции, итоги и статус.

Скачивает сохранённый артефакт электронного счёта для инвойса. XML-форматы возвращают строгий UTF-8-текст в поле xml; Factur-X возвращает байты application/pdf, закодированные в base64. Оба включают id, contentType и sizeBytes. XML больше 5 МиБ или PDF больше 25 МиБ отклоняется с ошибкой 413 payload_too_large. Доступно только после сохранения или отправки инвойса. / Скачивает сохранённый артефакт электронного счёта. XML-форматы возвращают строгий UTF-8-текст в поле xml; Factur-X возвращает байты application/pdf, закодированные в base64. Оба включают id, contentType и sizeBytes. XML больше 5 МиБ или PDF больше 25 МиБ отклоняется с ошибкой 413 payload_too_large. Доступно только после сохранения или отправки счёта.

Получает PDF для счёта. Тело передаётся как необработанные байты application/pdf, закодированные в base64 в поле base64, вместе с sizeBytes и contentType. PDF размером более 25 MiB отклоняются с ошибкой 413 payload_too_large. / Получает PDF счёта. Тело передаётся как необработанные байты application/pdf, закодированные в base64 в поле base64, вместе с sizeBytes и contentType. PDF размером более 25 MiB отклоняются с ошибкой 413 payload_too_large.

Получает один кухонный заказ по ID. Возвращает полные сведения о заказе, включая все позиции, их индивидуальные статусы, назначенную станцию и ссылку на стол. / Получает один кухонный заказ по ID. Возвращает все детали: позиции, индивидуальные статусы, назначенную станцию и ссылку на стол.

Получает сводку расчетного платежа IRPF для подачи Modelo 130 (фрилансеры/самозанятые в Испании). Возвращает квартальный чистый доход, вычитаемые расходы, предыдущие платежи и сумму к уплате. Пример: period='2026-Q1'

Получает ежегодную информационную сводку по удержаниям из арендного дохода (Modelo 180, Испания). Возвращает общие удержания по арендатору, объекту недвижимости и годовую сводку. Пример: period='2025'

Получает квартальную сводку по НДС (IVA) для подачи Модели 303 в Испании. Возвращает агрегированные итоги по налоговой ставке, вычитаемый НДС, чистую сумму к уплате и срок подачи. Пример: period='2026-Q1' / Получает квартальный отчет по НДС для Модели 303 в Испании. Возвращает общие суммы по налоговой ставке, вычитаемый НДС, сумму к уплате и срок подачи. Пример: period='2026-Q1'

Получает ежегодную информативную сводку операций, превышающих 3 005 € на контрагента (Modelo 347, Испания). Возвращает итоги по каждому участнику для клиентов и поставщиков, превышающих порог. Пример: period='2025' / Получает ежегодную сводку операций с третьими лицами, превышающих 3 005 € (Modelo 347). Возвращает итоги по клиенту/поставщику, превышающие порог. Пример: period='2025'

Получает годовую сводку по IVA для подачи Modelo 390 в Испании. Возвращает годовые итоги по ставкам, общий вычитаемый IVA и годовой баланс. Пример: period='2025' / Получает годовую сводку по IVA для Modelo 390. Возвращает годовые итоги по типам, общий вычитаемый IVA и годовой баланс.

Получает полный ежемесячный финансовый отчёт: доходы, расходы, прибыль, налоговая задолженность, статистика по счетам, разбивка расходов по категориям. По умолчанию: текущий месяц. Используйте для ответов на вопросы о финансовых показателях, движении денежных средств или ежемесячной прибыли и убытках. / Полный ежемесячный финансовый отчёт: доходы, расходы, прибыль, налоги, статистика по счетам, разбивка расходов по категориям. По умолчанию: текущий месяц.

Получает один продукт/услугу по его ID. / Получает один продукт/услугу по его ID.

Получает квартальные данные для подготовки налогов — Modelo 303 (IVA/IGIC), Modelo 130 (аванс по IRPF), итоги доходов/расходов, собранный налог против вычитаемого. По умолчанию — текущий квартал. Необходим для подачи квартальных налоговых деклараций в AEAT или ATC (Канарские острова). / Данные для подготовки квартальных налогов — Modelo 303, Modelo 130, итоги доходов/расходов, налог, предъявленный покупателям, против налога, уплаченного поставщикам. По умолчанию текущий квартал.

Получает одну котировку/смету по её ID. Возвращает полную смету с позициями и итогами.

Получает полные сведения о шаблоне повторяющегося счета по ID. Возвращает название шаблона, периодичность, дату следующего запуска, получателя, позиции и статус (активен/приостановлен). / Получает полные сведения о шаблоне повторяющегося счета по ID. Возвращает название, периодичность, следующий запуск, получателя, позиции и статус.

Получает одну бронь по ID. Возвращает полные детали бронирования: гость, объект, даты, канал, статус оплаты и заметки.

Получает одну POS-продажу по ID. Возвращает полные детали продажи: терминал, товары, способ оплаты, суммы и статус. / Получает одну POS-продажу по ID. Возвращает все детали: терминал, товары, способ оплаты, суммы и статус.

Получает полные сведения об одной записи учёта времени по идентификатору. Возвращает проект, пользователя, часы, описание, флаг биллинга, дату и статус. / Получает полные сведения об одной записи учёта времени по идентификатору. Возвращает проект, пользователя, часы, описание, флаг биллинга, дату и статус.

Получает агрегированную сводку учёта времени для рабочего пространства или конкретного участника команды. Возвращает общее количество часов, оплачиваемые часы, неоплачиваемые часы и ориентировочную стоимость за период. Фильтрует по диапазону дат и опционально по ID пользователя для разбивки по участникам. Получает агрегированную сводку учёта времени для рабочего пространства или конкретного участника. Возвращает общее количество часов, оплачиваемые, неоплачиваемые часы и ориентировочную стоимость за период. Фильтрует по диапазону дат и опционально по пользователю для разбивки по участникам.

Получает одного вендора/поставщика по его ID. Возвращает полные контактные данные. / Получает поставщика по его ID. Возвращает все контактные данные.

Получает конфигурацию одного вебхука по его ID. / Получает конфигурацию одного вебхука по его ID.

Приглашает нового участника в рабочее пространство по адресу электронной почты. Отправляется приглашение по электронной почте — участник должен принять его, прежде чем получит доступ. Назначаемые роли: admin, editor, accountant, viewer. Точный доступ определяется текущей политикой ролей рабочего пространства. Owner исключен из приглашений и должен быть переведен через отдельную процедуру. Пример: email='ana@example.com', role='accountant' / Приглашает нового участника в рабочее пространство по электронной почте. Отправляется электронное письмо с приглашением — участник должен принять его перед получением доступа. Назначаемые роли: admin, editor, accountant, viewer. Точный доступ зависит от действующей политики ролей рабочего пространства. Owner исключен из приглашений и должен быть переведен через отдельный процесс. Пример: email='ana@example.com', role='accountant'

Обнаружение медленных станций: агрегирует открытые кухонные тикеты по каждой станции и помечает узкое место (станцию с наибольшим количеством открытых тикетов). Возвращает для каждой станции количество открытых тикетов (openTickets), самое старое время ожидания в секундах и флаг isBottleneck. Вызывайте это в первую очередь для диагностики проблем производительности кухни, прежде чем углубляться в отдельные тикеты. / Обнаружение узкого места: агрегирует открытые тикеты по станциям и помечает самую загруженную. Возвращает openTickets, самое старое время ожидания и флаг isBottleneck для каждой станции. Вызывайте в первую очередь для диагностики проблем производительности кухни.

Отправляет счёт в польскую государственную систему e-счетов KSeF (Krajowy System e-Faktur). Польша требует обязательного выставления электронных счетов для B2B-транзакций (обязательный этап внедряется в 2025 году). Режимы: • mock — локальная симуляция (без сетевых вызовов, безопасно для разработки/тестирования) • sandbox — тестовая среда KSeF (demo.ksef.mf.gov.pl) • production — рабочий эндпоинт KSeF (ksef.mf.gov.pl) ПРИМЕЧАНИЕ: Этот инструмент — предварительная заглушка, совместимая с будущими версиями. Cloud-функция KSeF появится в PR #417. До слияния все вызовы возвращают ошибку NotImplementedYet с указанием, когда она станет доступна. / ПРИМЕЧАНИЕ: Этот инструмент — предварительная заглушка. Cloud-функция KSeF активируется с PR #417. До слияния все вызовы возвращают ошибку NotImplementedYet с инструкциями.

TRUST AREA — HR DECISION. Одобряет ожидающий запрос на отпуск. Регистрирует решение с отметкой времени и утверждающим. Идемпотентно: повторное одобрение уже одобренного отпуска не выполняет никаких действий. AREA DE CONFIANZA — DECISION RRHH. Одобряет ожидающий запрос на отпуск. Регистрирует решение.

Отменяет запрос на отпуск. Обычно используется запрашивающим сотрудником до утверждения, или HR после утверждения (что может вызвать откат расписания). / Отменяет запрос на отпуск (сотрудником или HR).

Перечисляет запросы на отпуск/PTO с необязательными фильтрами. Фильтрация по сотруднику, статусу (pending/approved/rejected/cancelled) или периоду (диапазон дат). Полезно для HR-дашбордов, календарных представлений, отслеживания баланса. / Перечисляет запросы на отпуск с необязательными фильтрами (сотрудник, статус, период).

ЗОНА ДОВЕРИЯ — КАДРОВОЕ РЕШЕНИЕ. Отклонить ожидающий запрос на отпуск с обязательной причиной. Причина обязательна для прозрачности и соблюдения трудового законодательства. / ЗОНА ДОВЕРИЯ — КАДРОВОЕ РЕШЕНИЕ. Отклонить запрос с обязательной причиной.

Создаёт новый запрос на отпуск/PTO для сотрудника. Типы: 'vacation', 'sick', 'personal', 'parental', 'unpaid', 'training'. Даты должны быть в формате ISO 8601 (ГГГГ-ММ-ДД). Статус изначально 'pending' — ожидает утверждения менеджером. / Создаёт новый запрос на отпуск/отгул. Начальный статус 'pending' — ожидает утверждения.

Выводит список всех подключенных банковских счетов рабочего пространства. Возвращает псевдоним, IBAN (только последние 4 цифры в целях безопасности), валюту, баланс и временную метку последней синхронизации. / Выводит список всех банковских счетов, подключенных к рабочему пространству. Возвращает псевдоним, IBAN (только последние 4 цифры для безопасности), валюту, баланс и последнюю синхронизацию.

Перечисляет все CRM-активности для клиента с опциональной пагинацией. Возвращает звонки, письма, встречи и задачи, записанные для клиента.

Перечисляет все контакты для клиента с опциональной пагинацией. Возвращает имя, email, телефон, роль и основной флаг. / Lista todos los contactos de un cliente con paginacion opcional.

Выводит список всех заметок для клиента с опциональной пагинацией. / Выводит список всех заметок клиента с опциональной пагинацией.

Выводит список всех клиентов/заказчиков с опциональной пагинацией. Возвращает контактную информацию, налоговые номера и адреса. / Выводит список всех клиентов с опциональной пагинацией. Возвращает контактную информацию, NIF/CIF и адреса.

Выводит все расходы с опциональной пагинацией и фильтрацией по диапазону дат. Возвращает расходы, отсортированные по дате (сначала новые). Пример: from='2026-01-01', to='2026-03-31', limit=50 / Выводит все расходы с опциональной пагинацией и фильтрами по дате.

Перечисляет все счета с необязательными постраничным разбиением и фильтрами. Возвращает постраничный список, отсортированный по дате выставления (сначала новые). Поддерживает фильтрацию по статусу (draft/sent/paid/overdue/cancelled) и диапазону дат. Пример: status='paid', from='2026-01-01', to='2026-03-31', limit=20 / Перечисляет счета с постраничным разбиением и необязательными фильтрами. Поддерживает фильтрацию по статусу и диапазону дат.

Перечисляет все кухонные станции. Возвращает идентификатор станции, название и статус активности. Используйте kitchen_flow_summary для просмотра загрузки заказов и узких мест по станциям.

Выводит все кухонные заказы для доски заказов в реальном времени, с опциональными фильтрами по статусу или станции. Возвращает id заказа, станцию, статус, номер стола и позиции. / Выводит все кухонные билеты из панели в реальном времени, с опциональными фильтрами по статусу или станции. Возвращает id, станцию, статус, стол и позиции.

Выводит каталог меню кухни. Поддерживает свободный текстовый поиск и фильтр активных/неактивных. Возвращает ID элемента, название, описание, цену, категорию и статус активности.

Выводит список всех продуктов/услуг с возможностью постраничной разбивки. Продукты — это повторно используемые позиции, которые можно добавлять в счета и предложения.

Перечисляет все арендные помещения для рабочего пространства. Возвращает название, адрес, вместимость, информацию о владельце и номер лицензии. / Перечисляет все арендные объекты для отпуска. Возвращает название, адрес, вместимость, данные владельца и номер лицензии.

Перечисляет все предложения/сметы с опциональной пагинацией и фильтрами. Предложения — это коммерческие предложения, отправляемые клиентам до того, как они становятся счетами. Поддерживает фильтрацию по статусу (draft/sent/accepted/rejected/expired) и диапазону дат. Пример: status='sent', from='2026-01-01', limit=20 / Перечисляет все коммерческие предложения с пагинацией и опциональными фильтрами. Поддерживает фильтрацию по состоянию и диапазону дат.

Перечисляет все шаблоны повторяющихся счетов. Возвращает название шаблона, частоту, дату следующего запланированного запуска, получателя, позиции и статус (активен/приостановлен). / Перечисляет все шаблоны повторяющихся счетов. Возвращает название шаблона, частоту, дату следующего выполнения, получателя, строки и статус.

Выводит список всех бронирований рабочего пространства с возможностью фильтрации по объекту, статусу или диапазону дат. Возвращает информацию о госте, датах, канале и общей сумме.

Выводит список POS-продаж с необязательными фильтрами по диапазону дат, терминалу или статусу. / Выводит список POS-продаж с необязательными фильтрами по дате, терминалу или статусу.

Перечисляет активных участников команды рабочего пространства и ожидающие приглашения. Владелец рабочего пространства НЕ учитывается как участник и исключается. Каждая строка содержит ID участника, имя, email, роль и статус приглашения (ожидает/активно). Полезно для проверки доступа команды и незакрытых приглашений. / Перечисляет активных участников команды и ожидающие приглашения. Владелец пространства НЕ отображается как участник и исключается. Каждая строка содержит ID, имя, email, роль и статус приглашения (ожидает/активно). Полезно для проверки доступа команды и ожидающих приглашений.

Перечисляет все настроенные POS-терминалы (считыватели Stripe Terminal) для рабочей области. Возвращает метку терминала, тип устройства, местоположение и статус подключения. / Перечисляет все терминалы точек продаж (считыватели Stripe Terminal). Возвращает метку, тип устройства, местоположение и статус подключения.

Выводит список записей учёта времени с опциональными фильтрами. Фильтрует по пользователю, проекту, диапазону дат или статусу оплаты. Полезен для создания табелей учёта рабочего времени, платёжных отчётов и анализа затрат по проектам. / Выводит список записей времени с опциональными фильтрами. Фильтрует по пользователю, проекту, диапазону дат или оплачиваемости. Полезен для табелей учёта рабочего времени, платёжных отчётов и анализа затрат по проектам.

Выводит список банковских транзакций с опциональными фильтрами. Фильтрует по счёту, диапазону дат, статусу (ожидающие/проведённые/исключённые) или категории. Полезен для сверки, сопоставления расходов и анализа денежных потоков. / Выводит список банковских операций с опциональными фильтрами. Фильтрует по счёту, диапазону дат, статусу (ожидающие/учтённые/исключённые) или категории. Полезен для сверки, распределения расходов и анализа денежного потока.

Выводит список всех поставщиков/продавцов с опциональной пагинацией и поиском. Возвращает контактную информацию, налоговые идентификаторы и адреса. / Выводит список всех поставщиков с опциональной пагинацией и поиском. Возвращает контактную информацию, NIF/CIF и адреса.

Перечисляет все настроенные вебхуки. Вебхуки отправляют HTTP POST уведомления, когда происходят события в Frihet. / Перечисляет все настроенные вебхуки. Вебхуки отправляют HTTP POST уведомления, когда происходят события в Frihet.

Регистрирует активность CRM для клиента. Используется для отслеживания звонков, писем, встреч или задач. Не указывайте пароли, учётные данные, данные платёжных карт, медицинские данные или официальные/государственные идентификаторы в полях свободного текста. Пример: clientId='abc123', type='call', title='Обсудили предложение за Q2', description='Клиент заинтересован в обновлении' / Регистрирует активность CRM для клиента. Не указывайте пароли, учётные данные, данные карт, данные о здоровье или официальные идентификаторы в полях свободного текста.

Отмечает счет как оплаченный. Опционально указывает дату оплаты. По умолчанию используется сегодняшняя дата, если дата не указана. / Отмечает счет как оплаченный. Опционально указывает дату оплаты.

TRUST AREA - СВЕРКА. Связывает банковскую транзакцию со счётом-фактурой или расходным документом. Влияет на записи фискальной сверки. Требует confirm=true для выполнения. Идемпотентно: повторное сопоставление с тем же документом не даёт эффекта. Пример: transactionId='tx_abc', documentId='inv_xyz', documentType='invoice', confirm=true / AREA DE CONFIANZA - СВЕРКА. Связывает банковскую операцию со счётом-фактурой или расходом. Влияет на записи фискальной сверки. Требует confirm=true для выполнения. Идемпотентно: повторная привязка к тому же документу не имеет эффекта. Пример: transactionId='tx_abc', documentId='inv_xyz', documentType='invoice', confirm=true

Устанавливает персону рабочего пространства. Определяет видимость модулей, стандартный план счетов и чек-лист адаптации. Персоны: - 'autonomo' — самозанятый (autonomo в Испании) - 'empresa' — малый/средний бизнес - 'agencia' — агентство / консалтинг - 'gestoria' — бухгалтерская фирма (управляет несколькими рабочими пространствами клиентов) Идемпотентно: повторная установка той же персоны не оказывает никакого эффекта. / Устанавливает персону рабочего пространства. Определяет видимые модули, план счетов и чек-лист.

Возвращает текущее состояние онбординга рабочего пространства: персона, завершённые шаги, ожидающие шаги, процент завершения. Полезно для управления внутриприложенными подсказками, триггерами последующих продаж и отслеживания партнёрских программ. / Возвращает текущее состояние онбординга рабочего пространства (персона, завершённые/ожидающие шаги).

Читает расчет сверхурочных в ERP за календарный месяц или год: ежедневные и еженедельные сверхурочные, отработанные/обычные/сверхурочные минуты, сверхурочные часы и предупреждения о соответствии, вычисленные из записей за выбранный период. Опционально фильтрует записи посещаемости по сотруднику. Формат периода: 'YYYY-MM' или 'YYYY'. / Читает ежедневные и еженедельные разбивки, а также сводные минуты/часы, рассчитанные по записям за выбранный период, с предупреждениями.

Приостанавливает активный шаблон повторяющегося счета. Новые счета не создаются, пока шаблон приостановлен. Шаблон сохраняется. Используйте resume_recurring_invoice, чтобы возобновить. / Приостанавливает активный шаблон повторяющегося счета. Новые счета не создаются, пока он приостановлен. Используйте resume_recurring_invoice, чтобы возобновить.

Перечисляет выплачиваемых сотрудников (активных или в отпуске) за месяц и по каждому сообщает, есть ли у него профиль начисления зарплаты, готовы ли обязательные поля, каких полей не хватает, и состояние ежемесячной проверки. Приостановленные и уволенные сотрудники исключаются. Используйте перед payroll_export. / Перечисляет выплачиваемых сотрудников и фактическую готовность их профиля начисления зарплаты.

Считывает нормализованный набор данных о сотрудниках за месяц, подготовленный для расчёта зарплаты. ERP принимает 'a3', 'contasol', 'sage' или 'siltra' в качестве метки назначения и возвращает её; ответ в формате JSON и одинаков для всех форматов, кроме этой метки. CSV, XML, PDF или файл, специфичный для провайдера, не создаётся. Frihet не рассчитывает зарплату. / Считывает нормализованные данные, готовые для расчёта зарплаты; не создаёт файл, специфичный для провайдера.

ЗОНА ДОВЕРИЯ - ЗАКРЫТИЕ ФИНАНСОВОГО ПЕРИОДА. ПОКА НЕ РЕАЛИЗОВАНО НА СЕРВЕРЕ: бэкенд отвечает HTTP 501 NOT_IMPLEMENTED на POST /v1/periods/close, поэтому вызов этого инструмента ничего не закрывает. Ни инвойсы, ни расходы, ни бухгалтерские проводки, ни банковские сверки не замораживаются, и рассчитывать на идемпотентный no-op не приходится. Вместо этого закрывайте период в приложении Frihet. Вызов по-прежнему требует confirm=true и вернёт 501 как ошибку. Используйте period_close_status (реализован), чтобы прочитать текущее состояние периода. / ЗОНА ДОВЕРИЯ - ЗАКРЫТИЕ ФИНАНСОВОГО ПЕРИОДА. ПОКА НЕ РЕАЛИЗОВАНО НА СЕРВЕРЕ: бэкенд отвечает HTTP 501 на POST /v1/periods/close, так что этот инструмент ничего не закрывает и не замораживает. Закрытие нужно делать в приложении Frihet.

Получает открытое или закрытое состояние текущего финансового года, включая его начало, инклюзивный диапазон дат и сведения о закрытии, которые могут быть null. Передайте четырёхзначную метку финансового года, чтобы прочитать состояние явно. / Возвращает открытое или закрытое состояние текущего или указанного финансового года.

ДОВЕРЕННАЯ ЗОНА - ПЕРЕОТКРЫТИЕ ФИНАНСОВОГО ПЕРИОДА. СЕГОДНЯ НА СЕРВЕРЕ НЕ РЕАЛИЗОВАНО: бэкенд отвечает HTTP 501 NOT_IMPLEMENTED на POST /v1/periods/{id}/reopen, поэтому вызов этого инструмента ничего не переоткрывает и не записывает запись в аудит. Переоткройте период в приложении Frihet. Вызов по-прежнему требует confirm=true и причину, а ошибка 501 будет возвращена как ошибка. / ДОВЕРЕННАЯ ЗОНА - ПЕРЕОТКРЫТИЕ ФИНАНСОВОГО ПЕРИОДА. СЕГОДНЯ НА СЕРВЕРЕ НЕ РЕАЛИЗОВАНО: бэкенд отвечает HTTP 501, поэтому ничего не переоткрывается и аудит не ведется. Сделайте это в приложении Frihet.

Возвращает документированный снимок RBAC-модели бэкенда по роли, ресурсу и действию. Он не выводится из правил Firestore и не гарантирует авторизацию в рантайме; авторитетен только ответ бэкенда с кодом 403. / Возвращает документированную модель RBAC, а не исчерпывающую гарантию авторизации.

Возвращает поля обратно-совместимой модели RBAC вызывающего отдельно от фактических областей действия ключа API, семантики неограниченного ключа, известного отказа области e-invoice и поверхностей, не указанных здесь. Это не исчерпывающий перечень; используйте точный ответ backend 403 как авторитет. / Отделяйте модель RBAC от реальных областей действия ключа API; это не исчерпывающая авторизация.

Возвращает депозит клиенту. Требует confirm=true. Переводит статус депозита в 'refunded' - движение денег, которое нельзя отменить из этого инструмента. Пример: id='dep_abc123', reason='Project cancelled', confirm=true / Возвращает депозит клиенту. Требует confirm=true. Это движение денег, которое нельзя отменить из этого инструмента.

Возвращает средства за POS-продажу полностью или частично. Это действие необратимо — покупатель получит возврат на исходный способ оплаты. Вы ОБЯЗАНЫ передать confirm=true для продолжения. При необходимости укажите amountCents для частичного возврата (по умолчанию полный возврат).

Удаляет участника из рабочей области. Участник немедленно теряет доступ. Созданные им записи (счета, расходы) сохраняются. Нельзя удалить владельца рабочей области: сначала передайте права владения. Требует confirm=true, чтобы предотвратить случайное удаление.

Возобновляет приостановленный шаблон повторяющегося счета. Следующий счет будет создан в следующую запланированную дату цикла после возобновления.

Запускает ручную генерацию следующего экземпляра счета из шаблона повторяющихся счетов. Используется для досрочного выставления счета или восстановления после пропущенного автоматического запуска. Созданный счет формируется как черновик; проверьте и отправьте отдельно. Пример: templateId='rec_abc123'

Ищет и фильтрует счета. Поддерживает фильтрацию по статусу и диапазону дат. Параметр query ищет по именам клиентов и содержимому счета. Пример: query='Acme', status='paid', from='2026-01-01', to='2026-03-31' / Ищет и фильтрует счета. Поддерживает фильтрацию по статусу и диапазону дат. Параметр query ищет по именам клиентов и содержимому счетов.

Отправляет электронную накладную получателю через выбранный канал передачи. Возвращает сразу workflowRunId — используйте get_einvoice_status для опроса до завершения. Поддерживаемые форматы (всего 11): • xrechnung-cii — синтаксис XRechnung CII (Германия, обязательно для B2G) • xrechnung-ubl — синтаксис XRechnung UBL 2.1 (Германия, альтернатива для B2G) • facturx-en16931 — Factur-X EN16931 PDF/A-3 (Франция, ЕС) • facturx-extended — Factur-X Extended с полями торговли/логистики (Франция, ЕС) • facturx-basic — Factur-X Basic, сокращённый набор полей (Франция, ЕС) • facturx-minimum — Factur-X Minimum для сводных счетов (Франция, ЕС) • fatturapa — XML FatturaPA через хаб SDI (Италия, обязательно) • ubl — универсальный XML UBL 2.1 (ЕС/весь мир) • cii — универсальный CII Cross Industry Invoice (ЕС/весь мир) • peppol-bis-3 — сеть PEPPOL BIS Billing 3.0 (ЕС/Северная Европа/Австралия/Сингапур) • facturae — Facturae 3.2.x (Испания, B2G через FACe/AEAT, обязательно) Режимы отправки: • email — вложить XML/PDF и отправить через Resend на email клиента из файла • chorus_pro — отправить на французский портал Chorus Pro (только facturx-*) • sdi — отправить на итальянский хаб SDI (только fatturapa) • peppol — передать через точку доступа PEPPOL (только peppol-bis-3) • download — сгенерировать и вернуть только подписанную ссылку на скачивание Если бэкенд отправки не развёрнут для этого рабочего пространства, возвращает честный ответ 'unavailable' — никаких сфабрикованных данных о workflow. / Отправляет электронную накладную получателю через выбранный канал передачи. Возвращает асинхронно — используйте get_einvoice_status для отслеживания статуса.

Отправляет клиенту счет по электронной почте. Требует confirm=true. При необходимости можно изменить адрес электронной почты получателя. Счет должен существовать и не должен быть отменен. Отправка достигает третьей стороны и не может быть отозвана. / Отправляет счет клиенту по электронной почте. Требует confirm=true. При необходимости можно изменить адрес электронной почты получателя. Отправка достигает третьей стороны и не может быть отменена.

Отправляет клиенту коммерческое предложение/смету по электронной почте. Требует confirm=true. При необходимости можно изменить адрес электронной почты получателя. Предложение должно существовать и не должно быть просрочено или отклонено. Отправка доходит до третьей стороны, и её нельзя отозвать. / Отправляет клиенту коммерческое предложение/смету по электронной почте. Требует confirm=true. При необходимости можно изменить email получателя. Отправка доходит до третьей стороны, и её нельзя отозвать.

Запускает ручную синхронизацию канала бронирования (Airbnb, Booking.com и т.д.). Импортирует новые бронирования и/или отправляет обновления календаря. Возвращает статус синхронизации и количество. / Запускает ручную синхронизацию канала бронирования. Импортирует новые бронирования и/или отправляет обновления календаря.

Отправляет синтетическое тестовое событие на эндпоинт вебхука и возвращает результат доставки. Проверяет доступность эндпоинта, валидацию подписи и конфигурацию TLS. Опционально укажите eventType для симуляции (по умолчанию: 'webhook.test'). Пример: id='wh_abc', eventType='invoice.paid' / Отправляет синтетическое тестовое событие на эндпоинт вебхука. Проверяет доступность, валидацию подписи и конфигурацию TLS.

Опрашивает статус подтверждения hacienda для отправки TicketBAI. Возвращает идентификатор TBAI, территорию и состояние подтверждения или отклонения hacienda. Типичные значения статуса: • submitted — отправлено, ожидается ответ hacienda (проверьте снова через 30–60 с) • accepted — hacienda подтвердила отправку (AEAT/провинциальное казначейство получило) • rejected — hacienda отклонила (проверьте rejectionReason для указаний по исправлению) • error — внутренняя ошибка обработки (см. поле error) / Запрашивает статус подтверждения получения от hacienda foral для отправки TicketBAI. Возвращает идентификатор TBAI, территорию и статус подтверждения или отклонения.

Отправляет счет в систему электронных счетов TicketBAI Страны Басков. Территория определяется автоматически по адресу рабочего пространства (Бискайя → BATUZ/LROE, Гипускоа → Gipuzkoa TicketBAI, Алава → Araba TicketBAI). Возвращает идентификатор отправки TicketBAI (идентификатор TBAI) и URL QR-кода для печати на счете. Используйте sandbox=true для тестовых отправок на тестовые конечные точки hacienda. Для отправок в производственную среду требуется действующий сертификат TicketBAI, настроенный в параметрах рабочего пространства. / Отправляет счет в систему TicketBAI Страны Басков. Территория определяется автоматически (Бискайя→BATUZ/LROE, Гипускоа, Алава). Возвращает идентификатор TBAI и URL QR-кода для печати на счете.

Обновляет существующего клиента с использованием семантики PATCH. Изменяются только предоставленные поля. Пример: id='abc123', email='new@acme.com', phone='+34600123456' / Actualiza un cliente existente. Solo se modifican los campos proporcionados.

Обновляет существующий депозит с использованием семантики PATCH. Изменяет только предоставленные поля. Пример: id='abc123', amount=750, notes='Updated retainer amount' / Обновляет существующий депозит. Изменяет только предоставленные поля.

Обновляет существующий расход с помощью семантики PATCH. Изменяются только указанные поля. Пример: id='abc123', amount=75.00, category='travel' / Обновляет существующий расход. Изменяются только предоставленные поля.

Обновляет существующую инвойс с использованием семантики PATCH. Изменяет только указанные поля. Пример: id='abc123', status='paid' для отметки инвойса как оплаченного. / Обновляет существующую инвойс. Изменяет только указанные поля.

Продвигает кухонный тикет по рабочему процессу: обновляет его статус (например, queued → preparing → ready → served) или переназначает на другую станцию.

Обновляет существующий продукт с помощью семантики PATCH. Изменяются только предоставленные поля. Пример: id='abc123', unitPrice=2000, taxRate=21 / Обновляет существующий продукт. Изменяются только предоставленные поля.

Обновляет существующее предложение с помощью PATCH-семантики. Изменяются только указанные поля. Пример: id='abc123', status='accepted' для отметки предложения как принятого. / Обновляет существующий бюджет. Изменяются только указанные поля.

Обновляет существующий шаблон повторяющегося счёта с использованием семантики PATCH. Изменяются только предоставленные поля. Изменение lineItems или taxRate влияет только на будущие сгенерированные счета, а не на уже созданные.

Изменяет роль существующего участника команды. Только администраторы или владельцы рабочего пространства могут менять роли. Нельзя изменить роль владельца - используйте отдельную процедуру передачи прав владения. Допустимые роли: admin, editor, accountant, viewer. Пример: memberId='mbr_abc123', role='accountant' / Изменяет роль существующего участника рабочего пространства. Менять роли могут только администраторы или владельцы. Нельзя изменить роль владельца - используйте процедуру передачи прав владения. Разрешённые роли: admin, editor, accountant, viewer.

Обновляет существующую запись времени с использованием семантики PATCH. Изменяются только переданные поля. Пример: id='te_abc123', hours=3.0, description='Frontend review + testing' / Обновляет существующую запись времени. Изменяются только переданные поля.

Обновляет существующего поставщика с использованием семантики PATCH. Изменяются только предоставленные поля. Пример: id='abc123', email='new@supplier.com', phone='+34600123456'

Обновляет существующую конфигурацию вебхука с использованием семантики PATCH. Изменяются только указанные поля. Пример: id='abc123', status='paused' для приостановки вебхука. / Обновляет конфигурацию вебхука. Изменяются только указанные поля.

Проверяет XML-документ электронного счета на соответствие схеме и правилам schematron указанного формата. Возвращает список ошибок с указанием серьезности, расположения в XPath, сообщения и идентификатора правила. Запускает валидатор KOSIT (XRechnung), Mustang (EN16931), XSD или Schematron в зависимости от формата. Используйте перед отправкой, чтобы выявить ошибки на раннем этапе и избежать затрат на сетевую передачу. Ответ valid=true означает, что документ проходит все проверки схемы и бизнес-правил. Если серверная часть валидации не развернута для этого рабочего пространства, возвращает честный ответ 'unavailable' — никогда не поддельный valid=true. / Проверяет XML-документ электронного счета на соответствие схеме и правилам schematron указанного формата.

TRUST AREA — COMPLIANCE. Повторно отправляет неудачную или отклоненную подачу VeriFactu в AEAT. Идемпотентно: использует ту же хэш-цепочку; AEAT удаляет дубликаты по хэшу. Создает запись в журнале аудита для каждой попытки повторной отправки. Требует confirm=true. Используйте только для счетов-фактур со статусом 'failed'. / AREA DE CONFIANZA — COMPLIANCE. Повторно отправляет неудачный счет-фактуру VeriFactu в AEAT. Идемпотентно: та же хэш-цепочка. Создает запись аудита при каждой попытке. Требует confirm=true. Только для счетов-фактур со статусом 'failed'.

Получает статус отправки VeriFactu (цепочка электронных счетов AEAT Испании) для конкретного счета. Возвращает метку времени последней отправки, хеш, код ответа AEAT и URL для проверки QR-кода. / Получает статус отправки VeriFactu (AEAT) для конкретного счета. Возвращает метку времени последней отправки, хеш, ответ AEAT и URL QR-кода.