# Überblick

FINN.pipedrive versorgt das CRM **Pipedrive** aus der SelectLine Warenwirtschaft. Gepflegt
wird weiter in der SelectLine; der Vertrieb arbeitet in Pipedrive und sieht dort dieselben
Kunden, Artikel und Vorgänge.

## Was das Modul kann

- **Kontakte übertragen** — CRM-Adressen der SelectLine als Organisationen und Personen, mit Kennzeichnung nach Kunde, Lieferant, Interessent.
- **Artikel als Produkte übertragen** — mit Preis, Status und auf Wunsch den Artikelbildern.
- **Belege als Deals übertragen** — je Belegtyp in eine festgelegte Phase, mit Positionen und Belegdaten.
- **Journale, Projekte und Leads abgleichen** — Journale als Aktivitäten, Projekte als Pipedrive-Projekte; Leads laufen umgekehrt und werden in der SelectLine zum Beleg.

## Wofür es typischerweise eingesetzt wird

| Fall | Was das Modul dabei leistet |
| ---- | --------------------------- |
| **Vertrieb im CRM, Stammdaten im ERP** | die Daten werden einmal in der SelectLine gepflegt und erscheinen in Pipedrive — keine doppelte Eingabe, keine abweichenden Dubletten |
| **Kunden im CRM bewerten** | Umsätze, Bestellanzahl und bereits bestellte Produktkategorien stehen am Kontakt in Pipedrive, ohne dafür ins ERP zu wechseln |
| **Wiedervorlage nach Kaufverhalten** | Kontakte werden anhand der Zeit seit der letzten Bestellung mit einem Label versehen und lassen sich in Pipedrive danach filtern |

![Was zwischen SelectLine und Pipedrive übertragen wird](https://wiki.dako-it.com/uploads/images/gallery/2026-09/ghostdocs-finnpipedrive-pd-ueberblick-00109d3a-ueberblick-datenfluss.png)

## Die Richtung

<p class="callout warning">Die Schnittstelle arbeitet derzeit im Wesentlichen <strong>in eine Richtung</strong>: von der SelectLine nach Pipedrive. Was in Pipedrive von Hand geändert wird, kommt nicht in die SelectLine zurück — und wird beim nächsten Lauf überschrieben.</p>

Die einzige Ausnahme ist die **Lead-Synchronisation**: Sie holt Leads aus Pipedrive und legt
daraus in der SelectLine einen Beleg an. Siehe [Leads](https://wiki.dako-it.com/books/finnpipedrive/page/leads).

Was gilt und was geplant ist, steht in der
[Leistungsbeschreibung](https://wiki.dako-it.com/books/finnpipedrive/page/leistungsbeschreibung).

## Die sechs Bereiche

Jeder Bereich wird einzeln eingerichtet und hat eine eigene Aufgabe in der Zeitsteuerung:

| Bereich | Aus der SelectLine | Nach Pipedrive |
| --------------- | ---------------------------- | ------------------------------ |
| [Kontakte](https://wiki.dako-it.com/books/finnpipedrive/page/kontakte) | CRM-Adressen | Organisationen und Personen |
| [Produkte](https://wiki.dako-it.com/books/finnpipedrive/page/produkte) | Artikel und Artikelbilder | Produkte |
| [Belege](https://wiki.dako-it.com/books/finnpipedrive/page/belege) | Belege mit Positionen | Deals |
| [Aktivitäten](https://wiki.dako-it.com/books/finnpipedrive/page/aktivitaten) | Journale | Aktivitäten |
| [Projekte](https://wiki.dako-it.com/books/finnpipedrive/page/projekte) | Projekte | Projekte |
| [Leads](https://wiki.dako-it.com/books/finnpipedrive/page/leads) | *(umgekehrte Richtung)* | Leads werden zum Beleg |

<p class="callout danger">Die Bereiche bauen aufeinander auf. <strong>Kontakte</strong> und <strong>Produkte</strong> müssen eingerichtet sein, bevor Belege übertragen werden können — ein Deal ohne Organisation und ohne Produkte wäre in Pipedrive nicht nachvollziehbar.</p>

## Wie zugeordnet wird

Beide Systeme müssen einen Datensatz wiedererkennen. Dafür wird in Pipedrive je Bereich ein
Feld hinterlegt, in dem die Nummer bzw. ID aus der SelectLine steht.

<p class="callout success">Das ist der Kern der Einrichtung: Ohne dieses Feld findet die Schnittstelle einen bereits übertragenen Datensatz nicht wieder und würde ihn erneut anlegen.</p>

Siehe [Zuordnung und Extrafelder](https://wiki.dako-it.com/books/finnpipedrive/page/zuordnung-und-extrafelder).

## Voraussetzungen

- Ein **Pipedrive-Konto** mit Administrationsrechten und ein API-Token.
- FINN.pipedrive ist ein eigenes, lizenzpflichtiges Modul.
- Eine **API-Lizenz** der SelectLine.

<p class="callout warning">Pipedrive begrenzt die Zahl der API-Zugriffe pro Tag. Wie viele zur Verfügung stehen, hängt vom Abo und der Zahl der Nutzer ab — und das entscheidet mit, wie oft die Übertragungen laufen können.</p>

Siehe [API-Tokens](https://wiki.dako-it.com/books/finnpipedrive/page/api-tokens).

## Aufbau dieses Handbuchs

| Kapitel | Inhalt |
| ---------------------------------- | ------------------------------------------ |
| [Grundlagen](https://wiki.dako-it.com/books/finnpipedrive/page/installation) | Installation, Leistungsumfang, Zuordnung |
| [Einstellungen](https://wiki.dako-it.com/books/finnpipedrive/page/allgemeine-einstellungen) | Verbindung und die sechs Bereiche einrichten |
| [Laufender Betrieb](https://wiki.dako-it.com/books/finnpipedrive/page/automatisierung) | Automatisierung, API-Tokens, Fehlersuche |