Dinero API: personlig eller offentlig integration til Dinero

Kort svar: Dinero API er et REST-API, der lader andre systemer oprette fakturaer, bogføre købsbilag, hente kontakter og læse regnskabstal i Dinero. Der er to veje ind: en personlig integration med API-nøgle, hvis det kun er til jeres egen virksomhed, og en offentlig integration via Visma Connect med OAuth 2.0, hvis I vil tilbyde den til andre Dinero-brugere. Uanset vej skal Dinero-regnskabet have Pro eller Total, ellers afvises kaldene.

Hvad er Dinero API?

Dinero er et regnskabsprogram, der primært bruges af små og mellemstore danske virksomheder, og hele systemet følger dansk lovgivning. Dinero API er et REST-API, hvor du bruger GET, POST, PUT og DELETE, som du kender det fra andre API'er. Dokumentationen er på engelsk, men Dinero svarer på både dansk og engelsk (Dinero Developer).

Alle kald går til api.dinero.dk efterfulgt af version og organisations-ID, fx /v1/{organizationId}/invoices for fakturaer. Hele listen over endpoints ligger i Dineros OpenAPI-dokumentation (Dinero API).

Hvad kan Dinero API?

Dinero giver et konkret råd om, hvilke endpoints man skal vælge: Brug dem, som brugerne selv ville bruge i programmet. En udgift bogføres som købsbilag. Laver jeres eget system fakturaen, giver det mening at bogføre den som et manuelt bilag med fakturaen vedhæftet som fil. Bogfører integrationen dagligt salg, er et manuelt bilag også det naturlige valg, gerne med ekstra konti til fx kortbetaling og MobilePay (Dinero Developer).

Personlig eller offentlig integration

Dinero har to adskilte login-systemer, og du skal kun bruge det ene (Dinero Developer).

Personlig integration

Du søger om credentials direkte i Dinero under Integrationer, "Se og opret API-nøgler" og "Personlig Integration". Det kræver et gyldigt Pro- eller Total-abonnement, og udløber abonnementet, mister integrationen adgangen. Client ID og secret vises kun én gang, og Dinero godkender normalt inden for en arbejdsdag (Dinero Developer).

Offentlig integration via Visma Connect

Her opretter du en konto i Visma Developer Portal. Teamet skal have Danmark som land og være en rigtig virksomhed med et rigtigt CVR-nummer, ellers bliver ansøgningen afvist. Client ID'et skal tydeligt vise, hvilken virksomhed der står bag, og må ikke indeholde navnet Dinero. Kun applikationstypen web application understøttes (Dinero Developer). Dinero kan afvise en integration af hensyn til sikkerhed, ineffektiv brug af API'et eller hvis tjenesten ligger for tæt på Dineros egen forretning (Dinero Developer).

Før integrationen kan udgives, skal den igennem en teknisk gennemgang. Du kører den med realistisk trafik, sender Client ID og tidsrum til Dinero og får grønt eller rødt lys. Integrationen skal kunne håndtere fejl som 400, 401 og 403 og stoppe ved gentagne fejl. Derefter kan den komme på Dineros integrationsside (Dinero Developer).

Login og tokens i Dinero API

Ved en personlig integration sender du Client ID og secret (base64-kodet) sammen med en API-nøgle, som du genererer i den organisation, du vil koble på. Til gengæld får du et adgangstoken, der gælder i én time (Dinero Developer):

POST https://authz.dinero.dk/dineroapi/oauth/token
Authorization: Basic base64(client_id:client_secret)
Content-Type: application/x-www-form-urlencoded

grant_type=password&scope=read write&username=<API-nøgle>&password=<API-nøgle>

Ved en offentlig integration sender du brugeren til Visma Connect med scopes som dineropublicapi:read, dineropublicapi:write og offline_access. Når brugeren godkender, bytter du koden til et adgangstoken. Med offline_access får du også et refresh token, så brugeren ikke skal godkende igen hver time (Dinero Developer). Dinero anbefaler et genbrugeligt refresh token med 365 dages levetid. Så skal brugeren godkende integrationen igen én gang om året (Dinero Developer).

Bemærk at Visma Connect er brugerbaseret, ikke virksomhedsbaseret. En revisor med ti virksomheder godkender altså én gang, og integrationen skal derefter bruge /organizations til at lade brugeren vælge den rigtige virksomhed. Har virksomheden hverken Pro eller Total, kan du kun kalde /organizations, og alt andet giver 403 (Dinero Developer, Dinero Developer).

Grænser, sider og webhooks

• Antal kald. 100 kald i minuttet pr. organisation pr. Client ID for offentlige integrationer og 60 i minuttet for personlige. Går du over, får du fejlkode 429 (Dinero Developer, Dinero Developer).
• Sider. Lister returnerer 100 poster som standard og højst 1.000 pr. side (Dinero Developer).
• Filtre. Ikke alle felter kan filtreres. Kun endpoints med parameteren queryFilter understøtter det (Dinero Developer).
• Webhooks. Der findes kun én webhook, for posteringer (entries), og kun for offentlige integrationer. Personlige integrationer skal i stedet hente lister med filteret changesSince (Dinero Developer).

Dinero holder øje med, hvordan API'et bruges. Bruger en integration ressourcerne ineffektivt eller rammer mange 400-, 401- eller 403-fejl, kan Dinero lukke adgangen, men skriver, at de altid vil forsøge at løse det i dialog først (Dinero Developer).

Byg selv eller brug en færdig integration?

Dineros integrationsoversigt har blandt andet sider om Shopify, WooCommerce, DanDomain, Stripe og MobilePay, og de fleste integrationer kræver Pro eller Total (Dinero). Er jeres behov det samme som alle andres, fx at salg fra en Shopify-butik skal bogføres, er en færdig integration næsten altid billigst.

En egen integration giver mening, når flowet er særligt: et branchesystem uden færdig kobling, et CRM der skal oprette tilbud, et tidsregistreringssystem der skal fakturere timer på den rigtige kunde, eller flere systemer der skal spille sammen. Til en enkelt virksomhed er den personlige integration hurtigst at komme i gang med. Se hvordan vi arbejder med Dinero-integration, systemintegration og AI-automatisering. Er I i tvivl om værktøjer uden kode, så læs Hvad er n8n?, og bruger I et andet regnskabsprogram, så se e-conomic API eller Billy API.

Typiske faldgruber

• Forkert abonnement. Testen virker i de 30 gratis Pro-dage, men bagefter falder virksomheden tilbage til Starter, og kaldene afvises (Dinero). Tjek HasPro eller HasTotal via /organizations. Bygger I en offentlig integration, kan Dinero give testvirksomheden Pro til API-test (Dinero Developer).
• Brugte refresh tokens. Visma Connect har replay-beskyttelse. Bytter du et allerede brugt engangs-token, ugyldiggøres hele godkendelsen, og brugeren skal godkende igen.
• Forkert Visma-profil. Udvikleren har én Visma-profil til Connect og en anden til Dinero og får 401. Tjek hvilken bruger der er logget ind ved godkendelsen.
• Forkert bilagstype. Udgifter oprettet som kassekladdelinjer i stedet for købsbilag forvirrer brugerne. Følg Dineros eget råd om bilagstyper.
• Dubletter og spidser. En kampagne giver mange ordrer på kort tid. Læg kaldene i kø under grænsen, og sørg for at samme ordre ikke bogføres to gange.