Documentation · Référence de l'administrateur

Référence des connexions

Ce document est une référence pour l'écran Connections de l'extension ADP Car Market Hub (CMH Center → Connections). C'est le lieu central où chaque source de données est connectée et où tous les identifiants API sont stockés — AutoScout24, mobile.de, 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

Connections présente vos sources de données sous la forme d'un accordéon unique et ordonné. Chaque ligne correspond à une source avec son statut de connexion affiché sur la droite :

une pastille verte Connected (AutoScout24, mobile.de, 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 est visible. Après avoir enregistré une source — ou exécuté un import pour celle-ci — sa ligne reste ouverte afin que vous puissiez voir le résultat.

Les six sources sont :

AutoScout24 — synchronisation de l'inventaire en direct via l'API AutoScout24.
mobile.de — synchronisation de l'inventaire en direct via vos identifiants API vendeur mobile.de.
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/FTPS/SFTP, d'un dossier 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, TXT, TSV, XML, Excel (.xlsx) ou JSON (ou une archive ZIP avec des images).

Toutes les sources en direct et planifiées s'exécutent sur le calendrier 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 API AutoScout24 était configurée sous Settings. Tous les identifiants des sources de données se trouvent désormais ici sur la page Connections, 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 → Connections (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 Settings Reference).
Les identifiants pour la source que vous utilisez : identifiants API AutoScout24, identifiants API vendeur mobile.de, 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 imap sur le serveur.

Instructions étape par étape

Ouvrez CMH Center → Connections.
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 sur la 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 un import manuel depuis Import & Limits.
Vérifiez le résultat dans CMH Center → Car Importer et dans l'inventaire CMH Cars.

Configuration reference

AutoScout24

Connectez votre inventaire AutoScout24 en direct 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 IDs, séparés par des virgules. Seuls les lettres, chiffres, tirets du 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 magasin de secrets 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 Connecté, et un lien Ouvrir l'importateur de véhicules apparaît pour vous permettre d'exécuter ou de gérer la synchronisation. L'enregistrement de nouveaux identifiants efface le jeton d'accès mis en cache ainsi que l'état de la connexion API mis en cache afin que la requête suivante utilise les nouvelles valeurs.

mobile.de

Connectez votre inventaire mobile.de en direct via l'API vendeur — tout comme carcuro, les colonnes sont mappées pour vous automatiquement, il n'y a donc rien à mapper manuellement.

Champ	Type	Notes
API user name	Texte	Votre nom d'utilisateur API mobile.de.
API password	Mot de passe	Stocké chiffré au repos. Laissez le champ vide pour conserver le mot de passe actuel ; saisissez une nouvelle valeur pour le remplacer.
Customer number	Texte	Optionnel.
Sandbox (test environment)	Commutateur	Lorsqu'il est activé, les requêtes sont envoyées à l'environnement de test de mobile.de au lieu de la production.

Ces identifiants proviennent de l'espace concessionnaire de mobile.de : ouvrez votre nom de compte › "mobile.de Konto" › "Inserats-Einbindung" (Intégration d'annonces) pour trouver le nom d'utilisateur et le mot de passe de l'API.

Utilisez Enregistrer les paramètres mobile.de pour stocker la connexion, et Importer depuis mobile.de maintenant pour lancer une importation immédiatement. mobile.de s'importe et se synchronise sur le calendrier d'importation central de l'extension avec un mappage automatique des colonnes, exactement comme carcuro.

carcuro

Si votre inventaire se trouve dans carcuro, connectez-le directement — exactement comme AutoScout24. Vous fournissez uniquement un jeton ; les colonnes sont mappées pour vous automatiquement, 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 Supprimer le jeton stocké pour l'effacer.
Which vehicles	Sélection	Véhicules disponibles (par défaut), Tous les véhicules, ou Véhicules vendus.
Complete inventory	Commutateur	Lorsqu'il est activé, carcuro est traité comme votre inventaire complet : les véhicules qui ne sont plus renvoyés sont supprimés immédiatement lors de la prochaine exécution, reflétant le comportement de AutoScout24.

Activez Importer et synchroniser automatiquement pour permettre à l'extension de récupérer carcuro selon le calendrier d'importation central. Utilisez Importer depuis carcuro maintenant pour lancer une importation 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.

Importation automatique (flux)

Au lieu de téléverser un fichier à chaque fois, laissez l'extension récupérer votre inventaire automatiquement.

Champ	Type	Notes
Activer l'importation automatique	Commutateur	Récupérer et importer selon le calendrier ci-dessous.
Emplacement du flux	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.
Intervalle	Sélection	Toutes les heures, deux fois par jour, ou tous les jours.
Authentification	Sélection + champs	Aucune, HTTP Basic (également utilisé pour FTP/SFTP), ou Jeton Bearer. Le mot de passe/jeton est stocké chiffré au repos.
Inventaire complet	Commutateur	Traiter le flux comme votre inventaire complet (conserver/supprimer les véhicules qui n'y figurent plus).

Le format de 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.

Importation par e-mail

Si votre logiciel de gestion de concession (DMS) envoie l'exportation d'inventaire par e-mail, l'extension peut la récupérer automatiquement. Elle se connecte à une boîte de réception, prend 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
Activer l'importation par e-mail	Commutateur	Vérifier la boîte de réception selon le calendrier ci-dessous.
Serveur IMAP / Port / Chiffrement	Texte / Nombre / Sélection	Hôte de la boîte de réception, port, et SSL / STARTTLS / Aucun.
Nom d'utilisateur / Mot de passe	Texte / Mot de passe	Identifiants de la boîte de réception. Le mot de passe est stocké chiffré au repos.
Dossier	Texte	Dossier de la boîte de réception à lire (par défaut `INBOX`).
Uniquement de l'expéditeur	Texte	Optionnel. Traiter uniquement les e-mails provenant de cette adresse.
Le sujet contient	Texte	Optionnel. Traiter uniquement les e-mails dont le sujet contient ce texte.
Nom du fichier joint	Texte	Optionnel. Faire correspondre la pièce jointe par son nom (caractères génériques `*` et `?`). Vide = première pièce jointe prise en charge.
Intervalle	Sélection	Toutes les heures, deux fois par jour, ou tous les jours.
Inventaire complet	Commutateur	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 une notification et vous pouvez utiliser un flux https:// / FTP / SFTP ou un dossier serveur à la place.

Importer un fichier depuis votre logiciel de gestion (DMS)

Un téléversement unique pour toute exportation de logiciel de gestion 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/Modèle (ou version) et un numéro de stock ou VIN sont requis ; laissez tout ce que votre exportation ne contient pas sur "non mappé". Une étape optionnelle de Mappage automatique par IA 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 Importer maintenant.
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 convertis 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

Une seule planification pour tout. AutoScout24, mobile.de et carcuro n'ont pas de planification propre — ils s'exécutent sur la planification d'importation centrale sous Import & Limits. Les sources de flux (feed) 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, normalisation des valeurs, importation des images, génération de slug 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 mot de passe API mobile.de, le jeton carcuro et les mots de passe de flux/boîte de réception sont stockés de manière chiffrée dans la base de données via le magasin de secrets de l'extension, et non en texte brut.
Des données de démonstration sont disponibles sur la page Outils pour faire des essais, et peuvent être supprimées à tout moment.

Dépannage

Une source affiche « Configurer » au lieu de « Connecté ». Les identifiants sont manquants ou incomplets. Ouvrez la ligne et saisissez-les à nouveau. Pour AutoScout24, vous avez besoin au moins d'un Client ID et d'un Client Secret ; pour carcuro, vous avez besoin du jeton d'entreprise.
carcuro a répondu par une erreur HTTP / a rejeté la demande. 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 mapping de colonnes n'est enregistré. Téléversez un fichier une fois lors de l'étape de téléversement de fichier et enregistrez d'abord le mapping — les sources de flux et d'e-mail réutilisent ce mapping.
L'importation par e-mail n'est pas disponible. L'extension PHP imap est manquante sur le serveur. Utilisez plutôt une source de flux ou un dossier serveur, ou demandez à votre hébergeur d'activer imap.
Rien ne s'importe comme prévu. Confirmez que la source est activée, qu'une licence valide est active et que la planification centrale sous Référence des importations et des limites est en cours d'exécution (voir Cron et traitement en arrière-plan).