Счетоводен софтуер с API

Всички функционалности на Nordlet са достъпени през едно JSON API, съпроводено от SDK, уебхукове (webhooks), идемпотентни повторни опити и MCP сървър за AI асистенти.

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 знака след десетичната запетая, никога като числа с плаваща запетая, така че да не се губят стотинки при закръгляване.
Единен формат на грешките. Всяка грешка връща еднакъв формат с код, съобщение и идентификатор на заявката (request id).
Споделени параметри за списъци. Всяко извикване на list приема едни и същи полета за странициране, сортиране и филтриране и може да връща общи суми.
Реални счетоводни правила. Счетоводните статии трябва да са балансирани, номерацията на документите не трябва да съдържа пропуски, а заключен счетоводен период отказва нови записи с отговор 409. Всяка промяна се записва в одитния лог (audit log).

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

Мрежовата връзка може да прекъсне, след като вашата заявка е била обработена, но преди да получите отговора. Последващ опит за повторно изпращане би могъл да създаде същата фактура втори път. Идемпотентността означава, че повтарящата се заявка има същия ефект като първоначалната.

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

Уебхукове (Webhooks)

Уебхукът представлява съобщение, което 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 сървър. AI асистенти като Claude могат да търсят и извикват API функционалностите с вашия API ключ. Вижте ръководството за MCP сървър.
Тестови компании (Sandbox). Тестовата компания функционира като реална, но е обозначена като тестови данни и изпраща справки и електронни фактури единствено към тестовите крайна точки на съответните институции.
Ограничение на заявките (Rate limit). До 300 заявки в минута за един API ключ, като хедърите показват оставащия лимит.

FAQ

Какво мога да правя през API?

Всичко в продукта: фактуриране, покупки, главна книга, банково съпоставяне, стоки, активи, трудови възнаграждения, отчети и декларации към държавните органи. Ръководството за бърз старт описва целия цикъл от издаването на фактура до данните за ДДС.

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

Да. Всяка компания в Nordlet разполага със собствена счетоводна сметка, с която вашият софтуер работи чрез съответния API ключ. API интерфейсът не съдържа метод за редактиране или изтриване на осчетоводена статия. Всяка корекция представлява нов запис, което запазва неизменяемостта на счетоводната книга.