Flux de travail d'importation de véhicules

Ce document décrit comment importer des fiches de véhicules depuis l'API AutoScout24 dans WordPress à l'aide de l'extension ADP Car Market Hub. Il couvre à la fois les méthodes d'importation manuelle et l'importation planifiée automatique, ainsi que les options d'importation, la détection des modifications, la gestion des images et la synchronisation complète (Full Sync).

Quand utiliser ce document

Lisez ce document si vous :

• Devez effectuer ou surveiller une importation de véhicules pour la première fois ou à la demande.
• Souhaitez comprendre la différence entre l'importation manuelle, le Batch-Wizard et l'importation planifiée (automatique).
• Dépannez des échecs d'importation ou des résultats inattendus.
• Devez comprendre comment l'extension gère les fiches mises à jour, les images et les véhicules supprimés.

Pour un contrôle quotidien rapide de l'état de l'importation, consultez le Flux de travail d'utilisation quotidienne.

---

Aperçu

L'extension récupère les fiches de véhicules depuis l'API AutoScout24 pour tous les Seller IDs configurés et stocke chaque fiche sous forme de publication WordPress du type de publication personnalisé (CPT) as24ci_car. Les métadonnées du véhicule (prix, kilométrage, spécifications, équipements, images) sont stockées dans les métadonnées de publication (post meta) et dans une table de base de données personnalisée dédiée.

Il existe trois façons de déclencher une importation :

1. Importation de véhicule unique — importe ou réimporte une fiche depuis l'onglet Car Importer.
2. Batch-Wizard — exécute manuellement une importation complète de toutes les fiches avec un suivi de la progression en direct. Convient pour l'importation initiale ou un rafraîchissement complet forcé.
3. Importation planifiée automatique — s'exécute à un intervalle configuré via WP-Cron ou un cron de serveur externe. C'est la méthode recommandée pour une synchronisation continue.

Les trois voies utilisent la même logique d'importation sous-jacente : connexion à l'API, récupération des fiches pour chaque vendeur configuré, comparaison avec la copie locale à l'aide de hachages de contenu, et création ou mise à jour des publications WordPress selon les besoins.

---

Configuration requise ou prérequis

• Des identifiants API valides (API Base URL, Seller ID(s), Client ID, Client Secret, Token URL et Audience) doivent être saisis et enregistrés dans ADP Car Market Hub → Réglages avant de pouvoir exécuter une importation.
• Le site WordPress doit être en mesure d'établir des connexions HTTPS sortantes vers le point de terminaison de l'API configuré.
• Pour les importations d'images, le répertoire des téléversements de WordPress doit être accessible en écriture.
• Au moins un Seller ID doit être configuré. L'extension lit l'option as24ci_seller_ids (liste d'identifiants séparés par des virgules).

---

Instructions étape par étape

Importer un seul véhicule

1. Accédez à ADP Car Market Hub → Car Importer.
2. Le tableau Pending vehicles répertorie les fiches disponibles sur l'API qui n'ont pas encore été importées dans WordPress.
3. Trouvez le véhicule que vous souhaitez importer.
4. Cliquez sur Import à côté de la fiche.
5. La page se recharge et le véhicule apparaît dans le tableau Imported vehicles ci-dessus.
6. Pour actualiser un véhicule déjà importé (par exemple, après un changement de prix sur AutoScout24), recherchez-le dans le tableau Imported vehicles et cliquez sur Re-import.

Exécuter le Batch-Wizard (importation complète manuelle)

Le Batch-Wizard est la méthode recommandée pour l'importation complète initiale de toutes les fiches et pour effectuer un rafraîchissement forcé en dehors de la planification régulière.

1. Accédez à ADP Car Market Hub → Importations et limites.
2. Cliquez sur le bouton Déclencher maintenant.
3. Le Batch-Wizard démarre et affiche une barre de progression en direct indiquant : - Le nombre total de véhicules à traiter. - Les véhicules traités jusqu'à présent. - Le temps restant estimé. - L'action en cours (insertion, mise à jour ou omission).
4. L'assistant traite un véhicule à la fois par défaut (taille de lot adaptative : 1 à 5 véhicules par étape). Cela évite les erreurs de temps d'exécution PHP sur les hébergements mutualisés.
5. Utilisez le bouton Pause pour suspendre temporairement l'importation. Cliquez sur Reprendre pour continuer.
6. Utilisez le bouton Abandonner pour arrêter l'importation. Les véhicules déjà traités lors de l'exécution en cours restent dans WordPress.
7. Une fois l'assistant terminé, un résumé affiche le nombre de véhicules insérés, mis à jour, ignorés, ainsi que les éventuelles erreurs.

Configuration et exécution des importations automatiques planifiées

Pour une synchronisation continue, activez le planificateur automatique :

1. Accédez à ADP Car Market Hub → Importations et limites.
2. Activez Importation automatique (la case à cocher ou le commutateur sur l'onglet).
3. Choisissez l'intervalle d'importation : - Toutes les heures - Toutes les 6 heures - Deux fois par jour - Tous les jours - Personnalisé (minimum 15 minutes — configurez la valeur en minutes dans le champ d'intervalle personnalisé)
4. Pour les planifications quotidiennes et bi-quotidiennes, définissez éventuellement l'heure de début.
5. Enregistrez les réglages d'automatisation.
6. Le WP-Cron de WordPress va maintenant déclencher des importations à l'intervalle configuré chaque fois que le site reçoit du trafic.

Pour les sites en production, le cron du serveur est recommandé :

1. Définissez le Mode Cron sur Cron du serveur dans l'onglet Importations et limites.
2. Copiez l'URL du point de terminaison cron affichée (l'URL inclut un jeton de sécurité).
3. Ajoutez une tâche cron côté serveur (par exemple, via crontab) appelant l'URL du point de terminaison à l'aide de curl ou wget à l'intervalle souhaité.
4. Si vous régénérez le jeton (Importations et limites → Régénérer le jeton), mettez à jour votre tâche cron avec la nouvelle URL.

---

Comment fonctionnent les importations

Détection des modifications

L'importateur calcule et stocke un hachage de contenu et un hachage d'image pour chaque véhicule importé. Lors des exécutions d'importation ultérieures, un véhicule est ignoré si aucun des deux hachages n'a changé. Cela permet de maintenir des exécutions d'importation rapides, en particulier pour les stocks importants où la plupart des véhicules restent inchangés.

Lorsqu'une fiche est mise à jour sur AutoScout24 (par exemple, un changement de prix ou de nouvelles images), les hachages ne correspondent plus et le véhicule est mis à jour dans WordPress.

Codes de résultat d'importation

Chaque véhicule traité lors d'une exécution d'importation est comptabilisé dans l'une des quatre catégories suivantes :

Le résumé de l'importation sur l'onglet Importations et limites et le Batch-Wizard affiche ces totaux après chaque exécution.

Importation d'images et file d'attente d'images

• Lorsque Importer les images est activé dans les Réglages, l'importateur télécharge les images des véhicules depuis l'API et les associe à la publication WordPress.
• Nombre max d'images par véhicule (Réglages) limite le nombre d'images téléchargées par fiche (0 = illimité).
• Mode file d'attente d'images (activé par défaut pour les importations cron/REST) : lors des importations planifiées, seule la première image de chaque véhicule est téléchargée immédiatement. Toutes les images restantes sont ajoutées à une file d'attente persistante en arrière-plan et traitées de manière asynchrone par le worker de la file d'attente d'images, qui s'exécute environ toutes les 5 minutes. Cela évite les erreurs de dépassement de temps d'exécution PHP lors des importations volumineuses.
• Le worker de la file d'attente d'images traite jusqu'à 30 images par lot.
• La taille actuelle de la file d'attente et l'état du worker sont visibles sur l'onglet Système et aide.
• Pour traiter immédiatement la file d'attente d'images, cliquez sur Exécuter la file d'attente d'images maintenant sur l'onglet Système et aide.
• Conversion WebP : si elle est activée dans les Réglages et que GD ou Imagick est disponible, les images sont converties au format WebP lors du téléchargement. Le niveau de qualité est configurable (1–100, par défaut 80).

Verrouillage d'importation

L'extension utilise un verrou d'exécution basé sur les transients avec une durée de vie (TTL) d'environ 40 minutes. Si une exécution d'importation est déjà en cours lorsqu'un second déclencheur arrive (depuis WP-Cron, le cron du serveur ou un bouton manuel), le second déclencheur est ignoré et un message « déjà en cours » est enregistré dans le journal. Si le verrou est obsolète (plus ancien que la TTL), il est automatiquement effacé afin que l'exécution suivante puisse se dérouler.

Synchronisation complète (Full Sync)

Lorsque la Synchronisation complète est activée dans l'onglet Importations et limites, l'importateur compare l'ensemble des Listing IDs renvoyés par l'API avec toutes les publications de véhicules présentes dans WordPress. Toute publication locale dont le Listing ID n'est pas présent dans la fiche distante actuelle est définitivement supprimée — y compris toutes les images associées.

• N'activez la Synchronisation complète que lorsque vous souhaitez que le stock de WordPress reflète exactement les fiches en direct d'AutoScout24.
• Les suppressions liées à la Synchronisation complète sont enregistrées dans le journal de l'extension avec les totaux sync_deleted.
• Lorsque la Synchronisation complète est désactivée, les véhicules retirés d'AutoScout24 restent dans WordPress jusqu'à ce qu'ils soient supprimés manuellement.

État de publication des véhicules

Les véhicules importés sont créés avec l'état de publication configuré dans Réglages → État de publication par défaut (publish ou draft). Lorsqu'un véhicule est mis à jour lors d'une exécution d'importation ultérieure, son état de publication n'est pas modifié — une publication publiée reste publiée.

---

Référence de configuration

---

Notes opérationnelles

• Plusieurs Seller IDs : l'importateur s'exécute séparément pour chaque Seller ID configuré. Une erreur pour un vendeur n'arrête pas les importations pour les autres vendeurs.
• Robustesse du cron : le lanceur d'importation augmente la limite de temps d'exécution PHP à 300 secondes lors des exécutions déclenchées par cron/REST. Sur les environnements d'hébergement qui restreignent set_time_limit(), cela peut ne pas s'appliquer.
• Taille de lot du Batch-Wizard : l'assistant adapte sa taille de lot (1 à 5 véhicules par étape) pour rester dans des limites de temps d'exécution sûres.
• Déclenchement manuel pendant un cron actif : si le cron automatique est en cours d'exécution lorsque vous cliquez sur Déclencher maintenant, le déclenchement manuel sera ignoré en raison du verrouillage d'exécution. Attendez que l'exécution en cours se termine ou effacez le verrou.
• Journal d'importation : tous les événements d'importation (appels API, véhicules insérés/mis à jour/ignorés/en erreur, téléchargements d'images) sont écrits dans le journal de l'extension. Consultez ADP Car Market Hub → Journaux pour plus de détails.
• Journalisation détaillée : si elle est activée, le journal inclut des détails par véhicule et par image. Désactivez-la en production pour limiter la croissance du journal.

---

Dépannage

---

Documents connexes

• Flux de travail d'utilisation quotidienne
• Manuel de l'administrateur
• Flux de travail de gestion des leads
• Manuel de l'utilisateur