Dinero API: практичний гайд
Що треба знати, щоб читати дані з Dinero: вхід через Visma Connect, одна організація на виклик, поля, які треба просити самому, і проводки, які читаються лише в межах одного облікового року. Приклади використовують саме ті адреси й параметри, які викликає JaKonto.
Зміст
Автентифікація: OAuth 2.0 через Visma Connect
Dinero використовує Visma Connect. Користувача відправляють на connect.visma.com/connect/authorize з вашим client_id, скоупами й redirect_uri; отриманий код обмінюють на токени на connect.visma.com/connect/token з grant_type=authorization_code url-кодованою формою.
Скоупи — dineropublicapi:read, dineropublicapi:write і offline_access, лише ті, що вам погодили. З offline_access приходить і refresh_token, тож користувачу не треба входити знову. Виклики API надсилають Authorization: Bearer <access_token>.
https://connect.visma.com/connect/authorize
?client_id=<CLIENT_ID>&response_type=code
&scope=dineropublicapi:read dineropublicapi:write offline_access
&redirect_uri=https://example.com/dinero/callback&state=<STATE>
curl -X POST https://connect.visma.com/connect/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=authorization_code&code=<CODE>&redirect_uri=https://example.com/dinero/callback" \
-d "client_id=<CLIENT_ID>&client_secret=<CLIENT_SECRET>"
Організації й вимога Pro
У користувача може бути кілька організацій. Візьміть їх через /v1/organizations і ставте id організації в шлях усіх інших викликів: /v1/{organizationId}/invoices тощо.
API потребує підписки Dinero Pro або Total. Без неї працює лише /v1/organizations; виклики до даних організації відхиляються з HTTP 403 і code 90.
curl https://api.dinero.dk/v1/organizations \
-H "Authorization: Bearer <ACCESS_TOKEN>"
→ [{"id": 123456, "name": "…", "isPro": true}]
Інвойси: page, pageSize і fields
Списки приймають page і pageSize. Список інвойсів повертає лише кілька полів, якщо не попросити більше через fields — без TotalExclVat і TotalInclVat ваші суми вийдуть 0.
curl -G https://api.dinero.dk/v1/<ORG_ID>/invoices \
--data-urlencode 'page=0' --data-urlencode 'pageSize=100' \
--data-urlencode 'fields=Guid,Number,ContactName,Date,PaymentDate,Currency,Status,TotalExclVat,TotalInclVat' \
-H "Authorization: Bearer <ACCESS_TOKEN>"
Проводки: лише в межах одного облікового року
/v1/{organizationId}/entries потребує fromDate і toDate, і обидві дати мають бути в одному обліковому році — інакше Dinero відповідає code 82. Період на кілька років ділять по роках.
Відповідь — голий масив, а не обʼєкт з Collection, як у списку інвойсів.
curl -G https://api.dinero.dk/v1/<ORG_ID>/entries \
--data-urlencode 'fromDate=2026-01-01' --data-urlencode 'toDate=2026-06-30' \
-H "Authorization: Bearer <ACCESS_TOKEN>"
→ [{"AccountNumber": 1000, "Amount": -1250.0, "Date": "2026-01-14", …}]
Граблі, на які ми наступили самі
- Регістр змішаний: /organizations відповідає в camelCase (id, name, isPro), списки й проводки — у PascalCase (Guid, TotalInclVat, AccountNumber, Amount). Читайте обидва.
- Ліміт запитів застосовується: 100 викликів на хвилину на організацію для партнерів, 60 на хвилину на клієнта для персональних інтеграцій. Понад це API відповідає 429.
- Вебхуки є лише для entries і лише для інтеграцій через Visma Connect, не через API-ключ: GET /v1/{organizationId}/webhooks/events і POST …/webhooks/subscribe.
- Суми — у кронах з десятковими; переводьте в ере (цілі), перш ніж додавати.
JaKonto і Dinero
Інтеграцію JaKonto з Dinero через Visma Connect збудовано з тими самими полями, що з e-conomic і Billy; її ввімкнуть пізніше. А поки можна взяти безкоштовний API-ключ і спробувати API на демо-компанії e-conomic — ваші виклики не зміняться, коли відкриється Dinero.
Питання
Де офіційна документація API Dinero?
На developer.dinero.dk (посібники) і api.dinero.dk/openapi (ендпоінти).
Чи працює API Dinero з безкоштовним Dinero?
Ні. Потрібна підписка Dinero Pro або Total; без неї можна викликати лише /v1/organizations.
Скільки викликів можна робити?
100 на хвилину на організацію для партнерів і 60 на хвилину на клієнта для персональних інтеграцій. Понад це Dinero відповідає 429.
Чи має Dinero вебхуки?
Так, для entries і лише для інтеграцій через Visma Connect.
Чи пише JaKonto в Dinero?
Ні. JaKonto лише читає.
Інтеграція з e-conomic API · Інтеграція з Billy API · Інтеграція з Dinero API · MCP-сервер