Ma synchronisation avec un outil externe s’est arrêtée
Une liaison entre deux systèmes ne tombe presque jamais sans raison, et presque jamais des deux côtés à la fois. Elle tombe parce qu’une autorisation a expiré, parce qu’un format a changé, ou parce qu’une limite d’appels a été atteinte. Dans les trois cas, le refus est explicite quelque part — il faut simplement savoir où regarder.
Dans quel sens la liaison est-elle cassée
- Le site n’envoie plus rien : le problème est dans le déclenchement, côté boutique.
- Le site envoie mais l’autre système refuse : la réponse contient un code et un message qui nomment la cause.
- L’autre système envoie mais le site ne traite rien : l’adresse de réception a changé, ou elle est protégée par une règle qui bloque l’appel.
- Les données circulent mais sont fausses : ce n’est pas une panne de liaison, c’est une correspondance de champs devenue inexacte.
Les quatre causes que je rencontre le plus
L’autorisation a expiré. Beaucoup de services délivrent des jetons d’accès valables un temps limité, ou révoquent une clé lorsqu’un mot de passe change. La liaison fonctionne pendant des mois, puis s’arrête un matin sans que rien n’ait été modifié chez vous.
L’autre service a changé de version. Un champ renommé, un format de date modifié, un champ devenu obligatoire : l’appel est refusé alors que le code n’a pas bougé. Ces changements sont annoncés à l’avance par courriel, à une adresse que plus personne ne relève.
La limite d’appels est atteinte. Les services imposent un nombre maximal d’appels par minute ou par jour. Une synchronisation qui traite produit par produit atteint cette limite dès que le catalogue grossit, et les appels suivants sont rejetés.
Le certificat ou l’adresse a changé. Un site passé en HTTPS, un domaine modifié, un certificat expiré : l’autre système ne parvient plus à joindre l’adresse enregistrée chez lui.
Retrouver le message de refus
-
Chercher le journal côté site
Une intégration correctement écrite enregistre chaque appel et chaque réponse. Si ce journal n’existe pas, c’est la première chose à ajouter, avant même de chercher la cause.
-
Chercher le journal côté service
La plupart des plateformes exposent un historique des appels reçus, avec le code de réponse. Si vos appels n’y figurent pas, ils ne partent pas.
-
Rejouer un appel isolé
Un seul produit, une seule commande. La réponse obtenue est bien plus lisible qu’un traitement de masse qui échoue sur une ligne inconnue.
-
Vérifier la date d’expiration des accès
Jeton, clé, mot de passe applicatif, certificat client : chacun a une échéance, et aucune n’est rappelée automatiquement.
-
Vérifier ce qui a changé chez l’autre
Note de version, changement d’offre, migration annoncée. Une liaison qui tombe sans cause côté boutique a presque toujours une cause côté partenaire.
Continuer sur la bonne page
-
Intégrations et API
Comment je construis une liaison qui signale ses échecs au lieu de les taire.
-
Connecter un ERP ou un fournisseur
Le cas PrestaShop, avec le service web et ses limites.
-
L’API REST expliquée
Comment deux systèmes se parlent, et ce que signifie chaque code de réponse.
-
Le webhook expliqué
Quand c’est l’autre service qui appelle votre site, et pourquoi l’appel peut échouer.
Décrivez votre besoin en 1 minute
Quelques questions ciblées pour que je vous réponde avec une estimation, pas avec un questionnaire de plus.