Referenz zu Verbindungen

Dieses Dokument ist eine Referenz für den Bildschirm Verbindungen 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-Posteingang oder ein einmaliger Datei-Upload.

Wann Sie dieses Dokument verwenden sollten

Verwenden Sie diese Referenz, wenn Sie Fahrzeuge in das Plugin importieren 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

Verbindungen präsentiert Ihre Datenquellen als ein einziges, übersichtliches Akkordeon. Jede Zeile stellt eine Quelle dar, deren Verbindungsstatus auf der rechten Seite angezeigt wird:

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

Klicken Sie auf eine Zeile, um sie auszuklappen und diese Quelle zu konfigurieren. Das Öffnen einer Zeile schliesst 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 Erfassen des Bestands-Exports aus einem Postfach.
6. Eine Datei aus Ihrer Garagen-Software (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 zu Import & Limits). Sie geben die Zugangsdaten hier einmal ein; das Plugin kümmert sich um den Rest gemäss dem von Ihnen zentral festgelegten Zeitplan.

Wo sind die API-Zugangsdaten hin? 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 behält nur 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 quellenbezogene 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 unter Import & Limits aus.
6. Überprüfen Sie das Ergebnis in CMH Center → Car Importer 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, damit 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-Importe und -Synchronisierungen laufen über den zentralen Importzeitplan des Plugins mit automatischer Spaltenzuordnung, genau wie bei 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 Importzeitplan abruft. Verwenden Sie Jetzt von 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 Dateiuploads gespeichert haben, wird wiederverwendet. Laden Sie einmalig eine Datei hoch und speichern Sie die Zuordnung, bevor Sie den Feed aktivieren.

E-Mail-Import

Wenn Ihre Garagen-Software 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 mithilfe der gespeicherten Spaltenzuordnung.

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

Eine Datei aus Ihrer Garagen-Software (DMS) importieren

Ein einmaliger Upload für jeden Export aus einer Garagen-Software (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 mit seinem 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 Lager-Nummer oder Fahrgestellnummer (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 Codierung 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 Importzeitplan 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 Teamzuweisung. 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" anstelle von "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. Auf 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 dass der zentrale Zeitplan unter Referenz zu Import & Limits läuft (siehe Cron und Hintergrundverarbeitung).

Verwandte Dokumente

• Settings Reference
• Referenz zum Fahrzeug-Importer
• Referenz zu Import & Limits
• Mapping-Referenz
• Arbeitsablauf für den Fahrzeugimport
• External API Credentials