Nordlet для разработчиков приложений

Добавьте выставление счетов, ведение бухгалтерского учета и подготовку налоговой отчетности ЕС в ваше программное обеспечение через единый JSON API, типизированные SDK, вебхуки, MCP-сервер и тестовые компании.

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

Nordlet представляет собой бухгалтерское программное обеспечение, разработанное по принципу API-first. Все функции веб-приложения также доступны через единый JSON API. Ваше приложение отправляет события, а Nordlet ведет учет и подготавливает налоговую отчетность.

Что делает Nordlet

Предоставляет каждое действие в формате POST /v1/{module}/{resource}/{action} с телом в формате JSON, например /v1/sales/invoices/create.
Аутентифицирует каждый запрос с помощью ключа API, принадлежащего конкретной компании. Каждый ключ имеет набор разрешений (scopes), таких как sales:read или sales:write, которые ограничивают его возможности.
Принимает суммы в виде строк с фиксированной точкой (decimal strings), но никогда в виде чисел с плавающей точкой (floating-point numbers), благодаря чему центы не теряются из-за округления.
Принимает заголовок Idempotency-Key для каждого изменения. Повторный запрос с тем же ключом возвращает первоначальный результат вместо повторного выполнения операции. Идемпотентность (idempotency) означает, что повторный запрос дает тот же эффект, что и один запрос.
Возвращает все ошибки в едином общем формате.
Допускает до 300 запросов в минуту для каждого ключа API.
Записывает каждое изменение в журнал аудита (audit log).

Руководство по соглашениям API подробно описывает каждое из этих правил.

Безупречный учет

Выставление счета присваивает сквозной номер без пропусков, проверяет, открыт ли отчетный период (accounting period), и проводит бухгалтерскую проводку (journal entry) в рамках одной транзакции базы данных.
Каждая проводка должна быть сбалансирована. База данных проверяет это самостоятельно при сохранении транзакции.
Выставленные и зарегистрированные документы нельзя удалить. Ошибочное сопоставление с банковской выпиской исправляется сторнирующей проводкой, а не редактированием старой. В этом заключается суть неизменяемого реестра (immutable ledger).

SDK, MCP и вебхуки

Типизированные SDK генерируются на основе одной и той же спецификации OpenAPI для TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift и Rust. До официальной публикации SDK вы можете установить его из исходного репозитория. См. руководство по SDK.
Доступна коллекция Postman со всеми эндпоинтами.
MCP-сервер позволяет ИИ-ассистенту, например Claude Code, искать информацию в API и вызывать его функции с вашим ключом API. Каждый вызов представляет собой обычный запрос к API с теми же разрешениями и лимитами.
Вебхуки уведомляют ваше приложение о происходящих событиях, например sale_invoice.issued или sale_invoice.paid. Каждая отправка подписывается HMAC-подписью, чтобы вы могли убедиться, что запрос поступил от Nordlet. Неудачные отправки повторяются в течение примерно 24 часов.

Тестирование с помощью тестовых компаний

Создайте компанию со значением isSandbox: true или отметьте галочкой поле тестовой среды при настройке компании в приложении.
Тестовая компания работает так же, как реальная: те же модули, тот же API.
Она четко помечена как тестовые данные, и вы не можете превратить реальную компанию в тестовую или наоборот.
Отчетность и электронные счета-фактуры (e-invoices) тестовой компании отправляются в тестовые сервисы налоговых органов.
Использование ресурсов тестовой компании тарифицируется и оплачивается так же, как использование реальной компании.

Руководство по началу работы пошагово описывает получение первого ключа API, создание первого счета-фактуры и прохождение всего цикла.

FAQ

Может ли одно приложение обслуживать несколько компаний?

Да. Каждый ключ API принадлежит конкретной компании, поэтому вы создаете ключ для каждой компании. Каждое сообщение вебхука содержит идентификатор companyId компании, к которой оно относится, поэтому один обработчик может обслуживать несколько компаний.

Должен ли я самостоятельно формировать налоговую отчетность?

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