API-інтеграції
Інтеграції з Dinero, e-conomic, CVR, данськими адресними даними, Stripe і Skat, які ми будуємо й підтримуємо.
JaKonto: один API для данської бухгалтерії
Один API лише на читання поверх данських облікових систем із MCP-сервером в офіційному реєстрі MCP. Підійде, коли вашому застосунку потрібні бухгалтерські дані без окремої інтеграції з кожною системою.
Данський бізнес працює на кількох системах, які рідко між собою розмовляють: бухгалтерська програма, інтернет-магазин чи система бронювання, платіжний провайдер і державні реєстри компаній та адрес. Кожне відсутнє з'єднання перетворюється на ручну роботу — ввести номер CVR, перевірити адресу, скопіювати рахунок, — а ручна робота перетворюється на помилки.
Ми будуємо інтеграції з цими системами й знаємо їхні особливості з власних продуктів. До Dinero звертаємося через Visma Connect з OAuth і PKCE; публічне API працює лише для організацій із підпискою Pro, а проводки віддає тільки в межах одного фінансового року за запит. e-conomic використовує іншу схему — токен застосунку й токен угоди, — тому між вашою системою та бухгалтерською програмою ми ставимо шар, незалежний від провайдера. Дані про компанії беремо з реєстру CVR, включно з публічним реєстром власників, який показує, кому належить яка частка. Адреси — з DAR у форматі, сумісному з DAWA, старим адресним сервісом, який уже закрито.
Наш бухгалтерський API jakonto.dk читає данські облікові системи через один інтерфейс. danadresse.dk — наш DAWA-сумісний адресний API з 56 ендпоінтами, а soge.dk і uahub.dk використовують дані CVR для пошуку компаній і для перевірки, що людина, яка заявляє права на компанію, справді її контролює. Зі Stripe ми зробили депозити через Connect і захист від неявок у нашій платформі бронювання та оплату за фактичне використання в нашому адресному API. Два чесні застереження. Наш клієнт для ПДВ-інтерфейсу Skat працює в тестовому середовищі Skat, а доступ до продакшену ще в очікуванні. А щодо входу через MitID ми провели дослідження й обрали брокера, але інтеграцію ще не будували.
Одна інтеграція двох систем коштує від 1 000 DKK без ПДВ. Ціна залежить від того, чи мають системи задокументовані API, скільки полів і напрямків задіяно і скільки логіки повторів, журналювання й тестування потрібно. Після запуску лишаються невеликі поточні витрати: хостинг, можлива плата провайдеру за доступ до API та супровід від 600 DKK на місяць, щоб інтеграція встигала за змінами API.
Не замовляйте індивідуальну інтеграцію, якщо готовий конектор уже виконує задачу. Багато інтернет-магазинів і систем бронювання вже мають конектор до e-conomic чи Dinero, і ввімкнути його дешевше. А якщо вам потрібен лише пошук за CVR чи адресою у формі, готовий API під'єднати швидше, ніж будь-що, зроблене з нуля.
Ключові можливості
Бухгалтерські системи
Читання клієнтів, рахунків, товарів і проводок із Dinero та e-conomic через один шар, незалежний від провайдера. Токени доступу зберігаються зашифрованими, окремий набір для кожного клієнта.
Пошук за CVR
Пошук компаній за номером CVR чи назвою з автоматичним заповненням назви й адреси. Номер CVR перевіряється за контрольною цифрою ще до запиту в реєстр.
Данські адреси
Автодоповнення, очищення адрес і зворотний пошук на даних DAR у форматі, сумісному з DAWA, тож код, написаний під DAWA, потребує мінімальних змін.
Платежі через Stripe
Checkout, підписки, депозити через Stripe Connect і оплата за використання. Вебхуки перевіряються, зберігаються й дедуплікуються, тож повторна подія обробляється рівно один раз.
ПДВ-інтерфейс Skat
Клієнт на Python із підписом WS-Security для ПДВ-API Skat, що працює в тестовому середовищі. API створює чернетку декларації, яку компанія потім підтверджує на skat.dk.
Журнали й повтори
Кожен виклик записується зі статусом і часом, ліміти запитів дотримуються, а тимчасові помилки повторюються. Помилки, повернені з HTTP 200, усе одно обробляються як помилки.
Чому варто обрати цю послугу
Дані, введені один раз, ідуть до наступної системи з тим самим написанням і тими самими числами.
Вимоги до підписки, обмеження за датами й дивні формати помилок ми знаємо до початку роботи, а не дізнаємося в продакшені.
Нейтральний шар між вашою системою й бухгалтерією означає, що зміна провайдера зачіпає один адаптер, а не всю систему.
Журнали викликів і сповіщення показують розірване з'єднання одразу, а не наприкінці місяця.
Як ми працюємо
Наш перевірений процес гарантує якість на кожному етапі
Перевіряємо доступи й ліміти
З'ясовуємо, яку підписку, реєстрацію застосунку й права вимагає кожен провайдер і які в нього ліміти запитів та вікна даних, ще до першого рядка коду.
Зіставляємо поля
Поля клієнтів, товарів, рахунків і ПДВ зіставляються між системами з чітким рішенням, яка система є головною для кожного з них.
Будуємо на тестових середовищах
Де провайдер має тестове середовище, як Stripe і Skat, ми спершу будуємо на ньому. Реальні дані з'являються лише після чистого тестового прогону.
Тест на офіційних зразках
Підписи й формати файлів ми перевіряємо на опублікованих зразках самого провайдера, тож знаємо, що наш результат збігається, ще до першого реального виклику.
Запуск із моніторингом
Інтеграцію вмикаємо з журналами й сповіщеннями, перші прогони відстежуємо разом із вами, а облікові дані тримаємо в сховищі секретів, ніколи в коді.
Часті запитання
Чи можете ви під'єднати наш магазин до e-conomic або Dinero?
У більшості випадків. Спершу перевіряємо, чи немає у вашого магазину готового конектора, бо це дешевше. Читання з Dinero ми перевірили наскрізь на реальному Pro-акаунті, а наші продукти мають адаптер читання для e-conomic; запис замовлень і рахунків у бухгалтерську програму будуємо під кожен проєкт, із зіставленими кодами ПДВ і тестом у пісочниці, перш ніж він торкнеться ваших книг.
Чому б не брати дані CVR напряму з Virk?
Можна, і ми так робимо. Доступ до розповсюдження CVR потребує користувача від Erhvervsstyrelsen, а дані треба кешувати, щоб вони були швидкими під навантаженням. Якщо вам потрібен лише пошук у формі, наш готовий API компаній на soge.dk під'єднати швидше; для масових чи особливих задач інтегруємося з реєстром напряму.
Чи підтримуєте ви вхід через MitID?
Поки що не як готову інтеграцію. MitID не можна під'єднати напряму — тільки через сертифікованого брокера. Ми порівняли брокерів і обрали одного для старту, але вхід через MitID для клієнта ще не будували. Якщо він вам потрібен, ми назвемо вартість одного входу ще до початку робіт.
Чи можете ви подавати нашу ПДВ-декларацію автоматично?
Ні, і повністю цього не може ніхто. ПДВ-API Skat створює чернетку декларації з ваших бухгалтерських даних, а компанія мусить сама підтвердити її на skat.dk. Наш клієнт для цього API працює в тестовому середовищі Skat, але доступ до продакшену ще в очікуванні, тож як готову послугу ми це поки не пропонуємо.
Що буде, коли провайдер змінить своє API?
Провайдери знімають версії з підтримки й перейменовують поля. На супроводі ми стежимо за їхніми повідомленнями про зміни, регулярно запускаємо тести інтеграції й оновлюємо код до того, як стара версія перестане працювати. Без супроводу виправляємо за погодинною ставкою 500 DKK, коли вам це потрібно.
Готові перейти через міст?
Давайте побудуємо ваш блискавичний міст до цифрової трансформації. Від першої консультації до розгортання — ми рухаємося швидко.