> ## 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.

# Pipedrive

> Verbinde Fynn mit Pipedrive: Billing-Übersicht direkt an Organisationen, Kunden-Sync in beide Richtungen und Angebote per Deep-Link.

Die Pipedrive-Integration zeigt dir Abrechnungsdaten direkt an jeder Organisation in Pipedrive, hält Kundendaten beidseitig aktuell und öffnet den Fynn-Angebotseditor mit vorausgewähltem Kunden per Klick.

## Was die Integration kann

<CardGroup cols={2}>
  <Card title="Billing-Panel an Organisationen" icon="chart-bar">
    In der Organisations-Ansicht in Pipedrive siehst du den aktuellen Abonnementstatus, offene und bezahlte Rechnungen (inkl. Hinweis auf aktive Ratenpläne), letzte Zahlungen und aktuelle Angebote.
  </Card>

  <Card title="Schnellaktionen" icon="bolt">
    Direkt aus dem Panel heraus: Rechnung erneut senden, Link zur Zahlungsmethoden-Verwaltung verschicken oder ein Abonnement zum nächstmöglichen Termin kündigen.
  </Card>

  <Card title="Angebote erstellen und bearbeiten" icon="file-contract">
    Ein Klick im Panel öffnet den Fynn-Angebotseditor mit dem passenden Kunden bereits vorausgewählt. Bestehende Angebote öffnest du genauso direkt.
  </Card>

  <Card title="Kunden-Sync" icon="arrows-rotate">
    Fynn-Kunden und Pipedrive-Organisationen bleiben automatisch synchronisiert: Neue Organisationen in Pipedrive können direkt als Fynn-Kunden angelegt werden; Änderungen am Firmennamen werden in beide Richtungen übertragen.
  </Card>
</CardGroup>

## Pipedrive verbinden

<Steps>
  <Step title="Integrationsseite öffnen">
    Öffne in der Fynn-App die Einstellungen und navigiere zu **Integrationen**. Wähle dort Pipedrive aus.
  </Step>

  <Step title="OAuth-Verbindung herstellen">
    Klicke auf **Pipedrive verbinden**. Du wirst zu Pipedrive weitergeleitet, um Fynn die benötigten Berechtigungen zu erteilen. Nach der Bestätigung kehrt Pipedrive automatisch zu Fynn zurück.
  </Step>

  <Step title="Integration einrichten">
    Nach dem ersten Verbinden richtet Fynn automatisch die nötigen Felder und Webhooks in deinem Pipedrive-Konto ein. Das passiert im Hintergrund und dauert wenige Sekunden.
  </Step>

  <Step title="Fertig">
    Das Billing-Panel erscheint ab sofort in jeder Pipedrive-Organisation, der ein Fynn-Kunde zugeordnet ist.
  </Step>
</Steps>

## Konfiguration

Auf der Einstellungsseite der Pipedrive-Integration findest du zwei Sync-Optionen:

<AccordionGroup>
  <Accordion title="Kunden aus Pipedrive anlegen">
    Wenn diese Option aktiv ist, legt Fynn automatisch einen neuen Kunden an, sobald eine Organisation in Pipedrive erstellt oder geändert wird und noch kein Fynn-Kunden verknüpft ist. Ohne diese Option startet die Verknüpfung erst, wenn du einen Kunden manuell in Fynn anlegst und der Abgleich die passende Organisation findet.
  </Accordion>

  <Accordion title="Bidirektionaler Sync">
    Ist der bidirektionale Sync eingeschaltet, überträgt Fynn Änderungen am Kundennamen auch zurück nach Pipedrive. Ohne diese Option fließen Änderungen nur von Pipedrive nach Fynn.
  </Accordion>
</AccordionGroup>

## Angebote direkt in Pipedrive erstellen und bearbeiten

Angebote entstehen und wachsen direkt in Pipedrive, ohne die App zu wechseln. Ein Klick im Aktionsmenü einer Organisation öffnet den vollständigen Fynn-Angebotseditor in einem fokussierten Fenster, ganz ohne die linke Navigation. Du arbeitest also mit dem echten Editor, nur eingebettet.

<Steps>
  <Step title="Angebot anlegen">
    Öffne bei einer Organisation das Aktionsmenü und wähle die Fynn-Aktion zum Erstellen eines Angebots. Fynn legt sofort einen Entwurf für den verknüpften Kunden an und öffnet ihn direkt im Editor, ohne Zwischenschritt.
  </Step>

  <Step title="Angebot ausarbeiten">
    Im eingebetteten Editor ergänzt du Positionen, Preise, Laufzeiten und Texte wie gewohnt. Alle Änderungen werden automatisch gespeichert.
  </Step>

  <Step title="Bestehendes Angebot bearbeiten">
    Ein bestehendes Angebot öffnest du über die Angebots-Aktion erneut im Editor-Fenster. Du landest genau in dem Angebot und kannst weiterarbeiten.
  </Step>
</Steps>

<Note>
  Ist die Organisation noch mit keinem Fynn-Kunden verknüpft, führt dich ein Hinweis zuerst zur Konfiguration. Sobald die Verknüpfung steht, öffnet die Aktion den Editor direkt.
</Note>

## Billing-Panel

Das Panel in Pipedrive zeigt für jede verknüpfte Organisation:

| Bereich     | Inhalt                                                                       |
| ----------- | ---------------------------------------------------------------------------- |
| Abonnements | Aktive Pläne, Status, nächste Abrechnung                                     |
| Rechnungen  | Letzte Rechnungen mit Betrag, Status und Hinweis auf einen aktiven Ratenplan |
| Zahlungen   | Letzte eingegangene Zahlungen                                                |
| Angebote    | Aktuelle Angebote mit direktem Link zum Editor                               |

Über die Aktionsschaltflächen im Panel kannst du ohne Wechsel in die Fynn-App eine Rechnung erneut zustellen, einen Zahlungsmethoden-Link an den Kunden schicken oder ein Abonnement kündigen.

## Abrechnungsfortschritt in Pipedrive

Das Billing-Panel in Pipedrive zeigt dir auch den Abrechnungsfortschritt der verknüpften Organisation: wie viel bereits fakturiert wurde und, bei Verträgen mit einem festen Gesamtvolumen, wie viel noch offen ist.

Bei unbefristeten Abonnements ohne festes Vertragsvolumen wird nur der bereits fakturierte Betrag angezeigt. Es gibt kein sinnvolles Soll, das sich ausweisen ließe.

<Info>
  Der Abrechnungsfortschritt erscheint automatisch im Panel, sobald für den Kunden Rechnungen in Fynn vorhanden sind.
</Info>

## Hinweise

<Info>
  Für neue Organisationen ohne hinterlegte E-Mail-Adresse in Pipedrive wird in Fynn zunächst eine Platzhalter-E-Mail eingetragen. Die tatsächliche Rechnungs-E-Mail trägst du direkt im Kundenprofil in Fynn nach.
</Info>

<Note>
  Der Fynn-Kundenname und Pipedrive-Organisationsname werden beim bidirektionalen Sync abgeglichen. Weitere Felder (Ansprechpartner, E-Mail, Telefon) werden aktuell nicht übertragen.
</Note>

<Warning>
  Die Integration setzt ein aktives Pipedrive-Konto sowie die Berechtigung voraus, Organisations-Felder und Webhooks in Pipedrive zu erstellen. Stelle sicher, dass dein Pipedrive-Nutzer diese Rechte hat, bevor du die Verbindung herstellst.
</Warning>