Intégrer Ktype avec TecDoc — Guide complet d'identification pièces auto

Dans l'univers des pièces détachées automobiles, une question domine toutes les autres : « cette pièce va-t-elle sur ma voiture ? ». La réponse passe, dans la plupart des catalogues européens, par un identifiant : le K-Type. Le récupérer automatiquement à partir de la plaque, puis l'utiliser pour filtrer un catalogue TecDoc, est le cœur de tout site de pièces auto performant.

Ce tutoriel explique ce qu'est le K-Type, comment l'obtenir via notre API et comment l'exploiter dans votre catalogue.

Qu'est-ce que TecDoc et le K-Type ?

TecDoc est le catalogue de référence de l'après-vente automobile en Europe. Il recense les véhicules et les pièces de très nombreux équipementiers, avec leurs relations de compatibilité.

Dans TecDoc, chaque type de véhicule (une combinaison précise de modèle, motorisation et période) reçoit un identifiant numérique : le K-Type (ou KTypNr). Par exemple, une Renault Mégane III 1.9 dCi 130 correspond à un K-Type donné. Les équipementiers associent leurs références de pièces à ces K-Types.

Conséquence : si vous connaissez le K-Type du véhicule de votre client, vous savez quelles pièces lui sont destinées.

Étape 1 : récupérer le K-Type depuis la plaque

L'API Plaque France renvoie le K-Type dans le champ k_type, accompagné des identifiants tecdoc_car_id, tecdoc_manu_id (constructeur) et tecdoc_model_id (gamme).

async function getKType(plaque) {
const url = new URL("https://api-plaque-immatriculation-siv.p.rapidapi.com/get-vehicule-info");
url.searchParams.set("immatriculation", plaque);

const res = await fetch(url, {
  headers: {
    "x-rapidapi-host": "api-plaque-immatriculation-siv.p.rapidapi.com",
    "x-rapidapi-key": process.env.RAPIDAPI_KEY,
  },
  signal: AbortSignal.timeout(10_000),
});
if (!res.ok) throw new Error(`Erreur ${res.status}`);

const { data } = await res.json();
return {
  kType: data.k_type || null,
  constructeur: data.tecdoc_manu_id || null,
  gamme: data.tecdoc_model_id || null,
  libelle: `${data.marque} ${data.modele} ${data.sra_commercial ?? ""}`.trim(),
};
}

Étape 2 : filtrer le catalogue par K-Type

Dans votre base, chaque pièce est liée à une liste de K-Types compatibles (table de liaison article ↔ véhicule). Le filtrage devient une simple jointure :

SELECT p.reference, p.libelle, p.marque, p.prix
FROM pieces p
JOIN pieces_vehicules pv ON pv.piece_id = p.id
WHERE pv.ktype = :ktype
AND p.categorie = :categorie
ORDER BY p.prix;

Indexez la colonne ktype de la table de liaison : c'est la requête la plus fréquente de votre site.

Étape 3 : gérer les critères complémentaires

Le K-Type ne suffit pas toujours. Pour certaines pièces, TecDoc précise des critères : position (avant / arrière), diamètre de disque, présence d'un équipement, plage de numéros de châssis… Affichez-les clairement à côté de chaque référence et, quand c'est possible, filtrez automatiquement grâce aux autres données de l'API (code moteur, boîte de vitesses, date de mise en circulation).

Étape 4 : prévoir les cas sans K-Type

Certains véhicules n'ont pas de K-Type renvoyé : modèles très anciens, rares, utilitaires spécifiques ou véhicules importés. Prévoyez un parcours alternatif :

1. Proposer un sélecteur marque / modèle / motorisation, par exemple avec l'API Car Selector.
2. Rechercher via le constructeur et la gamme (tecdoc_manu_id, tecdoc_model_id) lorsqu'ils sont présents.
3. Offrir une assistance humaine (formulaire « je ne trouve pas ma pièce »).

Mesurer l'impact

Les indicateurs à suivre après l'intégration :

• taux de retour pour incompatibilité, qui doit baisser nettement ;
• taux de conversion des pages catégories filtrées par véhicule ;
• part des visiteurs utilisant la recherche par plaque par rapport au sélecteur classique.

Conclusion

Le K-Type est la clé de voûte d'un catalogue de pièces auto fiable. En le récupérant automatiquement depuis la plaque, puis en l'utilisant comme filtre principal de votre catalogue TecDoc, vous offrez à vos clients une recherche rapide et des pièces compatibles du premier coup.

FAQ

Tous les véhicules ont-ils un K-Type ?

La grande majorité des véhicules particuliers en circulation en ont un, mais certains modèles rares, anciens ou spécifiques peuvent ne pas en avoir.

Votre API donne-t-elle accès au catalogue TecDoc ?

Non, elle fournit le K-Type et les identifiants TecDoc du véhicule. L'accès au catalogue de pièces relève d'une licence TecDoc ou de vos fournisseurs.

Le K-Type suffit-il à garantir la compatibilité ?

Il filtre efficacement le catalogue ; certains articles ont des critères complémentaires à vérifier (position, équipement, période).