Как использовать Norman в n8n и Make

Выберите REST или MCP

Используйте HTTP-запрос, если сценарий должен выполнить конкретную операцию API, например прочитать транзакции или создать черновик счёта. Так с Norman Public API могут работать и n8n, и Make.

Используйте MCP, если ИИ-агент должен сам выбирать инструменты Norman для задачи. Карточка n8n в разделе Integrations ведёт к руководству по MCP. REST API-ключ и OAuth-подключение MCP настраиваются по-разному. Для MCP смотрите инструкцию подключения и поддержку удалённого MCP с OAuth в вашем инструменте.

Подготовьте ключ Norman

Откройте Automations → Integrations → Public API. Выберите компанию и создайте Read only ключ для первого теста. Сохраните его в хранилище учётных данных n8n или Make. Используйте отдельные ключи, если сценариям нужны разные права или независимый отзыв доступа.

Настройте HTTP-шаг

В n8n добавьте узел HTTP Request. Выберите общие учётные данные с Header Auth: имя заголовка Authorization, значение Bearer YOUR_API_KEY. Подключите эти учётные данные к узлу.

В Make добавьте HTTP → Make a request. Настройте его хранилище учётных данных или keychain на отправку такого же Authorization-заголовка. Названия настроек зависят от версии HTTP-модуля.

Запустите шаг один раз. Успешный ответ содержит results; подставляйте publicId компании в следующие пути, которым нужен её идентификатор. Если компания архивная, добавьте query-параметр include_archived=true.

Актуальные элементы интерфейса описаны в официальных руководствах n8n HTTP Request и Make HTTP.

Пример: регулярная выгрузка транзакций

После проверки компании выполните запрос:

https://api.norman.finance/api/v1/accounting/transactions/?page=1&page_size=100

Используйте read_transactions, обрабатывайте записи из results и переходите по URL next из ответа, пока он не станет null. В n8n узел HTTP Request поддерживает Response Contains Next URL. В Make используйте доступные настройки пагинации HTTP-модуля или цикл. Переходите только по ссылкам на хост API Norman.

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

Пример: из CRM в черновик счёта

Запустите сценарий из CRM, создайте или обновите клиента и подготовьте черновик счёта в Norman. Используйте набор прав Invoicing, JSON-запросы и пример создания счёта. Сохраните ID клиента и счёта в CRM. Проверьте черновик перед добавлением шага отправки письма.

Для загрузки документа используйте multipart с полем file, а не JSON. Обработка может продолжаться после ответа на загрузку; прочитайте документ позже, чтобы проверить результат.

Надёжные повторные запуски

Добавьте ветку обработки ошибок: обновляйте недействующие учётные данные, исправляйте недостающие права и соблюдайте Retry-After при ответе 429. После тайм-аута не повторяйте создание записи или отправку, пока не проверите, была ли операция выполнена.

Публичные подписки на события пока не входят в API. Запускайте такие сценарии по расписанию или по событию в исходной системе. Подробнее: доступ к API и ошибки и полный справочник.