API plaque Espagne : intégrer la recherche par matrícula

Un client de Barcelone qui commande des plaquettes de frein, un véhicule acheté à Valence et réimmatriculé en France, une flotte qui roule des deux côtés des Pyrénées : dès que votre activité touche l'Espagne, la plaque espagnole (la matrícula) devient une donnée d'entrée comme une autre.

Ce guide présente les particularités du format espagnol, la façon de normaliser ce que tapent vos utilisateurs et les points d'attention pour exploiter la réponse.

Le format de la matrícula actuelle

Depuis septembre 2000, l'Espagne utilise un format national unique : quatre chiffres suivis de trois lettres, par exemple 1234 BCD.

Trois particularités le distinguent du format français :

• Pas de voyelles : les lettres A, E, I, O, U sont exclues, de même que Ñ et Q. Seules restent les consonnes B, C, D, F, G, H, J, K, L, M, N, P, R, S, T, V, W, X, Y, Z.
• Pas d'indication géographique : contrairement aux anciennes plaques, le format actuel ne dit rien de la province d'immatriculation.
• Un ordre chronologique : les combinaisons sont attribuées dans l'ordre. Une plaque en B est donc plus ancienne qu'une plaque en M, mais cette lecture reste approximative et ne remplace pas la date de première immatriculation.

Les formats que vous croiserez quand même

Avant 2000, les plaques portaient un code provincial d'une ou deux lettres (M pour Madrid, B pour Barcelone, etc.) suivi de chiffres et de lettres. Il en circule encore sur des véhicules anciens.

D'autres séries existent pour des usages particuliers : cyclomoteurs (plaques jaunes commençant par C), remorques (préfixe R), véhicules historiques (préfixe H), plaques temporaires.

La documentation de notre API indique que le format national actuel est celui pris en charge ; la couverture des anciens formats provinciaux n'est pas garantie. Pour les autres séries, testez vos cas réels avant d'en faire une promesse à vos utilisateurs.

Normaliser la saisie

Un utilisateur peut écrire 1234-bcd, 1234 BCD, 1234BCD ou même E 1234 BCD en recopiant l'identifiant pays de la bande bleue. Une fonction de normalisation simple couvre la plupart de ces variantes :

const SPANISH_CONSONANTS = "BCDFGHJKLMNPRSTVWXYZ";
 
export function normalizeSpanishPlate(input) {
  let plate = input.toUpperCase().replace(/[\s-]/g, "");
  // Retire un "E" recopié depuis la bande européenne, s'il précède le format actuel.
  if (/^E\d{4}[A-Z]{3}$/.test(plate)) plate = plate.slice(1);
  return plate;
}
 
export function isCurrentSpanishFormat(plate) {
  return new RegExp(`^\\d{4}[${SPANISH_CONSONANTS}]{3}$`).test(plate);
}

Deux conseils :

1. Avertissez, ne bloquez pas. Si isCurrentSpanishFormat renvoie false, affichez un message du type « Format inhabituel, vérifiez la saisie » mais laissez l'utilisateur poursuivre : il peut s'agir d'un ancien format légitime.
2. Ne corrigez pas silencieusement les voyelles. Un A à la place d'un 4 ne se devine pas de manière fiable. Mieux vaut demander à l'utilisateur.

Appeler l'API pour une plaque espagnole

L'Espagne est servie par le même endpoint que la France. D'après notre référence API, il suffit d'ajouter le paramètre pays=ES à la requête GET /get-vehicule-info. Le détail de la souscription et des en-têtes est disponible dans la documentation de l'API plaque.

curl --request GET \
  --url 'https://api-plaque-immatriculation-siv.p.rapidapi.com/get-vehicule-info?immatriculation=8034BGY&pays=ES' \
  --header 'x-rapidapi-host: api-plaque-immatriculation-siv.p.rapidapi.com' \
  --header 'x-rapidapi-key: VOTRE_CLE_RAPIDAPI'

Ce que montre la réponse d'exemple

La réponse d'exemple publiée pour la plaque 8034BGY décrit un Nissan Terrano II diesel. Elle utilise la même structure que pour la France, mais plusieurs champs sont vides :

{
  "immat": "8034BGY",
  "pays": "ES",
  "marque": "NISSAN",
  "modele": "TERRANO II (R20)",
  "energieNGC": "DIESEL",
  "puisFiscReelCH": "125 CH",
  "date1erCir_fr": "26-03-2001",
  "puisFisc": "",
  "type_mine": "",
  "cnit": "",
  "k_type": "5990"
}

Ce n'est pas un défaut : la puissance fiscale, le type mine et le CNIT sont des notions propres à la carte grise française. Pour un véhicule espagnol, ne les affichez pas, ou masquez-les automatiquement lorsqu'elles sont vides. À l'inverse, le K-Type et les données moteur restent exploitables pour la recherche de pièces.

Cas d'usage côté espagnol

Vente de pièces en ligne

Un site français qui livre en Espagne peut proposer à ses clients espagnols la même recherche par plaque qu'à ses clients français. Le K-Type renvoyé permet d'interroger le même catalogue TecDoc. Notre article sur l'intégration K-Type et TecDoc détaille cette étape.

Import d'un véhicule espagnol

Avant d'acheter un véhicule en Espagne, un mandataire peut vérifier que la version annoncée correspond à la fiche technique. La recherche par plaque donne une première identification ; le VIN, relevé sur le véhicule, permet de recouper.

Flottes transfrontalières

Un loueur ou une entreprise avec des agences en Catalogne et en Occitanie peut gérer un référentiel véhicules unique, alimenté par la même API quel que soit le pays d'immatriculation.

Cas concret : un formulaire bilingue

Une boutique de pièces propose une page en espagnol. Le parcours retenu :

1. le pays est déduit de la langue de la page (ES), avec un sélecteur pour changer ;
2. la saisie est normalisée avec normalizeSpanishPlate ;
3. un format inhabituel déclenche un avertissement, sans bloquer ;
4. le serveur appelle l'API avec pays=ES ;
5. la fiche affiche marque, modèle, motorisation et dimensions de pneus, en masquant les champs vides ;
6. si aucun véhicule n'est trouvé, le client peut chercher par VIN ou choisir son modèle manuellement.

Conclusion

Intégrer la matrícula espagnole demande peu de code supplémentaire si votre intégration française est propre : un paramètre pays, une normalisation adaptée aux consonnes et une fiche qui tient compte des champs propres à chaque pays. Pour aller plus loin, notre article sur la recherche multi-pays montre comment faire cohabiter France, Espagne et Italie dans un même formulaire.

FAQ

Faut-il un abonnement séparé pour l'Espagne ?

Non. D'après notre documentation, l'Espagne est accessible via le même endpoint que la France, en précisant pays=ES.

Peut-on retrouver la province d'un véhicule à partir de sa plaque actuelle ?

Non. Depuis 2000, la matrícula ne contient plus de code provincial. Seules les anciennes plaques en indiquaient un.

Pourquoi la puissance fiscale est-elle vide pour un véhicule espagnol ?

La puissance fiscale (en CV) est une notion de la carte grise française. Utilisez plutôt la puissance réelle en kW ou en ch, renseignée dans d'autres champs.

Les plaques de cyclomoteurs espagnols sont-elles reconnues ?

Notre documentation ne garantit que le format national actuel des voitures. Testez vos cas avant de proposer cette recherche à vos utilisateurs.