Zuständigkeiten

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

Hinweise zur Funktion

Die Zuständigkeiten in WOWIPORT können auf der Ebene der Wirtschaftseinheiten und der Nutzungseinheiten separat definiert werden.

Die Zuständigkeit ist mit einer Abteilungsart ("DepartmentType") verbunden, welche Aufschluss über die verbundene Tätigkeit gibt.

Jedes verbundene Objekt verfügt über eine Vielzahl an möglichen Zuständigkeiten, welche durch die jeweiligen Tätigkeitsbereiche unterschieden werden. Die Tätigkeitsbereiche können in einer Person vereint sein.

Jede Tätigkeit benötigt einen Hauptverantwortlichen ("MainJurisdiction"). Die hier hinterlegte Person ist dann der/die Hauptansprechpartner/in.

Die Zuständigkeit für ein Objekt kann ebenfalls eine "universelle Zuständigkeit" aufweisen ("...UniversalResponsibility" = true; "...UniversalResponsibleOfficial" enthält dann den Datensatz der Person).

Die hier hinterlegte Person übernimmt in diesem Fall alle Tätigkeiten für das entsprechende Objekt.

Der Endpunkt der Nutzungseinheiten enthält zusätzlich die Daten der Wirtschaftseinheit, um übergeordnete Zuständigkeiten zu erkennen.

Abfrage der Zuständigkeiten über die Wirtschaftseinheit

Version 1.1

---

get

Autorisierungen

Authorization

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

economicUnitIdinteger · int32Optional

Antworten

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.1/CommercialInventory/EconomicUnit/Jurisdiction

HTTPcURLJavaScriptPython

GET /openwowi/v1.1/CommercialInventory/EconomicUnit/Jurisdiction HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "EconomicUnit": {
      "Id": 1,
      "IdNum": "text",
      "Name": "text",
      "Location": "text"
    },
    "EconomicUnitUniversalResponsibility": true,
    "EconomicUnitUniversalResponsibleOfficial": {
      "Id": 1,
      "CodeShort": "text",
      "AutomaticMailsActivated": true,
      "UniversalResponsibilityPossible": true,
      "PersonId": 1,
      "PersonName": "text",
      "UserId": 1
    },
    "EconomicUnitJurisdictionList": [
      {
        "Id": 1,
        "MainJurisdiction": true,
        "ResponsibleOfficial": {
          "Id": 1,
          "CodeShort": "text",
          "AutomaticMailsActivated": true,
          "UniversalResponsibilityPossible": true,
          "PersonId": 1,
          "PersonName": "text",
          "UserId": 1
        },
        "Department": {
          "Id": 1,
          "Name": "text"
        },
        "DepartmentType": {
          "Id": 1,
          "Name": "text"
        }
      }
    ]
  }
]

---

Version 1.2

---

get

Autorisierungen

Authorization

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

economicUnitIdinteger · int32Optional

showNullValuesbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.2/CommercialInventory/EconomicUnit/Jurisdiction

HTTPcURLJavaScriptPython

GET /openwowi/v1.2/CommercialInventory/EconomicUnit/Jurisdiction HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "EconomicUnit": {
      "Id": 1,
      "IdNum": "text",
      "Name": "text",
      "Location": "text"
    },
    "EconomicUnitUniversalResponsibility": true,
    "EconomicUnitUniversalResponsibleOfficial": {
      "Id": 1,
      "CodeShort": "text",
      "AutomaticMailsActivated": true,
      "UniversalResponsibilityPossible": true,
      "PersonId": 1,
      "PersonName": "text",
      "UserId": 1
    },
    "EconomicUnitJurisdictionList": [
      {
        "Id": 1,
        "MainJurisdiction": true,
        "ResponsibleOfficial": {
          "Id": 1,
          "CodeShort": "text",
          "AutomaticMailsActivated": true,
          "UniversalResponsibilityPossible": true,
          "PersonId": 1,
          "PersonName": "text",
          "UserId": 1
        },
        "Department": {
          "Id": 1,
          "Name": "text"
        },
        "DepartmentType": {
          "Id": 1,
          "Name": "text"
        }
      }
    ]
  }
]

---

Abfrage der Zuständigkeiten über die Nutzungseinheiten

Version 1.1

---

get

Autorisierungen

Authorization

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

useUnitIdinteger · int32Optional

economicUnitIdinteger · int32Optional

Antworten

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.1/CommercialInventory/UseUnit/Jurisdiction

HTTPcURLJavaScriptPython

GET /openwowi/v1.1/CommercialInventory/UseUnit/Jurisdiction HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "UseUnit": {
      "Id": 1,
      "UseUnitNumber": "text",
      "BuildingLandId": 1,
      "EconomicUnitId": 1,
      "EconomicUnit": "text"
    },
    "UseUnitUniversalResponsibility": true,
    "UseUnitUniversalResponsibleOfficial": {
      "Id": 1,
      "CodeShort": "text",
      "AutomaticMailsActivated": true,
      "UniversalResponsibilityPossible": true,
      "PersonId": 1,
      "PersonName": "text",
      "UserId": 1
    },
    "EconomicUnitUniversalResponsibility": true,
    "EconomicUnitUniversalResponsibleOfficial": {
      "Id": 1,
      "CodeShort": "text",
      "AutomaticMailsActivated": true,
      "UniversalResponsibilityPossible": true,
      "PersonId": 1,
      "PersonName": "text",
      "UserId": 1
    },
    "UseUnitJurisdictionList": [
      {
        "Id": 1,
        "MainJurisdiction": true,
        "ResponsibleOfficial": {
          "Id": 1,
          "CodeShort": "text",
          "AutomaticMailsActivated": true,
          "UniversalResponsibilityPossible": true,
          "PersonId": 1,
          "PersonName": "text",
          "UserId": 1
        },
        "Department": {
          "Id": 1,
          "Name": "text"
        },
        "DepartmentType": {
          "Id": 1,
          "Name": "text"
        }
      }
    ]
  }
]

---

Version 1.2

---

get

Autorisierungen

Authorization

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

useUnitIdinteger · int32Optional

economicUnitIdinteger · int32Optional

showNullValuesbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.2/CommercialInventory/UseUnit/Jurisdiction

HTTPcURLJavaScriptPython

GET /openwowi/v1.2/CommercialInventory/UseUnit/Jurisdiction HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "UseUnit": {
      "Id": 1,
      "UseUnitNumber": "text",
      "BuildingLandId": 1,
      "EconomicUnitId": 1,
      "EconomicUnit": "text"
    },
    "UseUnitUniversalResponsibility": true,
    "UseUnitUniversalResponsibleOfficial": {
      "Id": 1,
      "CodeShort": "text",
      "AutomaticMailsActivated": true,
      "UniversalResponsibilityPossible": true,
      "PersonId": 1,
      "PersonName": "text",
      "UserId": 1
    },
    "EconomicUnitUniversalResponsibility": true,
    "EconomicUnitUniversalResponsibleOfficial": {
      "Id": 1,
      "CodeShort": "text",
      "AutomaticMailsActivated": true,
      "UniversalResponsibilityPossible": true,
      "PersonId": 1,
      "PersonName": "text",
      "UserId": 1
    },
    "UseUnitJurisdictionList": [
      {
        "Id": 1,
        "MainJurisdiction": true,
        "ResponsibleOfficial": {
          "Id": 1,
          "CodeShort": "text",
          "AutomaticMailsActivated": true,
          "UniversalResponsibilityPossible": true,
          "PersonId": 1,
          "PersonName": "text",
          "UserId": 1
        },
        "Department": {
          "Id": 1,
          "Name": "text"
        },
        "DepartmentType": {
          "Id": 1,
          "Name": "text"
        }
      }
    ]
  }
]

---

Details der zuständigen Person

Version 1.1

---

get

Autorisierungen

Authorization

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

responsibleOfficialIdinteger · int32Optional

responsibleOfficialCodeShortstringOptional

personIdinteger · int32Optional

includeMainAddressbooleanOptionalDefault: false

includeMainCommunicationbooleanOptionalDefault: false

includePersonAddressesbooleanOptionalDefault: false

includePersonCommunicationsbooleanOptionalDefault: false

includePersonBankAccountsbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.1/CommercialInventory/ResponsibleOfficial

HTTPcURLJavaScriptPython

GET /openwowi/v1.1/CommercialInventory/ResponsibleOfficial HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "CodeShort": "text",
    "AutomaticMailsActivated": true,
    "UniversalResponsibilityPossible": true,
    "UserId": 1,
    "Person": {
      "Id": 1,
      "IdNum": "text",
      "Shortname": "text",
      "Name": "text",
      "NodeId": 1,
      "TaxNumber": "text",
      "TaxIdentificationNumber": "text",
      "ValidFrom": "2025-11-01",
      "ValidTo": "2025-11-01",
      "IsNaturalPerson": true,
      "NaturalPerson": {
        "Title": "text",
        "FirstName": "text",
        "LastName": "text",
        "BirthName": "text",
        "CareOf": "text",
        "BirthDate": "2025-11-01",
        "DeathDate": "2025-11-01T20:40:07.381Z",
        "Gender": {
          "Id": 1,
          "Name": "text"
        },
        "MaritalType": {
          "Id": 1,
          "Name": "text"
        },
        "Nationality": {
          "Id": 1,
          "Name": "text",
          "Code": "text"
        },
        "PersonInCare": {
          "Id": 1,
          "IdNum": "text"
        },
        "ContactFor": [
          {
            "Id": 1,
            "IdNum": "text",
            "LongName1": "text",
            "LongName2": "text"
          }
        ]
      },
      "LegalPerson": {
        "LongName1": "text",
        "LongName2": "text",
        "VatId": "text",
        "CommercialRegisterNumber": "text",
        "CommercialRegisterTown": "text",
        "ContractPersons": [
          {
            "Id": 1,
            "IdNum": "text",
            "FirstName": "text",
            "LastName": "text"
          }
        ]
      },
      "Addresses": [
        {
          "Id": 1,
          "Zip": "text",
          "Town": "text",
          "Street": "text",
          "HouseNumber": "text",
          "HouseNumberAddition": "text",
          "ValidFrom": "2025-11-01",
          "ValidTo": "2025-11-01",
          "StreetComplete": "text",
          "HouseNumberComplete": "text",
          "MainAddress": true,
          "AddressType": {
            "Id": 1,
            "Name": "text"
          },
          "Country": {
            "Id": 1,
            "Name": "text",
            "Code": "text"
          }
        }
      ],
      "Communications": [
        {
          "Id": 1,
          "RelatedAddressId": 1,
          "Content": "text",
          "Explanation": "text",
          "RelatedAddress": "text",
          "CommunicationType": {
            "Id": 1,
            "Name": "text"
          }
        }
      ],
      "BankAccounts": [
        {
          "Id": 1,
          "Iban": "text",
          "Bic": "text",
          "AccountHolder": "text",
          "ValidFrom": "2025-11-01",
          "ValidTo": "2025-11-01",
          "BankAccountType": {
            "Id": 1,
            "Code": "text"
          },
          "BankAccountId": 1,
          "BankAccountUsageType": {
            "Id": 1,
            "Code": "text"
          }
        }
      ],
      "FirstEmailCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstLandlinePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstMobilePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      }
    },
    "DefaultAddress": {
      "Id": 1,
      "Zip": "text",
      "Town": "text",
      "Street": "text",
      "HouseNumber": "text",
      "HouseNumberAddition": "text",
      "ValidFrom": "2025-11-01",
      "ValidTo": "2025-11-01",
      "StreetComplete": "text",
      "HouseNumberComplete": "text",
      "MainAddress": true,
      "AddressType": {
        "Id": 1,
        "Name": "text"
      },
      "Country": {
        "Id": 1,
        "Name": "text",
        "Code": "text"
      }
    }
  }
]

---

Version 1.2

---

get

Autorisierungen

Authorization

Abfrageparameter

apiKeystringOptional

limitinteger · int32OptionalExample: 20

offsetinteger · int32Optional

responsibleOfficialIdinteger · int32Optional

responsibleOfficialCodeShortstringOptional

personIdinteger · int32Optional

includeMainAddressbooleanOptionalDefault: false

includeMainCommunicationbooleanOptionalDefault: false

includePersonAddressesbooleanOptionalDefault: false

includePersonCommunicationsbooleanOptionalDefault: false

includePersonBankAccountsbooleanOptionalDefault: false

showNullValuesbooleanOptionalDefault: false

Antworten

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

get

/openwowi/v1.2/CommercialInventory/ResponsibleOfficial

HTTPcURLJavaScriptPython

GET /openwowi/v1.2/CommercialInventory/ResponsibleOfficial HTTP/1.1
Host: 
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "Id": 1,
    "CodeShort": "text",
    "AutomaticMailsActivated": true,
    "UniversalResponsibilityPossible": true,
    "UserId": 1,
    "Person": {
      "Id": 1,
      "IdNum": "text",
      "Shortname": "text",
      "Name": "text",
      "NodeId": 1,
      "TaxNumber": "text",
      "TaxIdentificationNumber": "text",
      "ValidFrom": "2025-11-01",
      "ValidTo": "2025-11-01",
      "IsNaturalPerson": true,
      "NaturalPerson": {
        "Title": "text",
        "FirstName": "text",
        "LastName": "text",
        "BirthName": "text",
        "CareOf": "text",
        "BirthDate": "2025-11-01",
        "DeathDate": "2025-11-01T20:40:07.381Z",
        "Gender": {
          "Id": 1,
          "Name": "text"
        },
        "MaritalType": {
          "Id": 1,
          "Name": "text"
        },
        "Nationality": {
          "Id": 1,
          "Name": "text",
          "Code": "text"
        },
        "PersonInCare": {
          "Id": 1,
          "IdNum": "text"
        },
        "ContactFor": [
          {
            "Id": 1,
            "IdNum": "text",
            "LongName1": "text",
            "LongName2": "text"
          }
        ]
      },
      "LegalPerson": {
        "LongName1": "text",
        "LongName2": "text",
        "VatId": "text",
        "CommercialRegisterNumber": "text",
        "CommercialRegisterTown": "text",
        "ContractPersons": [
          {
            "Id": 1,
            "IdNum": "text",
            "FirstName": "text",
            "LastName": "text"
          }
        ]
      },
      "Addresses": [
        {
          "Id": 1,
          "Zip": "text",
          "Town": "text",
          "Street": "text",
          "HouseNumber": "text",
          "HouseNumberAddition": "text",
          "ValidFrom": "2025-11-01",
          "ValidTo": "2025-11-01",
          "StreetComplete": "text",
          "HouseNumberComplete": "text",
          "MainAddress": true,
          "AddressType": {
            "Id": 1,
            "Name": "text"
          },
          "Country": {
            "Id": 1,
            "Name": "text",
            "Code": "text"
          }
        }
      ],
      "Communications": [
        {
          "Id": 1,
          "RelatedAddressId": 1,
          "Content": "text",
          "Explanation": "text",
          "RelatedAddress": "text",
          "CommunicationType": {
            "Id": 1,
            "Name": "text"
          }
        }
      ],
      "BankAccounts": [
        {
          "Id": 1,
          "Iban": "text",
          "Bic": "text",
          "AccountHolder": "text",
          "ValidFrom": "2025-11-01",
          "ValidTo": "2025-11-01",
          "BankAccountType": {
            "Id": 1,
            "Code": "text"
          },
          "BankAccountId": 1,
          "BankAccountUsageType": {
            "Id": 1,
            "Code": "text"
          }
        }
      ],
      "FirstEmailCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstLandlinePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      },
      "FirstMobilePhoneCommunication": {
        "Id": 1,
        "RelatedAddressId": 1,
        "Content": "text",
        "Explanation": "text",
        "RelatedAddress": "text",
        "CommunicationType": {
          "Id": 1,
          "Name": "text"
        }
      }
    },
    "DefaultAddress": {
      "Id": 1,
      "Zip": "text",
      "Town": "text",
      "Street": "text",
      "HouseNumber": "text",
      "HouseNumberAddition": "text",
      "ValidFrom": "2025-11-01",
      "ValidTo": "2025-11-01",
      "StreetComplete": "text",
      "HouseNumberComplete": "text",
      "MainAddress": true,
      "AddressType": {
        "Id": 1,
        "Name": "text"
      },
      "Country": {
        "Id": 1,
        "Name": "text",
        "Code": "text"
      }
    }
  }
]

---