Documentación
Centro de desarrolladoresEstado de la APIAsistencia
Empieza a escribir para buscar...

Guía de casos de uso de la API v2024-11-01 para vehículos

Cómo usar la API de vehículos.

Versión de la API: 2020-11-01

¿Qué es la API de vehículos?

Con la API de socios vendedores para vehículos (API de vehículos), puedes recuperar información sobre los vehículos, incluidos sus identificadores únicos. Puedes usar esta información para proporcionar información sobre la compatibilidad de los ASIN de la lista con la API de listados.

Los artículos que requieren información sobre la compatibilidad del vehículo requieren una lista de los tipos K de vehículos. Esta API proporciona una lista de vehículos y sus KTYPE, que puedes usar para asignar de forma independiente cada artículo de tu catálogo a una lista de KTypes. Luego, esta asignación se puede proporcionar a Amazon mediante la API de listados.

¿Qué contiene esta guía?

En esta guía se describe cómo:

  • Usa la API de vehículos para obtener la lista más reciente de vehículos.
  • Actualiza la información de compatibilidad de un ASIN mediante la API de listados.

Terminología

  • ASIN: número de identificación normalizado de Amazon (ASIN) que identifica un artículo en el catálogo de Amazon.
  • TIPO K: identificador numérico asociado a la definición de un vehículo (marca, modelo, tipo, año) y que utilizan varias marcas para vincular sus productos.

Tutorial 1: Proporciona información sobre la compatibilidad de los ASIN

Proporciona información de compatibilidad para los artículos de tu catálogo.

Requisitos

Para completar este tutorial, debes tener lo siguiente:

Paso 1. Recupera una lista de vehículos y sus K-Types

Para obtener una lista de vehículos, llame al getVehicles operación.

Parámetros de consulta

NombreDescripciónObligatorio
marketplaceIdUn identificador del mercado en el que opera el recurso. Para encontrar el identificador de un mercado, consulta Identificadores de mercado.
Tipo: cadena		Sí
vehicleTypeEl tipo de vehículo. Los valores posibles son CAR y MOTORBIKE.
Tipo: enumeración (VehicleType)		Sí
pageTokenUn token que puedes usar para recuperar la página de resultados siguiente o anterior. La respuesta incluye pagination cuando el número de resultados supera el tamaño de la página. Para obtener la siguiente página de resultados, llame a la operación con el nextToken e incluye los mismos argumentos que la llamada que produjo el token. Para obtener una lista completa, ejecuta esta operación hasta que no haya nextToken en la respuesta. Tenga en cuenta que esta operación puede devolver páginas vacías.
Tipo: cadena		No
updatedAfterIncluye este campo para recuperar solo los vehículos que se hayan modificado o añadido al catálogo de Amazon después de la fecha que indiques. Debes estar en ISO 8601 formato de fecha y hora.
Tipo: cadena		No

Ejemplo de solicitud

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

Respuesta

Una respuesta correcta incluye las siguientes propiedades:

NombreDescripción
paginationEl nextToken y previousToken valores necesarios para recuperar la página de resultados siguiente o anterior, si están disponibles.
Tipo: Pagination
vehiclesUna lista de vehículos del catálogo de Amazon.
Tipo: < Vehicle > gama

Ejemplo de respuesta

{
  "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"
    }
  ]
}

Paso 2. Mapea tus artículos a KTypes

Usa la respuesta del paso anterior para seleccionar los vehículos a los que se ajusten tus artículos. Para cada artículo, anota el KTYPE de los vehículos compatibles con él. Proporcionarás esta lista de KTypes en el siguiente paso.

Paso 3. Actualiza la compatibilidad con la API de listados

Para actualizar la información de compatibilidad de un ASIN, llama al patchListingsItem operación. El patches el parámetro en el cuerpo de la solicitud debe tener el path igual a /attributes/vehicle_fitment y contienen la lista de KTypes en value.

Parámetros de ruta

NombreDescripciónObligatorio
sellerIdUn identificador de socio vendedor, como una cuenta de vendedor o un código de proveedor.
Tipo: cadena		Sí
skuUn socio vendedor ha proporcionado el identificador de un listado de Amazon.
Tipo: cadena		Sí

Parámetros de consulta

NombreDescripciónObligatorio
marketplaceIdsUna lista delimitada por comas de los identificadores de Amazon Marketplace de la solicitud.
Tipo: gama		Sí
includedDataUna lista de conjuntos de datos delimitados por comas para incluir en la respuesta.
Tipo: < enumeración (IncludedData) > gama		No
modeEl modo de operación de la solicitud.
Tipo: enumeración (Mode)		No
issueLocaleUn lugar para la localización de problemas. Si no se proporciona, se utiliza el código de idioma predeterminado de la primera plataforma.
Tipo: cadena		No

Parámetros de texto

NombreDescripciónObligatorio
productTypeEl tipo de producto de Amazon del artículo del listado.
Tipo: cadena		Sí
patchesUna o más operaciones de parche JSON para realizar en el elemento del listado.
Tipo: < PatchOperation > gama		Sí

Ejemplo de solicitud

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"
        }
      ]
    }
  ]
}

Respuesta

Una respuesta correcta incluye las siguientes propiedades:

NombreDescripción
skuUn socio vendedor ha proporcionado el identificador de un listado de Amazon.
Tipo: cadena
statusEl estado del envío del artículo del anuncio.
Tipo: enumeración (Status)
submissionIdEl identificador único del envío del artículo del anuncio.
Tipo: cadena
issuesProblemas con los artículos del anuncio relacionados con el envío del artículo del anuncio.
Tipo: < Issue > gama
identifiersAtributos de identidad asociados al producto en el catálogo de Amazon, como el ASIN.
Tipo: ItemIdentifiers

Ejemplo de respuesta

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

❗️

Condiciones de uso

Al descargar y utilizar los datos proporcionados por esta API, los términos de uso que se encuentran aquí se aplican y son aceptados por los usuarios.

Updated 5 days ago

¿Te ha ayudado esta página?