Runbook
PDF ne se génère pas (Livre de police, facture, certificat)
Symptômes
Comment ça se manifeste.
Cliquer "Générer PDF" ne télécharge rien ou affiche une erreur 500.
Étapes de résolution
Suivez dans l'ordre — chaque étape suppose la précédente faite.
- Vérifier que la fiche véhicule est COMPLÈTE : vendeur (CNI/SIREN), acheteur (si vendu), prix achat, prix vente, date, immatriculation.
- Si données manquantes : message clair "Champs obligatoires manquants pour ce type de document". Liste les champs.
- Tester un AUTRE format (proposition vs facture vs livre de police) sur le même véhicule. Si certains marchent et d'autres pas : c'est un bug template, déclarez incident.
- Si TOUS les formats KO sur TOUS les véhicules : problème global → déclarez incident URGENT.
- En attendant : utilisez l'extract CSV depuis Journal d'audit qui contient les mêmes infos en texte brut.
Comment éviter à l'avenir
Bonne pratique.
Compléter chaque fiche à 100% AVANT validation. Utilisez le wizard "Nouvelle entrée" qui force la saisie des champs obligatoires.
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…
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…
Connexion diffuseur échouée (LBC/Centrale/Autoscout)
Le connecteur API natif refuse la connexion ou échoue à la publication. Job en "…
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…