Dinero API: en praktisk guide
Det, du skal vide for at læse data fra Dinero: login via Visma Connect, én organisation pr. kald, felter du selv skal bede om, og posteringer, der kun kan hentes inden for ét regnskabsår. Eksemplerne bruger præcis de adresser og parametre, JaKonto selv kalder.
Indhold
Login: OAuth 2.0 via Visma Connect
Dinero bruger Visma Connect. Brugeren sendes til connect.visma.com/connect/authorize med dit client_id, dine scopes og din redirect_uri; den kode, der kommer tilbage, veksles til tokens på connect.visma.com/connect/token med grant_type=authorization_code som url-kodet formular.
Scopes er dineropublicapi:read, dineropublicapi:write og offline_access — kun dem, du har fået godkendt. Med offline_access får du også et refresh_token, så brugeren ikke skal logge ind igen. Selve API-kaldene sender 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>"
Organisationer og Pro-kravet
En bruger kan have flere organisationer. Hent dem med /v1/organizations, og brug organisationens id i stien til alt andet: /v1/{organisationId}/invoices osv.
API'et kræver et Dinero Pro- eller Total-abonnement. Uden det virker kun /v1/organizations; kald på organisationens data afvises med HTTP 403 og code 90.
curl https://api.dinero.dk/v1/organizations \
-H "Authorization: Bearer <ACCESS_TOKEN>"
→ [{"id": 123456, "name": "…", "isPro": true}]
Fakturaer: page, pageSize og fields
Lister tager page og pageSize. Listen over fakturaer returnerer kun få felter, medmindre du beder om flere med fields — uden TotalExclVat og TotalInclVat bliver dine summer 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>"
Posteringer: kun inden for ét regnskabsår
/v1/{organisationId}/entries kræver fromDate og toDate, og begge skal ligge i samme regnskabsår — ellers svarer Dinero med code 82. Spænder din periode over flere år, så del den op pr. regnskabsår.
Svaret er et rent array, ikke et objekt med Collection som fakturalisten.
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", …}]
Faldgruber, vi selv er gået i
- Store og små bogstaver blandes: /organizations svarer i camelCase (id, name, isPro), lister og posteringer i PascalCase (Guid, TotalInclVat, AccountNumber, Amount). Læs begge.
- Rate limit håndhæves: 100 kald pr. minut pr. organisation for partnere, 60 pr. minut pr. klient for personlige integrationer. Over grænsen svarer API'et 429.
- Webhooks findes kun for entries og kun for Visma Connect-integrationer, ikke for API-nøgle-integrationer: GET /v1/{organisationId}/webhooks/events og POST …/webhooks/subscribe.
- Beløb er kroner med decimaler; regn i øre (heltal), før du summerer.
JaKonto og Dinero
JaKontos Dinero-integration via Visma Connect er bygget med de samme felter som fra e-conomic og Billy og slås til senere. Indtil da kan du hente en gratis API-nøgle og afprøve API'et på e-conomics demo-regnskab — dine kald bliver de samme, når Dinero åbner.
Spørgsmål
Hvor er den officielle Dinero API-dokumentation?
På developer.dinero.dk (vejledning) og api.dinero.dk/openapi (endpoints).
Virker Dineros API med gratis Dinero?
Nej. Det kræver Dinero Pro eller Total; uden det kan du kun kalde /v1/organizations.
Hvor mange kald må jeg lave?
100 pr. minut pr. organisation for partnere og 60 pr. minut pr. klient for personlige integrationer. Derover svarer Dinero 429.
Har Dinero webhooks?
Ja, for entries og kun for Visma Connect-integrationer.
Skriver JaKonto i Dinero?
Nej. JaKonto læser kun.
e-conomic API-integration · Billy API-integration · Dinero API-integration · MCP-server