> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fynn.eu/llms.txt
> Use this file to discover all available pages before exploring further.

# Kunde verwalten

> Erstelle und verwalte Kunden.

## Kunde erstellen

Erstelle einen neuen Kunden um Abonnements und Rechnungen zu erstellen.

<Tabs>
  <Tab title="Web-App verwenden">
    <Steps>
      <Step title="Kunden erstellen - Maske öffnen">
        Um die Kunden erstellen Maske zu öffnen, gibt es mehrere Möglichkeiten.

        Die schnellste Möglichkeit ist es, oben links auf das Plus-Symbol zu klicken und dann "Kunde" auszuwählen.
        Alternativ kannst du einfach `c` `n` als Tastenkombination verwenden.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/Oz1fjsoxDmWZX8Mb/images/plus-create-shortcut.png?fit=max&auto=format&n=Oz1fjsoxDmWZX8Mb&q=85&s=37d9ba4615650166518f1c6d1afe0806" alt="Plus-Shortcut" width="360px" data-path="images/plus-create-shortcut.png" />
        </Frame>

        Andernfalls kannst du auch auf ["Kunden"](https://app.fynn.eu/customers) in der linken Navigation klicken und dann auf "Neu".
      </Step>

      <Step title="Fülle die Kundendetails aus">
        Fülle die Kundendetails aus. Je nach Kundentyp (Privatperson oder Unternehmen) sind unterschiedliche Felder erforderlich.

        <Tip>
          Standardmäßig wird eine Kundennummer auf Basis des [Nummernkreises](/guide/tenant/number-ranges) generiert.
          Du kannst die Kundennummer auch manuell festlegen, indem du auf "Kundennummer" klickst und eine eigene Nummer eingibst.
        </Tip>

        <Info>
          **Automatische Spracherkennung:** Die Sprache des Kunden wird automatisch anhand des Landes vorgeschlagen.
          Kunden aus DACH-Ländern (DE, AT, CH) erhalten Deutsch, alle anderen Englisch.
          Die Sprache bestimmt, in welcher Sprache [Benachrichtigungen](/guide/notifications/introduction) und [Rechnungen](/guide/invoices/introduction) erstellt werden.
          Du kannst die vorgeschlagene Sprache jederzeit manuell überschreiben.
        </Info>

        <AccordionGroup>
          <Accordion title="Empfängeradresse">
            Wird die Empfängeradresse nicht ausgefüllt, wird automatisch eine leere Adresse erstellt. Diese kannst du im Nachhinein bearbeiten.

            Die Empfängeradresse wird zur Erstellung von [Rechnungen](/guide/invoices) und [Angeboten](/guide/offers) verwendet.

            <Frame>
              <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-create-address.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=2765720101be797df3e755c6286c7695" alt="Empfängeradresse" width="983" height="342" data-path="images/customer-create-address.png" />
            </Frame>
          </Accordion>

          <Accordion title="Abweichende Rechnungsdaten">
            In einigen Fällen kann es erforderlich sein, dass die Rechnungs E-Mail Adresse von der Empfängeradresse abweicht.

            In diesem Fall kannst du die abweichenden Rechnungsdaten ausfüllen.
          </Accordion>

          <Accordion title="DATEV">
            <Note>
              Die DATEV-Integration ist als Add-On verfügbar. Kontaktiere uns, wenn du die DATEV-Integration aktivieren möchtest.
            </Note>

            Wenn du die DATEV-Integration aktiviert hast, kannst du hier die DATEV-Debitorennummer eingeben oder automatisch auf Basis des [Nummernkreises](/guide/tenant/number-ranges) generieren lassen.

            <Frame>
              <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-create-datev.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=2e02be921129232abd650319cd23dba4" alt="DATEV Einstellungen" width="989" height="215" data-path="images/customer-create-datev.png" />
            </Frame>
          </Accordion>
        </AccordionGroup>

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-create-form.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=00c3bdc619509b4988ed26246d3a0e8f" alt="Kunde anlegen" width="1042" height="799" data-path="images/customer-create-form.png" />
        </Frame>

        Klicke nun auf <b>Kunde erstellen</b> um den Kunden anzulegen.
      </Step>

      <Step title="Kunde wurde erfolgreich angelegt">
        Der Kunde wurde erfolgreich angelegt. Du kannst nun [Abonnements](/guide/subscriptions), [Angebote](/guide/offers) und [Rechnungen](/guide/invoices) für den Kunden erstellen.

        <Frame>
          <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-details-empty.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=271cb67cafb5cb3e7ceab431589c65d9" alt="Kunde erfolgreich angelegt" width="1425" height="833" data-path="images/customer-details-empty.png" />
        </Frame>
      </Step>
    </Steps>
  </Tab>

  <Tab title="API verwenden">
    Verwende hierfür den [Kunde erstellen](/api-reference/customer/create-customer) Endpunkt.

    ```bash theme={null}
    POST /customers
    ```

    Alternativ kannst du den [Kunden abrufen](/api-reference/customer/get-customer)
    oder den [Kunden über die API aktualisieren](/api-reference/customer/update-customer).
  </Tab>

  <Tab title="Importieren">
    Der Import der Kundendaten ist aktuell über folgende Wege möglich:

    * Anlage über die [API](/api-reference/customer/create-customer)
    * DATEV-Debitorenstamm-Import
    * Stripe-Import

    <Tip>
      Solltest du Interesse an einem Stripe oder DATEV-Debitorenstamm-Import haben, oder von einer anderen Subscription Billing Lösung migrieren wollen, kontaktiere uns bitte hierzu.
    </Tip>
  </Tab>
</Tabs>

## Kunde bearbeiten

Nachdem du einen Kunden erstellt hast, kannst du die Kundendetails jederzeit bearbeiten.

<Warning>
  Unter Umständen kann es sein, dass du die Kundendetails nicht bearbeiten kannst, sofern du nicht die entsprechenden Berechtigungen hast oder die Kunden in der Web-Oberfläche schreibgeschützt sind.
</Warning>

Um die Einstellungen zu schreibgeschützte Kunden zu ändern, siehe [Schreibgeschützte Kunden](/guide/tenant/ui-defaults#Schreibgeschützte-Kunden).

<Steps>
  <Step title="Kunden bearbeiten - Maske öffnen">
    Um die Kundendetails zu bearbeiten, klicke auf "Kunden" in der linken Navigation und wähle den Kunden aus, den du bearbeiten möchtest.

    Klicke nun auf "Bearbeiten" auf der rechten Seite um die Kundendetails zu bearbeiten.
  </Step>

  <Step title="Kundendetails bearbeiten">
    Passe die Kundendetails an und klicke auf "Speichern" um die Änderungen zu übernehmen.

    <Frame>
      <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-edit-form.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=a252a13b0973fb11559f162f6cde20cf" alt="Kunde bearbeiten" width="1534" height="1998" data-path="images/customer-edit-form.png" />
    </Frame>
  </Step>

  <Step title="Kundenadresse bearbeiten">
    Um die Adresse des Kunden zu bearbeiten, bleibe in der selben Maske und wähle das passende Dropdown im Bereich "Adressen" aus.

    Neben der Adresse kannst du über das "Stift"-Symbol die Adresse bearbeiten.

    <Info>
      Bei einer Änderung der Adresse wird die Adresse ebenfalls für bestehende Abonnements aktualisiert, sofern diese am Abonnement ausgewählt wurde, oder die Standardadresse verwendet werden soll.
      Wünscht du dies nicht, lege bitte eine neue Adresse an und wähle diese explizit am Abonnement aus.
    </Info>

    <Frame>
      <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-edit-address.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=ca8509635f4c4b2754efd9ed2a8d9a5a" alt="Adresse bearbeiten" width="1428" height="522" data-path="images/customer-edit-address.png" />
    </Frame>
  </Step>

  <Step title="Kunde wurde erfolgreich bearbeitet" />
</Steps>

## Kunde archivieren

Du kannst einen Kunden archivieren, um diesen in der Kundenübersicht auszublenden.
Archivierte Kunden können zu einem späteren Zeitpunkt wiederhergestellt werden.

<Tabs>
  <Tab title="Web-App verwenden">
    <Steps>
      <Step title="Kunden archivieren">
        Um einen Kunden zu archivieren, klicke auf "Kunden" in der linken Navigation und wähle den Kunden aus, den du archivieren möchtest.

        Klicke nun auf "Archivieren" auf der rechten Seite um den Kunden zu archivieren.
      </Step>

      <Step title="Kunden archivieren bestätigen">
        Bestätige das Archivieren des Kunden, indem du auf "Archivieren" klickst.

        <Check>
          Einmal archivierte Kunden können wiederhergestellt werden.
        </Check>
      </Step>

      <Step title="Kunde wurde erfolgreich archiviert">
        Der Kunde wurde erfolgreich archiviert und wird in der Kundenübersicht ausgeblendet.
      </Step>
    </Steps>
  </Tab>

  <Tab title="API verwenden">
    Verwende hierfür den [Kunde archivieren](/api-reference/customer/archive-customer) Endpunkt.

    ```bash theme={null}
    PUT /customers/{customerId}/archive
    ```
  </Tab>
</Tabs>

## Kunde löschen

Du kannst einen Kunden löschen, wenn dieser nicht mehr benötigt wird.

Um einen Kunden löschen zu können, müssen folgende Bedingungen erfüllt sein:

* Der Kunde darf keine aktiven Abonnements besitzen
* Der Kunde darf keine Rechnungen besitzen
* Der Kunde darf keine abgeschlossenen Bestellungen besitzen
* Der Kunde darf keine Zahlungen besitzen

<Tip>
  Sollte eines der oben genannten Kriterien nicht erfüllt sein, kannst du stattdessen den \[Kunden archivieren]\(#Kunde archivieren).
  Archivierte Kunden werden in der Kundenübersicht ausgeblendet.
</Tip>

<Tabs>
  <Tab title="Web-App verwenden">
    <Steps>
      <Step title="Kunden löschen">
        Um einen Kunden zu löschen, klicke auf "Kunden" in der linken Navigation und wähle den Kunden aus, den du löschen möchtest.

        Klicke nun auf "Löschen" auf der rechten Seite um den Kunden zu löschen.
      </Step>

      <Step title="Kunden löschen bestätigen">
        Bestätige die Löschung des Kunden, indem du auf "Unwiderruflich löschen" klickst.

        <Warning>
          Einmal gelöschte Kunden können **nicht** wiederhergestellt werden.
        </Warning>
      </Step>

      <Step title="Kunde wurde erfolgreich gelöscht">
        Der Kunde wurde erfolgreich gelöscht.
      </Step>
    </Steps>
  </Tab>

  <Tab title="API verwenden">
    Verwende hierfür den [Kunde löschen](/api-reference/customer/delete-customer) Endpunkt.

    ```bash theme={null}
    DELETE /customers/{customerId}
    ```
  </Tab>
</Tabs>

## Kunden exportieren

Um Kunden als Xlsx-Datei zu exportieren, navigiere zur Kundenübersicht und klicke auf "Exportieren".
Der Export umfasst alle Kunden, die in deiner Organisation angelegt sind.

Im Export sind folgende Informationen enthalten:

* Kundenstammdaten
* Standard-Rechnungsadresse
* Standard-Kundenadresse
* Kunden-E-Mail-Adresse
* Rechnungs-E-Mail-Adresse
* Standard-Zahlungsart

<Frame>
  <img src="https://mintcdn.com/fynnsubscriptionbilling/tzBoVhlU_naKbmRt/images/customer-export.png?fit=max&auto=format&n=tzBoVhlU_naKbmRt&q=85&s=c62b4aeff05b9345c3da5bab9ca6fe59" alt="Kunden exportieren" width="1159" height="123" data-path="images/customer-export.png" />
</Frame>

## Persönlicher Ansprechpartner hinterlegen

Du kannst für jeden Kunden einen persönlichen Ansprechpartner hinterlegen. Dieser wird auf Angeboten, im [Kundenbereich](/guide/customers/customer-portal) und in der Kundendetailansicht angezeigt.

## Einstellungen

Individuelle Einstellungen pro Kunde wie Zahlungsfrist, automatischer Versand und Mahnwesen findest du unter [Kundeneinstellungen](/guide/customers/settings).