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 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 Inventar und wird von derselben Import-Pipeline verarbeitet.

Übersicht

Universal Import präsentiert Ihre Datenquellen als ein einziges, übersichtliches Akkordeon. Jede Zeile stellt eine Quelle dar, deren Verbindungsstatus rechts angezeigt wird:

• eine grüne Verbunden-Pille (AutoScout24, carcuro) oder Aktiv-Pille (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 klappt die anderen ein, 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-Inventarsynchronisation über die AutoScout24-API.
2. carcuro – Live-Inventarsynchronisation über Ihr carcuro-Firmentoken.
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 Inventarexports aus einem Postfach.
5. Datei aus Ihrer Garagen-Software (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 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 „Universal Import“ an einem einzigen 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 → Universal Import (erfordert die Verwaltungsberechtigung des Plugins).
• Eine gültige Plugin-Lizenz – Importe und geplante Synchronisationen erfordern eine aktive Lizenz (siehe Settings Reference).
• Zugangsdaten für die jeweils verwendete Quelle: AutoScout24-API-Zugangsdaten, ein carcuro-Firmentoken, 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 der Quelle, die Sie verbinden möchten.
3. Geben Sie die Details dieser Quelle ein (siehe die quellenbezogene 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 unter Import & Limits aus.
6. Überprüfen Sie das Ergebnis im CMH Center → Car Importer und im CMH Cars-Inventar.

Konfigurationsreferenz

AutoScout24

Verbinden Sie Ihr Live-AutoScout24-Inventar direkt über die API.

Wenn die Zugangsdaten vorhanden sind, zeigt die Zeile Verbunden an, und ein Link Car Importer öffnen erscheint, damit Sie die Synchronisation 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 Inventar in carcuro liegt, verbinden Sie es direkt – genau wie AutoScout24. Sie geben nur ein Token an; die Spalten werden automatisch für Sie zugewiesen, sodass nichts manuell zugeordnet werden muss.

Aktivieren Sie Automatisch importieren und synchronisieren, damit das Plugin carcuro gemäss dem 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 Ihr Inventar automatisch abrufen.

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

E-Mail-Import

Wenn Ihre Garagen-Software den Inventarexport 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.

Datei aus Ihrer Garagen-Software (DMS) importieren

Ein einmaliger Upload für jeden Export 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. Erforderlich sind nur Marke/Modell (oder Version) sowie eine Lager-Nummer oder VIN; lassen Sie alles, was Ihr Export nicht enthält, auf „nicht zugeordnet“. Ein optionaler Schritt Automatisch zuordnen mit KI kann Ihnen die 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 erledigt: Windows-1252-Dateien werden in UTF-8 konvertiert (Schweizer Umlaute und ähnliche Zeichen bleiben erhalten), und mehrzeilige Zellen in CSV-Dateien werden korrekt gelesen.

Betriebliche Hinweise

• 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 Kulanzzeit für das Soft-Delete von verschwundenen Fahrzeugen, Wertnormalisierung, Bildimport, Slug-Generierung und Team-Zuweisung. Jede Einstellung gilt für das gesamte Inventar, unabhängig davon, aus welcher Quelle ein Fahrzeug stammt.
• Passwörter und Keys sind 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 Firmentoken.
• carcuro antwortete mit einem HTTP-Fehler / lehnte die Anfrage ab. Das Firmentoken ist wahrscheinlich falsch. Kopieren Sie es erneut aus carcuro unter Webseite › Fahrzeugliste › Integration.
• Die Feed- oder E-Mail-Quelle meldet, dass keine Spaltenzuordnung gespeichert ist. Laden Sie einmalig eine Datei im Datei-Upload-Schritt hoch und speichern Sie zuerst die Zuordnung – die Feed- und E-Mail-Quellen verwenden diese Zuordnung 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, eine gültige Lizenz aktiv ist und der zentrale Zeitplan unter 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