Cas d'usage concrets

note

Dans tous les exemples, remplacez ProviderId par votre identifiant, et adaptez les paramètres lang et countryCode à votre marché cible.

---

8.1 Fabricants → Séries de modèles → Véhicules

Étape 1 – Liste des fabricants

Fonction : getLinkageTargets

{
  "getLinkageTargets": {
    "provider": "ProviderId",
    "linkageTargetCountry": "DE",
    "lang": "fr",
    "linkageTargetType": "P",
    "perPage": 0,
    "page": 1,
    "includeMfrFacets": true
  }
}

Réponse : tableau mfrFacets.counts avec id, name, count pour chaque fabricant.

---

Étape 2 – Séries de modèles d'un fabricant

Fonction : getLinkageTargets

{
  "getLinkageTargets": {
    "provider": "ProviderId",
    "linkageTargetCountry": "DE",
    "lang": "fr",
    "linkageTargetType": "P",
    "mfrIds": 5,
    "perPage": 0,
    "page": 1,
    "includeVehicleModelSeriesFacets": true
  }
}

Réponse : tableau vehicleModelSeriesFacets.counts avec id, name, count.

---

Étape 3 – Véhicules d'une série de modèles

Fonction : getLinkageTargets

{
  "getLinkageTargets": {
    "provider": "ProviderId",
    "linkageTargetCountry": "DE",
    "lang": "fr",
    "linkageTargetType": "P",
    "mfrIds": 5,
    "vehicleModelSeriesIds": 13,
    "perPage": 100,
    "page": 1
  }
}

Réponse : tableau linkageTargets avec les détails techniques (puissance, cylindrée, carburant, images…).

---

8.2 Marques et logos

Fonction : getBrands

{
  "getBrands": {
    "articleCountry": "DE",
    "lang": "fr",
    "provider": "ProviderId",
    "includeAll": true
  }
}

Réponse : tableau data.array avec dataSupplierId, mfrName, addressDetails, et dataSupplierLogo (URLs en différentes tailles : 100, 200, 400, 800px).

---

8.3 Arbre d'assemblage → Articles par groupe

Étape 1 – Liste des groupes d'assemblage

Fonction : getArticles

{
  "getArticles": {
    "articleCountry": "DE",
    "provider": "ProviderId",
    "lang": "fr",
    "perPage": 0,
    "page": 1,
    "assemblyGroupFacetOptions": {
      "enabled": true,
      "assemblyGroupType": "P",
      "includeCompleteTree": true
    }
  }
}

Réponse : tableau assemblyGroupFacets.counts avec assemblyGroupNodeId, assemblyGroupName, parentNodeId, count.

---

Étape 2 – Articles pour un groupe spécifique

Fonction : getArticles

{
  "getArticles": {
    "articleCountry": "DE",
    "provider": "ProviderId",
    "assemblyGroupNodeIds": 102801,
    "lang": "fr",
    "perPage": 100,
    "page": 1,
    "includeAll": true
  }
}

Réponse : tableau articles avec numéro d'article, marque, critères, images, OEM numbers…

Filtrage par véhicule

Ajoutez linkageTargetType et linkageTargetId pour restreindre les résultats à un véhicule spécifique.

---

8.4 Fabricants et véhicules compatibles avec un article

Étape 1 – Fabricants compatibles

Fonction : getArticleLinkedAllLinkingTargetManufacturer2

{
  "getArticleLinkedAllLinkingTargetManufacturer2": {
    "articleCountry": "DE",
    "articleId": 446521824,
    "country": "DE",
    "linkingTargetType": "P",
    "provider": "ProviderId"
  }
}

Réponse : tableau data.array avec manuId et manuName.

---

Étape 2 – Véhicules compatibles

Fonction : getArticleLinkedAllLinkingTarget4

{
  "getArticleLinkedAllLinkingTarget4": {
    "articleCountry": "DE",
    "articleId": 446521824,
    "country": "DE",
    "lang": "fr",
    "linkingTargetManuId": 5,
    "linkingTargetType": "P",
    "provider": "ProviderId"
  }
}

---

Étape 3 – Détails complets article + véhicule

Fonction : getArticleLinkedAllLinkingTargetsByIds3

{
  "getArticleLinkedAllLinkingTargetsByIds3": {
    "articleCountry": "DE",
    "articleId": 446521824,
    "immediateAttributs": true,
    "lang": "fr",
    "linkedArticlePairs": {
      "array": [
        { "articleLinkId": 832107059, "linkingTargetId": 33251 }
      ]
    },
    "linkingTargetType": "P",
    "provider": "ProviderId"
  }
}

---

8.5 Recherche d'articles par numéro

Fonction : getArticles

{
  "getArticles": {
    "articleCountry": "DE",
    "provider": "ProviderId",
    "searchQuery": "51277162",
    "searchType": 0,
    "lang": "fr",
    "perPage": 100,
    "page": 1,
    "includeAll": true
  }
}

Types de recherche (searchType)

Valeur	Description
0	Article Number (IAM) – DEFAULT
1	OE Number
2	Trade Number
3	Comparable Number
4	Replacement Number
5	Replaced Number
6	EAN Number
7	Criteria Number
10	Any Number (0 à 7)
99	Free Text

Types de correspondance (searchMatchType)

Valeur	Description
exact	Correspondance exacte – DEFAULT
prefix	Correspondance en préfixe
suffix	Correspondance en suffixe
prefix_or_suffix	Préfixe ou suffixe