Buchwerke

Die Endpunkte der Version 1.2 sind momentan in der Entwicklung und können noch Änderungen erfahren.

Hinweise zur Funktion

Buchwerke stellen eine Sammlung aller Konten eines Unternehmens dar. Erst über Buchwerke sind die Hauptkonten eines Kontenrahmenes im Unternehmen ansprechbar. Jedes Buchwerk stellt für sich eine bilanzierende Einheit dar. Im Falle einer Verwaltung fremder Objekte (reine Fremdverwaltung, Wohnungseigentumsverwaltung oder Sondereigentumsverwaltung) werden je Eigentümergemeinschaft oder je Eigentümer die Buchungen in eigenen Buchwerken gesammelt und für die Abrechnung gegenüber dem Eigentümer genutzt. Um Kostenumbuchungen in der Umlagenabrechnung der Vorjahre vornehmen zu können, ohne dass Umsätze im laufenden Geschäftsjahr entstehen, gibt es spezielle Buchwerke vom Typ „Buchung". Diese sind nicht mit der Finanzbuchhaltung verbunden und bieten die Möglichkeit, die Kosten von einem AK/KV auf einen anderen AK/KV umzubuchen.

Buchwerke lassen sich über den folgenden API-Endpunkt aufrufen:

Buchwerke abrufen

Version 1.0

---

get

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

Codestring · nullfähigOptional

Namestring · nullfähigOptional

CompanyCodeTypeIdinteger · int32Optional

CompanyCodeTypeCodestring · nullfähigOptional

ManagementIdinteger · int32 · nullfähigOptional

Managementstring · nullfähigOptional

NodeIdinteger · int32Optional

OwnerIdinteger · int32 · nullfähigOptional

Ownerstring · nullfähigOptional

ValidFromstring · dateOptionalExample: 2026-03-24Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ValidTostring · date · nullfähigOptionalExample: 2026-03-24Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

AdministrationTypeIdinteger · int32 · nullfähigOptional

AdministrationTypeNamestring · nullfähigOptional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.0/AccountancyMasterData/CompanyCodes

HTTPcURLJavaScriptPython

GET /openwowi/v1.0/AccountancyMasterData/CompanyCodes HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "Code": "text",
    "Name": "text",
    "CompanyCodeTypeId": 1,
    "CompanyCodeTypeCode": "text",
    "ManagementId": 1,
    "Management": "text",
    "NodeId": 1,
    "OwnerId": 1,
    "Owner": "text",
    "ValidFrom": "2026-03-24",
    "ValidTo": "2026-03-24",
    "AdministrationTypeId": 1,
    "AdministrationTypeName": "text"
  }
]

---

Version 1.2

---

get

Autorisierungen

Authorization

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

ownerIdinteger · int32Optional

ownerNumberstringOptional

managementIdinteger · int32Optional

managementIdNumstringOptional

companyCodeIdinteger · int32Optional

companyCodeCodestringOptional

includeFiscalYearsbooleanOptional

includeBookingPeriodsbooleanOptional

showNullValuesbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

Idinteger · int32Optional

Codestring · nullfähigOptional

Namestring · nullfähigOptional

NodeIdinteger · int32Optional

ValidFromstring · dateOptionalExample: 2026-03-24Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

ValidTostring · date · nullfähigOptionalExample: 2026-03-24Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.2/AccountancyMasterData/CompanyCodes

HTTPcURLJavaScriptPython

GET /openwowi/v1.2/AccountancyMasterData/CompanyCodes HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "Code": "text",
    "Name": "text",
    "NodeId": 1,
    "ValidFrom": "2026-03-24",
    "ValidTo": "2026-03-24",
    "Management": {
      "Id": 1,
      "IdNum": "text",
      "Name": "text",
      "PersonId": 1
    },
    "Owner": {
      "Id": 1,
      "OwnerNumber": "text"
    },
    "CompanyCodeType": {
      "Id": 1,
      "Name": "text"
    },
    "AdministrationType": {
      "Id": 1,
      "Name": "text"
    },
    "FiscalYears": [
      {
        "Id": 1,
        "Number": 1,
        "Name": "text",
        "ValidFrom": "2026-03-24",
        "ValidTo": "2026-03-24",
        "FirstCalenderMonth": 1,
        "FirstCalenderYear": 1,
        "ValidBookingFrom": "2026-03-24",
        "ValidBookingTo": "2026-03-24",
        "ValidCalenderDateFrom": "2026-03-24",
        "ValidCalenderDateTo": "2026-03-24",
        "CountPeriods": 1
      }
    ],
    "BookingPeriods": [
      {
        "Id": 1,
        "Number": 1,
        "Open": true,
        "OpenCommissioning": true,
        "OpenCooperativeManagement": true,
        "OpenRentAccounting": true,
        "OpenRunningCostDistribution": true,
        "ValidFrom": "2026-03-24",
        "ValidTo": "2026-03-24",
        "FiscalYear": {
          "Id": 1,
          "Number": 1
        }
      }
    ]
  }
]

---