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

# Attio

> Verbinde Fynn mit Attio: Abrechnungs-Widget direkt an der Company, Aktionen aus dem CRM und Kunden-Sync in beide Richtungen.

Die Attio-Integration zeigt deine Fynn-Abrechnung direkt an der Company in Attio, lässt dich typische Aktionen ohne Wechsel ins Billing anstoßen und hält Fynn-Kunden und Attio-Companies automatisch synchron.

## Was die Integration kann

<CardGroup cols={2}>
  <Card title="Abrechnungs-Widget an der Company" icon="table-columns">
    Ein Widget direkt in Attio zeigt an jeder Company das Abonnement, die letzten Rechnungen (inklusive Ratenplan), Zahlungen und Angebote deines Fynn-Kunden.
  </Card>

  <Card title="Aktionen aus Attio" icon="bolt">
    Aus dem Company-Datensatz heraus erstellst du ein Angebot, sendest eine Rechnung erneut, verschickst einen Zahlungslink oder kündigst ein Abo, jeweils mit Bestätigung vor der Kündigung.
  </Card>

  <Card title="Kunden-Sync" icon="arrows-rotate">
    Neue Companies in Attio können automatisch als Fynn-Kunden angelegt werden. Änderungen am Firmennamen werden bei aktiviertem bidirektionalen Sync in beide Richtungen übertragen.
  </Card>

  <Card title="Automatische Verknüpfung" icon="id-badge">
    Fynn schreibt die Kunden-ID (`fynn_customer_id`) und einen Billing-Link (`fynn_billing_url`) auf die Attio-Company. So bleibt die Verbindung zwischen CRM und Billing eindeutig und dauerhaft.
  </Card>
</CardGroup>

## Attio verbinden

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

  <Step title="OAuth-Verbindung herstellen">
    Klicke auf **Attio verbinden**. Du wirst zu Attio weitergeleitet, um Fynn Zugriff auf deinen Workspace zu erteilen. Nach der Bestätigung kehrst du automatisch zu Fynn zurück.
  </Step>

  <Step title="Integration einrichten">
    Nach dem Verbinden richtet Fynn die benötigten Attribute (`fynn_customer_id` und `fynn_billing_url`) auf dem Companies-Objekt ein und registriert den Webhook für Echtzeit-Sync. Das läuft automatisch im Hintergrund.
  </Step>

  <Step title="Fertig">
    Ab sofort werden Änderungen an Attio-Companies direkt nach Fynn übertragen, und verknüpfte Companies tragen den Billing-Link.
  </Step>
</Steps>

## Widget und Aktionen einrichten

Das Abrechnungs-Widget und die Aktionen laufen als Fynn-App direkt in Attio. Damit sich die App gegenüber Fynn authentifizieren kann, hinterlegst du einmalig ein Integration-Secret.

<Steps>
  <Step title="Integration-Secret in Fynn kopieren">
    Öffne in Fynn die Attio-Integrationsseite. Sobald die Integration eingerichtet ist, findest du dort das Integration-Secret. Klicke auf **Kopieren**.
  </Step>

  <Step title="In die Attio-App-Einstellungen einfügen">
    Öffne in Attio die Einstellungen der Fynn-App (**Workspace Settings, App, Fynn Billing**) und füge das Integration-Secret zusammen mit der API-Basis-URL ein.
  </Step>

  <Step title="Widget an der Company hinzufügen">
    Öffne eine Company in Attio, wähle in der Seitenkonfiguration **Widget hinzufügen** und füge das Fynn-Abrechnungs-Widget hinzu. Die Aktionen stehen anschließend im Aktionsmenü der Company bereit.
  </Step>
</Steps>

<Note>
  Behandle das Integration-Secret wie ein Passwort. Es bleibt bei einer erneuten Einrichtung unverändert, sodass du es nicht erneut in Attio eintragen musst.
</Note>

## Angebote direkt in Attio erstellen

An jeder Company findest du die Aktion **Angebot erstellen (CPQ)**. Damit baust du ein vollständiges Angebot für den verknüpften Fynn-Kunden, ohne Attio zu verlassen. Der Builder unterstützt alle wesentlichen Angebots-Bausteine direkt im Attio-Dialog.

<Steps>
  <Step title="Aktion öffnen">
    Öffne eine Company und wähle **Angebot erstellen (CPQ)**. Ist noch kein Fynn-Kunde verknüpft, weist dich ein Hinweis darauf hin, den Kunden zuerst anzulegen oder zu verknüpfen.
  </Step>

  <Step title="Ablaufdatum setzen">
    Lege optional ein Ablaufdatum für das Angebot fest. Ohne Datum bleibt das Angebot zeitlich offen.
  </Step>

  <Step title="Käufer-Adresse eintragen">
    Trage die Rechnungsadresse des Käufers ein. Die Felder werden auf korrekte Eingaben geprüft, zum Beispiel E-Mail-Format und Ländercode, damit das Angebot keine ungültigen Adressdaten enthält.
  </Step>

  <Step title="Positionen hinzufügen">
    Wähle Produkte aus deinem Katalog, setze die Mengen und füge Positionen hinzu oder entferne sie wieder. Die laufende Summe aktualisiert sich dabei live.
  </Step>

  <Step title="Textblöcke einfügen">
    Ergänze das Angebot um Überschriften und Absätze. Du kannst Blöcke hinzufügen, bearbeiten, entfernen und in der Reihenfolge verschieben.
  </Step>

  <Step title="Im Fynn-Editor verfeinern">
    Für erweiterte Preisgestaltung wie Phasen, Rabatte und Konditionen, oder um Bilder und Dateien hinzuzufügen, öffnest du das Angebot über **Im Fynn-Editor öffnen**. Bilder und Dateianhänge lassen sich nur dort ergänzen, da Attio keinen Datei-Upload unterstützt.
  </Step>
</Steps>

Bestehende Angebote im Abrechnungs-Widget tragen bei offenen Entwürfen einen **Bearbeiten**-Button, der denselben Angebots-Builder für dieses Angebot erneut öffnet.

<Info>
  Für die Angebotserstellung ist keine zusätzliche Einrichtung nötig. Sie nutzt dieselbe API-Basis-URL und dasselbe Integration-Secret, die du bereits hinterlegt hast.
</Info>

<Note>
  Angenommene oder archivierte Angebote sind gesperrt und können im Builder nicht bearbeitet werden. Öffne stattdessen den Fynn-Editor direkt.
</Note>

## Abrechnungsfortschritt in Attio

Das Abrechnungs-Widget an der Company zeigt neben Abonnements, Rechnungen und Zahlungen auch den Abrechnungsfortschritt deines Kunden: wie viel bereits fakturiert wurde und, bei Verträgen mit einem festen Gesamtvolumen, wie viel davon 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 ist automatisch verfügbar, sobald für den Kunden Rechnungen in Fynn vorhanden sind. Keine zusätzliche Einrichtung erforderlich.
</Info>

## Konfiguration

Auf der Einstellungsseite der Attio-Integration stehen dir folgende Optionen zur Verfügung:

<AccordionGroup>
  <Accordion title="Kunden aus Attio anlegen">
    Wenn diese Option aktiv ist, legt Fynn automatisch einen neuen Kunden an, sobald eine Company in Attio angelegt oder aktualisiert wird und noch kein Fynn-Kunde verknüpft ist.
  </Accordion>

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

  <Accordion title="Belege spiegeln">
    Ist diese Option aktiv, legt Fynn deine Abos, Rechnungen und Angebote als eigene Attio-Objekte an und verknüpft sie mit der Company. Die Option ist standardmäßig aus, weil sie zusätzliche Objekte und eine laufende Synchronisierung in Attio erzeugt. Die Objekte werden erst beim Aktivieren angelegt.
  </Accordion>
</AccordionGroup>

## Belege als Attio-Objekte spiegeln

Zusätzlich zum Live-Widget kann Fynn deine Abos, Rechnungen und Angebote als native Attio-Objekte anlegen und mit der Company verknüpfen. So kannst du in Attio direkt filtern, sortieren und in Listen arbeiten.

Die Spiegelung ist ein bewusster Schalter und standardmäßig aus, damit ohne dein Zutun keine zusätzlichen Objekte und keine laufende Synchronisierung in deinem Workspace entstehen. Erst wenn du **Belege spiegeln** in den Attio-Einstellungen aktivierst, legt Fynn die benötigten Objekte an. Ab diesem Zeitpunkt werden neue und geänderte Belege nach Attio übertragen.

<Note>
  Schaltest du die Spiegelung wieder aus, stoppt die Übertragung. Die bereits in Attio angelegten Objekte bleiben erhalten und werden nicht automatisch entfernt.
</Note>

## Felder an Attio-Companies

Fynn ergänzt das Companies-Objekt in Attio um zwei Text-Attribute:

| Feld               | Bedeutung                                                   |
| ------------------ | ----------------------------------------------------------- |
| `fynn_customer_id` | Eindeutige Fynn-Kunden-ID, die die Verknüpfung sicherstellt |
| `fynn_billing_url` | Direktlink zur Kundendetailseite in Fynn                    |

Die Felder werden beim ersten Einrichten der Integration automatisch angelegt, falls sie noch nicht existieren.

## Hinweise

<Note>
  Der Kunden-Sync überträgt aktuell den Firmennamen. Weitere Felder (Adresse, E-Mail, Ansprechpartner) werden nicht automatisch übertragen.
</Note>

<Info>
  Das Abrechnungs-Widget und die Aktionen lesen die Daten live aus Fynn. In Attio werden keine Rechnungen oder Zahlungen gespeichert, du siehst also immer den aktuellen Stand.
</Info>

<Warning>
  Die Integration benötigt einen Attio-Workspace mit Berechtigungen zum Erstellen und Bearbeiten von Attributen im Companies-Objekt sowie zum Anlegen von Webhooks. Stelle sicher, dass dein Attio-Nutzer diese Rechte hat.
</Warning>