> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.contracthero.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# PowerBI Bericht

## Ihr Vorteil

Excel-Exports sind statisch und schnell veraltet. Mit der PowerBI-Integration analysieren Sie Ihre Vertragsdaten direkt in Microsoft PowerBI und arbeiten auf einer Live-Verbindung zu Ihren ContractHero-Daten: Zahlungen, Laufzeiten, Kategorien, Vertragspartner und Statusfelder stehen in einem fertigen Bericht zur Verfügung. Sie sparen die Modellierungsarbeit und können sofort in die Analyse einsteigen — von der „Flughöhe Geschäftsführung" bis zum Drilldown auf einzelne Verträge.

## So funktioniert's

Die Einrichtung erfolgt in drei Schritten: **App im Power-BI-Marketplace installieren → API-Token in ContractHero erstellen → Token in der App eintragen.**

**Voraussetzung:** Power-BI-Zugang in Ihrer Microsoft-Organisation. Für die Installation der Marketplace-App in der Organisation werden Admin-Rechte in Power BI benötigt.

### 1. ContractHero-App im Power-BI-Marketplace installieren

1. **Öffnen Sie Power BI im Browser** (`https://app.powerbi.com`). Über die Desktop-Version ist die Marketplace-Installation nicht möglich.
2. Navigieren Sie zum [ContractHero-Eintrag im Power-BI-Marketplace](https://marketplace.microsoft.com/de-de/product/power-bi/contractherogmbh1665056535620.ch_contractmanagement?tab=overview) und klicken Sie auf **„Jetzt abrufen"** → **„Installieren"**.
3. Nach der Installation erscheint die App in Ihrer linken Power-BI-Seitenleiste unter **„Apps"**. Beim ersten Öffnen sehen Sie **Beispieldaten** — das ist normal, bis Sie Ihre eigenen Daten verbinden.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19101_1b041bh.png)

### 2. API-Token in ContractHero erstellen

1. Klicken Sie in ContractHero **oben rechts auf Ihren Profil-Avatar** → **„Profil"**.


![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19112_ucp51l.png)


2. Scrollen Sie zu **„Einstellung für erfahrene Benutzer"** und klicken Sie auf **„Token erstellen"**.


![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19140_1pivm0b.png)

**2.1**

![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19174_r6r24d.png)

3. Geben Sie dem Token einen sprechenden Namen (z. B. **„Power BI – Max Mustermann"**), damit Sie später nachvollziehen können, wo der Token genutzt wird.

![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19185_1yk9z3f.png)


4. Klicken Sie auf **„Generieren"** und kopieren Sie den Token sofort in die Zwischenablage. Aus Sicherheitsgründen können Sie ihn später nicht mehr einsehen.


![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19200_b0fqmy.png)

**4.1**

![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19253_tqhvnb.png)



### 3. Token in der Power-BI-App eintragen

1. Klicken Sie in der ContractHero-App in Power BI oben auf **„Ihre Daten verbinden"**.
2. **Fügen Sie den API-Token** in das entsprechende Feld ein.


![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19214_19jiqj7.png)


3. Optional: Hinterlegen Sie eine **URL zu Ihrem Firmenlogo**, damit dieses im Bericht angezeigt wird. Lässt sich später in den Einstellungen ändern.
4. Im nächsten Schritt:
    * **Authentifizierungsart:** **„Anonym"** wählen (die Autorisierung läuft bereits über den Token).
    * **Datenschutzstufe:** **„Public"**.


![](https://storage.crisp.chat/users/helpdesk/website/-/1/2/5/2/12522a019f980500/screenshot-2026-05-13-at-19234_px8htf.png)


5. Klicken Sie auf **„Anmelden und Verbindung herstellen"**.
6. Die Aktualisierung startet im Hintergrund — die erste Synchronisation kann einige Minuten dauern, abhängig von der Power-BI-Auslastung.

## Häufige Fragen

### Welche Daten werden übermittelt?

Übertragen werden zentrale Vertragsfelder wie Vertragsname, Vertragspartner, Status, Kategorie, Zahlungsbetrag, Intervall, Zahlungsart, Laufzeitart sowie Start-, End- und Kündigungsdaten. Genau diese Felder finden Sie als Filter und Dimensionen in den vorgefertigten Dashboards.

### Steuert mein ContractHero-Berechtigungskonzept auch die Sicht in Power BI?

Ja. API-Token in ContractHero sind **nutzergebunden**: Der Bericht zeigt nur die Verträge, auf die der Nutzer Zugriff hat, dessen Token in der App hinterlegt ist. Eingeschränkte Rechte in ContractHero bedeuten automatisch eingeschränkte Sicht in Power BI.

### Wie teile ich den Bericht mit Kolleginnen und Kollegen?

Sie haben zwei Wege:
* **Direkt in Power BI freigeben** (über „Freigeben → Zugriff verwalten") — das fällt unter das Power-BI-eigene Rechtemanagement.
* **Empfohlen für Nachvollziehbarkeit:** Lassen Sie jede Person einen eigenen API-Token in ihrem ContractHero-Profil erstellen und mit der App verbinden. So sehen Sie an der Token-Bezeichnung, wer worauf Zugriff hat, und können einzelne Verbindungen widerrufen, ohne andere zu beeinträchtigen.

### Wie oft werden die Daten aktualisiert?

Sie können die Aktualisierung **jederzeit manuell anstoßen** — über die App-Übersicht in Power BI. Zur konfigurierbaren automatischen Aktualisierungsfrequenz wenden Sie sich an Ihren ContractHero-Ansprechpartner; sie hängt vom Power-BI-Plan ab.

### Welche Power-BI-Lizenz brauche ich?

Für die reine Anzeige der ausgelieferten Dashboards reicht in der Regel eine Standard-Power-BI-Lizenz aus. Möchten Sie die Berichte selbst bearbeiten oder eigene Visualisierungen anlegen, gelten die Lizenzregeln von Microsoft. Diese Frage beantwortet Ihr Power-BI- oder M365-Administrator besser als wir.

### Ich sehe nach dem Klick auf den Marketplace-Eintrag nichts — was tun?

Aktualisieren Sie die Power-BI-Seite einmal. In manchen Fällen geht die Verknüpfung zwischen Marketplace und App nach dem Zwischenschritt verloren und ein Reload behebt das.

## Gut zu wissen

* **Browser, nicht Desktop:** Der Marketplace-Schritt funktioniert nur über die Browser-Version von Power BI (`app.powerbi.com`).
* **Token-Sicherheit:** Geben Sie Ihren API-Token nicht weiter. Wenn ein Mitarbeiter das Unternehmen verlässt, löschen Sie den zugehörigen Token in seinem Profil — der Bericht für diese Person funktioniert dann nicht mehr.
* **Sieben Dashboards out-of-the-box:** Übersicht (Flughöhe Geschäftsführung), granulare Sicht, Prüfung-Tabelle, Prüfung-Visual, Prüfung-Detail mit Vertrags-Snapshot, Deep-Dive-Tabelle und Deep-Dive-Visual.
* **Filter zurücksetzen:** Mehrfachauswahl per Strg+Klick funktioniert; ein dedizierter Button setzt alle Filter zurück.
* **Initialer Auslieferungszustand:** Die App startet mit **Beispieldaten**. Erst nach dem Token-Schritt sehen Sie Ihre echten Verträge.

## Verwandte Artikel

* [Kalenderansicht: Alle Fristen und Aufgaben auf einen Blick](https://support.contracthero.com/de/article/kalenderansicht-alle-fristen-und-aufgaben-auf-einen-blick-17xgfv9/) — Fristen im Griff, ohne zwischen Tools hin- und herzuspringen
* [KI-Vertragsanalyse: Wie ContractHero Vertragsdaten automatisch ausliest](https://support.contracthero.com/de/article/ki-vertragsanalyse-wie-contracthero-vertragsdaten-automatisch-ausliest-113zc01/) — wie die Felder, die in PowerBI ankommen, in ContractHero entstehen
