@frihet/mcp-server

List Anomalies

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

Apply Deposit

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

Apply Late Fee

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

Clock In (Attendance)

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

Clock Out (Attendance)

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

Categorize Transaction

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

Create Client

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

Create Client Contact

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

Create Client Note

Добавляет заметку клиенту. Заметки — это текстовые записи произвольной формы, полезные для сохранения контекста. Пример: clientId='abc123', content='Prefers invoices in English. Payment NET 30.' / Добавляет заметку клиенту. Заметки — это текст в свободной форме для сохранения контекста.

Create Credit Note

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

Create Deposit

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

Create Expense

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

Create Invoice

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

Create Product

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

Create Quote

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

Create Recurring Invoice

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

Create Reservation

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

Create Time Entry

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

Create Vendor

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

Create Webhook

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

Delete Client

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

Delete Client Contact

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

Delete Client Note

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

Delete Deposit

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

Delete Expense

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

Delete Invoice

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

Delete Product

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

Delete Quote

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

Delete Recurring Invoice

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

Delete Time Entry

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

Delete Vendor

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

Delete Webhook

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

Duplicate Invoice

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

Export E-Invoice XML

Экспортирует счет-фактуру как 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 часов.

Export DATEV

Экспортирует бухгалтерские данные в формате 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 файла.

Get FACe Submission Status

Опрашивает статус подачи счета 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.

Submit to FACe (Spain B2G)

Отправляет счёт в формате 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.

Calculate AIEM (Arbitrio Importación Canarias)

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

Create Bank Categorization Rule

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

List Bank Categorization Rules

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

Approve GL Entry

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

Get GL Entry Audit Log

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

Reject GL Entry

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

Get Modelo 200 Summary (Corporate Tax — Annual IS)

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

Get Modelo 202 Summary (Corporate Tax — Installment Payments)

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

Get Modelo 415 Summary (IGIC Annual Operations >€3,005)

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

Get Modelo 418 Summary (IGIC Monthly Large Enterprises)

Получает сводку 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.

Get Modelo 425 Summary (IGIC Annual Recap)

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

Add Custom Portal Domain

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

Remove Custom Portal Domain

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

Verify Custom Portal Domain

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

Generate Portal Self-Onboard Link

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

Lookup Tax ID via VIES (EU VAT Validation)

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

Consolidated AR Aging (Gestoria)

Получает отчет по старению дебиторской задолженности, объединяющий данные всех клиентов управляющего — общие суммы по категориям (текущая / 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.

Send Gestoria Message

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

List Gestoria Messages

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

Bulk Send Gestoria Template

Отправляет один и тот же шаблон запроса документа до 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`.

Create Gestoria Template

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

Get Bank Account

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

Get Business Context

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

Get Client

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

Get Deposit

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

Get E-Invoice Status

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

Get Expense

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

Get Invoice

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

Get Invoice E-Invoice XML

Загружает XML электронного счета. Возвращает XML, соответствующий EN16931, в автоматически определяемом формате (UBL, CII, XRechnung, Factur-X, FatturaPA, PEPPOL). Доступно только после сохранения или отправки счета.

Get Invoice PDF

Получает PDF-файл для счета. Возвращает URL для скачивания PDF или двоичные данные.

Get Kitchen Ticket

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

Get Modelo 130 Summary (IRPF Estimated Payment)

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

Get Modelo 180 Summary (IRPF Rentals Annual)

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

Get Modelo 303 Summary (IVA Quarterly)

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

Get Modelo 347 Summary (Operations >€3,005 Annual Recap)

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

Get Modelo 390 Summary (IVA Annual Recap)

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

Get Monthly Summary

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

Get Product

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

Get Quarterly Taxes

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

Get Quote

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

Get Recurring Invoice

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

Get Reservation

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

Get POS Sale

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

Get Time Entry

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

Get Time Summary

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

Get Vendor

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

Get Webhook

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

Invite Team Member

Приглашает нового участника в рабочее пространство по электронной почте. Отправляется приглашение по электронной почте — участник должен принять его, прежде чем получить доступ. Роли: owner (полный доступ), admin (управление без выставления счетов), member (операционный доступ), viewer (только чтение). Пример: email='ana@example.com', role='member' / Приглашает нового участника в рабочее пространство по электронной почте. Отправляется приглашение по электронной почте — участник должен принять его, прежде чем получить доступ. Роли: owner (полный доступ), admin (управление без выставления счетов), member (операционный доступ), viewer (только чтение). Пример: email='ana@example.com', role='member'

Kitchen Flow Summary

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

Submit to KSeF (Poland)

Отправляет счёт в польскую государственную систему 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 с инструкциями.

Approve Leave Request

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

Cancel Leave Request

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

List Leave Requests

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

Reject Leave Request

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

Create Leave Request

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

List Bank Accounts

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

List Client Activities

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

List Client Contacts

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

List Client Notes

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

List Clients

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

List Deposits

List Expenses

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

List Invoices

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

List Kitchen Stations

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

List Kitchen Tickets

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

List Menu Items

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

List Products

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

List Properties

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

List Quotes

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

List Recurring Invoices

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

List Reservations

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

List POS Sales

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

List Team Members

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

List POS Terminals

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

List Time Entries

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

List Bank Transactions

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

List Vendors

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

List Webhooks

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

Log Client Activity

Зарегистрируйте активность CRM для клиента. Используйте для отслеживания звонков, писем, встреч или задач. Пример: clientId='abc123', type='call', title='Discussed Q2 proposal', description='Client interested in upgrade' / Зарегистрируйте активность CRM для клиента. Используйте для отслеживания звонков, писем, встреч или задач.

Mark Invoice Paid

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

Match Transaction to Invoice

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

Set Onboarding Persona

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

Onboarding Status

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

Overtime Report

Генерирует отчёт о сверхурочных за период. Агрегирует обычные и сверхурочные часы по каждому сотруднику + общую ориентировочную стоимость в EUR. Полезно для подготовки расчёта зарплаты и проверок трудового законодательства. Формат периода: 'YYYY-MM' (месячный) или 'YYYY-QN' (квартальный) или 'YYYY' (годовой). / Отчёт о сверхурочных по периодам. Агрегирует обычные и сверхурочные часы по сотрудникам + ориентировочная стоимость.

Pause Recurring Invoice

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

Payroll Readiness Checklist

Выводит список всех сотрудников за указанный месяц с состоянием готовности к зарплате. Возможные состояния: - 'ready' – все обязательные данные заполнены, готов к экспорту - 'missing_data' – не хватает некоторых обязательных полей (см. missingFields[]) - 'blocked' – заблокирован вручную или обнаружено несоответствие данных Используйте перед payroll_export, чтобы выявить пробелы. Формат месяца: 'YYYY-MM'. / Выводит список сотрудников с состоянием готовности к зарплате. Используйте перед payroll_export.

Export Payroll (Gestoria Format)

Экспортирует данные по зарплате за месяц в формате, совместимом с gestoria. Поддерживаемые форматы: - 'a3' — Wolters Kluwer A3 (CSV с колонками испанской зарплаты) - 'contasol' — Sage Contasol - 'sage' — Sage 50/200 - 'holded' — Формат импорта Holded - 'siltra' — SILTRA Seguridad Social XML Frihet НЕ рассчитывает зарплату — он экспортирует подготовленные данные для gestoria. Формат месяца: 'YYYY-MM'. / Экспортирует данные по зарплате в формате, совместимом с gestoria. Месяц в формате 'YYYY-MM'.

Close Accounting Period

TRUST AREA - FISCAL CLOSE. Закрывает ежемесячный или ежеквартальный учётный период. Замораживает счета, расходы, записи журнала и банковские выверки за период. Требуется confirm=true. Идемпотентно: повторное закрытие уже закрытого периода ничего не делает. Закрытые периоды можно снова открыть с помощью period_reopen + audit reason. / AREA DE CONFIANZA - CIERRE FISCAL. Закрывает ежемесячный или ежеквартальный учётный период. Замораживает счета, расходы, проводки. Требуется confirm=true.

Period Close Status

Получает состояние текущего учётного периода (открыт / закрывается / закрыт / повторно открыт). Без periodId возвращает текущий открытый или последний закрытый период. / Возвращает состояние текущего учётного периода (открыт / закрывается / закрыт / повторно открыт).

Reopen Accounting Period

TRUST AREA — FISCAL REOPEN. Открывает закрытый учётный период заново. Требует указать причину (аудит) и confirm=true. Повторное открытие позволяет вносить правки задним числом в счета и расходы — используйте с крайней осторожностью. / AREA DE CONFIANZA — REAPERTURA FISCAL. Открывает закрытый период заново. Требует указать причину (аудит) и confirm=true.

Permissions Matrix

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

My Permissions

Возвращает фактическую роль и разрешения вызывающего в текущем workspace. Используется для ограничения UI на стороне клиента, отладки ошибок доступа и обнаружения возможностей. / Devuelve el rol efectivo y los permisos del llamante en el workspace actual.

Refund Deposit

Возвращает депозит клиенту. Переводит статус депозита в 'refunded'. Пример: id='dep_abc123', reason='Project cancelled' / Возвращает депозит клиенту.

Refund POS Sale

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

Remove Team Member

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

Resume Recurring Invoice

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

Run Recurring Invoice Now

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

Search Invoices

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

Send E-Invoice

Отправляет электронную накладную получателю через выбранный канал передачи. Возвращает сразу 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 для отслеживания статуса.

Send Invoice

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

Send Quote

Отправить коммерческое предложение/смету клиенту по электронной почте. При желании можно изменить адрес электронной почты получателя. Коммерческое предложение должно существовать и не должно быть просроченным или отклонённым. / Отправить смету клиенту по электронной почте. При желании можно изменить адрес получателя.

Sync Channel

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

Test Webhook

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

Get TicketBAI Submission Status

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

Submit TicketBAI (Basque Country)

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

Update Client

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

Update Deposit

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

Update Expense

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

Update Invoice

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

Update Kitchen Ticket

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

Update Product

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

Update Quote

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

Update Recurring Invoice

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

Update Team Member Role

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

Update Time Entry

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

Update Vendor

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

Update Webhook

Обновляет существующую конфигурацию webhook, используя семантику PATCH. Изменяются только указанные поля. Пример: id='abc123', active=false для отключения webhook. / Actualiza la configuracion de un webhook. Solo se modifican los campos proporcionados.

Validate E-Invoice XML

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

Re-submit VeriFactu Submission

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

Get VeriFactu Submission Status

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