Бухгалтерське програмне забезпечення з 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 приймає однакові поля для постраничної розбивки (pagination), сортування та фільтрації, а також може повертати підсумкові суми.
Справжні правила бухобліку. Бухгалтерські проводки повинні бути збалансованими, номери документів не повинні мати пропусків, а заблокований звітний період відхиляє нові проведення з відповіддю 409. Кожна зміна записується до журналу аудиту (audit log).

Безпечні повтори завдяки ідемпотентності

Мережа може дати збій після того, як ваш запит було оброблено, але до того, як ви отримали відповідь. Повторна спроба в такому разі могла б створити той самий рахунок двічі. Ідемпотентність означає, що повторний запит має такий самий результат, як і перший.

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

Вебхуки

Вебхук (webhook) — це повідомлення, яке Nordlet надсилає на ваш сервер при виникненні певної події, наприклад sale_invoice.paid.

Події записуються в тій самій транзакції бази даних, що й зміна, тому зміна, яку було скасовано (rolled back), не генерує жодних подій.
Кожна доставка підписується за допомогою 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). ** Тестова компанія працює так само, як і справжня, але позначена як тестові дані та надсилає звіти й електронні рахунки виключно на тестові кінцеві точки (endpoints) державних органів.
Ліміт запитів (rate limit). 300 запитів на хвилину для одного ключа API із заголовками, які показують залишок ліміту.

FAQ

Що можна робити через API?

Усе, що є в продукті: виставлення рахунків, закупівлі, головну книгу, звірку банківських виписок, облік товарів, необоротних активів, заробітну плату, звіти та подання звітності до державних органів. Посібник з початку роботи демонструє повний цикл від виставлення рахунку до розрахунку ПДВ.

Чи можу я вбудувати бухгалтерський облік у власний продукт?

Так. Кожна компанія в Nordlet має власні книги обліку, а ваше програмне забезпечення працює з ними за допомогою свого ключа API. API не містить викликів, які б редагували або видаляли вже проведену бухгалтерську проводку. Будь-яке виправлення оформлюється новою проводкою, що забезпечує незмінність головної книги (immutable ledger).