Verbindungen-Referenz

Dieses Dokument ist eine Referenz für den Bildschirm Verbindungen (Connections) des ADP Car Market Hub-Plugins (CMH Center → Connections). Es ist der zentrale Ort, an dem jede Datenquelle verbunden wird und an dem alle API-Zugangsdaten gespeichert sind – AutoScout24, mobile.de, carcuro, ein automatischer Feed, ein E-Mail-Postfach oder ein einmaliger Datei-Upload.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie Fahrzeuge in das Plugin einpflegen möchten, wenn Sie die API-Zugangsdaten für eine Datenquelle eingeben oder ändern müssen oder wenn Sie überprüfen möchten, ob eine Quelle verbunden ist. Unabhängig von der Quelle landet jedes Fahrzeug im selben Bestand und wird von derselben Import-Pipeline verarbeitet.

Übersicht

Unter „Verbindungen“ werden Ihre Datenquellen in einem einzigen, übersichtlichen Akkordeon dargestellt. Jede Zeile steht für eine Quelle, deren Verbindungsstatus auf der rechten Seite angezeigt wird:

• ein grünes Label Verbunden (AutoScout24, mobile.de, carcuro) oder Aktiv (Feed, E-Mail), wenn die Quelle eingerichtet ist, oder
• eine Handlungsaufforderung Konfigurieren, wenn dies nicht der Fall ist.

Klicken Sie auf eine Zeile, um sie aufzuklappen und diese Quelle zu konfigurieren. Das Öffnen einer Zeile schließt die anderen, sodass nur die Quelle sichtbar ist, an der Sie gerade arbeiten. Nachdem Sie eine Quelle gespeichert – oder einen Import für sie ausgeführt – haben, bleibt ihre Zeile geöffnet, damit Sie das Ergebnis sehen können.

Die sechs Quellen sind:

1. AutoScout24 – Live-Bestandssynchronisierung über die AutoScout24-API.
2. mobile.de – Live-Bestandssynchronisierung über Ihre mobile.de-Händler-API-Zugangsdaten.
3. carcuro – Live-Bestandssynchronisierung über Ihr carcuro-Firmen-Token.
4. Automatischer Import (Feed) – ein geplanter Abruf von einer https://-URL, einem FTP/FTPS/SFTP-Verzeichnis, einem Serverordner oder einem Cloud-Freigabelink.
5. E-Mail-Import – automatisches Abrufen des Bestandsexports aus einem Postfach.
6. Datei aus Ihrer Händlersoftware (DMS) importieren – ein einmaliger Upload einer CSV-, TXT-, TSV-, XML-, Excel- (.xlsx) oder JSON-Datei (oder eines ZIP-Archivs mit Bildern).

Alle Live- und geplanten Quellen laufen über den zentralen Importzeitplan des Plugins, der unter Import & Limits konfiguriert wird (siehe Referenz für Import und Limits). Sie geben die Zugangsdaten hier einmalig ein; das Plugin kümmert sich um den Rest gemäß dem von Ihnen zentral festgelegten Zeitplan.

Wo sind die API-Zugangsdaten geblieben? In früheren Versionen wurde die AutoScout24-API-Verbindung unter Einstellungen konfiguriert. Alle Zugangsdaten für Datenquellen befinden sich jetzt hier auf der Seite „Verbindungen“ an einem Ort, mit einem sichtbaren Verbindungsstatus. Der Einstellungsbildschirm enthält nur noch allgemeine Optionen (wie die Standardwährung) und eine Karte Datenquellen & API-Verbindungen, die hierher verlinkt.

Anforderungen oder Voraussetzungen

• Zugriff auf CMH Center → Verbindungen (erfordert die Verwaltungsberechtigung des Plugins).
• Eine gültige Plugin-Lizenz – Importe und geplante Synchronisierungen erfordern eine aktive Lizenz (siehe Settings Reference).
• Zugangsdaten für die von Ihnen verwendete Quelle: AutoScout24-API-Zugangsdaten, mobile.de-Händler-API-Zugangsdaten, ein carcuro-Firmen-Token, Feed-/FTP-/SFTP-Zugangsdaten oder IMAP-Postfach-Zugangsdaten. Diese werden von Ihrem Anbieter ausgestellt, nicht vom Plugin.
• Für den E-Mail-Import: die PHP-Erweiterung imap auf dem Server.

Schritt-für-Schritt-Anleitung

1. Öffnen Sie CMH Center → Verbindungen.
2. Klicken Sie auf die Zeile der Quelle, die Sie verbinden möchten.
3. Geben Sie die Details dieser Quelle ein (siehe die quellspezifische Referenz unten) und speichern Sie. Das Status-Label auf der rechten Seite wechselt zu Verbunden / Aktiv.
4. Legen Sie unter CMH Center → Import & Limits fest, wie oft das Plugin importiert – dieser einzige Zeitplan steuert jede verbundene Quelle.
5. Um sofort zu importieren, verwenden Sie die Ausführen-Schaltfläche der Quelle (zum Beispiel Jetzt von carcuro importieren) oder führen Sie einen manuellen Import über Import & Limits aus.
6. Überprüfen Sie das Ergebnis in CMH Center → Fahrzeug-Importer Referenz und im CMH Cars-Bestand.

---

Konfigurationsreferenz

AutoScout24

Verbinden Sie Ihren Live-Bestand von AutoScout24 direkt über die API.

Wenn die Zugangsdaten vorhanden sind, zeigt die Zeile Verbunden an, und es erscheint ein Link Fahrzeug-Importer öffnen, über den Sie die Synchronisierung ausführen oder verwalten können. Das Speichern neuer Zugangsdaten löscht das zwischengespeicherte Access Token und den zwischengespeicherten API-Verbindungsstatus, sodass die nächste Anfrage die neuen Werte verwendet.

mobile.de

Verbinden Sie Ihren Live-Bestand von mobile.de direkt über die Händler-API – genau wie bei carcuro werden die Spalten automatisch für Sie zugewiesen, sodass Sie nichts manuell zuordnen müssen.

Diese Zugangsdaten stammen aus dem mobile.de Händlerbereich: Öffnen Sie Ihren Kontonamen › „mobile.de Konto“ › „Inserats-Einbindung“, um den API-Benutzernamen und das Passwort zu finden.

Verwenden Sie mobile.de-Einstellungen speichern, um die Verbindung zu sichern, und Jetzt von mobile.de importieren, um sofort einen Import auszuführen. mobile.de importiert und synchronisiert über den zentralen Import-Zeitplan des Plugins mit automatischer Spaltenzuordnung, genau wie carcuro.

carcuro

Wenn sich Ihr Bestand in carcuro befindet, verbinden Sie ihn direkt – genau wie AutoScout24. Sie geben nur ein Token an; die Spalten werden automatisch für Sie zugewiesen, sodass Sie nichts manuell zuordnen müssen.

Aktivieren Sie Automatisch importieren und synchronisieren, damit das Plugin carcuro über den zentralen Import-Zeitplan abruft. Verwenden Sie Jetzt aus carcuro importieren, um sofort einen Import auszuführen. Neue Fahrzeuge erscheinen, bei carcuro entfernte Fahrzeuge werden hier entfernt – es macht keinen Unterschied, ob Sie AutoScout24 oder carcuro verwenden.

Automatischer Import (Feed)

Anstatt jedes Mal eine Datei hochzuladen, lassen Sie das Plugin Ihren Bestand automatisch abrufen.

Das Dateiformat (CSV, XML oder Excel) wird automatisch erkannt, und die Spaltenzuordnung, die Sie beim Schritt des Datei-Uploads gespeichert haben, wird wiederverwendet. Laden Sie eine Datei hoch und speichern Sie die Zuordnung einmal, bevor Sie den Feed aktivieren.

E-Mail-Import

Wenn Ihre Händlersoftware den Bestandsexport per E-Mail versendet, kann das Plugin diesen automatisch abholen. Es verbindet sich mit einem Postfach, liest die neueste passende Nachricht mit einem CSV-, XML-, Excel- oder JSON-Anhang und importiert diese unter Verwendung der gespeicherten Spaltenzuordnung.

Der E-Mail-Import erfordert die PHP-Erweiterung imap. Wenn diese nicht installiert ist, zeigt die Karte einen Hinweis an und Sie können stattdessen einen https://- / FTP- / SFTP-Feed oder einen Serverordner verwenden.

Importieren einer Datei aus Ihrer Händlersoftware (DMS)

Ein einmaliger Upload für jeden Export aus einer Händlersoftware (DMS).

• Akzeptierte Formate: CSV, TXT, TSV, XML, Excel (.xlsx) und JSON – oder ein ZIP-Archiv, das die Datendatei zusammen mit den Fahrzeugbildern enthält (verweisen Sie in Ihrer Bildspalte auf jedes Bild über seinen Dateinamen).
• Spalten einmalig zuordnen. Nach dem Upload ordnen Sie jedes Plugin-Feld einer Spalte aus Ihrer Datei zu. Nur Marke/Modell (oder Version) und eine Bestandsnummer oder VIN sind erforderlich; lassen Sie alles, was Ihr Export nicht enthält, auf „nicht zugeordnet“. Ein optionaler Schritt Automatisch zuordnen mit KI kann Ihnen eine Zuordnung zur Überprüfung vorschlagen.
• Vorschau vor dem Import. Ein Testlauf zeigt, wie viele Zeilen gültig sind, welche neu oder aktualisiert würden und welche Zeilen Probleme aufweisen – es wird nichts geschrieben, bis Sie Jetzt importieren wählen.
• Die Zuordnung wird gespeichert und für den nächsten Upload sowie für die automatischen Feed- und E-Mail-Quellen wiederverwendet.
• Die Zeichenkodierung wird für Sie übernommen: Windows-1252-Dateien werden in UTF-8 konvertiert (Schweizer Umlaute und ähnliche Zeichen bleiben erhalten), und mehrzeilige Zellen in CSV-Dateien werden korrekt ausgelesen.

---

---

Betriebliche Hinweise

• Ein Zeitplan für alles. AutoScout24, mobile.de und carcuro haben keinen eigenen Zeitplan – sie laufen über den zentralen Import-Zeitplan unter Import & Limits. Die Feed- und E-Mail-Quellen bieten zusätzlich ein eigenes Intervall. Ein manueller Import kann jederzeit ausgelöst werden.
• Eine Pipeline für alles. Unabhängig von der Quelle durchläuft jedes Fahrzeug dieselbe nachgelagerte Verarbeitung: VIN-basierte Wiedereinstellungs-Erkennung, Wertnormalisierung, Bildimport, Slug-Generierung und Team-Zuweisung. Jede Einstellung gilt für den gesamten Bestand, unabhängig davon, aus welcher Quelle ein Fahrzeug stammt.
• Zugangsdaten sind im Ruhezustand verschlüsselt. Das AutoScout24 Client Secret, das mobile.de API-Passwort, das carcuro-Token und die Feed-/Postfach-Passwörter werden verschlüsselt in der Datenbank über den Secret-Store des Plugins gespeichert, nicht als Klartext.
• Demodaten sind auf der Tools-Seite zum Ausprobieren verfügbar und können jederzeit wieder entfernt werden.

Fehlerbehebung

• Eine Quelle zeigt "Konfigurieren" statt "Verbunden" an. Die Zugangsdaten fehlen oder sind unvollständig. Öffnen Sie die Zeile und geben Sie sie erneut ein. Für AutoScout24 benötigen Sie mindestens eine Client ID und ein Client Secret; für carcuro benötigen Sie das Firmen-Token.
• carcuro hat mit einem HTTP-Fehler geantwortet / die Anfrage abgelehnt. Das Firmen-Token ist wahrscheinlich falsch. Kopieren Sie es erneut aus carcuro unter Webseite › Fahrzeugliste › Integration.
• Die Feed- oder E-Mail-Quelle meldet, dass kein Spalten-Mapping gespeichert ist. Laden Sie einmalig eine Datei im Schritt "Datei-Upload" hoch und speichern Sie zuerst das Mapping – die Feed- und E-Mail-Quellen verwenden dieses Mapping wieder.
• E-Mail-Import ist nicht verfügbar. Dem Server fehlt die PHP-Erweiterung imap. Verwenden Sie stattdessen eine Feed- oder Server-Ordner-Quelle oder bitten Sie Ihren Hoster, imap zu aktivieren.
• Es wird nichts nach Zeitplan importiert. Vergewissern Sie sich, dass die Quelle aktiviert ist, eine gültige Lizenz aktiv ist und der zentrale Zeitplan unter Referenz für Import und Limits läuft (siehe Cron-Jobs und Hintergrundverarbeitung).

Zugehörige Dokumente

• Einstellungs-Referenz
• Fahrzeug-Importer Referenz
• Referenz für Import und Limits
• Mapping-Referenz
• Fahrzeug-Import-Workflow
• Externe API-Zugangsdaten