← Інтеграція з Dinero API

Dinero API: практичний гайд

Що треба знати, щоб читати дані з Dinero: вхід через Visma Connect, одна організація на виклик, поля, які треба просити самому, і проводки, які читаються лише в межах одного облікового року. Приклади використовують саме ті адреси й параметри, які викликає JaKonto.

Зміст

  1. Автентифікація: OAuth 2.0 через Visma Connect
  2. Організації й вимога Pro
  3. Інвойси: page, pageSize і fields
  4. Проводки: лише в межах одного облікового року
  5. Граблі, на які ми наступили самі
  6. JaKonto і Dinero

Автентифікація: 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-сервер