# Kundenexport (JSON)

> Was Kundenexport (JSON) kann, wie du das Werkzeug aktivierst und freigibst, was in der JSON-Datei steht und wie du einen Kunden aus der Kundenverwaltung exportierst.

**Kundenexport (JSON)** ist ein Werkzeug, das i-Planner selbst gebaut hat. Ein externer Anbieter ist nicht beteiligt. Damit lädst du in der **Kundenverwaltung** den Datensatz eines Kunden als JSON-Datei herunter. Vorher muss deine Organisation das Werkzeug einmal unter **Organisation › Integrationen** aktivieren.

## Kurz erklärt {#kurz-erklaert}

Kundenexport (JSON) erzeugt in der **Kundenverwaltung** für einen Kunden eine JSON-Datei mit seinen Daten:

- Im Fenster **Kundenexport (JSON)** wählst du genau einen Kunden aus. Ein Klick auf **Öffnen** startet sofort den Download der Datei `kunde_<ID>.json`. Hinter `kunde_` steht die interne ID des Kunden.
- In der Datei stehen der Kundendatensatz, Adressen, Kontaktdaten, Beruf, Nummern, Identifizierung, Finanzdaten, Verträge mit ihren Vertragspersonen, Schäden, Beziehungen zu anderen Kontakten und Verknüpfungen. Die Einzelheiten stehen unter [Was in der JSON-Datei von Kundenexport (JSON) steht](/organisation/integrationen/kundenexport-json/uebersicht#json-datei-kundenexport-json-steht).
- Dazu kommen als Nachschlagelisten die Feldbeschriftungen, die Werte der Auswahllisten mit ihrer Bezeichnung und die Sparten. Mit ihnen lassen sich die gespeicherten Werte lesen.
- Ist beim Öffnen des Werkzeugs in der **Kundenverwaltung** ein Kunde aufgerufen, steht er im Fenster schon im Feld **Kunde**.
- Unter **Organisation › Integrationen** legt deine Organisation fest, wer das Werkzeug nutzen darf.
- Zugangsdaten oder einen Account brauchst du dafür nicht.

Die Daten gehen nur in eine Richtung und nur für einen Kunden je Export. Einen Export mehrerer oder aller Kunden auf einmal gibt es nicht. Auch einen automatischen oder zeitgesteuerten Export oder eine Synchronisation gibt es nicht. Kundenexport (JSON) hat keine Import-Funktion. Der Export liest nur und ändert in i-Planner nichts. An Dritte geht dabei nichts.

Typische Aufgaben:

- Deine Organisation will das Werkzeug nutzen: [Kundenexport (JSON) einrichten](/organisation/integrationen/kundenexport-json/uebersicht#kundenexport-json-einrichten).
- Du brauchst die Daten eines Kunden als Datei: [Kunden als JSON-Datei exportieren](/organisation/integrationen/kundenexport-json/uebersicht#kunden-json-datei-exportieren).
- Du willst die Datei lesen oder weiterverarbeiten: [Was in der JSON-Datei von Kundenexport (JSON) steht](/organisation/integrationen/kundenexport-json/uebersicht#json-datei-kundenexport-json-steht).
- Die Kachel fehlt oder statt der Datei kommt eine Meldung: [Fehlerbehebung](/organisation/integrationen/kundenexport-json/fehlerbehebung).

## Voraussetzungen {#voraussetzungen}

- Zum Aktivieren und zum Festlegen der Freigabe unter **Organisation › Integrationen** braucht deine Benutzerrolle das Recht **Integrationen**.
- Kundenexport (JSON) ist unter **Organisation › Integrationen** aktiviert. Sonst erscheint die Kachel **Kundenexport (JSON)** in der **Kundenverwaltung** nicht.
- Wer exportiert, ist für das Werkzeug freigegeben. Das ist der Fall, wenn die **Freigabe** auf **Alle Mitarbeiter** (Voreinstellung) steht. Bei **Nur ausgewählte Mitarbeiter** muss die Person selbst, über ihre Rolle oder über eine ihrer Gruppen ausgewählt sein.
- Du arbeitest mit einem Mitarbeiter-Login in der **Kundenverwaltung**. Mit einem Kunden-Login im Kundenportal lässt sich das Werkzeug nicht nutzen.
- Zugangsdaten oder einen Account brauchst du nicht.
- Der Kontakt, den du exportieren willst, ist als Kunde angelegt. Produktpartner und Benutzer lassen sich im Fenster **Kundenexport (JSON)** nicht auswählen.

## Kundenexport (JSON) einrichten {#kundenexport-json-einrichten}

Kundenexport (JSON) richtest du einmal für die ganze Organisation ein.

1. Öffne **Organisation › Integrationen** und wähle links unter **Entdecken** die Liste **Alle**. Kundenexport (JSON) hat keine Kategorie und steht deshalb nicht unter **Pool**, **Datenlieferanten**, **E-Mail** oder **KI**.
2. Klicke **Kundenexport (JSON)** an. Die Detailseite zeigt oben das Kennzeichen **Official**, die Beschreibung „i-Planner-Tool zum vollständigen Export eines Kundendatensatzes im JSON-Format.“ und **Built by** iPlanner.
3. Schalte im Bereich **Aktivierung** den Schalter **Integration aktivieren** ein. i-Planner speichert die Änderung sofort, einen **Speichern**-Knopf gibt es nicht.

*Animation: Die Detailseite von Kundenexport (JSON) unter Organisation › Integrationen mit dem grünen Logo mit geschweiften Klammern, dem Kennzeichen Official, der Beschreibung „i-Planner-Tool zum vollständigen Export eines Kundendatensatzes im JSON-Format.“ und der Angabe Built by iPlanner. Im Bereich Aktivierung wird der Schalter Integration aktivieren eingeschaltet, es erscheint Feld „Integration aktivieren“ wurde gespeichert!, und darunter erscheint der Bereich Einschränkungen mit der Freigabe Alle Mitarbeiter. Dann wird die Freigabe auf Nur ausgewählte Mitarbeiter gestellt. Im neuen Bereich Ausgewählte Mitarbeiter mit der Liste aus Gruppen, Rollen und Personen wird die Rolle Administrator angekreuzt, der Zähler springt auf 2 Mitglieder, es erscheint Freigabe gespeichert.*

4. Optional: Nach dem Einschalten erscheint der Bereich **Einschränkungen**. Dort legst du unter **Freigabe** fest, wer das Werkzeug nutzen darf: **Alle Mitarbeiter** (Voreinstellung) oder **Nur ausgewählte Mitarbeiter**.
5. Nur bei **Nur ausgewählte Mitarbeiter**: Wähle im Bereich **Ausgewählte Mitarbeiter** die Rollen, Gruppen und Personen aus, die Kundenexport (JSON) nutzen dürfen. Nach jeder Änderung an der Auswahl meldet i-Planner „Freigabe gespeichert“.

Mehr musst du nicht eintragen. Die Detailseite von Kundenexport (JSON) hat keinen Bereich **Zugangsdaten**, und es gibt kein geheimes Feld wie ein Passwort oder einen Schlüssel.

| Feld | Pflicht | Was eintragen |
|---|---|---|
| **Integration aktivieren** | Ja | Einschalten, einmal für die Organisation. Solange der Schalter aus ist, erscheint die Kachel **Kundenexport (JSON)** in der **Kundenverwaltung** nicht. |
| **Freigabe** | Nein | **Alle Mitarbeiter** (Voreinstellung) oder **Nur ausgewählte Mitarbeiter**. Das Feld erscheint erst nach dem Einschalten im Bereich **Einschränkungen**. |
| **Ausgewählte Mitarbeiter** | Nein | Die Rollen, Gruppen und Personen, die Kundenexport (JSON) nutzen dürfen. Der Bereich erscheint bei **Nur ausgewählte Mitarbeiter**, und zwar schon vor dem ersten Einschalten. Eine Auswahl dort speichert i-Planner aber erst, wenn das Werkzeug aktiviert ist, siehe [Integration aktivieren](/organisation/integrationen/uebersicht#integration-aktivieren). Ist dort niemand ausgewählt, darf niemand das Werkzeug nutzen. |

::callout
---
color: amber
icon: i-heroicons-exclamation-triangle
---
Bei **Nur ausgewählte Mitarbeiter** gibt es in der **Kundenverwaltung** keine Ausnahme für Administratoren. Die Kachel **Kundenexport (JSON)** sieht nur, wer selbst, über seine Rolle oder über eine seiner Gruppen ausgewählt ist. Das gilt auch für dich, wenn du die Auswahl triffst.
::

Wie die Auswahl der Rollen, Gruppen und Personen im Einzelnen funktioniert, steht unter **Organisation › Integrationen** im Abschnitt [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf).

Ob Kundenexport (JSON) eingeschaltet ist, siehst du unter **Organisation › Integrationen**. In der Listenansicht steht dann als Status **Aktiv**, in der Kachelansicht trägt die Kachel die Markierung **Aktiviert**. **Inaktiv** steht für eingerichtet, aber ausgeschaltet, **Verfügbar** für noch nie aktiviert. Wer das Werkzeug ein- oder ausgeschaltet oder die Freigabe geändert hat, steht unter **Organisation › Audit-Log** in Einträgen mit dem **Bereich** „Integrationen“.

## Was Kundenexport (JSON) übermittelt {#kundenexport-json-uebermittelt}

Nichts an Dritte. Kundenexport (JSON) hat keinen externen Anbieter. Auf seiner Detailseite unter **Organisation › Integrationen** steht **Built by** iPlanner, und der Export läuft auf dem i-Planner-Server. Ein Klick auf **Öffnen** im Fenster **Kundenexport (JSON)** erzeugt einen Download-Link. Er führt zum i-Planner-Server und enthält nur die interne ID des gewählten Kunden und einen Einmal-Code. Der Link gilt nur einmal und höchstens 30 Minuten.

## Was in der JSON-Datei von Kundenexport (JSON) steht {#json-datei-kundenexport-json-steht}

Zurück kommt bei Kundenexport (JSON) eine JSON-Datei, die dein Browser herunterlädt. Das passiert sofort nach dem Klick auf **Öffnen** im Fenster **Kundenexport (JSON)**, bei jedem Klick neu. In i-Planner landet nichts. Beim Export wird dort nichts gespeichert oder geändert. Die Datei zeigt den Stand der Daten zum Zeitpunkt des Downloads.

- Dateiname: `kunde_<ID>.json`. Hinter `kunde_` steht die interne ID des Kunden.
- Format: UTF-8, lesbar formatiert mit Zeilenumbrüchen und Einrückungen. Umlaute stehen als Umlaute in der Datei.

Die Datei ist in Abschnitte gegliedert, jeder Abschnitt ist eine Liste von Einträgen:

| Abschnitt in der Datei | Inhalt |
|---|---|
| `customer` | Der Kundendatensatz mit den Stammdaten des Kunden |
| `addresses` | Adressen |
| `contactdata` | Kontaktdaten |
| `occupations` | Angaben zum Beruf |
| `numbers` | Nummern |
| `idents` | Angaben zur Identifizierung |
| `finance` | Finanzdaten |
| `contracts` | Verträge. Zu jedem Vertrag stehen unter `persons` die Vertragspersonen |
| `damages` | Schäden |
| `customer_relations` | Beziehungen des Kunden zu anderen Kontakten, zum Beispiel zu Partner oder Kindern |
| `relations` | Verknüpfungen, bei denen der Kunde Eigentümer ist, zum Beispiel ein Vertrag, mit dem ein Dokument verknüpft ist |
| `fields` | Nachschlageliste: Feldbeschriftung, technischer Feldname und Eingabetyp der Felder für Kunde, Schäden, Dokumente, Adressen, Kontaktdaten, Beruf, Finanzen, Nummern und Identifizierung |
| `options` | Nachschlageliste: alle Werte der Auswahllisten deiner Organisation mit ihrer Bezeichnung |
| `sparten` | Nachschlageliste: alle Sparten |

Nicht in der Datei stehen unter anderem Bankverbindungen, Dokumente und Dateien, Aktivitäten und Ziele. „Vollständig“ in der Beschreibung auf der Detailseite bezieht sich nur auf den Umfang in dieser Tabelle. Gelöschte Adressen, Kontaktdaten, Berufsangaben, Nummern, Identifizierungen, Finanzdaten, Verträge, Schäden und Verknüpfungen fehlen auch.

So liest du die Datei:

- Die Schlüssel sind die technischen Feldnamen. Auswahlfelder enthalten den gespeicherten Wert, nicht den Klartext.
- Den Klartext zu einem gespeicherten Wert findest du in `options`. Dort steht zu jedem Wert (`wert`) die Bezeichnung (`bezeichnung`). Die Sparten stehen in `sparten`. Beide Listen enthalten alle Einträge deiner Organisation, nicht nur die Werte dieses Kunden.
- Die Beschriftungen der Felder für Kunde, Schäden, Dokumente, Adressen, Kontaktdaten, Beruf, Finanzen, Nummern und Identifizierung stehen in `fields`. Für Verträge und Vertragspersonen gibt es dort keine Beschriftungen. Diese Felder stehen nur mit ihrem technischen Namen in der Datei.

## Kunden als JSON-Datei exportieren {#kunden-json-datei-exportieren}

Das geht in der **Kundenverwaltung**, sobald Kundenexport (JSON) unter **Organisation › Integrationen** aktiviert ist und du dafür freigegeben bist.

1. Rufe in der **Kundenverwaltung** den Kunden auf, den du exportieren willst. Der Schritt ist optional, spart aber die Suche. Ist beim Öffnen des Werkzeugs ein Kunde aufgerufen, steht er im Fenster schon im Feld **Kunde**.
2. Klicke oben rechts in der Kopfzeile, links neben deinem Profilbild, auf das Raster-Symbol mit dem Tooltip **Schnittstellen**. Es öffnet die Kacheln der Schnittstellen, die für dich aktiviert und freigegeben sind, jede mit Logo und Namen.
3. Wähle **Kundenexport (JSON)**. Das Fenster **Kundenexport (JSON)** öffnet sich mit dem Feld **Kunde** und den Schaltflächen **Öffnen** und **Abbrechen**. Darin steht der Hinweis „Bitte wähle einen Kunden aus und drücke "Öffnen", um die Daten zu exportieren.“
4. Steht im Feld **Kunde** noch niemand, suche den Kunden über **Kunde suchen** und wähle ihn in der Trefferliste aus. Unter jedem Namen steht eine Zusatzzeile, zum Beispiel mit „Geb.“ und dem Geburtsdatum, der Nummer, dem Betreuer und der Adresse. Das Feld nimmt genau einen Kunden auf. Sobald er gewählt ist, verschwindet das Suchfeld.
5. Klicke auf **Öffnen**. Der Download der Datei `kunde_<ID>.json` startet sofort.

**Abbrechen** schließt das Fenster.

Jeder Klick auf **Öffnen** erzeugt einen neuen Download-Link, der nur einmal und höchstens 30 Minuten gilt. Brauchst du die Datei noch einmal oder mit dem aktuellen Stand, klicke im Fenster **Kundenexport (JSON)** erneut auf **Öffnen**.

## Häufige Fragen {#haeufige-fragen}

::faq
  :::faq-item{question="Kann ich mehrere oder alle Kunden auf einmal exportieren?"}
  Nein. Im Fenster **Kundenexport (JSON)** nimmt das Feld **Kunde** genau einen Kunden auf. Einen Massenexport gibt es nicht. Auch einen automatischen oder zeitgesteuerten Export gibt es nicht. Für jeden weiteren Kunden wiederholst du den Export.
  :::

  :::faq-item{question="Kann ich die JSON-Datei wieder in i-Planner einspielen?"}
  Nein. Kundenexport (JSON) hat keine Import-Funktion und keinen Rückweg. Der Export liest nur. In i-Planner wird dabei nichts gespeichert oder geändert.
  :::

  :::faq-item{question="Brauche ich Zugangsdaten oder einen Account für Kundenexport (JSON)?"}
  Nein. Die Detailseite unter **Organisation › Integrationen** hat keinen Bereich **Zugangsdaten**, und das Fenster **Kundenexport (JSON)** in der **Kundenverwaltung** fragt keinen Account ab.

  Hinter dem Info-Symbol am Schalter **Integration aktivieren** steht zwar ein Hinweis zu Accounts: „Deaktivieren suspendiert die Accounts nicht — es schränkt nur die Nutzung der Schnittstelle ein. Zum Stilllegen der Accounts den Schalter ‚Alle Accounts deaktivieren‘ nutzen.“ Dieser Text ist bei allen Integrationen gleich. Kundenexport (JSON) verwendet keine Accounts.
  :::

  :::faq-item{question="Kann ich nachvollziehen, wer einen Kunden exportiert hat?"}
  Nein. Einzelne Exporte stehen nicht im Audit-Log der Organisation. Dort steht nur, wer Kundenexport (JSON) ein- oder ausgeschaltet oder die Freigabe geändert hat. Du findest das unter **Organisation › Audit-Log** in Einträgen mit dem **Bereich** „Integrationen“. Mehr dazu steht unter **Organisation › Integrationen** im Abschnitt [Sehen, wer eine Integration geändert hat](/organisation/integrationen/uebersicht#aenderungen-im-audit-log). Wer exportieren darf, legst du über die **Freigabe** auf der Detailseite von Kundenexport (JSON) fest.
  :::
::

## Weitere Themen {#weitere-themen}

- [Fehlerbehebung](/organisation/integrationen/kundenexport-json/fehlerbehebung): wenn die Kachel fehlt, der Download nicht startet oder eine Fehlermeldung erscheint.
- [Wer die Integration nutzen darf](/organisation/integrationen/uebersicht#wer-integration-nutzen-darf): die Freigabe für Rollen, Gruppen und Personen einstellen.
- [Kunden](/kundenverwaltung/kontakte/kunden/uebersicht): den Kunden in der Kundenverwaltung aufrufen.
- [Portale](/organisation/integrationen/portale/uebersicht): die Linksammlung zu den Gesellschaftsportalen, ebenfalls ein Werkzeug von i-Planner.