Universal Import Referenz

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

Wann dieses Dokument zu verwenden ist

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

Universal Import stellt Ihre Datenquellen als ein einziges, übersichtliches Akkordeon dar. Jede Zeile ist eine Quelle, deren Verbindungsstatus auf der rechten Seite angezeigt wird:

• eine grüne Verbunden-Pille (AutoScout24, carcuro) oder Aktiv-Pille (Feed, E-Mail), wenn die Quelle eingerichtet ist, oder
• eine Konfigurieren-Aufforderung, wenn dies nicht der Fall ist.

Klicken Sie auf eine Zeile, um sie zu erweitern 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 fünf Quellen sind:

1. AutoScout24 – Live-Bestandssynchronisierung über die AutoScout24-API.
2. carcuro – Live-Bestandssynchronisierung über Ihr carcuro-Firmen-Token.
3. Automatischer Import (Feed) – ein geplanter Abruf von einer https://-URL, einem FTP/SFTP-Verzeichnis, einem Serverordner oder einem Cloud-Freigabelink.
4. E-Mail-Import – automatisches Abholen des Bestands-Exports aus einem Postfach.
5. Eine Datei aus Ihrer Händlersoftware (DMS) importieren – ein einmaliger Upload einer CSV-, XML-, Excel- 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 einmal 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 „Universal Import“, 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 → Universal Import (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, 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 → Universal Import.
2. Klicken Sie auf die Zeile für die Quelle, die Sie verbinden möchten.
3. Geben Sie die Details dieser Quelle ein (siehe die quellspezifische Referenz unten) und speichern Sie. Die Statuspille 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 aus carcuro importieren) oder führen Sie einen manuellen Import über 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-AutoScout24-Bestand direkt über die API.

Wenn die Zugangsdaten vorhanden sind, zeigt die Zeile Verbunden an, und ein Link Car Importer öffnen erscheint, 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.

carcuro

Wenn Ihr Bestand in carcuro liegt, verbinden Sie ihn direkt – genau wie AutoScout24. Sie geben nur ein Token an; die Spalten werden automatisch für Sie gemappt, sodass nichts manuell gemappt werden muss.

Aktivieren Sie Automatisch importieren und synchronisieren, damit das Plugin carcuro über den zentralen Importzeitplan 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 das beim Datei-Upload-Schritt gespeicherte Spalten-Mapping wird wiederverwendet. Laden Sie einmal eine Datei hoch und speichern Sie das Mapping, bevor Sie den Feed aktivieren.

E-Mail-Import

Wenn Ihre Händlersoftware den Bestands-Export per E-Mail versendet, kann das Plugin diesen automatisch abholen. Es verbindet sich mit einem Postfach, nimmt die neueste passende Nachricht mit einem CSV-, XML-, Excel- oder JSON-Anhang und importiert sie unter Verwendung des gespeicherten Spalten-Mappings.

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.

Eine Datei aus Ihrer Händlersoftware (DMS) importieren

Ein einmaliger Upload für jeden Export 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 mit seinem Dateinamen).
• Spalten einmalig mappen. Nach dem Upload weisen 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 gemappt“. Ein optionaler Schritt Automatisch mappen mit KI kann Ihnen das Mapping zur Überprüfung vorschlagen.
• Vorschau vor dem Importieren. 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.
• Das Mapping wird gespeichert und für den nächsten Upload sowie für die automatischen Feed- und E-Mail-Quellen wiederverwendet.
• Die Kodierung 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 gelesen.

Betriebshinweise

• Ein Zeitplan für alles. AutoScout24 und carcuro haben keinen eigenen Zeitplan – sie laufen über den zentralen Importzeitplan unter Import & Limits. Die Feed- und E-Mail-Quellen bieten zusätzlich ihr eigenes Intervall an. Ein manueller Import kann jederzeit gestartet werden.
• Eine Pipeline für alles. Unabhängig von der Quelle durchläuft jedes Fahrzeug dieselbe nachgelagerte Verarbeitung: VIN-basierte Erkennung von Wiedereinstellungen, die Soft-Delete-Schonfrist für verschwundene Fahrzeuge, Wertnormalisierung, Bildimport, Slug-Generierung und Team-Zuweisung. Jede Einstellung gilt für den gesamten Bestand, unabhängig davon, aus welcher Quelle ein Fahrzeug stammt.
• Secrets sind auf dem Server verschlüsselt. Das AutoScout24 Client Secret, das carcuro-Token und die Feed-/Postfach-Passwörter werden verschlüsselt in der Datenbank über den Secret-Speicher 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 einmal eine Datei im Datei-Upload-Schritt 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 Serverordner-Quelle oder bitten Sie Ihren Hoster, imap zu aktivieren.
• Nichts wird nach Zeitplan importiert. Vergewissern Sie sich, dass die Quelle aktiviert ist, dass eine gültige Lizenz aktiv ist und dass der zentrale Zeitplan unter Import & Limits läuft (siehe Cron-Jobs und Hintergrundverarbeitung).

Verwandte Dokumente

• Settings Reference
• Fahrzeug-Importer Referenz
• Referenz für Import und Limits
• Mapping-Referenz
• Fahrzeug-Import-Workflow
• External API Credentials