Guía de casos de uso de la Listings Restrictions API v2021-08-01

Cómo acceder mediante programación a las restricciones en los listados del catálogo de Amazon.

Versión API: 2021-08-01

¿Qué es la Listings Restrictions API?

Usando la Selling Partner API para restricciones de listados (Listings Restrictions API), puede verificar si existen restricciones que impidan la creación de un listado para un item en el catálogo de Amazon. Si un item está restringido, es posible que pueda tomar medidas adicionales para solicitar la aprobación para crear una lista. Consulte la Referencia de la Listings Restrictions API para obtener detalles sobre las operaciones de la API y los tipos de datos y esquemas asociados.

Use la Listings Restrictions API junto con la Listings Items API Reference . Por ejemplo, primero puede determinar si existen restricciones de listados utilizando la Listings Restrictions API. Si no existen restricciones, puede llamar a la Listings Items API Reference para crear listados de solo oferta. Consulte la referencia de la Listings Items API para obtener más información sobre la Listings Items API Reference .

Características clave

La Listings Restrictions API proporciona detalles sobre las restricciones de listados, si las hay, en un item de catálogo existente identificado por ASIN.
Opcionalmente, puede filtrar las restricciones según el tipo de condición.
La Listings Restrictions API admite la verificación de múltiples mercados para restricciones de listados en una sola llamada.
Cuando se requiere aprobación, la Listings Restrictions API devuelve los links del siguiente paso para que pueda obtener la aprobación para crear el listado.

Terminología

ASIN : Número de identificación estándar de Amazon que identifica un item en el catálogo de Amazon.
Listing : un listado de Amazon es un item que un selling partner ha puesto a la venta en Amazon y está identificado por una Unidad de mantenimiento de existencias (SKU). Los datos de los productos incluidos en los listados de Amazon se concilian en los items del catálogo de Amazon, que se identifican mediante números de identificación estándar de Amazon (ASIN).
Restriction : Una restricción es una condición que impide la creación de un listado. En algunos casos, la restricción se debe a un requisito de aprobación, en cuyo caso puede haber pasos adicionales disponibles para solicitar la aprobación.

Tutorial: Obtener restricciones de listados para un item en el catálogo

Use este tutorial para recuperar cualquier restricción de listado para un item existente en el catálogo de Amazon.

requisitos previos

Para completar este tutorial, necesitará:

Autorización del selling partner para el que está haciendo llamadas. Consulte la Guía para desarrolladores de la Selling Partner API para obtener más información.
La función de ficha de producto asignada a su perfil de desarrollador.
El rol de Listado de productos seleccionado en la página de registro de la aplicación para su aplicación.
Una comprensión básica de la API de selling partner. Consulte la Guía para desarrolladores de la Selling Partner API para obtener más información.

Paso 1: obtenga restricciones de listados para un item en el catálogo de Amazon

Llame a la operación getListingsRestrictions para devolver cualquier restricción de listados, pasando los siguientes parámetros:

Parámetros de Query

Parámetro	Ejemplo	Descripción	Requerido
`asin`	`B0000ASIN1`	El número de identificación estándar de Amazon (ASIN) del item. Tipo: string	Sí
`conditionType`	`used_very_good`	La condición utilizada para filtrar las restricciones. Tipo: enum ( ConditionType )	No
`sellerid`	`AXXXXXXXXXXX`	Un identificador de selling partner, como una cuenta de comerciante. Tipo: string	Sí
`marketplaceIds`	`ATVPDKIKX0DER`	Lista delimitada por comas de identificadores de mercado de Amazon para la solicitud. Consulte la Guía para desarrolladores de la Selling Partner API para ver la lista de identificadores de mercado de Amazon. Tipo: array (csv)	Sí
`reasonLocale`	`en_US`	Una configuración regional para la localización del texto del motivo. Cuando no se proporciona, se utiliza el código de idioma predeterminado del primer mercado. Ejemplos: `es_US` , `fr_CA` , `fr_FR` . Los mensajes localizados por defecto son `en_US` cuando una localización no está disponible en la configuración regional especificada. Tipo: string	No

solicitud de ejemplo

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

Respuesta

Una respuesta exitosa devuelve información sobre todas las restricciones aplicables, si las hay. Si no hay restricciones para el tipo de condición especificado (cuando se proporciona) en el mercado especificado, la lista de restricciones en la respuesta estará vacía.

Cuando existen restricciones para el tipo de condición especificado (cuando se proporciona) en el mercado especificado, evalúe el array reasons en la respuesta para determinar el motivo e identificar los próximos pasos, si los hay. Cada razón tiene un reasonCode que indica por qué la lista está restringida.

Cuando se requiere aprobación

Amazon requiere que los selling partners obtengan aprobación antes de publicar ciertos items para la venta. El proceso de aprobación puede incluir una variedad de requisitos y calificaciones de aprobación. Si el código de motivo en la respuesta indica que se requiere aprobación, el selling partner puede solicitar la aprobación para publicar el item.

En este caso, use la información en la array de links en la respuesta para indicarle al selling partner que navegue hasta el link URL proporcionado y luego siga las instrucciones allí para solicitar la aprobación de la lista.

Una respuesta exitosa incluye lo siguiente:

Nombre	Ejemplo	Descripción
`restrictions`	Ver ejemplo de respuesta	Una lista de restricciones para el item del catálogo de Amazon especificado. Tipo: array < Restriction >

Respuesta de ejemplo (sin restricciones)

{
  "restrictions": [
    {
    }
  ]
}

Respuesta de ejemplo (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": "solicitud 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": "solicitud 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": "solicitud 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": "solicitud 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": "solicitud 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": "solicitud 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": "solicitud 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": "solicitud 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": "solicitud 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": "solicitud Approval via Seller Central.",
              "type": "text/html"
            }
          ]
        }
      ]
    }
  ]
}

Updated over 1 year ago