Preguntas frecuentes sobre las API de listados

Frequently asked questions about Listings APIs.

¿Por qué se muestran los artículos como restringidos o no se pueden añadir?

Selecciona esta opción para ampliar la respuesta.

Los artículos se mostrarán como restringidos si no tienes acceso al tipo de producto. Si tienes problemas de acceso, ponte en contacto con el responsable de proveedores o a través de Ponte en contacto con nosotros, asegurándote de especificar que tu problema es una consulta a la API.

¿Puedo editar mi precio de coste a través de la API?

Selecciona esta opción para ampliar la respuesta.

No es posible aumentar el precio de los artículos existentes a través de la API. También es necesario verificar las disminuciones significativas de precios. En este caso, ponte en contacto con tu gerente de proveedores o abre un Póngase en contacto con nosotros caso. A continuación, sube tus cambios de coste a través de Items > Edit Item Costs.

Los valores originales enviados por el proveedor ya no se aceptan. ¿Cómo podemos enviarlos correctamente?

Selecciona esta opción para ampliar la respuesta.

En algunos casos extremos, es posible que el esquema haya cambiado y los valores originales enviados por el proveedor ya no sean válidos. Si este es el caso, pide al proveedor que abra un caso con el equipo de asistencia de Amazon.

¿Cómo actualizo el contenido premium A+?

Selecciona esta opción para ampliar la respuesta.

El contenido Premium A+ no es compatible.

¿Por qué mis cambios no aparecen en la página de detalles aunque se muestren como correctos?

Selecciona esta opción para ampliar la respuesta.

Las API ofrecen un método alternativo de envío de datos de catálogo a Amazon. El proceso posterior y las normas que rigen los datos de catálogo son los mismos, independientemente del método de envío. En algunos casos, especialmente cuando ya tenemos un listing sobre un producto, puede que no se dé prioridad a la información enviada por un proveedor.

¿Por qué no hay información resumida en la respuesta de la API para obtener artículos de listings?

Selecciona esta opción para ampliar la respuesta.

La vista general es un resumen del ASIN con el que se está creando una listing. Si la vista general no está completa, es porque el envío falló y no coincidió con un ASIN. Asegúrate de comprobar el esquema y el formato de tu tipo de producto e inténtalo de nuevo. Si el problema persiste, abre un caso con la asistencia para desarrolladores.

He enviado mi listing sin problemas, pero no los encuentro en la lista.

Selecciona esta opción para ampliar la respuesta.

Es posible que tu listing haya tenido algún problema después de su envío (un problema asincrónico). Para ver estos problemas, utiliza la operación getListingsItem.

¿Qué significa el mensaje de problema "No coincide con tus categorías de productos"?

Selecciona esta opción para ampliar la respuesta.

Si recibes el mensaje "No coincide con tus categorías de productos", el ASIN está configurado en una categoría de productos a la que el proveedor no tiene acceso. Envíanos una solicitud mediante el formulario Ponte en contacto con nosotros a través de Vendor Central, anotando el mensaje, los ASIN y el tipo de producto correcto. Abre un caso con la asistencia para desarrolladores si necesitas asistencia técnica o cuando se indique en la guía de solución de problemas.

¿Qué significa el mensaje de problema "No compatible: no se pueden añadir los siguientes productos"?

Selecciona esta opción para ampliar la respuesta.

Si recibes el mensaje "No compatible: no se pueden añadir los siguientes productos", envíanos una solicitud mediante el formulario Ponte en contacto con nosotros a través de Vendor Central en el que se indique el mensaje del problema y los ASIN o ID externos afectados. Abre un caso con la asistencia para desarrolladores si necesitas asistencia técnica o cuando se indique en la guía de solución de problemas.

Esquemas de productos

¿Cómo determino los requisitos de publicación para publicar un producto nuevo en Amazon?

Selecciona esta opción para ampliar la respuesta.

Para identificar los requisitos de publicación adecuados, primero debes seleccionar el tipo de producto correcto. Esto permitirá a Amazon proporcionar por adelantado todos los requisitos de publicación necesarios. Los siguientes pasos describen el proceso:

  1. Usa el searchDefinitionsProductTypes operación para obtener una lista de los tipos de productos aplicables a sus socios vendedores. Si tienes el título de un producto, puedes obtener una recomendación fiable sobre el tipo de producto aprobando el itemName parámetro. Con el itemName parámetro, puedes combinar el título y la descripción del producto para obtener sugerencias de tipos de productos más detalladas. También puedes usar keywords para buscar entre los tipos de productos o pasar un parámetro vacío para ver la lista completa de los tipos de productos disponibles. Para obtener información adicional, consulta el Guía de casos de uso de la API de definiciones de tipos de productos v2020-09-01.

  2. Una vez que conozcas el tipo de producto, llama al getDefinitionsProductType operación con el requirements parámetro para recuperar los requisitos para crear un nuevo listado.

Cuando cambie el esquema JSON del tipo de producto, ¿se actualizará la versión del esquema?

Selecciona esta opción para ampliar la respuesta.

Sí. La versión del esquema siempre se actualiza a la versión más reciente de la definición del tipo de producto de Amazon.

Hay varias maneras de identificar los cambios entre dos versiones del esquema:

¿Con qué frecuencia cambian los requisitos del catálogo de Amazon?

Selecciona esta opción para ampliar la respuesta.

En función de las señales de búsqueda y compra de los clientes, Amazon revisa los atributos de los productos con regularidad y planifica las actualizaciones necesarias para la última semana de cada mes. En ocasiones, Amazon realiza algunas actualizaciones antes del lanzamiento previsto para abordar los comentarios de los clientes y resolver cualquier defecto o brecha. La mayoría de los cambios son menores y no afectan al comportamiento de los clientes. Antes de actualizar cualquier atributo para el envío de tu anuncio, usa el API de definiciones de tipos de productos para obtener el esquema JSON más reciente.

¿Cómo uso el $lifecycle ¿atributo en los metadatos de definición del tipo de producto en el flujo de trabajo?

Selecciona esta opción para ampliar la respuesta.

Usa el $lifecycle atributo para encontrar detalles sobre el contenido obsoleto y las acciones a tomar. El contenido obsoleto es el contenido que sigue siendo técnicamente válido, pero que se eliminará en el futuro. Por ejemplo, el enumDeprecated elemento del $lifecycle El atributo enumera los valores de enumeración obsoletos que deberías esforzarte por reemplazar con los valores más recientes.

Envíos de listados

¿Cuáles son las diferentes formas de publicar artículos en Amazon de forma programática?

Selecciona esta opción para ampliar la respuesta.

Puedes publicar artículos en Amazon de las siguientes maneras:

Para obtener más información, consulte Guía de flujos de trabajo de administración de listados de edificios.

¿Qué diferencia hay entre la API de artículos de catálogo v2022-04-01 y la API de artículos de listados v2021-08-01?

Selecciona esta opción para ampliar la respuesta.

El API de artículos de catálogo v2022-04-01 proporciona información a nivel de ASIN, que se concilia de varios listados con ese artículo. El API de artículos de listados v2021-08-01 proporciona información sobre el anuncio específico enviado por un socio vendedor.

¿Los datos que devuelve la API de artículos del catálogo v2022-04-01 pueden diferir según la plataforma?

Selecciona esta opción para ampliar la respuesta.

Sí. El API de artículos de catálogo v2022-04-01 devuelve los datos asociados a un ASIN. Un ASIN representa el mismo producto físico en todos los mercados, con pocas excepciones. Sin embargo, los datos de cada ASIN varían según la plataforma porque los países tienen diferentes requisitos de datos específicos para cada plataforma.

Además, dado que la mayoría de los atributos son texto localizado, el texto puede variar según la plataforma o la ubicación, incluso cuando el texto describe el mismo producto. Usa el marketplaceIds filtrar en el API de definiciones de tipos de productos v2020-09-01 operaciones para cumplir con los requisitos específicos del mercado para crear o actualizar productos.

¿Es posible crear un producto en Amazon sin un ASIN o identificador de producto (UPC, GTIN o EAN) con la API de artículos de listados v2021-08-01?

Selecciona esta opción para ampliar la respuesta.

Sí. Si no tienes un identificador de producto, puedes crear un producto con una exención de GTIN. Para obtener la exención, debes enviar una solicitud de exención manual a través de tu cuenta de Seller Central. Para obtener más información, consulta Seller Central. Una vez que hayas recibido la aprobación, puedes crear un envío de anuncios a través del API de artículos de listados v2021-08-01. Debes proporcionar GENERIC como el nombre de la marca y establezca el supplier_declared_has_product_identifier_exemption atribuir a true.

Si llamo patchListingsItem después de llamar JSON_LISTINGS_FEED, ¿la actualización del feed JSON sobrescribe la llamada al parche?

Selecciona esta opción para ampliar la respuesta.

No. Amazon uses submission timestamps to ensure that updates happen in the correct order.

When you upload a JSON_LISTINGS_FEED with inventory updates, Amazon records the feed submission time as the timestamp for all updates within the feed. If you then initiate an inventory update through the patchListingsItem operation, the system assigns the request submission time as the timestamp for that inventory update. In this scenario, if the patchListingsItem operation gets processed first, then it overrides the data provided in the JSON_LISTINGS_FEED.

¿Puedo enviar un JSON_LISTINGS_FEED con múltiples mercados?

Selecciona esta opción para ampliar la respuesta.

No. El JSON_LISTINGS_FEED y API de artículos de listados v2021-08-01 admite un mercado único por feed.

¿Quién tiene más prioridad para anular la información de la página de detalles del producto en Amazon?

Selecciona esta opción para ampliar la respuesta.

Los propietarios de marcas tienen la máxima prioridad a la hora de actualizar los datos de la página de detalles del producto en Amazon. Si Amazon utiliza sus propios datos en la página de detalles del producto, los propietarios de las marcas pueden anularlos enviando un mensaje al servicio de asistencia de Seller Central.

¿Cómo puedo validar los datos de mis listados antes de realizar una llamada de producción?

Selecciona esta opción para ampliar la respuesta.

Before you submit a listing, verify that the attributes of the listing adhere to the JSON schema for the product type. For information about JSON schema validation utilities, refer to Amazon Product Type Definitions Meta-Schema (v1).
After you validate the JSON, you can preview errors before you create or update a listing by using VALIDATION_PREVIEW mode. This mode provides a test environment that checks the values that you provide in the payload for validation errors. VALIDATION_PREVIEW mode synchronously performs the same checks that are done on production submissions, but without persisting to your catalog.

¿Cuándo puedo saber si hay problemas con mis anuncios?

Selecciona esta opción para ampliar la respuesta.

Amazon realiza varias validaciones de los listados enviados por los socios vendedores. Algunas de estas validaciones se devuelven de forma sincrónica en respuesta a los envíos. Si subes los datos de los anuncios con el API de artículos de listados v2021-08-01 y el estado del envío es ACCEPTED, luego el envío pasó las validaciones sincrónicas. Amazon envía el envío en sentido descendente para crear o actualizar el SKU. Hay una serie de procesos posteriores que se llevan a cabo a continuación para crear o actualizar un artículo en el catálogo de Amazon. Cualquiera de estos procesos posteriores puede generar problemas que se devuelven de forma asincrónica. Por ejemplo, si el envío de un listado contiene datos que entran en conflicto con otro artículo del catálogo de Amazon. Para crear o actualizar correctamente los artículos del catálogo de Amazon, debes gestionar los problemas notificados de forma sincrónica y asincrónica. Para obtener más información sobre los problemas relacionados con los listados, consulta Manejar los problemas con los artículos de y Solución de problemas con la API de artículos de listados.

¿Cómo puedo confirmar la creación de mi producto en el catálogo de Amazon?

Selecciona esta opción para ampliar la respuesta.

Amazon envía un LISTINGS_ITEM_STATUS_CHANGE notificación cuando cambia el estado de un artículo del anuncio. Se publica una notificación cuando cambia la capacidad de compra de un artículo del anuncio o cuando se crea o elimina un artículo del anuncio. Para recibir una notificación cuando se cree un anuncio, suscríbete al LISTINGS_ITEM_STATUS_CHANGE notificación. El ListingsItemStatus el atributo devuelto en la carga útil contiene el estado actual asociado al artículo del anuncio afectado. Si no hay ningún valor, el estado de estado no se aplica al artículo del anuncio. Por ejemplo, si DISCOVERABLE no está presente, Amazon Retail no puede buscar el artículo del listado.

¿Por qué hay un retraso notable entre el momento en que los cambios en un artículo del anuncio se reflejan en el getListingItem los resultados de la operación en comparación con cuando LISTINGS_ITEM_ISSUES_CHANGE y LISTINGS_ITEM_STATUS_CHANGE ¿se reciben notificaciones en la cola de SQS?

Selecciona esta opción para ampliar la respuesta.

There can be a delay because the Amazon backend updates every 15 minutes. As a result, every update might be delayed by 0-15 minutes depending on when the update occurred in that window.
For example, a 15-20 minute delay for the LISTINGS_ITEM_ISSUES_CHANGE and LISTINGS_ITEM_STATUS_CHANGE notifications is normal. Our data sources can be up to 15 minutes behind because the data sources rely on many upstream processes to send updates for notifications.

Por el contrario, el getListingItem La operación consulta directamente el estado actual, por lo que los resultados están disponibles más rápido (en 1 a 5 minutos). Para minimizar los errores de limitación, Amazon recomienda utilizar notificaciones push para recibir actualizaciones en tiempo real sobre los cambios de estado y los problemas relacionados con los listados.

Después de enviar un producto, ¿por qué recibo un error porque faltan atributos que no forman parte del esquema JSON del tipo de producto?

Selecciona esta opción para ampliar la respuesta.

Durante la fase de proceso de envío de un listado, Amazon evalúa el listado. Si el listado se desvía del tipo de producto seleccionado, el tipo de producto del listado cambiará al tipo de producto recomendado por Amazon. Esto hace que los atributos del nuevo tipo de producto aparezcan como faltantes. Transmitimos información sobre un tipo de producto modificado mediante una advertencia en el anuncio.

Amazon recomienda que utilices el searchDefinitionsProductTypes operación para recuperar una lista de todos los tipos de productos aplicables. Para obtener una recomendación de alta confianza sobre el tipo de producto correcto con esta operación, utilice la itemName parámetro.

¿Qué debo hacer si alcanzo el límite de tarifa con el JSON_LISTINGS_FEED?

Selecciona esta opción para ampliar la respuesta.

Con el JSON_LISTINGS_FEED, puedes enviar hasta 10 000 SKU en una sola solicitud cada 5 minutos. Para evitar problemas de limitación, en lugar de enviar ficheros pequeños, envía un fichero grande. Subir varios feeds pequeños cada pocos segundos es ineficaz y puede generar un retraso. Esto puede bloquear el procesamiento de otros feeds y obligarte a cancelar algunos de los feeds enviados anteriormente. En lugar de enviar los mismos datos, envía únicamente información actualizada para reducir el número de llamadas. Para obtener información sobre cómo optimizar el envío de tus feeds, consulta Mejores prácticas de la API de Feeds.

¿Por qué se ha aplicado la actualización de mi imagen en todo el mundo?

Selecciona esta opción para ampliar la respuesta.

Los atributos de imagen proporcionados por el API de artículos de listados v2021-08-01 las operaciones asignan imágenes a ASIN a nivel global cuando el ASIN existe, incluso si especificas el marketplace_id selector. Este comportamiento es coherente con otras experiencias, como Añadir un producto en Seller Central.


¿Te ha ayudado esta página?