Runbook
Connexion diffuseur échouée (LBC/Centrale/Autoscout)
Symptômes
Comment ça se manifeste.
Le connecteur API natif refuse la connexion ou échoue à la publication. Job en "Failed" ou "Dead letter".
Étapes de résolution
Suivez dans l'ordre — chaque étape suppose la précédente faite.
- Vérifier les credentials API : Diffuseurs → cliquez la plateforme → "Modifier" → vérifiez le token.
- Token expiré ? Tokens API expirent généralement après 12 mois. Régénérez côté plateforme partenaire (espace Pro LBC/Centrale → Settings → API).
- Tester avec le FLUX XML UNIVERSEL à la place : Diffuseurs → Flux XML → URL à donner au commercial Pro de la plateforme. Plan B gratuit qui marche toujours.
- Voir les erreurs détaillées dans Cockpit → cliquez le job failed → "View error log".
- Erreur "401 Unauthorized" : token invalide ou expiré. Erreur "429 Too Many Requests" : rate limit côté plateforme, attendez 1h. Erreur "500 Internal" : problème côté plateforme, retry plus tard.
Comment éviter à l'avenir
Bonne pratique.
Renouveler les tokens API tous les 12 mois (rotation). Garder une alerte calendrier "Renouveler token LBC" 11 mois après création.
Autres runbooks
Cas connexes.
La page ne charge pas (écran blanc, timeout, 500)
L'écran reste blanc ou affiche "Erreur 500" / "Service Unavailable" / le chargem…
PDF ne se génère pas (Livre de police, facture, certificat)
Cliquer "Générer PDF" ne télécharge rien ou affiche une erreur 500.
TVA marge incorrecte / inexpliquée
Le calcul TVA marge ne correspond pas à mes attentes ou à celui de mon comptable…
Mon véhicule n'apparaît pas sur la vitrine publique
Le véhicule existe dans <code>/admin/transactions</code> mais pas visible sur la…
Doublons clients détectés
Le même client apparaît plusieurs fois sous des emails ou numéros différents.
Paiement en ligne — non disponible en V1
Vous attendez qu'un paiement en ligne fasse passer la commande en "Payé" automat…