Documentation · Référence de l'administrateur
Référence de l'importation universelle
Ce document est une référence pour l'écran Universal Import de l'extension ADP Car Market Hub (CMH Center → Universal Import). C'est le lieu central où chaque source de données est connectée et où tous les identifiants API sont stockés — AutoScout24, carcuro, un flux automatique, une boîte de réception e-mail ou un import de fichier ponctuel.
Quand utiliser ce document
Utilisez cette référence lorsque vous souhaitez importer des véhicules dans l'extension, lorsque vous devez saisir ou modifier les identifiants API d'une source de données, ou lorsque vous souhaitez vérifier si une source est connectée. Quelle que soit la source, chaque véhicule se retrouve dans le même inventaire et est traité par le même pipeline d'importation.
Aperçu
Universal Import présente vos sources de données sous la forme d'un accordéon unique et ordonné. Chaque ligne représente une source avec son statut de connexion affiché à droite :
- une pastille verte Connected (AutoScout24, carcuro) ou Active (flux, e-mail) lorsque la source est configurée, ou
- un appel à l'action Configure lorsqu'elle ne l'est pas.
Cliquez sur une ligne pour la développer et configurer cette source ; l'ouverture d'une ligne réduit les autres, de sorte que seule la source sur laquelle vous travaillez soit visible. Après avoir enregistré une source — ou lancé un import pour celle-ci —, sa ligne reste ouverte afin que vous puissiez voir le résultat.
Les cinq sources sont :
- AutoScout24 — synchronisation de l'inventaire en direct via l'API AutoScout24.
- carcuro — synchronisation de l'inventaire en direct via votre jeton d'entreprise carcuro.
- Automatic import (feed) — une récupération planifiée à partir d'une URL
https://, d'un emplacement FTP/SFTP, d'un dossier de serveur ou d'un lien de partage cloud. - E-mail import — collecte automatique de l'export d'inventaire depuis une boîte aux lettres.
- Import a file from your dealer software (DMS) — un import ponctuel d'un fichier CSV, XML, Excel ou JSON (ou d'une archive ZIP avec des images).
Toutes les sources en direct et planifiées s'exécutent sur le programme d'importation central de l'extension, configuré sous Import & Limits (voir Référence des importations et des limites). Vous saisissez les identifiants une seule fois ici ; l'extension gère le reste selon le calendrier que vous définissez de manière centralisée.
Où sont passés les identifiants API ? Dans les versions précédentes, la connexion à l'API AutoScout24 était configurée sous Settings. Tous les identifiants des sources de données se trouvent désormais ici sur la page Universal Import, en un seul endroit, avec un statut de connexion visible. L'écran Settings ne conserve que les options générales (telles que la devise par défaut) et une carte Data sources & API connections qui renvoie ici.
Configuration requise ou prérequis
- Accès à CMH Center → Universal Import (nécessite la capacité de gestion de l'extension).
- Une licence d'extension valide — les importations et la synchronisation planifiée nécessitent une licence active (voir Référence des réglages).
- Les identifiants pour la source que vous utilisez : identifiants API AutoScout24, un jeton d'entreprise carcuro, des identifiants de flux/FTP/SFTP ou des identifiants de boîte aux lettres IMAP. Ceux-ci sont fournis par votre prestataire, et non par l'extension.
- Pour l'importation par e-mail : l'extension PHP
imapsur le serveur.
Instructions étape par étape
- Ouvrez CMH Center → Universal Import.
- Cliquez sur la ligne de la source que vous souhaitez connecter.
- Saisissez les détails de cette source (voir la référence par source ci-dessous) et enregistrez. La pastille de statut à droite passe à Connected / Active.
- Définissez la fréquence d'importation de l'extension sous CMH Center → Import & Limits — ce calendrier unique pilote chaque source connectée.
- Pour importer immédiatement, utilisez le bouton d'exécution de la source (par exemple Import from carcuro now) ou lancez une importation manuelle depuis Import & Limits.
- Vérifiez le résultat dans CMH Center → Car Importer et dans l'inventaire CMH Cars.
Référence de configuration
AutoScout24
Connectez votre inventaire en direct AutoScout24 directement via l'API.
| Champ | Type | Notes |
|---|---|---|
| API Base URL | URL | URL complète incluant https://. Validée ; les barres obliques de fin sont supprimées. Une URL invalide est rejetée et la valeur précédente est conservée. |
| Seller ID | Texte | Un ou plusieurs Seller ID, séparés par des virgules. Seuls les lettres, chiffres, tirets bas et tirets sont conservés après nettoyage. |
| Client ID | Texte | Identifiant client de type OAuth fourni par AutoScout24. |
| Client Secret | Mot de passe | Stocké chiffré au repos via le stockage sécurisé de l'extension. Laissez le champ vide pour conserver le secret actuel ; saisissez une nouvelle valeur pour le remplacer. |
Lorsque les identifiants sont présents, la ligne affiche Connected, et un lien Open Car Importer apparaît pour vous permettre de lancer ou de gérer la synchronisation. L'enregistrement de nouveaux identifiants efface le jeton d'accès mis en cache ainsi que le statut de connexion API mis en cache, de sorte que la requête suivante utilise les nouvelles valeurs.
carcuro
Si votre inventaire se trouve dans carcuro, connectez-le directement — exactement comme AutoScout24. Vous fournissez uniquement un jeton ; les colonnes sont mappées automatiquement pour vous, il n'y a donc rien à mapper manuellement.
| Champ | Type | Notes |
|---|---|---|
| carcuro company token | Mot de passe | Votre company_token carcuro. Stocké chiffré au repos. Se trouve dans carcuro sous Webseite › Fahrzeugliste › Integration. Laissez vide pour conserver le jeton stocké ; cochez Remove stored token pour l'effacer. |
| Which vehicles | Sélection | Available vehicles (par défaut), All vehicles ou Sold vehicles. |
| Complete inventory | Bascule | Lorsqu'activé, carcuro est traité comme votre inventaire complet : les véhicules qui ne sont plus renvoyés sont conservés puis supprimés (suppression réversible), imitant le comportement de AutoScout24. |
Activez Import and sync automatically pour permettre à l'extension de récupérer carcuro selon le programme d'importation central. Utilisez Import from carcuro now pour lancer un import immédiatement. Les nouveaux véhicules apparaissent, les véhicules supprimés dans carcuro sont supprimés ici — cela ne fait aucune différence que vous utilisiez AutoScout24 ou carcuro.
Automatic import (feed)
Au lieu de téléverser un fichier à chaque fois, laissez l'extension récupérer votre inventaire automatiquement.
| Champ | Type | Notes |
|---|---|---|
| Enable automatic import | Bascule | Récupérer et importer selon le calendrier ci-dessous. |
| Feed location | Texte | Une URL https://, un emplacement ftp:// ou sftp://, ou un chemin de fichier serveur absolu. Les liens de partage cloud (Dropbox, Google Drive, OneDrive, Google Sheets) sont acceptés — collez le lien de partage tel quel. |
| Interval | Sélection | Toutes les heures, deux fois par jour ou tous les jours. |
| Authentication | Sélection + champs | None, HTTP Basic (également utilisé pour FTP/SFTP) ou Bearer token. Le mot de passe/jeton est stocké chiffré au repos. |
| Complete inventory | Bascule | Traiter le flux comme votre inventaire complet (conserver/supprimer les véhicules qui n'y figurent plus). |
Le format du fichier (CSV, XML ou Excel) est détecté automatiquement, et le mappage de colonnes que vous avez enregistré lors de l'étape de téléversement de fichier est réutilisé. Téléversez un fichier et enregistrez le mappage une fois avant d'activer le flux.
E-mail import
Si votre logiciel de concession envoie l'export d'inventaire par e-mail, l'extension peut le collecter automatiquement. Elle se connecte à une boîte aux lettres, récupère le message correspondant le plus récent contenant une pièce jointe CSV, XML, Excel ou JSON, et l'importe en utilisant le mappage de colonnes enregistré.
| Champ | Type | Notes |
|---|---|---|
| Enable e-mail import | Bascule | Vérifier la boîte aux lettres selon le calendrier ci-dessous. |
| IMAP server / Port / Encryption | Texte / Nombre / Sélection | Hôte de la boîte aux lettres, port et SSL / STARTTLS / None. |
| Username / Password | Texte / Mot de passe | Identifiants de la boîte aux lettres. Le mot de passe est stocké chiffré au repos. |
| Folder | Texte | Dossier de la boîte aux lettres à lire (par défaut INBOX). |
| Only from sender | Texte | Optionnel. Traiter uniquement les e-mails provenant de cette adresse. |
| Subject contains | Texte | Optionnel. Traiter uniquement les e-mails dont l'objet contient ce texte. |
| Attachment filename | Texte | Optionnel. Filtrer la pièce jointe par son nom (caractères génériques * et ?). Vide = première pièce jointe prise en charge. |
| Interval | Sélection | Toutes les heures, deux fois par jour ou tous les jours. |
| Complete inventory | Bascule | Traiter la pièce jointe comme votre inventaire complet. |
L'importation par e-mail nécessite l'extension PHP imap. Si elle n'est pas installée, la carte affiche un avertissement et vous pouvez utiliser un flux https:// / FTP / SFTP ou un dossier de serveur à la place.
Import a file from your dealer software (DMS)
Un téléversement ponctuel pour tout export de logiciel de concession (DMS).
- Formats acceptés : CSV, TXT, TSV, XML, Excel (
.xlsx) et JSON — ou une archive ZIP contenant le fichier de données ainsi que les images des véhicules (référencez chaque image par son nom de fichier dans votre colonne d'images). - Mappez les colonnes une seule fois. Après le téléversement, vous mappez chaque champ de l'extension à une colonne de votre fichier. Seuls la marque/le modèle (ou la version) et un numéro de stock ou un VIN sont requis ; laissez sur « non mappé » tout ce que votre export ne contient pas. Une étape optionnelle Auto-map with AI peut vous suggérer le mappage pour examen.
- Prévisualisez avant d'importer. Une simulation montre combien de lignes sont valides, lesquelles seraient nouvelles ou mises à jour, et les lignes présentant des problèmes — rien n'est écrit tant que vous ne choisissez pas Import now.
- Le mappage est enregistré et réutilisé pour le prochain téléversement ainsi que pour les sources de flux automatique et d'e-mail.
- L'encodage est géré pour vous : les fichiers Windows-1252 sont convertes en UTF-8 (les trémas suisses et caractères similaires sont préservés), et les cellules multilignes dans les fichiers CSV sont lues correctement.
Notes opérationnelles
- Un seul calendrier pour tout. AutoScout24 et carcuro n'ont pas de calendrier propre — ils s'exécutent sur le programme d'importation central sous Import & Limits. Les sources de flux et d'e-mail proposent en plus leur propre intervalle. Un import manuel peut toujours être déclenché.
- Un seul pipeline pour tout. Quelle que soit la source, chaque véhicule passe par le même traitement en aval : détection de réinscription basée sur le VIN, période de grâce de suppression réversible pour les véhicules qui disparaissent, normalisation des valeurs, importation d'images, génération de slugs et attribution d'équipe. Chaque réglage s'applique à l'ensemble de l'inventaire, quelle que soit la source d'origine du véhicule.
- Les secrets sont chiffrés au repos. Le Client Secret AutoScout24, le jeton carcuro et les mots de passe de flux/boîte aux lettres sont stockés chiffrés dans la base de données via le stockage sécurisé de l'extension, et non en texte clair.
- Des données de démonstration sont disponibles depuis la page Tools pour faire des essais, et peuvent être supprimées à tout moment.
Dépannage
- Une source affiche « Configure » au lieu de « Connected ». Les identifiants sont manquants ou incomplets. Ouvrez la ligne et saisissez-les à nouveau. Pour AutoScout24, vous devez disposer au minimum d'un Client ID et d'un Client Secret ; pour carcuro, vous avez besoin du jeton d'entreprise.
- carcuro a renvoyé une erreur HTTP / a rejeté la requête. Le jeton d'entreprise est probablement incorrect. Copiez-le à nouveau depuis carcuro sous Webseite › Fahrzeugliste › Integration.
- La source de flux ou d'e-mail indique qu'aucun mappage de colonnes n'est enregistré. Téléversez un fichier une fois lors de l'étape d'importation de fichier et enregistrez d'abord le mappage — les sources de flux et d'e-mail réutilisent ce mappage.
- L'importation par e-mail n'est pas disponible. L'extension PHP
imapest manquante sur le serveur. Utilisez plutôt une source de flux ou de dossier de serveur, ou demandez à votre hébergeur d'activerimap. - Rien ne s'importe comme prévu. Confirmez que la source est activée, qu'une licence valide est active et que le calendrier central sous Import & Limits est en cours d'exécution (voir Cron et traitement en arrière-plan).