Le problème de départ
Votre logiciel de gestion automobile détient la donnée de référence : chaque véhicule, son prix, son kilométrage, sa motorisation, ses équipements, ses photos. Votre site WordPress, lui, doit présenter ce même stock à vos visiteurs, avec une recherche qui fonctionne et des fiches complètes.
Entre les deux, il faut un mécanisme qui lise la donnée là où elle vit, la transforme en contenu WordPress, et recommence à intervalles réguliers sans intervention humaine. C'est le rôle d'une passerelle. Voici comment elle est construite, mode de connexion par mode de connexion.
Les trois modes de connexion que l'on rencontre réellement
Contrairement à ce que l'on lit souvent, il n'existe pas « une API » universelle côté logiciels automobiles. Sur les connecteurs que nous avons développés, tout se ramène à trois familles techniques. Le choix ne vous appartient pas : il dépend de ce que votre éditeur met à disposition.
1. Le flux XML déposé sur un FTP ou un SFTP
C'est le mode historique, et il reste très répandu. L'éditeur génère un fichier XML contenant l'intégralité du stock et le dépose sur un serveur de fichiers. La passerelle s'y connecte avec un identifiant et un mot de passe, télécharge le fichier, puis le lit.
C'est le fonctionnement de la passerelle PlanetVO pour WordPress, qui récupère le flux en FTP avec un repli en SFTP quand le serveur l'impose. Chaque balise Vehicule du fichier porte la marque, le modèle, l'année, la boîte et son nombre de rapports, la cylindrée, l'énergie, les couleurs intérieure et extérieure, les équipements de série séparés des options, la garantie, le numéro de série, les URL des photos, et jusqu'aux coordonnées de l'annonceur.
Deux caractéristiques à retenir. Le fichier est une photographie à un instant donné : ce qui n'y figure plus n'existe plus, et c'est cette absence qui déclenche le retrait du véhicule sur le site. Et la fraîcheur de la donnée dépend d'abord de la fréquence à laquelle l'éditeur régénère le fichier.
2. L'API authentifiée par jeton
Ici, plus de fichier. La passerelle s'authentifie auprès d'un service, obtient un jeton, puis interroge des points d'entrée qui lui renvoient les véhicules, souvent page par page.
La passerelle TEC3H pour WordPress fonctionne ainsi : un couple client_id / client_secret permet d'obtenir un jeton JWT, qui autorise ensuite les appels. Elle gère la multi-concession, ce qui suppose de savoir à quel point de vente rattacher chaque véhicule au moment de l'import — l'adresse, la ville, le code postal et les téléphones de la concession font partie du flux et doivent suivre l'annonce jusqu'à sa fiche.
Bee2Link relève de la même famille, avec une liste de véhicules paginée qu'il faut parcourir jusqu'au bout avant de conclure la synchronisation. AutoScout24 y ajoute une couche OAuth. Un point de vigilance propre à ce mode : le jeton expire. Une passerelle qui ne sait pas le renouveler en cours de traitement s'arrête au milieu du stock, avec un site à moitié à jour.
3. L'API signée
Troisième cas : l'appel n'est pas authentifié par un jeton mais par une signature calculée sur l'URL elle-même. C'est le fonctionnement de la passerelle Auto-Gestion pour WordPress, où une clé et un secret servent à signer chaque requête.
L'avantage, c'est qu'il n'y a pas de session à maintenir. L'inconvénient, c'est que la signature intègre en général des éléments variables : le moindre écart entre l'horloge de votre serveur WordPress et celle de l'éditeur fait échouer l'appel avec une erreur d'authentification qui n'a rien à voir avec vos identifiants. C'est un grand classique des diagnostics le lendemain d'une migration d'hébergement.
| Mode | Ce que vous fournissez | Point de vigilance |
|---|---|---|
| Flux XML sur FTP / SFTP | Hôte, identifiant, mot de passe | Fraîcheur du fichier côté éditeur |
| API par jeton | client_id et client_secret | Expiration du jeton, pagination |
| API signée | Clé et secret de signature | Horloge du serveur, format de l'URL |
Ce que WordPress doit accueillir en face
Un véhicule n'est pas un article de blog. Le plugin AutoWP crée un type de contenu dédié, « annonce », accompagné de ses taxonomies et de ses champs personnalisés — la couche ACF est embarquée, vous n'avez rien à installer en plus.
Trois natures de données coexistent, et les confondre est la première cause de moteur de recherche inutilisable :
- Les taxonomies portent ce qui doit servir à filtrer et à regrouper : marque, modèle, énergie, type de boîte. Une taxonomie est indexée et permet des pages de listing par marque ou par modèle.
- Les champs personnalisés portent les valeurs propres à un véhicule : référence, kilométrage, prix, mise en circulation, puissance DIN et fiscale, cylindrée, nombre de portes, de places et de rapports, couleur.
- Le contenu éditorial porte les observations commerciales rédigées dans le logiciel et les services du revendeur.
La fréquence de synchronisation
La synchronisation est déclenchée par le cron de WordPress, avec deux fréquences possibles au paramétrage : toutes les heures ou deux fois par jour.
Le choix n'est pas cosmétique. L'horaire convient aux stocks qui bougent tout au long de la journée, avec des baisses de prix fréquentes et des ventes rapides. Le rythme biquotidien suffit largement à un parc stable, et il réduit d'autant la charge sur l'hébergement — chaque passe télécharge un flux, ouvre des images et écrit en base.
Deux précisions utiles. Le cron WordPress n'est pas un planificateur système : il se déclenche à la visite d'une page, si bien qu'une synchronisation « horaire » peut se réveiller en retard sur un site à faible trafic ; le remède est un cron serveur qui appelle le site à intervalle fixe. Et aucune fréquence de passerelle ne rattrapera un flux régénéré une fois par jour : avant de régler ce paramètre, il faut savoir à quel rythme la source est produite.
Le traitement des véhicules sortis du flux
C'est la question qui revient à chaque mise en service, et elle mérite mieux qu'une réponse par défaut. Un véhicule vendu disparaît du flux à la synchronisation suivante. Que doit-il devenir sur le site ? Le plugin propose trois comportements, à choisir dans l'administration.
- La suppression définitive. La fiche disparaît. C'est le choix le plus propre pour un site qui ne veut afficher que du disponible, mais l'URL renvoie une erreur 404 et l'ancienneté acquise dans les moteurs de recherche est perdue.
- La mise à la corbeille. La fiche sort du site public mais reste récupérable pendant la durée de rétention de WordPress. Utile lors des premières semaines, quand un aléa de flux peut faire disparaître temporairement des véhicules qui n'ont jamais été vendus.
- Le basculement dans la catégorie « vendus ». La page reste en ligne, sort du listing des véhicules disponibles, et conserve son URL et son référencement. C'est l'option à privilégier si votre stratégie repose sur le trafic organique : une fiche « Clio V dCi » bien positionnée continue de capter des recherches, et le formulaire de contact reste actif pour proposer un modèle équivalent.
Le mapping, là où se joue la qualité de l'affichage
Récupérer les données est la partie mécanique. Les faire correspondre à la structure du site est le vrai travail, et c'est celui que nous réalisons lors de l'installation.
Chaque éditeur nomme et découpe ses champs à sa façon. L'un expose un prix TTC affiché, l'autre un prix total. L'un donne les équipements en liste à plat, l'autre les fournit déjà rangés en groupes que la fiche peut restituer en accordéon. Certains flux transportent le genre national, la première main, la norme antipollution, ou les champs propres aux véhicules électriques : capacité de batterie, type de prise, puissance et temps de charge. Ces informations n'ont de valeur que si elles atterrissent au bon endroit dans la fiche, avec la bonne unité et le bon libellé.
Les photos constituent l'autre poste de charge. Le flux fournit des URL, la passerelle doit les télécharger, les ranger dans la médiathèque, conserver l'ordre d'origine — la première photo devient l'image mise en avant — et surtout ne pas les retélécharger à chaque passe. Une déduplication faible transforme une synchronisation horaire en machine à remplir le disque. La fiche affiche ensuite l'intégralité des photos du flux dans une visionneuse plein écran, y compris quand un véhicule en compte 30 ou plus.
Importer ne suffit pas : il faut afficher
C'est la différence de fond entre une passerelle et un simple plugin d'import. Un import remplit une base de données. Il vous laisse ensuite construire vous-même le listing, le moteur de recherche et la fiche véhicule — c'est-à-dire l'essentiel du travail, et la partie que vos visiteurs voient.
Le plugin AutoWP livre les gabarits d'affichage avec la synchronisation : la page de listing avec compteur de véhicules disponibles et tri, le moteur de recherche avec ses filtres marque, modèle, énergie, kilométrage maximum, prix maximum, année minimum et case « véhicule utilitaire », et la fiche complète avec galerie, informations générales, motorisation, habitacle, prix et garantie, équipements, observations, sidebar de contact et annonces similaires. Quatre shortcodes — iwp_listing, iwp_search, iwp_carousel et iwp_property — permettent de poser ces éléments ailleurs dans le site, y compris dans une page construite avec Elementor ou Divi. Les gabarits sont surchargeables depuis le thème enfant quand la maquette l'exige.
Ce qui se passe après la mise en service
Une passerelle n'est pas un projet qui se termine. Les éditeurs modifient leurs formats, ajoutent des champs, changent une URL d'API ; WordPress publie de nouvelles versions. L'installation, le paramétrage et le mapping sont réalisés par notre équipe en 5 jours ouvrés à partir de vos accès et des identifiants de votre flux, puis la maintenance couvre le suivi du flux et les corrections nécessaires lorsque la source évolue.
Si vous voulez savoir dans quelle famille technique se situe votre propre logiciel et ce que son flux transporte réellement, la liste des passerelles disponibles détaille les champs récupérés pour chacun, et la page des tarifs précise ce que couvrent les 500 € HT d'installation et les 150 € HT annuels.