{
 "openapi": "3.1.0",
 "info": {
  "title": "Talverk API",
  "version": "1.0.0",
  "description": "Læs virksomhedens eget regnskab fra jeres egne systemer - kun læsning. Testnøgler (tvk_test_) og sandkassen giver kun demoens opdigtede tal. Vilkårene for API'et følger, før API'et åbnes for rigtige data."
 },
 "servers": [
  {
   "url": "https://{vaert}/portal/api/v1",
   "variables": {
    "vaert": {
     "default": "talverk.dk",
     "description": "jeres bogholders portaladresse"
    }
   }
  }
 ],
 "security": [
  {
   "bearer": []
  }
 ],
 "paths": {
  "/virksomhed/": {
   "get": {
    "operationId": "virksomhed",
    "summary": "Virksomheden",
    "description": "Navn, CVR-nummer, regnskabsprogram, regnskabsårene med perioderne - og nøglens adgang.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "object",
             "properties": {
              "navn": {
               "type": "string"
              },
              "cvr": {
               "type": [
                "string",
                "null"
               ]
              },
              "regnskabsprogram": {
               "type": [
                "string",
                "null"
               ]
              },
              "regnskabsaar": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "id": {
                  "type": "string"
                 },
                 "navn": {
                  "type": "string"
                 },
                 "fra": {
                  "type": [
                   "string",
                   "null"
                  ],
                  "format": "date"
                 },
                 "til": {
                  "type": [
                   "string",
                   "null"
                  ],
                  "format": "date"
                 },
                 "perioder": {
                  "type": "array",
                  "items": {
                   "type": "object",
                   "properties": {
                    "nr": {
                     "type": "integer"
                    },
                    "fra": {
                     "type": "string"
                    },
                    "til": {
                     "type": "string"
                    }
                   }
                  }
                 }
                }
               }
              },
              "noeglens_adgang": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "delt_med_virksomheden": {
               "type": "array",
               "items": {
                "type": "string"
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": {
         "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"
         ]
        }
       }
      }
     },
     "401": {
      "description": "Ingen nøgle i Authorization-hovedet - eller en nøgle i et forkert format.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "429": {
      "description": "For mange kald - vent det antal sekunder, Retry-After siger.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": []
     }
    ],
    "x-scope": null
   }
  },
  "/konti/": {
   "get": {
    "operationId": "konti",
    "summary": "Konti med saldi",
    "description": "Kontoplanen, som kunden ser den under Regnskab: årets bevægelse, sidste år og saldoen. Bogføringens fortegn (debet +, kredit -).",
    "parameters": [
     {
      "name": "aar",
      "in": "query",
      "required": false,
      "description": "Regnskabsårets id fra virksomhed/ (standard: indeværende år).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "fra_periode",
      "in": "query",
      "required": false,
      "description": "Første periode (1-18) - sammen med til_periode.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "til_periode",
      "in": "query",
      "required": false,
      "description": "Sidste periode (1-18) - sammen med fra_periode.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "object",
             "properties": {
              "aar": {
               "type": "string"
              },
              "konti": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "nr": {
                  "type": "string"
                 },
                 "navn": {
                  "type": "string"
                 },
                 "slags": {
                  "type": "string",
                  "enum": [
                   "resultat",
                   "balance"
                  ]
                 },
                 "i_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "sidste_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "saldo": {
                  "$ref": "#/components/schemas/Beloeb"
                 }
                }
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": {
         "aar": "2026",
         "konti": [
          {
           "nr": "1010",
           "navn": "Salg af ydelser",
           "slags": "resultat",
           "i_aar": "-842500.00",
           "sidste_aar": "-790000.00",
           "saldo": null
          }
         ]
        }
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "400": {
      "description": "En parameter har en værdi, API'et ikke kender.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Regnskabet (eller den del) er ikke hentet endnu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "regnskab:laes"
      ]
     }
    ],
    "x-scope": "regnskab:laes"
   }
  },
  "/posteringer/": {
   "get": {
    "operationId": "posteringer",
    "summary": "Posteringer på en konto",
    "description": "Bogførte posteringer og kladdens posteringer på én konto fra portalens seneste hentning. Bogføringens fortegn. Delt i sider.",
    "parameters": [
     {
      "name": "aar",
      "in": "query",
      "required": false,
      "description": "Regnskabsårets id fra virksomhed/ (standard: indeværende år).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "konto",
      "in": "query",
      "required": true,
      "description": "Kontonummeret (påkrævet).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "fra_dato",
      "in": "query",
      "required": false,
      "description": "Fra og med datoen (ÅÅÅÅ-MM-DD).",
      "schema": {
       "type": "string",
       "format": "date"
      }
     },
     {
      "name": "til_dato",
      "in": "query",
      "required": false,
      "description": "Til og med datoen (ÅÅÅÅ-MM-DD).",
      "schema": {
       "type": "string",
       "format": "date"
      }
     },
     {
      "name": "antal",
      "in": "query",
      "required": false,
      "description": "Rækker pr. side (1-500, standard 100).",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "efter",
      "in": "query",
      "required": false,
      "description": "Markøren fra \"naeste\" i forrige svar.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "dato": {
                "type": "string"
               },
               "konto": {
                "type": "string"
               },
               "bilag": {
                "type": [
                 "integer",
                 "string",
                 "null"
                ]
               },
               "tekst": {
                "type": "string"
               },
               "beloeb": {
                "$ref": "#/components/schemas/Beloeb"
               },
               "kladde": {
                "type": "boolean"
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": [
         {
          "dato": "2026-03-14",
          "konto": "1010",
          "bilag": 1043,
          "tekst": "Faktura 1043",
          "beloeb": "-12500.00",
          "kladde": false
         }
        ]
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "400": {
      "description": "En parameter har en værdi, API'et ikke kender.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Dataene er hentet igen siden første side - start forfra.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "404": {
      "description": "API'et er ikke slået til, eller det, I spørger efter, findes ikke.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "regnskab:laes"
      ]
     }
    ],
    "x-scope": "regnskab:laes"
   }
  },
  "/resultatopgoerelse/": {
   "get": {
    "operationId": "resultatopgoerelse",
    "summary": "Resultatopgørelse",
    "description": "Som kundens side Regnskab -> Resultat med mellemresultaterne. Indtægter med plus og udgifter med minus.",
    "parameters": [
     {
      "name": "aar",
      "in": "query",
      "required": false,
      "description": "Regnskabsårets id fra virksomhed/ (standard: indeværende år).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "fra_periode",
      "in": "query",
      "required": false,
      "description": "Første periode (1-18) - sammen med til_periode.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "til_periode",
      "in": "query",
      "required": false,
      "description": "Sidste periode (1-18) - sammen med fra_periode.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "object",
             "properties": {
              "aar": {
               "type": "string"
              },
              "periode": {
               "type": "string"
              },
              "linjer": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "slags": {
                  "type": "string",
                  "enum": [
                   "overskrift",
                   "konto",
                   "sum",
                   "mellemresultat"
                  ]
                 },
                 "nr": {
                  "type": [
                   "string",
                   "null"
                  ]
                 },
                 "navn": {
                  "type": "string"
                 },
                 "i_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "sidste_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "saldo": {
                  "$ref": "#/components/schemas/Beloeb"
                 }
                }
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": {
         "aar": "2026",
         "periode": "2026",
         "linjer": [
          {
           "slags": "konto",
           "nr": "1010",
           "navn": "Salg af ydelser",
           "i_aar": "842500.00",
           "sidste_aar": "790000.00"
          }
         ]
        }
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "400": {
      "description": "En parameter har en værdi, API'et ikke kender.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Regnskabet (eller den del) er ikke hentet endnu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "regnskab:laes"
      ]
     }
    ],
    "x-scope": "regnskab:laes"
   }
  },
  "/balance/": {
   "get": {
    "operationId": "balance",
    "summary": "Balance",
    "description": "Aktiver og passiver som på kundens side Regnskab. Egenkapital og gæld med plus.",
    "parameters": [
     {
      "name": "aar",
      "in": "query",
      "required": false,
      "description": "Regnskabsårets id fra virksomhed/ (standard: indeværende år).",
      "schema": {
       "type": "string"
      }
     },
     {
      "name": "fra_periode",
      "in": "query",
      "required": false,
      "description": "Første periode (1-18) - sammen med til_periode.",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "til_periode",
      "in": "query",
      "required": false,
      "description": "Sidste periode (1-18) - sammen med fra_periode.",
      "schema": {
       "type": "integer"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "object",
             "properties": {
              "aar": {
               "type": "string"
              },
              "periode": {
               "type": "string"
              },
              "aktiver": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "slags": {
                  "type": "string",
                  "enum": [
                   "overskrift",
                   "konto",
                   "sum",
                   "mellemresultat"
                  ]
                 },
                 "nr": {
                  "type": [
                   "string",
                   "null"
                  ]
                 },
                 "navn": {
                  "type": "string"
                 },
                 "i_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "sidste_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "saldo": {
                  "$ref": "#/components/schemas/Beloeb"
                 }
                }
               }
              },
              "passiver": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "slags": {
                  "type": "string",
                  "enum": [
                   "overskrift",
                   "konto",
                   "sum",
                   "mellemresultat"
                  ]
                 },
                 "nr": {
                  "type": [
                   "string",
                   "null"
                  ]
                 },
                 "navn": {
                  "type": "string"
                 },
                 "i_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "sidste_aar": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "saldo": {
                  "$ref": "#/components/schemas/Beloeb"
                 }
                }
               }
              },
              "forskel": {
               "$ref": "#/components/schemas/Beloeb"
              }
             }
            }
           }
          }
         ]
        },
        "example": {
         "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
        }
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "400": {
      "description": "En parameter har en værdi, API'et ikke kender.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Regnskabet (eller den del) er ikke hentet endnu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "regnskab:laes"
      ]
     }
    ],
    "x-scope": "regnskab:laes"
   }
  },
  "/debitorer/": {
   "get": {
    "operationId": "debitorer",
    "summary": "Debitorer (åbne poster)",
    "description": "Som kundens side Debitorer -> Skylder nu. Beløbene i kroner - en faktura i fremmed valuta har også valutaen og beløbet i valutaen.",
    "parameters": [
     {
      "name": "vis",
      "in": "query",
      "required": false,
      "description": "\"skyldes\" (standard) eller \"alle\" åbne poster.",
      "schema": {
       "type": "string",
       "enum": [
        "skyldes",
        "alle"
       ]
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "object",
             "properties": {
              "visning": {
               "type": "string"
              },
              "kunder": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "kundenr": {
                  "type": [
                   "string",
                   "null"
                  ]
                 },
                 "navn": {
                  "type": "string"
                 },
                 "saldo": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "forfaldent": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "fakturaer": {
                  "type": "array",
                  "items": {
                   "type": "object",
                   "properties": {
                    "nr": {
                     "type": "string"
                    },
                    "dato": {
                     "type": [
                      "string",
                      "null"
                     ],
                     "format": "date"
                    },
                    "forfald": {
                     "type": [
                      "string",
                      "null"
                     ],
                     "format": "date"
                    },
                    "beloeb": {
                     "$ref": "#/components/schemas/Beloeb"
                    },
                    "mangler": {
                     "$ref": "#/components/schemas/Beloeb"
                    },
                    "dage_over_forfald": {
                     "type": "integer"
                    },
                    "valuta": {
                     "type": "string"
                    },
                    "beloeb_valuta": {
                     "$ref": "#/components/schemas/Beloeb"
                    }
                   }
                  }
                 }
                }
               }
              },
              "i_jeres_favoer": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "kundenr": {
                  "type": [
                   "string",
                   "null"
                  ]
                 },
                 "navn": {
                  "type": "string"
                 },
                 "saldo": {
                  "$ref": "#/components/schemas/Beloeb"
                 }
                }
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": {
         "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": []
        }
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "400": {
      "description": "En parameter har en værdi, API'et ikke kender.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Regnskabet (eller den del) er ikke hentet endnu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "debitorer:laes"
      ]
     }
    ],
    "x-scope": "debitorer:laes"
   }
  },
  "/kreditorer/": {
   "get": {
    "operationId": "kreditorer",
    "summary": "Kreditorer (åbne poster)",
    "description": "De åbne leverandørfakturaer pr. hentningens dag - som den automatiske kreditorsaldoliste.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "object",
             "properties": {
              "pr_dato": {
               "type": "string"
              },
              "leverandoerer": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "nr": {
                  "type": "string"
                 },
                 "navn": {
                  "type": "string"
                 },
                 "i_alt": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "fakturaer": {
                  "type": "array",
                  "items": {
                   "type": "object",
                   "properties": {
                    "nr": {
                     "type": "string"
                    },
                    "forfald": {
                     "type": [
                      "string",
                      "null"
                     ],
                     "format": "date"
                    },
                    "dage_over_forfald": {
                     "type": "integer"
                    },
                    "beloeb": {
                     "$ref": "#/components/schemas/Beloeb"
                    }
                   }
                  }
                 }
                }
               }
              },
              "kreditorkort_afviger": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "nr": {
                  "type": "string"
                 },
                 "navn": {
                  "type": "string"
                 },
                 "saldo": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "paa_fakturaer": {
                  "$ref": "#/components/schemas/Beloeb"
                 }
                }
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": {
         "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": []
        }
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Regnskabet (eller den del) er ikke hentet endnu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "kreditorer:laes"
      ]
     }
    ],
    "x-scope": "kreditorer:laes"
   }
  },
  "/fakturaer/": {
   "get": {
    "operationId": "fakturaer",
    "summary": "Fakturaer fra bogholderiet",
    "description": "Fakturaerne fra bogholderiet til virksomheden (som under Fakturaer). Ingen PDF og ingen timer.",
    "parameters": [
     {
      "name": "fra_dato",
      "in": "query",
      "required": false,
      "description": "Fra og med datoen (ÅÅÅÅ-MM-DD).",
      "schema": {
       "type": "string",
       "format": "date"
      }
     },
     {
      "name": "til_dato",
      "in": "query",
      "required": false,
      "description": "Til og med datoen (ÅÅÅÅ-MM-DD).",
      "schema": {
       "type": "string",
       "format": "date"
      }
     },
     {
      "name": "betalt",
      "in": "query",
      "required": false,
      "description": "Kun betalte eller ubetalte.",
      "schema": {
       "type": "string",
       "enum": [
        "ja",
        "nej"
       ]
      }
     },
     {
      "name": "antal",
      "in": "query",
      "required": false,
      "description": "Rækker pr. side (1-500, standard 100).",
      "schema": {
       "type": "integer"
      }
     },
     {
      "name": "efter",
      "in": "query",
      "required": false,
      "description": "Markøren fra \"naeste\" i forrige svar.",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "array",
             "items": {
              "type": "object",
              "properties": {
               "nr": {
                "type": "string"
               },
               "dato": {
                "type": "string"
               },
               "forfald": {
                "type": [
                 "string",
                 "null"
                ],
                "format": "date"
               },
               "periode_fra": {
                "type": [
                 "string",
                 "null"
                ],
                "format": "date"
               },
               "periode_til": {
                "type": [
                 "string",
                 "null"
                ],
                "format": "date"
               },
               "beloeb_ekskl_moms": {
                "$ref": "#/components/schemas/Beloeb"
               },
               "moms": {
                "$ref": "#/components/schemas/Beloeb"
               },
               "i_alt": {
                "$ref": "#/components/schemas/Beloeb"
               },
               "betalt": {
                "type": "boolean"
               },
               "betalt_dato": {
                "type": [
                 "string",
                 "null"
                ],
                "format": "date"
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": [
         {
          "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
         }
        ]
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "400": {
      "description": "En parameter har en værdi, API'et ikke kender.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "fakturaer:laes"
      ]
     }
    ],
    "x-scope": "fakturaer:laes"
   }
  },
  "/budget/": {
   "get": {
    "operationId": "budget",
    "summary": "Budget (resultatbudgettet)",
    "description": "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.",
    "parameters": [
     {
      "name": "aar",
      "in": "query",
      "required": false,
      "description": "Regnskabsårets id fra virksomhed/ (standard: indeværende år).",
      "schema": {
       "type": "string"
      }
     }
    ],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "allOf": [
          {
           "$ref": "#/components/schemas/Omslag"
          },
          {
           "type": "object",
           "properties": {
            "data": {
             "type": "object",
             "properties": {
              "aar": {
               "type": "string"
              },
              "godkendt": {
               "type": "boolean"
              },
              "maaneder": {
               "type": "array",
               "items": {
                "type": "string"
               }
              },
              "resultat_prognose": {
               "$ref": "#/components/schemas/Beloeb"
              },
              "linjer": {
               "type": "array",
               "items": {
                "type": "object",
                "properties": {
                 "slags": {
                  "type": "string"
                 },
                 "noegle": {
                  "type": "string"
                 },
                 "navn": {
                  "type": "string"
                 },
                 "prognose": {
                  "$ref": "#/components/schemas/Beloeb"
                 },
                 "maaneder": {
                  "type": "array",
                  "items": {
                   "type": "object",
                   "properties": {
                    "maaned": {
                     "type": "string"
                    },
                    "faktisk": {
                     "$ref": "#/components/schemas/Beloeb"
                    },
                    "budget": {
                     "$ref": "#/components/schemas/Beloeb"
                    }
                   }
                  }
                 }
                }
               }
              }
             }
            }
           }
          }
         ]
        },
        "example": {
         "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"
            }
           ]
          }
         ]
        }
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "400": {
      "description": "En parameter har en værdi, API'et ikke kender.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Regnskabet (eller den del) er ikke hentet endnu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "budget:laes"
      ]
     }
    ],
    "x-scope": "budget:laes"
   }
  },
  "/noegletal/": {
   "get": {
    "operationId": "noegletal",
    "summary": "Nøgletal",
    "description": "Nøgletallene, regnet af portalen (ingen AI, koster intet). Samme form som AI-API'et.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "virksomhed": {
           "type": "string"
          },
          "noegletal": {
           "type": "object"
          },
          "tilstand": {
           "type": "string"
          }
         }
        },
        "example": {
         "virksomhed": "Nordlys Design ApS",
         "tilstand": "test",
         "noegletal": {
          "omsaetning": {
           "now": 842500.0,
           "before": 790000.0
          },
          "resultat": {
           "now": 112000.0
          },
          "likvider_i_dag": 215000.0
         }
        }
       }
      }
     },
     "403": {
      "description": "Nøglen har ikke den adgang, endpointet kræver.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "409": {
      "description": "Regnskabet (eller den del) er ikke hentet endnu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "noegletal:laes"
      ]
     }
    ],
    "x-scope": "noegletal:laes"
   }
  },
  "/status/": {
   "get": {
    "operationId": "status",
    "summary": "Status",
    "description": "Virksomheden, hentningen, nøglens adgang og månedens forbrug af AI-spørgsmål.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "virksomhed": {
           "type": "string"
          },
          "nøgle": {
           "type": "string"
          },
          "regnskab_hentet": {
           "type": [
            "string",
            "null"
           ]
          },
          "tilstand": {
           "type": "string"
          },
          "scopes": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "maaned": {
           "type": "object",
           "properties": {
            "spoergsmaal": {
             "type": "integer"
            },
            "loft": {
             "type": "integer"
            },
            "pris_kr": {
             "type": "string"
            }
           }
          }
         }
        },
        "example": {
         "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"
         }
        }
       }
      }
     },
     "401": {
      "description": "Ingen nøgle i Authorization-hovedet - eller en nøgle i et forkert format.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": []
     }
    ],
    "x-scope": null
   }
  },
  "/spoerg/": {
   "post": {
    "operationId": "spoerg",
    "summary": "Spørg AI-assistenten",
    "description": "AI-API'et: et spørgsmål om virksomhedens regnskab (kun live-nøgler, betalt pr. spørgsmål). Body: {\"spoergsmaal\": \"...\"}.",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "svar": {
           "type": "string"
          },
          "grafer": {
           "type": "array",
           "items": {
            "type": "object"
           }
          },
          "utjekkede_tal": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "pris_kr": {
           "type": "string"
          },
          "virksomhed": {
           "type": "string"
          }
         }
        },
        "example": {
         "svar": "Omsætningen er steget 7 % i forhold til samme periode sidste år.",
         "grafer": [],
         "utjekkede_tal": [],
         "pris_kr": "1.00",
         "virksomhed": "Nordlys Design ApS"
        }
       }
      }
     },
     "403": {
      "description": "AI-API'et er ikke slået til for virksomheden.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "429": {
      "description": "For mange kald - vent det antal sekunder, Retry-After siger.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     },
     "502": {
      "description": "AI'en kunne ikke svare lige nu.",
      "content": {
       "application/json": {
        "schema": {
         "$ref": "#/components/schemas/Fejl"
        }
       }
      }
     }
    },
    "security": [
     {
      "bearer": [
       "ai:spoerg"
      ]
     }
    ],
    "x-scope": "ai:spoerg",
    "requestBody": {
     "required": true,
     "content": {
      "application/json": {
       "schema": {
        "type": "object",
        "properties": {
         "spoergsmaal": {
          "type": "string"
         }
        }
       }
      }
     }
    }
   }
  },
  "/openapi.json": {
   "get": {
    "operationId": "openapi",
    "summary": "OpenAPI-beskrivelsen",
    "description": "Denne beskrivelse som OpenAPI 3.1 (offentlig - ingen nøgle).",
    "parameters": [],
    "responses": {
     "200": {
      "description": "OK",
      "content": {
       "application/json": {
        "schema": {
         "type": "object"
        },
        "example": {
         "openapi": "3.1.0"
        }
       }
      }
     }
    },
    "security": []
   }
  }
 },
 "components": {
  "securitySchemes": {
   "bearer": {
    "type": "http",
    "scheme": "bearer",
    "description": "Authorization: Bearer tvk_live_... eller tvk_test_... - aldrig i adressen."
   }
  },
  "schemas": {
   "Beloeb": {
    "type": [
     "string",
     "null"
    ],
    "pattern": "^-?\\d+\\.\\d{2}$",
    "description": "Kroner med to decimaler som tekst."
   },
   "Fejl": {
    "type": "object",
    "properties": {
     "fejl": {
      "type": "string"
     },
     "kode": {
      "type": "string",
      "enum": [
       "abonnement_lukket",
       "adgang_mistet",
       "ai_fejl",
       "for_mange_kald",
       "ikke_delt",
       "ikke_fundet",
       "ikke_hentet",
       "ikke_i_testtilstand",
       "ikke_slaaet_til",
       "kun_https",
       "mangler_noegle",
       "markoer_udloebet",
       "metode",
       "noegle_i_adressen",
       "scope_mangler",
       "testdata_mangler",
       "ugyldig_markoer",
       "ugyldig_parameter",
       "ukendt_noegle",
       "virksomhed_ophoert"
      ]
     }
    }
   },
   "Side": {
    "type": "object",
    "properties": {
     "naeste": {
      "type": [
       "string",
       "null"
      ],
      "description": "Markøren til næste side - send den som efter."
     }
    }
   },
   "Omslag": {
    "type": "object",
    "properties": {
     "virksomhed": {
      "type": "object",
      "properties": {
       "navn": {
        "type": "string"
       },
       "cvr": {
        "type": [
         "string",
         "null"
        ]
       }
      }
     },
     "tilstand": {
      "type": "string",
      "enum": [
       "live",
       "test"
      ]
     },
     "hentet": {
      "type": [
       "string",
       "null"
      ]
     },
     "fortegn": {
      "type": "string",
      "enum": [
       "bogfoering",
       "opstilling"
      ]
     },
     "data": {},
     "naeste": {
      "type": [
       "string",
       "null"
      ]
     }
    }
   }
  }
 },
 "x-scopes": {
  "regnskab:laes": "Regnskab: konti, posteringer, resultatopgørelse og balance",
  "debitorer:laes": "Debitorer: åbne poster",
  "kreditorer:laes": "Kreditorer: åbne poster",
  "fakturaer:laes": "Fakturaer fra bogholderiet",
  "budget:laes": "Budget (resultatbudgettet)",
  "noegletal:laes": "Nøgletal",
  "ai:spoerg": "AI-assistenten (spørgsmål - koster pr. spørgsmål)"
 },
 "x-graenser": {
  "live_pr_minut": 60,
  "live_pr_doegn": 5000,
  "test_pr_minut": 30,
  "test_pr_doegn": 1000,
  "sandkasse_pr_minut_pr_ip": 20,
  "sandkasse_pr_doegn_pr_ip": 300
 }
}