Guía de casos de uso de la API de restricciones de listings v2021-08-01

Cómo identificar de forma programática las restricciones en los listados del catálogo de Amazon.

Al utilizar la API del colaborador comercial para restricciones de listings (API de restricciones de listings), puedes comprobar si existe alguna restricción que te impida crear un listing para un artículo del catálogo de Amazon. Si un artículo está restringido, puedes realizar pasos adicionales para solicitar la aprobación para crear un listing. Consulta Referencia de la API de restricciones de listings para obtener información sobre las operaciones de la API y los tipos de datos y esquemas asociados.

Utiliza la API de restricciones de listings junto con la API de artículos de listings. Por ejemplo, puedes determinar primero si hay alguna restricción de listings utilizando la API de restricciones de listings. Si no hay restricciones, puedes llamar a la API de artículos de listings para crear listings solo para ofertas. Consulta la Referencia de la API de artículos de listings para obtener más información sobre la API de artículos de listings.

Características principales

La API de restricciones de listados proporciona detalles sobre las restricciones de publicación, si las hubiera, para un artículo del catálogo existente identificado mediante el número de identificación estándar (ASIN) de Amazon.
Opcionalmente, puedes filtrar las restricciones en función del tipo de condición.
La API de restricciones de listings permite comprobar las restricciones de listings en varios sitios web en una sola llamada.
Cuando se requiere aprobación, la API de restricciones de listings devuelve los enlaces de paso siguiente para que puedas solicitar la aprobación para crear el listing.

Terminología

ASIN: número de identificación normalizado de Amazon (ASIN) que identifica un artículo en el catálogo de Amazon.
Listado: Un listado de Amazon es un artículo que un socio vendedor ha puesto a la venta en Amazon y que se identifica mediante un SKU. Los datos del producto incluidos en los listados de Amazon se concilian con los artículos del catálogo de Amazon, que se identifican mediante un ASIN.
Restricción: una restricción es una condición que impide la creación de un listing. En algunos casos, la restricción se debe a un requisito de aprobación, en cuyo caso puede haber pasos adicionales para solicitar la aprobación.

Tutorial: Obtener restricciones de listings para un artículo del catálogo

Utiliza este tutorial para recuperar cualquier restricción de listings para un artículo existente en el catálogo de Amazon.

Para completar este tutorial, necesita:

Autorización del colaborador comercial para el que realizas las llamadas. Consulta Cómo autorizar aplicaciones API del colaborador comercial para obtener más información.
El rol de listing de productos asignado a tu perfil de desarrollador.
El rol de listing de productos seleccionado en la página de registro de la aplicación.
Un conocimiento básico de la API del colaborador comercial. Consulta ¿Qué es la API del colaborador comercial? para obtener más información.

Italia `getListingsRestrictions`

Llama a la operación getListingsRestrictions para obtener cualquier restricción de listings, utilizando los siguientes parámetros:

`getListingsRestrictions` parámetros de consulta

Parámetro	Ejemplo	Descripción	Obligatorio
`asin`	`B0000ASIN1`	El número de identificación estándar de Amazon (ASIN) del producto. Tipo: cadena	Sí
`conditionType`	`used_very_good`	La condición utilizada para filtrar las restricciones. Tipo: enum (Tipo de condición)	No
`sellerid`	`AXXXXXXXXXXX`	Un identificador de socio vendedor, como una cuenta de vendedor. Tipo: cadena	Sí
`marketplaceIds`	`ATVPDKIKX0DER`	Lista delimitada por comas de los identificadores de Amazon Marketplace de la solicitud. Consulte Identificadores de mercado para ver la lista de identificadores de Amazon Marketplace. Tipo: < cadena > matriz (csv)	Sí
`reasonLocale`	`en_US`	Una configuración regional a efectos de localización de texto. Si no se proporciona, se utiliza el código de idioma predeterminado del primer sitio web. Ejemplos: `en_US`, `fr_CA`, `fr_FR`. Los mensajes localizados tienen el valor predeterminado `en_US` si la localización no está disponible en la configuración regional especificada.	No

Ejemplo de `getListingsRestrictions`:

https://sellingpartnerapi-na.amazon.com/listings/2021-08-01/restrictions
   ?asin=B08XXLG119
   &conditionType=
   &sellerId=AXXXXXXXXXXX
   &marketplaceIds=ATVPDKIKX0DER

`getListingsRestrictions` obligatorio

Una respuesta correcta devuelve información sobre todas las restricciones aplicables, si las hay. Si no hay restricciones para el conditionType especificado (cuando se proporcione) en el sitio web especificado, la lista de restricciones de la respuesta estará vacía.

Si existen restricciones en el conditionType especificado (si corresponde) en el sitio web especificado, revisa la matriz reasons en la respuesta para determinar el motivo e identificar los próximos pasos si es necesario. Cada motivo tiene un reasonCodeque indica por qué el listing está restringido.

¿Cuándo se requiere la aprobación?

Amazon exige a sus colaboradores comerciales que obtengan la aprobación antes de hacer el listing de determinados artículos para su venta. El proceso de aprobación puede incluir una variedad de requisitos y cualificaciones de aprobación. Si el reasonCode de la respuesta indica que se requiere aprobación, el colaborador comercial puede solicitar la aprobación para publicar el artículo.

En este caso, utiliza la información de la matriz de enlaces de la respuesta para indicar al colaborador comercial que vaya hasta el enlace URL proporcionado y, a continuación, siga las instrucciones para solicitar la aprobación de la lista.

Una respuesta correcta incluye lo siguiente:

Nombre	Ejemplo	Descripción
`restrictions`	Consulte el ejemplo de respuesta.	Una lista de restricciones para el artículo del catálogo de Amazon especificado. Tipo: < `Restriction` > gama

`getListingsRestrictions` ejemplo de respuesta (sin restricciones)

{
  "restrictions": [
    { }
  ]
}

`getListingsRestrictions` ejemplo de respuesta (existen restricciones)

{
  "restrictions": [
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "collectible_like_new",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "new_new",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You need approval to list.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "used_acceptable",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "used_like_new",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "collectible_very_good",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "used_very_good",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "collectible_acceptable",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "collectible_good",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "used_good",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    },
    {
      "marketplaceId": "ATVPDKIKX0DER",
      "conditionType": "refurbished_refurbished",
      "reasons": [
        {
          "reasonCode": "APPROVAL_REQUIRED",
          "message": "You cannot list the product in this condition.",
          "links": [
            {
              "resource": "https://sellercentral.amazon.com/hz/approvalrequest/restrictions/approve?asin=B08XXLG119",
              "verb": "GET",
              "title": "Request Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    }
  ]
}

Updated 20 days ago

¿Te ha ayudado esta página?

Tutorial: Obtener restricciones de listings para un artículo del catálogo

Italia getListingsRestrictions

getListingsRestrictions parámetros de consulta

Ejemplo de getListingsRestrictions:

getListingsRestrictions obligatorio