Dans un garage, la fiche véhicule est le point de départ de tout : ordre de réparation, devis, commande de pièces, historique d'intervention. Quand elle est mal remplie, l'erreur se propage. Une motorisation approximative, et c'est le mauvais filtre à huile qui arrive le lendemain.
Intégrer une recherche par plaque dans un logiciel de gestion de garage (DMS, logiciel d'atelier, outil de prise de rendez-vous) permet de construire cette fiche à partir d'une source unique. Cet article détaille la mise en œuvre, du formulaire d'accueil aux cas où la recherche ne donne rien.
Ce que la plaque apporte à la fiche véhicule
À partir de la plaque, l'API renvoie des caractéristiques techniques : marque, modèle, version, énergie, puissance, cylindrée, type de boîte, code moteur, dimensions de pneus d'origine, et des identifiants de catalogue comme le K-Type. Pour un véhicule français, on trouve aussi des données issues de la carte grise, comme le type mine ou la puissance fiscale.
Ce qu'elle n'apporte pas est tout aussi important :
- pas d'historique d'entretien, de sinistres ou de kilométrage : ces informations restent celles de votre propre logiciel ou du carnet du client ;
- pas de données personnelles : le nom et les coordonnées du client se saisissent à part, avec son accord, comme aujourd'hui.
La fiche du garage combine donc trois sources : l'API pour la technique, le client pour ses coordonnées, l'atelier pour l'historique.
Correspondance entre réponse API et fiche atelier
Avant d'écrire du code, établissez la correspondance entre les champs de la réponse et ceux de votre fiche. Les noms de gauche proviennent de la réponse documentée de l'API ; ceux de droite sont des exemples de colonnes d'un logiciel d'atelier.
| Champ API | Exemple de valeur | Champ de la fiche atelier |
|---|---|---|
marque, modele, version | PEUGEOT, 207, SW 1.6 | Désignation du véhicule |
energieNGC | DIESEL | Carburant |
code_moteur | Liste de codes possibles | Code moteur (à confirmer) |
boite_vitesse | M | Type de boîte |
date1erCir_fr | 12-05-2009 | Date de mise en circulation |
vin | 17 caractères | Numéro de châssis |
k_type | 23388 | Identifiant catalogue pièces |
pneus | Tableau de dimensions | Montes d'origine |
Deux points de vigilance ressortent de la réponse d'exemple :
code_moteurpeut contenir plusieurs codes, séparés par des virgules. Ne l'affichez pas comme une valeur certaine : proposez une liste et laissez le mécanicien confirmer à l'ouverture du capot si la pièce en dépend.pneusliste plusieurs dimensions d'origine. Le véhicule n'en porte qu'une : le mécanicien la vérifie sur le flanc du pneu.
Le parcours à l'accueil
1. Saisie de la plaque
À l'arrivée du client ou lors de la prise de rendez-vous en ligne, un seul champ suffit. Normalisez la saisie (majuscules, sans espaces ni tirets) et prévoyez un sélecteur de pays si votre clientèle compte des véhicules étrangers. Le détail des formats est traité dans notre guide de l'API plaque France.
2. Recherche dans votre base, puis dans l'API
Si le véhicule est déjà connu de votre logiciel, inutile d'appeler l'API : affichez la fiche existante. Sinon, le serveur appelle l'API avec la clé RapidAPI stockée dans une variable d'environnement, jamais dans le poste client ou l'application installée sur la tablette.
3. Fiche préremplie, puis validée
Présentez le résultat dans le formulaire de création, champs modifiables. Indiquez visuellement l'origine des valeurs (par exemple une petite icône « issu de la plaque ») : le réceptionnaire sait ainsi ce qu'il a vérifié et ce qui vient de la recherche.
4. Enregistrement de la source
Conservez dans la fiche la date de la recherche et les champs effectivement renvoyés. En cas de litige sur une pièce, vous saurez si la motorisation venait de l'API ou d'une correction manuelle.
Réduire les erreurs de saisie
La recherche par plaque supprime la plupart des saisies manuelles, mais d'autres erreurs peuvent apparaître si l'intégration est trop confiante :
- plaque mal lue au téléphone (
Bpour8,Dpour0) : réaffichez la plaque en grand avec le résultat, pour que le réceptionnaire repère l'incohérence (« le client a parlé d'une Clio, l'API renvoie un utilitaire ») ; - mauvais pays sélectionné : rappelez le pays dans la fiche ;
- véhicule modifié depuis l'origine (moteur remplacé, jantes différentes) : les données renvoyées décrivent la configuration connue, pas l'état actuel. Le mécanicien garde le dernier mot.
Gérer les résultats absents
Une recherche peut ne rien renvoyer : véhicule très récent, plaque étrangère, format particulier, simple faute de frappe. Un logiciel de garage ne doit jamais bloquer l'accueil pour autant.
Prévoyez trois issues, dans cet ordre :
- Corriger la saisie : message clair (« Aucun véhicule trouvé pour AB-123-CD, vérifiez la plaque ») avec le champ toujours modifiable.
- Rechercher par VIN : le numéro de châssis figure sur la carte grise. Notre article API plaque ou API VIN détaille l'intérêt de cette alternative.
- Saisie manuelle guidée : sélection marque, modèle, motorisation, comme avant l'intégration.
Distinguez aussi les erreurs techniques (clé invalide, quota atteint, service momentanément indisponible) des véhicules introuvables. Les premières concernent l'administrateur du logiciel, pas le réceptionnaire : journalisez-les et affichez simplement « recherche indisponible, saisie manuelle ».
Les champs vides méritent le même traitement : un champ "" dans la réponse signifie que l'information n'est pas disponible pour ce véhicule. Laissez le champ ouvert à la saisie plutôt que d'y inscrire une valeur par défaut.
Cas concret : la commande de pièces
Un garage indépendant reçoit une voiture pour un remplacement de plaquettes. Avec l'intégration :
- la plaque est saisie à la réception ;
- la fiche se remplit : marque, modèle, version, énergie, K-Type ;
- le K-Type est transmis au catalogue du distributeur de pièces, qui filtre les références compatibles ;
- si plusieurs références restent possibles (montage selon option), le mécanicien vérifie sur le véhicule avant de commander.
L'identification par K-Type est détaillée dans notre article Intégrer Ktype avec TecDoc.
Conclusion
Une API de plaques ne remplace pas l'œil du mécanicien, mais elle lui fournit une fiche cohérente dès l'accueil. Les clés d'une bonne intégration : appeler l'API côté serveur, présenter des champs modifiables, signaler les valeurs incertaines et ne jamais bloquer le parcours quand rien ne revient. Pour évaluer l'intégration sur vos propres véhicules, consultez la documentation de l'API plaque.
Préremplissez vos fiches véhicules
Testez la recherche par plaque sur vos propres véhicules avant de l'intégrer à votre logiciel d'atelier.
FAQ
Faut-il appeler l'API à chaque passage du véhicule ?
Non. Une fois la fiche créée et validée, elle vit dans votre logiciel. Un nouvel appel n'est utile que si la fiche est incomplète ou si la plaque a changé.
L'API donne-t-elle le kilométrage ou l'historique d'entretien ?
Non. Elle renvoie des caractéristiques techniques. Le kilométrage et l'historique restent ceux relevés par l'atelier.
Que faire si le code moteur renvoyé contient plusieurs valeurs ?
Proposez-les comme liste de choix et faites confirmer le code sur le véhicule lorsque la pièce à commander en dépend.
Peut-on utiliser l'API depuis une tablette d'atelier ?
Oui, à condition que la tablette appelle votre serveur, qui détient la clé. La clé RapidAPI ne doit pas être stockée sur l'appareil.
