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

# Carano

> Fahrzeug-, Leasing- und Vertragsdaten eines Fahrers direkt am Ticket sehen.

Die Carano-Integration verbindet dein [Carano](https://www.carano.de)-Fuhrparkmanagement mit Chatarmin CX. Wenn ein Fahrer schreibt, siehst du sein Fahrzeug sowie die Leasing- und Vertragsdaten direkt im Ticket und musst nicht in Carano nachschlagen.

> [!NOTE]
>
> Carano erscheint im **Kundenpanel** eines Tickets. Die Integration liest nur Daten. Sie ändert nichts in Carano und erzeugt weder Tickets noch Benachrichtigungen.

## Wann du es brauchst

Nutze Carano, wenn du einen Firmenwagen-Fuhrpark in Carano verwaltest und dein Team oft Fragen wie diese beantwortet:

* „Welches Auto ist mir zugeordnet?“ und „Wie lautet mein Kennzeichen?“
* „Wann endet mein Leasingvertrag?“ und „Wie hoch ist meine Leasingrate?“
* „Wie viele Kilometer darf ich pro Jahr fahren?“
* „Wann kommt mein neues Auto?“

## Einrichten

Du brauchst die **API Base URL**, den **Username** und das **Password** deines Carano-API-Zugangs. Carano stellt dir diese Daten für dein Unternehmen bereit. Wenn du sie nicht hast, frag deinen Carano-Kontakt.

**1. Integrationen öffnen**

[Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in den Workspace-Einstellungen und wähle **Carano**.

Wenn Carano nicht aufgelistet ist, melde dich bei deinem Chatarmin-CX-Ansprechpartner, damit er es für deinen Workspace freischaltet.

**2. Carano-Zugang eintragen**

Klicke auf **Connect** und fülle das Formular aus:

| Feld | Was du einträgst |
| - | - |
| **API Base URL** | Die Webadresse deiner Carano-API. Ein abschließendes `/` wird automatisch entfernt. |
| **Username** | Der Benutzername, den Carano dir für den API-Zugang gegeben hat. |
| **Password** | Das Passwort zu diesem Benutzernamen. |

Klicke auf **Connect**, um zu speichern. Chatarmin CX meldet sich zuerst mit diesen Daten bei Carano an. Lehnt Carano sie ab, siehst du den Grund und es wird nichts gespeichert.

**3. Sicher testen**

Öffne ein Ticket von einem Fahrer, dessen E-Mail-Adresse in Carano hinterlegt ist. Klappe die **Carano**-Karte im Kundenpanel auf und prüfe, ob Fahrer und Fahrzeug stimmen. Dabei werden nur Daten gelesen, du kannst es also gefahrlos an einem echten Fahrer testen.

## Carano im Posteingang nutzen

Chatarmin CX findet den Fahrer in Carano über die **E-Mail-Adresse** des Ticket-Kontakts. Die **Carano**-Karte erscheint im Kundenpanel, wenn Carano einen Fahrer mit dieser E-Mail hat.

Die Karte hat diese Bereiche. Eine Zeile erscheint nur, wenn Carano dafür einen Wert hat.

| Bereich | Was du siehst |
| - | - |
| **Fahrer** | Name, ob der Fahrer **Aktiv** oder **Inaktiv** ist, Personalnummer, Mobilnummer und wann der Datensatz zuletzt aktualisiert wurde. |
| **Fahrzeug** | Kennzeichen, Marke und Modell, Fahrgestellnummer, Kraftstoff, Kilometerstand und der Fahrzeugstatus. Zeigt **Im Fuhrpark seit**, sobald das Auto im Fuhrpark ist, und **Voraussichtliche Lieferung**, solange es noch unterwegs ist. |
| **Vertrag** | Vertragsnummer und -art, Vertragsstatus, Leasinggeber, Leasingrate, Laufleistung pro Jahr und Vertragslaufzeit. |

Die Leasingrate wird in Euro angezeigt und erscheint nur einmal, im Bereich **Vertrag**.

Die Bereiche Fahrzeug und Vertrag erscheinen, wenn dem Fahrer in Carano ein Fahrzeug zugeordnet ist.

### Wenn die Karte etwas anderes zeigt

| Situation | Was du siehst |
| - | - |
| Carano nicht verbunden | Keine Carano-Karte |
| Kontakt hat keine E-Mail-Adresse | Keine Carano-Karte. Ergänze eine E-Mail beim Kontakt. |
| Kein Fahrer mit dieser E-Mail in Carano | Keine Carano-Karte |
| Fahrer hat kein Fahrzeug in Carano | Nur der Bereich **Fahrer** |
| Carano nicht erreichbar | Die Karte wandert in die Zeile der Apps, die nicht geladen werden konnten. Klappe sie auf und klicke auf **Erneut versuchen**. |

> [!NOTE]
>
> Die Zuordnung läuft nur über die E-Mail. Schreibt ein Fahrer von einer privaten Adresse, die nicht in Carano hinterlegt ist, erscheint die Karte nicht. Aktualisiere die E-Mail des Kontakts oder hinterlege die Adresse beim Fahrer in Carano.

## Daten und Zugriff

Für jedes Ticket, das du öffnest, sendet Chatarmin CX die E-Mail-Adresse des Kontakts und die Carano-IDs, die es zurückbekommt, an Carano, um Fahrer, Fahrzeug und Vertrag abzufragen. Es wird nichts in Carano geschrieben.

Dein Passwort wird verschlüsselt gespeichert. Chatarmin CX speichert auch den Anmelde-Token von Carano verschlüsselt, damit nicht für jedes Ticket eine neue Anmeldung nötig ist.

KI-Agenten haben keine Carano-Aktionen. Carano-Daten sind für dein Team im Posteingang gedacht.

## Verbindung ändern oder trennen

Um eine Verbindung zu ändern, klicke sie in den [Integrationen](https://armin.cx/app/_/settings/integrations) an. Lass **Password** leer, um das aktuelle zu behalten. Chatarmin CX prüft die Daten vor dem Speichern erneut bei Carano.

Zum Trennen öffnest du das Menü **Connected** der Verbindung, wählst **Disconnect** und bestätigst mit **Delete**. Die Carano-Karte verschwindet aus den Tickets. Deine Daten und dein Konto in Carano bleiben unverändert.

## Fehlerbehebung

### Die Verbindung lässt sich nicht speichern

* Prüfe die **API Base URL** auf Tippfehler. Sie muss eine vollständige Webadresse sein, die mit `https://` beginnt.
* Prüfe, ob **Username** und **Password** vollständig und ohne Leerzeichen kopiert sind.
* Frag bei Carano nach, ob der API-Zugang aktiv ist.

### Die Karte erscheint nicht

* Prüfe, ob der Kontakt eine E-Mail-Adresse hat und Carano einen Fahrer mit genau dieser E-Mail kennt.
* Prüfe, ob die Verbindung in den [Integrationen](https://armin.cx/app/_/settings/integrations) noch gespeichert ist.

### Die Karte zeigt „Laden fehlgeschlagen“

* Klicke auf der Karte auf **Erneut versuchen**.
* Schlägt es weiter fehl, wurde vielleicht das Passwort in Carano geändert. Öffne die Verbindung, trage das neue Passwort ein und speichere.

### Der Bereich Fahrzeug oder Vertrag fehlt

* Carano liefert diese Bereiche nur, wenn dem Fahrer ein Fahrzeug zugeordnet ist. Prüfe die Zuordnung in Carano.
* Einzelne Zeilen werden ausgeblendet, wenn Carano keinen Wert dafür hat. Prüfe den Datensatz in Carano.

Wenn das nicht hilft, wende dich an den Chatarmin-CX-Support. Nenne den Ticket-Link und die Uhrzeit, zu der du es geöffnet hast, aber nicht dein Passwort.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.