Бухгалтерское ПО с API

Все функции Nordlet доступны через единый JSON API со средами SDK, вебхуками, идемпотентными повторами и MCP-сервером для ИИ-ассистентов.

API (интерфейс программирования приложений) позволяет одной программе взаимодействовать с другой. Бухгалтерский API дает возможность вашему собственному программному обеспечению создавать счета, регистрировать платежи и формировать отчеты без необходимости кликать мышкой по экранам.

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

Возможности Nordlet

Единый формат запросов. Каждый вызов имеет вид POST /v1/{module}/{resource}/{action} с телом в формате JSON, например sales/invoices/create или bank/transactions/match.
Ключи API с областями видимости (scopes). Каждый ключ принадлежит конкретной компании и обладает определенными областями видимости, такими как sales:read или bank:write. Запрос с ключом, у которого отсутствует необходимая область видимости, возвращает ошибку 403.
Суммы в виде текста. Денежные суммы передаются в виде строк с фиксированной точкой, содержащих до 4 знаков после запятой, но никогда в виде чисел с плавающей запятой, благодаря чему при округлении не теряются центы.
Единый формат ошибок. Любая ошибка возвращает стандартный конверт, содержащий код, сообщение и идентификатор запроса.
Общие параметры для списков. Все вызовы list используют одинаковые поля для постраничной навигации, сортировки и фильтрации, а также могут возвращать итоговые суммы.
Соблюдение правил бухгалтерского учета. Бухгалтерские проводки должны быть сбалансированы, номера документов не должны иметь пропусков, а закрытый отчетный период отклоняет новые проводки с кодом ответа 409. Каждое изменение фиксируется в журнале аудита.

Безопасные повторы запросов благодаря идемпотентности

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

Передавайте заголовок Idempotency-Key с любым вызовом, который изменяет данные.
Повторный запрос с тем же ключом и тем же телом возвращает ранее сохраненный ответ с заголовком x-idempotent-replay: true.
Попытка использовать тот же ключ с другим телом запроса отклоняется.
Ключи хранятся в течение 24 часов.

Вебхуки

Вебхук - это уведомление, которое Nordlet отправляет на ваш сервер при наступлении определенного события, например sale_invoice.paid.

События записываются в базу данных в рамках той же транзакции, что и само изменение, поэтому отмененное (выкаченное назад) изменение не порождает никаких событий.
Каждое сообщение подписывается с помощью HMAC-SHA256 с использованием секретного ключа вашей подписки, что позволяет проверить подлинность отправки от Nordlet.
Доставка неудавшегося сообщения повторяется в течение примерно 24 часов. Вы также можете отправить его повторно вручную.
Управление подписками осуществляется в разделе Аккаунт → Вебхуки или через API.

Инструменты для разработчиков

Справочник по API. Интерактивный справочник по API, созданный на основе спецификации OpenAPI, а также коллекция Postman.
Среды SDK. Типизированные клиенты для TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift и Rust, сгенерированные на основе той же спецификации. См. руководство по SDK.
MCP-сервер. ИИ-ассистенты вроде Claude могут осуществлять поиск и вызывать API, используя ваш ключ API. См. руководство по MCP-серверу.
Тестовые компании (Sandbox). Тестовая компания функционирует как настоящая, имеет специальную пометку как тестовые данные и отправляет налоговую отчетность и электронные счета исключительно на тестовые эндпоинты госорганов.
Ограничение частоты запросов (rate limit). 300 запросов в минуту на один ключ API; заголовки ответа показывают оставшийся лимит.

FAQ

Что можно делать через API?

Все функции продукта: выставление счетов, учет закупок, главную книгу, сверку банковских выписок, учет ТМЦ, основных средств, расчет заработной платы, отчетность и отправку данных в государственные органы. В руководстве для начала работы подробно описан полный цикл от выставления счета до расчета показателей НДС.

Могу ли я встроить бухгалтерский учет в собственный продукт?

Да. Каждая компания в Nordlet имеет собственную учетную книгу, с которой ваше программное обеспечение работает через свой ключ API. В API отсутствуют методы для редактирования или удаления уже проведенных бухгалтерских проводок. Любая корректировка оформляется новой проводкой, что обеспечивает неизменяемость учетного журнала (immutable ledger).