Annonces qui disparaissent ou se dupliquent : diagnostiquer une synchronisation qui déraille

Quatre symptômes, quatre causes distinctes

« Les annonces ont disparu », « il y a des doublons », « les photos se réimportent en boucle », « un bien vendu est revenu en ligne » : ces quatre plaintes se ressemblent, mais elles n'ont ni la même cause ni le même correctif. Ce guide sert à identifier laquelle vous avez, à partir de ce que vous pouvez observer sans accès au code.

Symptôme 1 : tout le portefeuille disparaît d'un coup

Le site affiche zéro bien, ou une poignée. C'est presque toujours une panne de la source interprétée comme une suppression.

La mécanique est simple : la passerelle demande la liste des biens, reçoit une réponse vide ou une erreur, en conclut que le portefeuille ne contient plus rien, et archive ou supprime tout ce qu'elle avait créé. Le lendemain, la source répond de nouveau et tout est réimporté — avec de nouveaux identifiants, des URLs différentes et un référencement à reconstruire.

Ce qu'il faut vérifier : l'horodatage du dernier cycle réussi, et le nombre de biens retournés par la source à ce moment-là. Si votre passerelle ne journalise pas ces deux valeurs, c'est le premier manque à combler.

Le correctif : un garde-fou côté passerelle. Aucune suppression quand la source est en erreur, et aucun cycle qui supprime plus d'une fraction raisonnable du portefeuille sans validation humaine. Ce comportement doit être la valeur par défaut, pas une option.

Symptôme 2 : des doublons apparaissent

Le même bien existe deux fois, parfois avec des photos différentes. La cause est une clé de rapprochement instable.

Pour savoir si un bien reçu existe déjà sur le site, la passerelle a besoin d'un identifiant qui ne change jamais. Les candidats ne se valent pas :

Clé utilisée	Risque
Identifiant technique du logiciel	Le bon choix : stable et unique
Référence commerciale du mandat	Modifiable par l'agence, parfois réattribuée
Titre + ville + prix	Change à la première mise à jour de l'annonce
Position dans le flux	Aucune valeur : l'ordre varie à chaque génération

Une variante plus vicieuse : deux identifiants différents cherchés dans le même champ. Quand la passerelle rapproche un bien en testant « numéro interne ou référence », il suffit que le numéro interne d'un bien corresponde à la référence d'un autre pour que les deux biens se détournent mutuellement à chaque cycle.

Ce qu'il faut vérifier : ouvrez deux doublons et comparez leur identifiant source. S'il est identique, la clé n'est pas utilisée à l'import. S'il diffère, c'est la source qui a changé d'identifiant.

Symptôme 3 : les photos se réimportent à chaque cycle

La médiathèque grossit sans fin, le cycle de synchronisation s'allonge, l'hébergement finit par saturer. La passerelle ne reconnaît pas les images déjà importées.

La déduplication d'image doit reposer sur une donnée qui identifie la source de l'image, pas sur son apparence côté site. Un nom de fichier ne suffit pas : beaucoup de logiciels servent toutes leurs photos sous des noms génériques. Comparer le poids du fichier ne suffit pas non plus. La méthode fiable consiste à stocker, sur chaque média importé, l'URL ou l'identifiant d'origine, puis à interroger cette valeur avant tout téléchargement.

Ce qu'il faut vérifier : comptez les fichiers de la médiathèque sur deux jours consécutifs sans avoir touché au portefeuille. Une progression continue signe le problème.

Symptôme 4 : un bien vendu revient en ligne

Le bien est passé « vendu » ou « archivé » dans le logiciel, il réapparaît pourtant sur le site. Trois causes possibles, dans l'ordre de fréquence :

• Le flux continue de l'envoyer. Beaucoup d'exports incluent les biens vendus avec un statut particulier. Si ce statut n'est pas mappé, le bien est traité comme actif.
• La suppression a été faite à la main sur le site. Le cycle suivant, ne trouvant plus le bien, le recrée depuis la source. Un retrait doit toujours se faire côté logiciel.
• Deux sources alimentent le même site. Après un changement de logiciel, l'ancienne passerelle tourne encore. Chacune défait le travail de l'autre.

La méthode de diagnostic, dans l'ordre

1. Regardez les journaux avant tout. Date du dernier cycle, nombre de biens reçus, nombre créés, mis à jour, archivés, erreurs. Sans ces chiffres, tout le reste est de la conjecture.
2. Comparez les volumes. Combien de biens actifs dans le logiciel, combien publiés sur le site. Un écart stable est un problème de filtre ou de mapping ; un écart qui varie à chaque cycle est un problème de rapprochement.
3. Prenez un bien témoin. Modifiez un champ visible dans le logiciel, déclenchez un cycle, vérifiez la fiche. Vous saurez immédiatement si le trajet complet fonctionne.
4. Vérifiez l'unicité de la source. Une seule passerelle, une seule tâche planifiée. Les cycles concurrents produisent des symptômes ingérables.

Ce qu'une passerelle correcte doit vous donner

Le point commun de ces quatre pannes est l'absence d'observabilité : rien ne signale l'anomalie, on la découvre parce qu'un client appelle. Exigez au minimum un journal horodaté par cycle, un rapport lisible des biens créés, mis à jour et archivés, une alerte quand un cycle échoue ou supprime massivement, et la possibilité de rejouer un cycle sans tout réimporter.

Sur la façon dont les données sortent du logiciel et les pièges de chaque format, voyez également flux XML, API ou fichier plat : comment votre logiciel immobilier exporte vos biens.