Автоматизация Lexoffice с помощью n8n: документы, счета, контакты

Lexoffice можно автоматизировать с помощью n8n, хотя официального узла n8n для Lexoffice не существует: решением служит узел HTTP Request, который напрямую обращается к публичному API Lexoffice и получает там документы, создает счета или синхронизирует контакты. Для этого нужен личный API-ключ из аккаунта Lexoffice, который n8n передает как bearer-токен в заголовке Authorization, а также credential Header Auth, сохраненный в узле HTTP Request. Рабочий API работает с мая 2025 года по домену api.lexware.io и ограничен максимум двумя запросами в секунду. По состоянию на: июль 2026.

Почему нет нативного узла n8n для Lexoffice?

Lexoffice не входит в число сервисов, официально интегрированных n8n, поэтому в workflow нужно использовать универсальный узел HTTP Request вместо готового узла Lexoffice. Для таких случаев n8n поддерживает в узле HTTP Request несколько универсальных методов аутентификации, включая Header Auth, Basic Auth, OAuth2 и Query Auth (документация n8n по узлу HTTP Request). Для Lexoffice подходящим выбором является Header Auth, поскольку API требует аутентификации по bearer-токену через заголовок Authorization. Цена этой гибкости: конечные точки, поля и обработку ошибок приходится воссоздавать вручную, а при изменениях API со стороны Lexoffice workflow нужно поддерживать самостоятельно, вместо того чтобы он автоматически работал после обновления узла.

Как аутентифицировать n8n в API Lexoffice?

Аутентификация выполняется с помощью личного API-ключа, который вы создаете в аккаунте Lexoffice в настройках публичного API и передаете как bearer-токен в заголовке Authorization каждого запроса (документация API Lexware). В n8n для этого в узле HTTP Request создается credential Header Auth с именем Authorization и значением Bearer, за которым следует ключ. Для планирования workflow важны два технических момента:

• Базовый URL: С 26 мая 2025 года рабочий API работает по адресу https://api.lexware.io, старый адрес lexoffice.io с тех пор заменен.
• Ограничение частоты запросов: API допускает максимум два запроса в секунду; при превышении лимита он отвечает кодом HTTP 429, поэтому для крупных синхронизаций нужен ограниченный цикл или узел Wait в workflow.

Как с помощью n8n получить новые документы из Lexoffice?

Новые документы можно получить через GET-эндпоинт /v1/voucherlist, который фильтруется через параметры запроса по типу документа, статусу и дате создания или изменения. В n8n узел HTTP Request настраивается с методом GET и URL https://api.lexware.io/v1/voucherlist, дополненным параметрами вроде voucherType, voucherStatus и createdDateFrom, например, чтобы получить только открытые счета за последние 24 часа. Ответ разбит на страницы, со стандартным размером в 25 записей на страницу и полями вроде totalPages и totalElements, поэтому для полной синхронизации нужен цикл пагинации. Типичный паттерн: cron-триггер запускает workflow ежечасно, получает новые или измененные документы и записывает их в таблицу или внутренний дашборд.

Как через n8n создавать новые счета в Lexoffice?

Новые счета создаются через POST-запрос к /v1/invoices, где тело JSON содержит клиента, позиции счета и налоговые ставки. В узле HTTP Request выбирается метод POST, Content-Type устанавливается на application/json, а тело счета передается либо из предыдущих данных workflow, либо из узла Set, который собирает поля в соответствии со схемой Lexoffice. Практический пример: завершение заказа в интернет-магазине через webhook запускает workflow n8n, который автоматически переносит данные клиента и позиции в формат, ожидаемый Lexoffice, и создает счет. API строго проверяет схему, поэтому перед вводом такого workflow в продуктивную эксплуатацию стоит провести тестовые прогоны с реальными тестовыми данными.

Как синхронизировать контакты между n8n и Lexoffice?

Контакты можно запрашивать через GET /v1/contacts с фильтрами вроде e-mail или имени и создавать через POST /v1/contacts, что позволяет синхронизировать Lexoffice с CRM или таблицей. Распространенный паттерн проверяет через GET, существует ли уже контакт с определенным e-mail-адресом, и создает его через POST только при необходимости, чтобы избежать дублей. Для компаний, использующих Lexoffice как бухгалтерию наряду с отдельной CRM, это избавляет от двойного ручного ведения контактных данных. Тем, кто хочет постоянно эксплуатировать такие многоступенчатые workflow с обработкой ошибок, контролем лимита запросов и мониторингом, NordFlux предлагает поддержку в построении workflow n8n, включая оценку того, какие процессы вообще технически и экономически оправданы.

Часто задаваемые вопросы о Lexoffice и n8n

Есть ли официальный узел Lexoffice для n8n?

Нет, n8n не предлагает официального нативного узла для Lexoffice, поэтому подключение выполняется через универсальный узел HTTP Request к публичному API Lexoffice. Это означает больше усилий по настройке, чем с готовым узлом, но технически все основные функции, такие как документы, счета и контакты, доступны через API. При однократно настроенном credential Header Auth любое количество шагов workflow может использовать один и тот же доступ.

Каково ограничение частоты запросов API Lexoffice?

API Lexoffice ограничивает запросы максимум двумя запросами в секунду; при превышении лимита он отвечает кодом статуса HTTP 429. В workflow n8n с большим количеством записей поэтому стоит добавить узел Wait или ограниченный цикл, чтобы не превысить лимит. При более крупных синхронизациях, например нескольких сотен контактов, это заметно сказывается на времени выполнения и должно учитываться при планировании workflow.

Какой базовый URL сейчас использует API Lexoffice?

С 26 мая 2025 года рабочий API Lexoffice работает по домену api.lexware.io, старый адрес lexoffice.io с тех пор заменен. Workflow n8n, которые все еще используют старый URL, следует переключить на новый базовый URL, чтобы избежать ошибок. Сам API-ключ при этом не затрагивается и по-прежнему управляется в аккаунте Lexoffice.

Что произойдет, если Lexoffice изменит API?

Поскольку подключение работает через самостоятельно созданные HTTP-запросы, а не через поддерживаемый узел n8n, при изменениях схемы или эндпоинтов workflow нужно корректировать вручную. Это цена гибкости индивидуального паттерна: автоматического механизма обновления, какой был бы у официально поддерживаемого узла, здесь нет. Тем, кто не хочет нести эти затраты на обслуживание самостоятельно, стоит заранее заложить их в планирование.