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 для кожної кінцевої точки (endpoint).
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 формує звіти на основі даних бухгалтерського обліку. Залежно від країни, для кожного звіту він або надсилає його самостійно, або формує файл для завантаження, або відображає показники, які ви вносите вручну. Таблиця підтримки звітності містить перелік усіх випадків.