Spring til indhold

Talverk for udviklere

Læs virksomhedens eget regnskab fra jeres egne systemer - konti, posteringer, resultatopgørelse, balance, debitorer, kreditorer, fakturaer, budget og nøgletal. Kun læsning.

Kom i gang

API'et er en del af Talverk-portalen. En virksomhed får en nøgle, når den har en bogholder med et abonnement på portalen, og bogholderen har slået API'et til for den. Nøglen oprettes i kundeportalen under Virksomhed → Apps → API og giver kun adgang til den ene virksomhed - og kun til det, bogholderen deler med den.

  1. Prøv API'et med sandkasse-nøglen herunder - den giver kun opdigtede tal fra demoen.
  2. Byg jeres integration med en testnøgle (tvk_test_) - den giver også kun demoens tal.
  3. Skift til en live-nøgle (tvk_live_), når bogholderen har slået det til.

Sandkassen

Offentlig nøgle - kun læsning af demoens opdigtede tal, med egne grænser pr. IP-adresse:

curl https://talverk.dk/portal/api/v1/virksomhed/ \
  -H "Authorization: Bearer tvk_test_sandkasse_offentlig"

Vilkårene for API'et følger, før API'et åbnes for rigtige data. Sandkassen og testnøglerne viser kun opdigtede tal.

Godkendelse

Send nøglen i Authorization-hovedet - kun over https:

Authorization: Bearer tvk_live_...

En nøgle i adressen (fx ?key=) afvises og tilbagekaldes med det samme, så I skal lave en ny. Send aldrig nøglen over http - API'et svarer kun over https. Kald API'et fra jeres server, ikke fra en browser (der er ingen CORS). Adressen er jeres bogholders portaladresse, fx https://talverk.dk/portal/api/v1/.

  • tvk_live_... - virksomhedens egne tal.
  • tvk_test_... og sandkassen - kun demoens opdigtede tal. Hvilke data en nøgle giver, afgøres af nøglen selv - aldrig af en parameter.

Adgange (scopes)

Hver nøgle har de adgange, der blev valgt, da den blev oprettet - og et kald virker kun, når bogholderen stadig deler de data med virksomheden.

AdgangGiver
regnskab:laesRegnskab: konti, posteringer, resultatopgørelse og balance
debitorer:laesDebitorer: åbne poster
kreditorer:laesKreditorer: åbne poster
fakturaer:laesFakturaer fra bogholderiet
budget:laesBudget (resultatbudgettet)
noegletal:laesNøgletal
ai:spoergAI-assistenten (spørgsmål - koster pr. spørgsmål)

Endpoints

Alle svar er JSON. Beløb er tekst med to decimaler ("1234.50"), datoer ÅÅÅÅ-MM-DD. Læse-endpointene svarer i et omslag: virksomhed, tilstand (live eller test), hentet (hvornår tallene sidst blev hentet fra regnskabsprogrammet), fortegn, data og naeste. Fortegn: konti/ og posteringer/ har bogføringens (debet +, kredit -), resten opstillingens (indtægter, egenkapital og gæld med plus).

GET/portal/api/v1/virksomhed/

Virksomheden

Navn, CVR-nummer, regnskabsprogram, regnskabsårene med perioderne - og nøglens adgang.

Alle nøgler.

Eksempel på svar (opdigtede tal)
{
  "navn": "Nordlys Design ApS",
  "cvr": "41234567",
  "regnskabsprogram": "e-conomic",
  "regnskabsaar": [
    {
      "id": "2026",
      "navn": "2026",
      "fra": "2026-01-01",
      "til": "2026-12-31",
      "perioder": [
        {
          "nr": 1,
          "fra": "2026-01-01",
          "til": "2026-01-31"
        }
      ]
    }
  ],
  "noeglens_adgang": [
    "regnskab:laes"
  ],
  "delt_med_virksomheden": [
    "fakturaer:laes",
    "regnskab:laes"
  ]
}

Fejl: 401 mangler_noegle, 401 ukendt_noegle, 429 for_mange_kald

GET/portal/api/v1/konti/

Konti med saldi

Kontoplanen, som kunden ser den under Regnskab: årets bevægelse, sidste år og saldoen. Bogføringens fortegn (debet +, kredit -).

Adgang: regnskab:laes

ParameterTypeBeskrivelse
aarstringRegnskabsårets id fra virksomhed/ (standard: indeværende år).
fra_periodeintegerFørste periode (1-18) - sammen med til_periode.
til_periodeintegerSidste periode (1-18) - sammen med fra_periode.
Eksempel på svar (opdigtede tal)
{
  "aar": "2026",
  "konti": [
    {
      "nr": "1010",
      "navn": "Salg af ydelser",
      "slags": "resultat",
      "i_aar": "-842500.00",
      "sidste_aar": "-790000.00",
      "saldo": null
    }
  ]
}

Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet

GET/portal/api/v1/posteringer/

Posteringer på en konto

Bogførte posteringer og kladdens posteringer på én konto fra portalens seneste hentning. Bogføringens fortegn. Delt i sider.

Adgang: regnskab:laes · Delt i sider.

ParameterTypeBeskrivelse
aarstringRegnskabsårets id fra virksomhed/ (standard: indeværende år).
konto (påkrævet)stringKontonummeret (påkrævet).
fra_datostringFra og med datoen (ÅÅÅÅ-MM-DD).
til_datostringTil og med datoen (ÅÅÅÅ-MM-DD).
antalintegerRækker pr. side (1-500, standard 100).
efterstringMarkøren fra "naeste" i forrige svar.
Eksempel på svar (opdigtede tal)
[
  {
    "dato": "2026-03-14",
    "konto": "1010",
    "bilag": 1043,
    "tekst": "Faktura 1043",
    "beloeb": "-12500.00",
    "kladde": false
  }
]

Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 400 ugyldig_markoer, 409 markoer_udloebet, 404 ikke_fundet

GET/portal/api/v1/resultatopgoerelse/

Resultatopgørelse

Som kundens side Regnskab -> Resultat med mellemresultaterne. Indtægter med plus og udgifter med minus.

Adgang: regnskab:laes

ParameterTypeBeskrivelse
aarstringRegnskabsårets id fra virksomhed/ (standard: indeværende år).
fra_periodeintegerFørste periode (1-18) - sammen med til_periode.
til_periodeintegerSidste periode (1-18) - sammen med fra_periode.
Eksempel på svar (opdigtede tal)
{
  "aar": "2026",
  "periode": "2026",
  "linjer": [
    {
      "slags": "konto",
      "nr": "1010",
      "navn": "Salg af ydelser",
      "i_aar": "842500.00",
      "sidste_aar": "790000.00"
    }
  ]
}

Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet

GET/portal/api/v1/balance/

Balance

Aktiver og passiver som på kundens side Regnskab. Egenkapital og gæld med plus.

Adgang: regnskab:laes

ParameterTypeBeskrivelse
aarstringRegnskabsårets id fra virksomhed/ (standard: indeværende år).
fra_periodeintegerFørste periode (1-18) - sammen med til_periode.
til_periodeintegerSidste periode (1-18) - sammen med fra_periode.
Eksempel på svar (opdigtede tal)
{
  "aar": "2026",
  "periode": "2026",
  "aktiver": [
    {
      "slags": "konto",
      "nr": "5810",
      "navn": "Bank",
      "i_aar": "15000.00",
      "sidste_aar": "0.00",
      "saldo": "215000.00"
    }
  ],
  "passiver": [],
  "forskel": null
}

Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet

GET/portal/api/v1/debitorer/

Debitorer (åbne poster)

Som kundens side Debitorer -> Skylder nu. Beløbene i kroner - en faktura i fremmed valuta har også valutaen og beløbet i valutaen.

Adgang: debitorer:laes

ParameterTypeBeskrivelse
visstring: skyldes, alle"skyldes" (standard) eller "alle" åbne poster.
Eksempel på svar (opdigtede tal)
{
  "visning": "skyldes",
  "kunder": [
    {
      "kundenr": "101",
      "navn": "Kunde A/S",
      "saldo": "25000.00",
      "forfaldent": "0.00",
      "fakturaer": [
        {
          "nr": "1043",
          "dato": "2026-10-01",
          "forfald": "2026-10-15",
          "beloeb": "25000.00",
          "mangler": "25000.00",
          "dage_over_forfald": 0
        }
      ]
    }
  ],
  "i_jeres_favoer": []
}

Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet

GET/portal/api/v1/kreditorer/

Kreditorer (åbne poster)

De åbne leverandørfakturaer pr. hentningens dag - som den automatiske kreditorsaldoliste.

Adgang: kreditorer:laes

Eksempel på svar (opdigtede tal)
{
  "pr_dato": "2026-10-14",
  "leverandoerer": [
    {
      "nr": "201",
      "navn": "Leverandør ApS",
      "i_alt": "4375.00",
      "fakturaer": [
        {
          "nr": "F-88",
          "forfald": "2026-10-20",
          "dage_over_forfald": 0,
          "beloeb": "4375.00"
        }
      ]
    }
  ],
  "kreditorkort_afviger": []
}

Fejl: 403 scope_mangler, 403 ikke_delt, 409 ikke_hentet

GET/portal/api/v1/fakturaer/

Fakturaer fra bogholderiet

Fakturaerne fra bogholderiet til virksomheden (som under Fakturaer). Ingen PDF og ingen timer.

Adgang: fakturaer:laes · Delt i sider.

ParameterTypeBeskrivelse
fra_datostringFra og med datoen (ÅÅÅÅ-MM-DD).
til_datostringTil og med datoen (ÅÅÅÅ-MM-DD).
betaltstring: ja, nejKun betalte eller ubetalte.
antalintegerRækker pr. side (1-500, standard 100).
efterstringMarkøren fra "naeste" i forrige svar.
Eksempel på svar (opdigtede tal)
[
  {
    "nr": "2026-041",
    "dato": "2026-10-01",
    "forfald": "2026-10-09",
    "periode_fra": "2026-09-01",
    "periode_til": "2026-09-30",
    "beloeb_ekskl_moms": "4000.00",
    "moms": "1000.00",
    "i_alt": "5000.00",
    "betalt": false,
    "betalt_dato": null
  }
]

Fejl: 403 scope_mangler, 400 ugyldig_parameter, 400 ugyldig_markoer

GET/portal/api/v1/budget/

Budget (resultatbudgettet)

Resultatbudgettet for regnskabsåret som på siden Budget: det faktiske og budgettet pr. måned. Som siden: indtægter med plus og udgifter med minus.

Adgang: budget:laes

ParameterTypeBeskrivelse
aarstringRegnskabsårets id fra virksomhed/ (standard: indeværende år).
Eksempel på svar (opdigtede tal)
{
  "aar": "2026",
  "godkendt": false,
  "maaneder": [
    "2026-01"
  ],
  "resultat_prognose": "120000.00",
  "linjer": [
    {
      "slags": "konto",
      "noegle": "1010",
      "navn": "1010 Salg af ydelser",
      "prognose": "900000.00",
      "maaneder": [
        {
          "maaned": "2026-01",
          "faktisk": "70000.00",
          "budget": "70000.00"
        }
      ]
    }
  ]
}

Fejl: 403 scope_mangler, 403 ikke_delt, 400 ugyldig_parameter, 409 ikke_hentet

GET/portal/api/v1/noegletal/

Nøgletal

Nøgletallene, regnet af portalen (ingen AI, koster intet). Samme form som AI-API'et.

Adgang: noegletal:laes

Eksempel på svar (opdigtede tal)
{
  "virksomhed": "Nordlys Design ApS",
  "tilstand": "test",
  "noegletal": {
    "omsaetning": {
      "now": 842500.0,
      "before": 790000.0
    },
    "resultat": {
      "now": 112000.0
    },
    "likvider_i_dag": 215000.0
  }
}

Fejl: 403 scope_mangler, 403 ikke_delt, 409 ikke_hentet

GET/portal/api/v1/status/

Status

Virksomheden, hentningen, nøglens adgang og månedens forbrug af AI-spørgsmål.

Alle nøgler.

Eksempel på svar (opdigtede tal)
{
  "virksomhed": "Nordlys Design ApS",
  "nøgle": "Sandkassen",
  "regnskab_hentet": "2026-10-14T06:00:00+02:00",
  "tilstand": "test",
  "scopes": [
    "regnskab:laes"
  ],
  "maaned": {
    "spoergsmaal": 0,
    "loft": 0,
    "pris_kr": "0.00"
  }
}

Fejl: 401 mangler_noegle, 401 ukendt_noegle

POST/portal/api/v1/spoerg/

Spørg AI-assistenten

AI-API'et: et spørgsmål om virksomhedens regnskab (kun live-nøgler, betalt pr. spørgsmål). Body: {"spoergsmaal": "..."}.

Adgang: ai:spoerg

Eksempel på svar (opdigtede tal)
{
  "svar": "Omsætningen er steget 7 % i forhold til samme periode sidste år.",
  "grafer": [],
  "utjekkede_tal": [],
  "pris_kr": "1.00",
  "virksomhed": "Nordlys Design ApS"
}

Fejl: 403 ikke_slaaet_til, 403 ikke_i_testtilstand, 429 for_mange_kald, 502 ai_fejl

GET/portal/api/v1/openapi.json

OpenAPI-beskrivelsen

Denne beskrivelse som OpenAPI 3.1 (offentlig - ingen nøgle).

Offentlig - ingen nøgle.

Eksempel på svar (opdigtede tal)
{
  "openapi": "3.1.0"
}

Paginering

posteringer/ og fakturaer/ er delt i sider: antal (1-500, standard 100) og efter = naeste fra forrige svar. Er naeste null, er der ikke flere. Markøren hører til nøglen, endpointet og filtrene. posteringer/: er tallene hentet igen siden første side, svarer API'et 409 markoer_udloebet - start forfra. fakturaer/: næste side fortsætter efter den sidste faktura på forrige side (fakturadato og rækkefølge), så en faktura, der ændres imens (fx bliver betalt), hverken springes over eller kommer to gange.

Fejl og grænser

En fejl svarer altid {"fejl": "...", "kode": "..."} med HTTP-status:

StatusKodeBetyder
400noegle_i_adressenNøglen stod i adressen. Den er tilbagekaldt - lav en ny, og send den kun i hovedet.
400ugyldig_markoerMarkøren (efter) er forfalsket eller hører til en anden nøgle, et andet endpoint eller andre filtre.
400ugyldig_parameterEn parameter har en værdi, API'et ikke kender.
401mangler_noegleIngen nøgle i Authorization-hovedet - eller en nøgle i et forkert format.
401ukendt_noegleNøglen findes ikke, er tilbagekaldt, eller hører til et andet bogholderi.
403abonnement_lukketBogholderiets abonnement er lukket.
403adgang_mistetDen, der oprettede nøglen, har ikke længere fuld adgang til virksomheden.
403ikke_deltBogholderen deler ikke de data med virksomheden.
403ikke_i_testtilstandEndpointet findes ikke i testtilstanden (fx AI-spørgsmål).
403ikke_slaaet_tilAI-API'et er ikke slået til for virksomheden.
403kun_httpsKaldet kom over http. En nøgle sendt over http er tilbagekaldt.
403scope_manglerNøglen har ikke den adgang, endpointet kræver.
403virksomhed_ophoertVirksomheden er ikke længere kunde hos bogholderiet.
404ikke_fundetAPI'et er ikke slået til, eller det, I spørger efter, findes ikke.
405metodeKun GET (spoerg/: kun POST).
409ikke_hentetRegnskabet (eller den del) er ikke hentet endnu.
409markoer_udloebetDataene er hentet igen siden første side - start forfra.
429for_mange_kaldFor mange kald - vent det antal sekunder, Retry-After siger.
502ai_fejlAI'en kunne ikke svare lige nu.
503testdata_manglerTestdataene (demoen) kan ikke bruges lige nu.

Grænser pr. nøgle: live 60 kald i minuttet og 5000 i døgnet, test 30 i minuttet og 1000 i døgnet. Sandkassen: 20 i minuttet og 300 i døgnet pr. IP-adresse. Over en grænse svarer API'et 429 med Retry-After (sekunder).

Versionering

Adressen har versionen (/v1/), og beskrivelsen er version 1.0.0. Nye felter kan komme til i v1 - læs svarene, så et ukendt felt ikke er en fejl. Hvordan versioner ændres og udfases, kommer til at stå i vilkårene for API'et. Hele beskrivelsen: openapi.json (OpenAPI 3.1).