> For the complete documentation index, see [llms.txt](https://docs.openwowi.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openwowi.de/grundlagen/faq-frequently-asked-questions.md). # FAQ - Frequently asked Questions ## Administratives / Einrichtung
Wer ist für die Einrichtung des Zuganges zur OPENWOWI verantwortlich? Als Auftragsverarbeiter kann die Dr. Klein WOWI Digital natürlich nicht aus eigenem Antrieb heraus den Zugang zu Kundeninstanzen gewähren. Die Verantwortung liegt deshalb immer direkt beim Kunden. Wir bieten zu diesem Zweck eine ausführliche [Beschreibung der Einrichtung](/grundlagen/einrichtung-openwowi.md) an. Da der Kunde selten den Überblick über die von Ihnen verwendeten Endpunkte hat, fällt ein Teil der Verantwortung allerdings den Partnern zu. Um die Zusammenarbeit möglichst einfach zu gestalten, bieten wir aus diesem Grund zusätzlich eine [Checkliste](/grundlagen/checkliste-fur-die-einrichtung-in-wowiport.md) an, welche Ihnen bei der Einrichtung der OPENWOWI behilflich sein soll.
## Strategisches / Zusammenarbeit
Wir möchten gerne eine strategische Partnerschaft mit Ihnen vereinbaren. Sie können sich mit Ihrem Anliegen gerne an [Partnermanagement@drklein-wowi.de](mailto:partnermanagement@drklein-wowi.de) wenden. Idealerweise können Sie bereits einen Pilotkunden vorweisen, mit welchem wir dann gemeinsam die praktische Anbindung besprechen können.
Ich habe einen Bug gefunden und möchte diesen gerne prüfen lassen. Wir freuen uns immer über die Aufmerksamkeit unserer Partner und Kunden. Einen Bug können Sie direkt an melden. Alternativ natürlich auch direkt an Ihren technischen Ansprechpartner bei uns.
Unser Kunde stellt gerade sein ERP System auf WOWIPORT um. Wie stellen wir sicher, dass wir dabei berücksichtigt werden? Im Rahmen der Projektphase der Kunden werden üblicherweise auch die angebundenen Partner abgefragt. Wenn Sie sich proaktiv auf die zukünftige Anbindung vorbereiten möchten, dann können Sie sich gerne an [Partnermanagement@drklein-wowi.de](mailto:partnermanagement@drklein-wowi.de) wenden. bitte stellen Sie aber sicher, dass der Kunde hierüber informiert ist, damit es in der Projektphase nicht zu Parallelkommunikation kommt. Vor einer Anbindung können wir Ihnen bereits Zugriff auf unsere [Sandbox](/grundlagen/einrichtung-openwowi.md) bieten. Da die effektive Anbindung des Kunden häufig erst nach der Datenmigration Sinn macht, empfehlen wir einen Testlauf mit den Daten unserer Sandbox. Um die Migration nicht zu beeinträchtigen wird eine Anbindung der Migrations-Instanz von WOWIPORT ausdrücklich nicht gewünscht.
Wie können wir Erweiterungen in der OPENWOWI beantragen? Wenn Sie bereits Partner der OPENWOWI sind, können Sie Erweiterungen mit Ihrem technischen Ansprechpartner besprechen. Wichtige Informationen hierfür sind: * Was soll erweitert werden? * Welchem Zweck dienen die Erweiterungen? * Welches Zeitfenster steht für die Erweiterung zur Verfügung? * Welcher Kunde steht hinter dem Erweiterungswunsch? * Wer sind die Ansprechpartner für die Prozesse und die technische Umsetzung auf Ihrer Seite? Bitte beachten Sie, dass wir uns vorbehalten Erweiterungen abzulehnen, wenn diese nicht in die Gesamtplanung der OPENWOWI oder von WOWIPORT passen. Eine Liste aktueller Erweiterungswünsche finden Sie hier: [User-Requests](/releaseinformationen-user-requests-und-bugs/user-requests.md)
Können wir auch unser eigenes Interface (iFrame) in WOWIPORT einbauen? Diese Option ist leider nicht gegeben. Die Oberfläche von WOWIPORT soll möglichst marktneutral gestaltet bleiben. Sie haben allerdings die Möglichkeit direkte [Absprünge](/grundlagen/hyperlinks-aus-wowiport-zu-externen-anwendungen-integrieren.md) in Ihre Web-Umgebung zu konfigurieren.
## Technisches / API-Abrufe
Wir sind nur für für ein einzelnes Subunternehmen tätig und uns fehlen Daten in der API. Wenn Sie nur für ein Subunternehmen tätig sind, ist die Wahrscheinlichkeit groß, dass Sie nicht auf der höchsten Berechtigungsebene liegen. Sie können dann nur Daten von der Ebene abrufen, auf der Ihr User und der API Key angelegt wurde. Dazu zählen auch alle Daten, welche unterhalb Ihres Berechtigungsknotens liegen. Dies kann dazu führen, dass Daten fehlen, wenn diese auf einer höheren Berechtigungsebene liegen (z.B. übergreifend genutzte Personendatensätze). In diesem Fall muss entweder der Datensatz auf den korrekten Knotenpunkt geändert werden, oder Ihr User und API Key muss in der Berechtigungsebene angepasst werden.
Wir können die Daten paginiert abrufen, wissen aber nicht, wann wir den letzten Datensatz erreicht haben. In den Datenendpunkten (alle Endpunkte mit einem Parameter "Limit"), finden Sie im Header einen Schlüssel "Total-X-Count". Dieser gibt die Anzahl aller gefundenen Datensätze an.
Welche Version eines Endpunktes sollen wir im besten Fall verwenden? Die OPENWOWI bietet einige stabile Versionen an (Version 1.0 und 1.1), welche nur dann geändert werden, wenn WOWIPORT sich geändert hat, oder schwere Bugs gefunden werden. Zudem haben wir eine Version "Work in Progress", bei welcher laufend Änderungen vorgenommen werden. Dies ist derzeit die Version 1.2. In der Swagger finden Sie zudem eine "experimentelle API". Dies ist derzeit die Version 1.3. Wenn Sie eine Anbindung etablieren, die mit wenigen Daten auskommt oder die empfindlich auf Änderungen reagiert (z.B. Plattform-Anbindungen, welche ein festes Schema erwarten), dann empfehlen wir die stabilen Versionen. Wenn Sie eine Anbindung planen, welche noch Erweiterungen benötigt und welche mit unbekannten Daten im Schema umgehen kann, dann empfehlen wir die "Work in Progress" Version. Die "experimentelle API" empfehlen wir ausdrücklich nur nach Rücksprache mit uns.
Wir verstehen die Bedeutung der Daten nicht. Wir haben uns in der OPENWOWI bewusst für eine englische Lokalisierung entschieden, damit Entwickler aus anderen Sprachregionen nicht benachteiligt werden. Dies kann im Zweifelsfall zu Verständnisproblemen mit dem Kunden führen. Leider können wir in der API keine Übersetzungsmatrix anbieten, da die Labels in WOWIPORT reine UI-Elemente und keine verbundenen, deutschen Lokalisierungen sind. Der erste Ansatz wäre immer einen Beispieldatensatz mit dem Kunden zu besprechen und anhand dessen die Felder zu identifizieren. Dies kann natürlich auch in Kooperation mit der Dr. Klein WOWI Digital erfolgen. Ihr Kunde kann den Kontakt zu uns herstellen. Kontext zu einzelnen Funktionen der API finden Sie häufig in den erweiterbaren Abschnitten unter "Weitere Hinweise zur Funktion".
Welche Bedeutung haben die Parameter? Die Beschreibung der Parameter finden Sie hier:
Warum gibt es nicht zu jeder Entität Webhooks? Daten in WOWIPORT sind hierarchisch aufgebaut und die Speicherung eines untergeordneten Datensatzes führt üblicherweise zur Speicherung des darübergelegenen Datensatzes (Beispiel: Die Speicherung einer Vertragsposition in einem Nutzungsvertrag speichert gleichzeitig den Nutzungsvertrag). Aus diesem Grund bieten wir nur Webhooks für die übergeordneten Datensätze an. Hinzu kommt die vorhersehbare Nutzung der Webhooks. Wir bieten so Webhooks für Wirtschaftseinheiten und Nutzungseinheiten an, weil diese häufig genutzt werden, jedoch nicht für Gebäude, da diese eher als Nebendatensatz zu den Wirtschaftseinheiten behandelt werden.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.openwowi.de/grundlagen/faq-frequently-asked-questions.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.