Guide des cas d'utilisation de l'API pour véhicules v2024-11-01

Comment utiliser l'API Vehicles.

Version de l'API : 2020-11-01

Qu'est-ce que l'API Vehicles ?

Grâce à l'API Selling Partner pour les véhicules (API pour les véhicules), vous pouvez récupérer des informations sur les véhicules, y compris leurs identifiants uniques. Vous pouvez utiliser ces informations pour fournir des informations de compatibilité pour les ASIN répertoriés avec l'API Listings.

Les articles qui nécessitent des informations sur le montage du véhicule nécessitent une liste des types de véhicules K. Cette API fournit une liste de véhicules et de leur KTYPE, que vous pouvez utiliser pour associer indépendamment chaque article de votre catalogue à une liste de KTYPES. Ce mappage peut ensuite être fourni à Amazon à l'aide de l'API Listings.

Que contient ce guide ?

Ce guide explique comment :

Utilisez l'API Vehicles pour obtenir la liste la plus récente des véhicules.
Mettez à jour les informations d'ajustement pour un ASIN à l'aide de l'API Listings.

Terminologie

ASIN : numéro d'identification standard Amazon permettant d'identifier un article dans le catalogue Amazon.
TYPE K: identifiant numérique associé à la définition d'un véhicule (marque, modèle, type, année) et utilisé par différentes marques pour relier leurs produits.

Tutoriel 1 : Fournir des informations d'ajustement sur les ASIN

Fournissez des informations de compatibilité pour les articles de votre catalogue.

Conditions préalables

Pour terminer ce tutoriel, vous devez disposer des éléments suivants :

Autorisation du partenaire de vente pour lequel vous effectuez des appels. Pour plus d'informations, consultez la section Autorisation des applications API partenaire de vente.
Approbation pour Liste des produits rôle dans votre profil de développeur.
le rôle Offre de produit sélectionné sur la page d'enregistrement de l'application pour votre application ;

Étape 1 Récupérez une liste de véhicules et de leurs types K

Pour obtenir la liste des véhicules, appelez le getVehicles opération.

Paramètres de la requête

Nom	Description	Obligatoire
`marketplaceId`	Identifiant du site de vente sur lequel la ressource est exploitée. Pour trouver l'identifiant d'une place de marché, reportez-vous à Identifiants Marketplace. Tapez : chaîne	Oui
`vehicleType`	Le type de véhicule. Les valeurs possibles sont `CAR` et `MOTORBIKE`. Tapez : énumération (`VehicleType`)	Oui
`pageToken`	Un jeton que vous pouvez utiliser pour récupérer la page de résultats suivante ou précédente. La réponse inclut `pagination` lorsque le nombre de résultats dépasse la taille de la page. Pour obtenir la page de résultats suivante, appelez l'opération à l'aide du `nextToken` et incluez les mêmes arguments que l'appel qui a produit le jeton. Pour obtenir une liste complète, appelez cette opération jusqu'à ce qu'il n'y ait plus `nextToken` dans la réponse. Notez que cette opération peut renvoyer des pages vides. Tapez : chaîne	Non
`updatedAfter`	Incluez ce champ pour récupérer uniquement les véhicules qui ont été modifiés ou ajoutés au catalogue Amazon après la date que vous avez indiquée. Doit être dedans NORME ISO 8601 format date-heure. Tapez : chaîne	Non

Exemple de demande

GET https://sellingpartnerapi-eu.amazon.com/catalog/2024-11-01/automotive/vehicles?marketplaceId=A1F83G8C2ARO7P&updatedAfter=2024-11-01T01:00:00+01:00&vehicleType=CAR

Réponse

Une réponse réussie inclut les propriétés suivantes :

Nom	Description
`pagination`	Le `nextToken` et `previousToken` valeurs requises pour récupérer la page de résultats suivante ou précédente, si disponible. Tapez : `Pagination`
`vehicles`	Liste des véhicules du catalogue d'Amazon. Tapez : < `Vehicle` > gamme

Exemple de réponse

{
  "pagination": {
    "nextToken": "AQICAHhviiXpt-KG7DcOWDoXPW4_B4xAKk9r-8oi43dEh_cI4QF"
  },
  "vehicles": [
    {
      "bodyStyle": "MPV",
      "driveType": "Front-Wheel Drive",
      "energy": "Petrol/Liquified Petroleum Gas (LPG)",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 61.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 83.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "100408"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Dacia",
      "manufacturingStartDate": {
        "month": 11,
        "year": 2013
      },
      "manufacturingStopDate": {
        "month": 12,
        "year": 2015
      },
      "model": "Dokker",
      "status": "ACTIVE",
      "variantName": "1.6 LPG"
    },
    {
      "bodyStyle": "Closed Off-Road Vehicle",
      "driveType": "All-wheel Drive",
      "energy": "Petrol",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 100.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 136.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "10232"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Vauxhall",
      "manufacturingStartDate": {
        "month": 10,
        "year": 1998
      },
      "manufacturingStopDate": {
        "month": 10,
        "year": 2004
      },
      "model": "Frontera",
      "status": "ACTIVE",
      "variantName": "2.2 I"
    },
    {
      "bodyStyle": "Closed Off-Road Vehicle",
      "driveType": "All-wheel Drive",
      "energy": "Petrol",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 151.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 205.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "10233"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Vauxhall",
      "manufacturingStartDate": {
        "month": 10,
        "year": 1998
      },
      "manufacturingStopDate": {
        "month": 10,
        "year": 2004
      },
      "model": "Frontera",
      "status": "ACTIVE",
      "variantName": "3.2 I"
    },
    {
      "bodyStyle": "Closed Off-Road Vehicle",
      "driveType": "All-wheel Drive",
      "energy": "Diesel",
      "engineOutput": [
        {
          "unit": "KILOWATT",
          "value": 85.0
        },
        {
          "unit": "HORSEPOWER",
          "value": 116.0
        }
      ],
      "identifiers": [
        {
          "standard": "KTYPE",
          "value": "10234"
        }
      ],
      "lastProcessedDate": "2024-11-01T01:00:00+01:00",
      "make": "Vauxhall",
      "manufacturingStartDate": {
        "month": 10,
        "year": 1998
      },
      "manufacturingStopDate": {
        "month": 9,
        "year": 2004
      },
      "model": "Frontera",
      "status": "ACTIVE",
      "variantName": "2.2 DTI"
    }
  ]
}

Étape 2 Associez vos objets à KTypes

Utilisez la réponse de l'étape précédente pour sélectionner les véhicules adaptés à vos articles. Pour chaque article, notez le KTYPE des véhicules qui y correspondent. Vous fournissez cette liste de KTypes à l'étape suivante.

Étape 3 Mettez à jour l'équipement avec l'API Listings

Pour mettre à jour les informations de montage d'un ASIN, appelez le patchListingsItem opération. Le patches le paramètre dans le corps de la demande doit avoir path égal à /attributes/vehicle_fitment et contiennent la liste des KTypes dans value.

Paramètre de chemin d'accès

Nom	Description	Obligatoire
`sellerId`	Un identifiant de partenaire de vente, tel qu'un compte marchand ou un code fournisseur. Tapez : chaîne	Oui
`sku`	Un partenaire de vente a fourni l'identifiant d'une offre Amazon. Tapez : chaîne	Oui

Paramètres de la requête

Nom	Description	Obligatoire
`marketplaceIds`	Liste séparée par des virgules des identifiants Amazon Marketplace pour la demande. Tapez : gamme	Oui
`includedData`	Liste d'ensembles de données séparés par des virgules à inclure dans la réponse. Tapez : < énumération (`IncludedData`) > gamme	Non
`mode`	Mode de fonctionnement de la demande. Tapez : énumération (`Mode`)	Non
`issueLocale`	Un local pour la localisation des problèmes. Lorsqu'il n'est pas fourni, le code de langue par défaut du premier site de vente est utilisé. Tapez : chaîne	Non

Paramètres du corps

Nom	Description	Obligatoire
`productType`	Type de produit Amazon associé à l'article de l'offre. Tapez : chaîne	Oui
`patches`	Une ou plusieurs opérations de patch JSON à effectuer sur l'élément de liste. Tapez : < `PatchOperation` > gamme	Oui

Exemple de demande

PATCH https://sellingpartnerapi-eu.amazon.com/listings/2021-08-01/items/XXXXXXXXXX/SKU_XXXXXX?includedData=issues&marketplaceIds=A1PA6795UKMFR9
{
  "productType": "AUTO_OIL",
  "patches": [
    {
      "op": "replace",
      "path": "/attributes/vehicle_fitment",
      "value": [
        {
          "standard": [
            {
              "value": "ktype",
              "language_tag": "de_DE"
            }
          ],
          "code": [
            {
              "value": "10232, 10234, 10233",
              "language_tag": "de_DE"
            }
          ],
          "note": [
            {
              "value": "{\"10232,10234\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"]]],\"10233\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"],[\"Motorcode\",\"N47 D20 C\"]]]}",
              "language_tag": "de_DE"
            }
          ],
          "marketplace_id": "A1PA6795UKMFR9"
        }
      ]
    }
  ]
}

Réponse

Une réponse réussie inclut les propriétés suivantes :

Nom	Description
`sku`	Un partenaire de vente a fourni l'identifiant d'une offre Amazon. Tapez : chaîne
`status`	État de la soumission des objets de l'annonce. Tapez : énumération (`Status`)
`submissionId`	L'identifiant unique de l'objet de l'annonce soumis. Tapez : chaîne
`issues`	Problèmes liés à la soumission des annonces. Tapez : < `Issue` > gamme
`identifiers`	Attributs d'identité associés à l'article dans le catalogue Amazon, tels que l'ASIN. Tapez : `ItemIdentifiers`

Exemple de réponse

{
  "sku": "SKU-XXXX-XXXX",
  "status": "ACCEPTED",
  "submissionId": "xxxxxxxxxxxxxxxxx",
  "issues": []
}

❗️
Conditions d'utilisation
Lors du téléchargement et de l'utilisation des données fournies par cette API, les conditions d'utilisation disponibles ici s'appliquent et sont acceptés par les utilisateurs.

Updated 5 days ago

Cette page vous a-t-elle été utile ?

Qu'est-ce que l'API Vehicles ?

Que contient ce guide ?

Terminologie

Tutoriel 1 : Fournir des informations d'ajustement sur les ASIN

Conditions préalables

Étape 1 Récupérez une liste de véhicules et de leurs types K

Paramètres de la requête

Exemple de demande

Réponse

Exemple de réponse

Étape 2 Associez vos objets à KTypes

Étape 3 Mettez à jour l'équipement avec l'API Listings

Paramètre de chemin d'accès

Paramètres de la requête

Paramètres du corps

Exemple de demande

Réponse

Exemple de réponse

❗️Conditions d'utilisation

❗️
Conditions d'utilisation