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

OAuth2passwordErforderlich

Use username and password.

Token URL:

Abfrageparameter

apiKeystringOptional

Antworten

200

OK

Idinteger · int32Optional

Codestring · nullableOptional

Namestring · nullableOptional

CompanyCodeTypeIdinteger · int32Optional

CompanyCodeTypeCodestring · nullableOptional

ManagementIdinteger · int32 · nullableOptional

Managementstring · nullableOptional

NodeIdinteger · int32Optional

OwnerIdinteger · int32 · nullableOptional

Ownerstring · nullableOptional

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

ValidTostring · date · nullableOptionalExample: 2026-08-17Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

AdministrationTypeIdinteger · int32 · nullableOptional

AdministrationTypeNamestring · nullableOptional

400

Bad Request

401

Unauthorized

get/openwowi/v1.0/AccountancyMasterData/CompanyCodes

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-08-17",
    "ValidTo": "2026-08-17",
    "AdministrationTypeId": 1,
    "AdministrationTypeName": "text"
  }
]

---

Version 1.2

---

get

Autorisierungen

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

Idinteger · int32Optional

Codestring · nullableOptional

Namestring · nullableOptional

NodeIdinteger · int32Optional

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

ValidTostring · date · nullableOptionalExample: 2026-08-17Pattern: \d{4}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])

400

Bad Request

401

Unauthorized

get/openwowi/v1.2/AccountancyMasterData/CompanyCodes

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-08-17",
    "ValidTo": "2026-08-17",
    "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-08-17",
        "ValidTo": "2026-08-17",
        "FirstCalenderMonth": 1,
        "FirstCalenderYear": 1,
        "ValidBookingFrom": "2026-08-17",
        "ValidBookingTo": "2026-08-17",
        "ValidCalenderDateFrom": "2026-08-17",
        "ValidCalenderDateTo": "2026-08-17",
        "CountPeriods": 1
      }
    ],
    "BookingPeriods": [
      {
        "Id": 1,
        "Number": 1,
        "Open": true,
        "OpenCommissioning": true,
        "OpenCooperativeManagement": true,
        "OpenRentAccounting": true,
        "OpenRunningCostDistribution": true,
        "ValidFrom": "2026-08-17",
        "ValidTo": "2026-08-17",
        "FiscalYear": {
          "Id": 1,
          "Number": 1
        }
      }
    ]
  }
]

---