REST API
Нехай рахунки виставляє ваша власна система
Виставляйте рахунок просто з інтернет-магазину, застосунку або скрипта. Автентифікація токеном, посторінкова навігація курсором та ідемпотентні записи — і 100 запитів на місяць уже в тарифі Free, без платіжної картки.
curl https://app.lucanto.eu/api/v1/workspaces/{workspace_id}/invoices \
-H "Authorization: Bearer lct_live_xxx"Що ви можете побудувати
Із замовлення — рахунок
Ваш інтернет-магазин або застосунок звертається до Lucanto, щойно замовлення оплачене, — і рахунок уже існує. Без експорту, без переписування, без щомісячного надолужування.
Клієнти завжди синхронізовані
Створюйте та редагуйте клієнтів зі своєї системи й тримайте контактні та реєстраційні дані однаковими з обох боків.
Документи, які можна прочитати назад
Завантажуйте рахунки, стан їхньої оплати та дані за ними у власну звітність — замість того щоб експортувати таблиці.
API доступний уже в тарифі Free
REST API не зарезервований для великих клієнтів. Free містить 100 запитів на місяць — достатньо, щоб побудувати інтеграцію, протестувати її та пустити невеликий потік рахунків по-справжньому. Коли потрібен вищий ліміт, ви переходите на вищий тариф, а не відкриваєте нову можливість.
Від нуля до першого виклику
Створіть токен доступу
У Lucanto відкрийте Налаштування → API та згенеруйте токен робочого простору (lct_live_). Він належить робочому простору, а не людині, тож інтеграція працює далі й тоді, коли той, хто її налаштував, піде з компанії, і ніколи не дістанеться до чужих робочих просторів. Для швидкої проби з власного скрипта достатньо особистого токена (lct_pat_). Саме областями доступу ви втримаєте інтеграцію, призначену лише для читання, справді тільки на читанні.
Надішліть перший запит
Перший запит надішліть на https://app.lucanto.eu/api/v1 з токеном у заголовку Authorization. Quickstart у документації проведе вас усім шляхом від початку до кінця менш ніж за п’ять хвилин.
Підготуйте інтеграцію до продакшену
До кожного POST додавайте заголовок Idempotency-Key, щоб повторна спроба не виставила рахунок двічі, колекції проходьте курсором, а не зміщенням, і обробляйте стандартний формат помилки, а не лише перевіряйте HTTP 200.
Як поводиться API
Деталі, від яких залежить, чи переживе інтеграція свій перший поганий тиждень. Кожен рядок веде на відповідну сторінку документації.
| Властивість | Як це працює |
|---|---|
| Базова адреса | https://app.lucanto.eu/api/v1 |
| Токен робочого простору (lct_live_) | Прив’язаний до одного робочого простору — для інтеграцій інтернет-магазину та бухгалтерії, які діють від імені компанії |
| Особистий токен (lct_pat_) | Ваші власні права в усіх робочих просторах, до яких ви належите, — для скриптів і AI-асистентів |
| Посторінкова навігація | Курсором, стабільна навіть тоді, коли додаються нові записи |
| Ідемпотентність | Заголовок Idempotency-Key у POST, тож повторні спроби безпечні |
| Помилки | Єдиний формат помилки для всіх ендпоінтів |
Ми публікуємо кожну зміну
Нові ендпоінти, нові поля та несумісні зміни потрапляють до публічного changelog API. Несумісні зміни позначаємо окремою міткою, тож ви бачите їх ще до того, як вони вас торкнуться, — а RSS принесе їх вам, замість того щоб ви сюди заглядали.
Запити за тарифами
Ліміт запитів зростає разом з тарифом. Технічна підтримка API доступна від тарифу Starter. Ціни доповнень — без ПДВ.
| Що ви отримуєте | Доступність |
|---|---|
| Запити — Free | 100 / місяць |
| Запити — Starter | 500 / місяць |
| Запити — PRO | 5 000 / місяць |
| Запити — Business | 20 000 / місяць |
| Додаткові пакети запитів | Лише в тарифі Business10 000 за 5 € · 50 000 за 20 €, без ПДВ |
| Технічна підтримка API | Від тарифу Starter |
| MCP-сервер для AI-агентів | Усі тарифи, зокрема FreeЗараховується до того самого місячного ліміту запитів |
Вам не обов’язково будувати це самотужки
Якщо вільного розробника немає, є два шляхи, які не потребують жодного рядка коду. Підключіть Lucanto до AI-асистента через MCP і просто просіть рахунки звичайною мовою. Або доручіть інтеграцію комусь із розробників нижче — вони роблять саме це.
Партнери з інтеграції
Незалежні розробники та студії, які вже працювали з Lucanto API і можуть побудувати вашу інтеграцію під ключ. Рахунок вони виставляють вам напряму — ми не беремо комісії й не посередничаємо в замовленнях.
| Компанія | Країна | Контактна особа | Електронна пошта | Технології |
|---|---|---|---|---|
| SME Digital s.r.o. | Словаччина | Miloš Blaško | info@visblee.sk | PHP, Laravel, Ruby |
| Seiri s.r.o. | Словаччина | Marek Panti | marekpanti@gmail.com | Node.js, NestJS, Java |
| Seky IT s.r.o. | Словаччина | Lukáš Sekerák | sekys.sekys@gmail.com | PHP, Node.js |
| Studio TEM, s.r.o. | Словаччина | Michal Fehér | spolupraca@studiotem.com+421 911 258 330 | PHP, Laravel, WooCommerce, WordPress, Node.js |
| MATATE s.r.o. | Словаччина | Dávid Brontvaj | info@matate.sk | PHP, Next.js, Node.js |
Хочете потрапити до списку?
Якщо ви створюєте інтеграції й хочете отримувати замовлення, напишіть нам. Розкажіть, з якими технологіями працюєте і де можна побачити ваші роботи, — і ми додамо вас до цієї таблиці. hello@lucanto.eu
Часті запитання про API
Чи доступний REST API у тарифі Free?
Так. REST API є частиною Lucanto вже у Free, зі 100 запитами на місяць, — щоб підключити власну систему, переходити на вищий тариф не потрібно. Вищі ліміти приходять разом із платними тарифами: Starter 500, PRO 5 000 і Business 20 000 запитів на місяць.
Які ліміти запитів діють у кожному тарифі?
Free 100, Starter 500, PRO 5 000 і Business 20 000 запитів на місяць. У тарифі Business можна докупити додаткові пакети — 10 000 за 5 € або 50 000 за 20 €, обидва без ПДВ. Нижчі тарифи доповнення на додаткові запити не мають; якщо їх потрібно більше, ви переходите на вищий тариф.
Чи можу я виставити рахунок зі своєї системи?
Так, саме в цьому головний сенс API. Зі свого застосунку, інтернет-магазину чи внутрішнього інструмента ви звертаєтеся до Lucanto й виставляєте рахунок, нічого не переписуючи вручну; так само можна синхронізувати клієнтів і завантажувати документи разом з їхніми статусами. Ендпоінти, формати й автентифікацію описано в документації на docs.lucanto.eu.
Який токен обрати?
Для інтеграції, яка діє від імені компанії, — інтернет-магазину, синхронізації з бухгалтерією, внутрішнього інструмента — використовуйте токен робочого простору (lct_live_). Він прив’язаний саме до цього одного робочого простору, тож не дістанеться до чужих і не перестане працювати, коли людина, яка його створила, піде з компанії. Особистий токен (lct_pat_) несе ваш власний доступ в усіх робочих просторах, до яких ви належите, і пасує для власних скриптів та AI-асистентів. Для обох діє одне правило: під час створення токен обмежений правами того, хто його видав, тож він ніколи не дасть більшого доступу, ніж має сама ця людина.
Чим це відрізняється від MCP-сервера?
Та сама модель доступу, інший споживач і інший токен. REST API викликає ваш код — зазвичай з токеном робочого простору, який належить компанії. MCP викликає AI-асистент на кшталт Claude чи ChatGPT — з особистим токеном, який належить вам. Обидва спираються на ті самі області доступу й обидва зараховуються до того самого місячного ліміту запитів. MCP входить в усі тарифи, зокрема у Free.
Чи не зламаєте ви мою інтеграцію?
Помітні зміни — нові ендпоінти, нові поля та несумісні зміни — ми публікуємо в публічному changelog API, який можна фільтрувати за мітками й читати через RSS. Несумісні зміни позначено окремо, тож про зміну, яка вас торкнеться, ви дізнаєтеся ще до того, як вона дійде до вашої інтеграції, а не тоді, коли щось перестане працювати.
Чи надаєте ви технічну підтримку до API?
Технічна підтримка API доступна від тарифу Starter і вище. У Free ви маєте саме API зі 100 запитами на місяць, але без підтримки до нього. Якщо ви працюєте над інтеграцією й потрібна порада, напишіть нам через контактну форму.