Solución de problemas de la Listings Items API

Contexto y consejos de solución de problemas para mensajes y códigos de problemas comunes que los desarrolladores pueden encontrar durante el proceso de integración de la Listings Items API para la API de Selling Partner.

Suggest Edits

Solución de problemas de la Listings Items API

La Listings Items API brinda acceso programático a selling partner listings en Amazon. Puede crear, editar, eliminar y recuperar detalles sobre listados de Amazon (SKU) para un selling partne. Esto incluye datos del producto, como títulos de artículos y términos de venta, como precio e inventario.

Los datos de listados enviados a la Listings Items API cumplen con el formato de esquema JSON proporcionado por la Selling Partner API para Product Type Definitions .

Los siguientes consejos para la solución de problemas pueden ayudarlo a desbloquearlo si encuentra problemas informados para una lista, ya sea en el envío, durante el proceso o independientemente del proceso de envío en general.

¿Cómo se reciben los Listings Issues?

Síncrono vs Asíncrono

Dentro de la experiencia de listado, puede acceder a problemas durante diferentes partes del proceso. Es posible que reciba problemas sincrónicamente al enviar a la API de listados que impidan la aceptación y el procesamiento posterior del envío. También puede recibir notificaciones asincrónicas sobre problemas informados después de realizar el envío. Los problemas también se pueden recuperar al leer los datos de los listados.

Se produce un synchronous issue cuando el servidor rechaza la solicitud durante la solicitud inicial. Lo más probable es que se trate de un problema relacionado con atributos incorrectos o parámetros mal manejados adjuntos a la solicitud.

Se produce un asynchronous issue cuando una solicitud pasa la validación inicial pero devuelve un error después de procesar los datos recibidos. El problema devuelto tiene la forma de un mensaje que se puede utilizar para resolver el problema.

Procesamiento posterior al envío

Amazon realiza una serie de validaciones en los envíos realizados por Selling Partner. Algunas de estas validaciones se devuelven sincrónicamente en respuesta a los envíos. Estos cubren validaciones de datos en la entrada en sí, como atributos requeridos faltantes y atributos no válidos.

Si el envío pasa las validaciones sincrónicas anteriores, se acepta el envío y se envía en sentido descendente para crear o actualizar el SKU. Hay una serie de procesos posteriores que luego se realizan para crear con éxito un artículo en el catálogo de Amazon. Cualquiera de estos procesos posteriores puede generar problemas que se devuelven de forma asincrónica.

Para manejar adecuadamente todos los problemas posibles, un cliente debe manejar los problemas informados tanto de forma sincrónica como asincrónica.

Emitir códigos y mensajes: qué significan y cómo evitarlos

Issue Code	Listing Issues	Descripción	Detalles adicionales y acciones preventivas
90220	`attribute_name` es obligatorio pero no se proporciona.	Este problema ocurre cuando no se proporcionó un atributo obligatorio. Ejemplo: `item_package_dimensions` es obligatorio pero no se proporciona. Proporcione información para el atributo requerido como se indica en el mensaje de problema.	Para evitar esto, utilice la Product Type Definitions API para identificar los atributos necesarios y agregarlos a las comprobaciones de validación. Utilice la Notifications API para recibir actualizaciones instantáneas de las definiciones de tipos de productos.
4000001	El valor proporcionado por `attribute_name` no es válido.	El valor proporcionado para el atributo especificado no es válido. Ciertos atributos tienen listas restringidas de valores permitidos. Este problema suele estar asociado con la categoría de producto, la subcategoría de producto, la palabra clave de tipo de elemento o el nodo de navegación recomendado. Tenga en cuenta que se debe seguir la condicionalidad, lo que significa que solo se pueden seleccionar ciertas subcategorías para una determinada categoría de producto y solo ciertos nodos de navegación para ciertas subcategorías.	Para evitar esto, use la Product Type Definitions API para verificar los valores permitidos y la condicionalidad y asegúrese de que reflejen la lista de valores aceptados que se pueden seleccionar dentro de su sistema.
4005011	El valor de `attribute_name` entra en conflicto con otro artículo en el catálogo de Amazon, `conflicting_asin` . O cambia el valor a `conflicting_value` o comuníquese con Amazon para resolver el problema de conflicto de datos.	Este problema se devuelve cuando el envío tiene datos que entran en conflicto con otro artículo en el catálogo de Amazon. Debes revisar la información contradictoria del ASIN y el atributo al que se hace referencia. Es posible que deba cambiar los datos que se envían para resolver el conflicto con los datos existentes. Si desea cambiar cualquier valor existente, deberá enviar un caso de soporte de Amazon.	Cree un flujo de trabajo para mostrar cualquier dato de catálogo preexistente para el SKU usando el `y/o` API.
99022	El campo `field_name` para el atributo `attribute_name` no tiene suficientes valores. El mínimo requerido es valor(es) `min_occurrences` .	Valor mínimo no alcanzado. Este problema se genera cuando el valor enviado para un campo no cumple con los requisitos mínimos o falta. Revise el mensaje de problema para identificar los valores/requisitos que faltan y solicite al vendor que lo vuelva a enviar. Ejemplo: Esperado al menos `1` de campo `currency` para atributo `list_price` . Al agregar un precio de lista, debe proporcionar un valor para la moneda (por ejemplo, GB, EUR).	Una solución recomendada para evitar esto es agregar controles de validación dentro de su sistema para resaltar dónde no se han cumplido los requisitos mínimos.
4005034	No se admite el aumento del valor del costo. Use la función Edit Item Costs en Vendor/Seller Central.	No se permiten aumentos de costos. Use la función Edit Item Costs en Vendor/Seller Central. Si es necesario, puede utilizar el `Skip Cost Price` para eliminar el requisito de proporcionar un Precio de costo a través de la API.	Para evitar esto, utilice el ``API para mostrar los costos existentes. Además, envíe los aumentos de costos a través de la función 'Edit Item Costs' en Vendor/Seller Central para su aprobación antes del envío a través de las API cuando sea posible.
90225	Valor por `attribute_name` es más largo que el máximo permitido (unidad límite).	Algunos atributos tienen un límite máximo en la longitud del valor que se puede enviar. Reduzca la longitud del valor del atributo e intente enviarlo de nuevo. Consulte a continuación los atributos comunes con el número máximo de caracteres permitidos: `item_name` : 200 caracteres `generic_keyword` : 250 bytes `included_components` : 80 caracteres `externally_assigned_product_identifier` : se esperan 12 caracteres para UPC, 13 para EAN, 14 para GTIN
4005013	La información proporcionada coincide con un artículo que ya está en su catálogo (SKU: `matched_sku` ; COMO EN: `matched_asin` ). Los artículos no se pueden duplicar en su catálogo.	Este problema se devuelve cuando se envía un artículo y coincide con un ASIN existente que ya se agregó a la cuenta, o cuando un vendor desea editar un SKU en un ASIN existente. Un SKU es un atributo no editable y una vez que se crea el artículo, no se puede cambiar. El vendor debe usar el SKU original que usó para crear el artículo antes de editar cualquier otro atributo.	Cree un flujo de trabajo para mostrar cualquier dato de catálogo preexistente para el SKU usando el `y/o` API.
90180	El valor `boolean \| [false, true]` en el valor del campo para el atributo `attribute_name` tiene el tipo incorrecto. El tipo proporcionado es `STRING` mientras el tipo esperado es `BOOL` .	Una solución sería volver a enviar con el tipo esperado al que se hace referencia en el mensaje del problema. Ejemplo: el valor `number` en el campo `weight#1.value` para el atributo `battery` tiene el tipo incorrecto. El tipo proporcionado es `STRING` mientras el tipo esperado es `DECIMAL` .	Para evitar esto, agregue advertencias dentro de su sistema para informarle sobre el tipo esperado para ese valor.
4005007	Un partido por el valor de `attribute_name` no se pudo encontrar para la marca especificada. Corrija el valor y vuelva a enviar. Si el valor es correcto, comuníquese con su gerente de vendors para proporcionar documentación que verifique la afiliación entre el valor y la marca especificados.	Este problema se devuelve cuando el elemento enviado tiene una identificación externa que no está registrada para su uso con la marca proporcionada. Asegúrese de utilizar el valor adecuado (UPC, EAN o GTIN). Si es correcto, deberá proporcionar una prueba de afiliación entre la empresa en la que está registrado el ID externo y la marca que seleccionó (por ejemplo, un acuerdo de licencia). Deberá enviar la siguiente información: Identificación del seller Captura de pantalla del mensaje de problema o ID de envío o ID de lote. Marca exacta Título del producto UPC/EAN Marketplace Se debe adjuntar el Certificado GS1 para los UPC/EAN en el Artículo relacionado.	Comuníquese con nosotros: abra un caso a Soporte para desarrolladores si necesita soporte técnico o donde se indique en la guía de solución de problemas.
90244	Valor enumerado no válido `value` por atributo `attribute_name` .	Este problema significa que el valor proporcionado para el atributo no es válido. Ciertos atributos tienen valores estrictamente enumerados que el valor proporcionado debe coincidir exactamente. Asegúrese de llamar a la versión más reciente de la Product Type Definitions API y confirme que el tipo de producto en la carga JSON es correcto. Si este problema sigue sin resolverse, siempre puede enviar un ticket al Soporte para desarrolladores.	Consulte la Product Type Definitions API para obtener una lista de valores permitidos y asegúrese de que se reflejen en su sistema para evitar envíos fallidos.
4005033	El valor para `attribute_name` no se puede editar. Revertir el valor a `original_value` y vuelva a enviar.	Este problema se devuelve cuando intenta modificar un atributo no editable. El valor del atributo debe volver a cambiarse al original proporcionado en el mensaje de problema. Si el valor original es incorrecto y desea que se actualice el valor, debe enviar un caso de contacto que proporcione lo siguiente: Una lista de UPC/EAN El nombre del atributo a cambiar. el nuevo valor También puede haber algunos casos extremos en los que el valor original ya no se acepte al volver a enviarlo. Si este es el caso, también debe enviar un caso de contacto .	Cree un flujo de trabajo para mostrar cualquier dato de catálogo preexistente para el SKU usando el `y/o` API.
90248	El campo `field` para el atributo `attribute_name` tiene demasiados valores. El máximo permitido es valor(es) `allowed_count` (s), pero actualmente hay valores `actual_count` .	El campo especificado tiene más valores de los permitidos. Esto se asocia más comúnmente con los atributos de tamaño de prendas de vestir donde los valores dependen del tipo de producto. Ejemplo: `bottoms_size` no esperado para tipo de producto `shirt` . Para resolver esto, elimine o reduzca los valores según el mensaje del problema.	Para evitar esto, agregue restricciones para que solo se puedan seleccionar los atributos de tamaño de ropa relevantes para un tipo de producto en particular. Agregue controles de validación previa para otros, como la moneda, donde solo se espera un valor.
90114	Valor por `attribute_name` es menor que el mínimo requerido `limit`	Este problema se produce cuando no se alcanza el límite mínimo aceptable en el valor del atributo entero o decimal. Por lo general, este problema se ve con el precio de costo, la cantidad del paquete de caja y `items_per_inner_pack` . Pida al vendor que revise el mensaje de problema y corrija el envío ingresando un valor mínimo. Ejemplo: se espera que el precio de costo sea mayor que 0, por lo que esta entrada generaría un problema. cost_price: [{ "moneda": "GBP", "valor": 0 }]	Para evitar esto, agregue una verificación previa a la validación o una advertencia si el valor proporcionado es menor que el mínimo requerido.
90193	A valor `left_attribute_name` `left_attribute_value` no es menor que valor `right_attribute_name` `right_attribute_value`.	Ejemplo: un `cost_price` value '126.1' no es menor que valor `list_price` '33.21'.	Para evitar esto, proporcione un valor inferior al `right_attribute_value` .
90147	A valor `left_attribute_name` `left_attribute_value` no es menor o igual que valor `right_attribute_name` `right_attribute_value` .	Proporcione un valor menor o igual que el `right_attribute_value` mencionado en el mensaje de problema. Esto se debe más comúnmente a `item_weight` es menor que `item_package_weight` . Ejemplo: un `item_weight#1.value` valor `3.4` no es menor o igual que `item_package_weight#1.value` valor `6d-1` .	Agregue verificaciones previas a la validación dentro de su sistema para marcar si el `item_weight` es menor o igual a `item_package_weight` para que el vendor pueda tomar medidas correctivas antes del envío.
90221	Valor `value` para `attribute_name` debe ser mayor que el límite `limit`	Este problema generalmente se devuelve cuando un valor de Se ha enviado `0` por peso o costo. Ejemplo: Valor `0` para `item_package_weight` should be greater than the limit `0`.	Para evitar esto, agregue advertencias donde el valor ingresado esté por debajo del umbral dado. Los valores de costo y peso deben ser mayores que 0.
4005015	El ASIN proporcionado no coincide con el artículo existente en el catálogo de Amazon. Reemplace el valor con uno de los siguientes y vuelva a enviar: `attribute_value` .	Este problema se devuelve cuando Amazon Matching Service encontró un ASIN diferente en el catálogo en lugar del valor del atributo ASIN sugerido por el comerciante proporcionado. Deberá ingresar el ASIN coincidente al que se hace referencia en el mensaje de problema en la columna ASIN sugerido por el comerciante. Cualquier error tipográfico devolverá un error de ASIN no válido. Nota: Solicite al vendor que proporcione el valor del ASIN sugerido por el comerciante en mayúsculas.	Cree un flujo de trabajo para mostrar cualquier dato de catálogo preexistente para el SKU usando el `y/o` API.
4005008	El valor de `attribute_name` está restringido o no está registrado en GS1. Póngase en contacto con Amazon para proporcionar el certificado GS1 correspondiente.	Este problema se devuelve cuando una ID de producto externo está restringida o no está registrada en GS1. Si tiene prueba de propiedad del producto, comuníquese con Amazon para proporcionar el certificado GS1 correspondiente.	Verifique que el UPC/EAN/GTIN que proporcionó sea correcto.
99016	Un máximo de `max_count` ocurrencia(s) está(n) permitida(s) para el atributo `attribute_name` pero actualmente ocurre `actual_count` veces.	Esto ocurre cuando hay demasiadas entradas para un determinado nombre de atributo. Una solución sería eliminar cualquier entrada adicional y volver a enviar. Si el problema persiste, comuníquese con Soporte para desarrolladores para solicitar que eliminen los atributos duplicados. Ejemplo: Se permite un máximo de dos ocurrencias para el atributo `sport_type` pero actualmente ocurre cuatro veces. Para solucionar esto, el vendor debe eliminar dos de las entradas: "sport_type": [{ "language_tag", "en_GB", "value" : "Multi-Sport" }, { "language_tag" : "en_GB", "value" : "Surfing" }, { "language_tag" : "en_GB", "value" : "Snowboarding"}, { "language_tag" : "en_GB", "value" : "Cycling" }]	Para evitar esto, agregue una verificación previa a la validación o advertencias si proporciona más entradas de las permitidas.
90188	El valor no cumple con ISBN/UCCID. Requisitos de suma de comprobación para el atributo `attribute_name` .	El valor del atributo de ID de producto externo proporcionado no es válido. Cada `external_id_type` tiene un número esperado de caracteres. Revise y corrija para que cumplan con los siguientes requisitos: 12 caracteres esperados para UPC, 13 caracteres esperados para EAN, 14 caracteres esperados para GTIN.	Para evitar esto, agregue una advertencia dentro de su sistema si se viola la convención. Ejemplo: UPC seleccionado como tipo pero el identificador tiene 13 caracteres en lugar de los 12 esperados.
90226	Valor por `attribute_name` es más corto que el mínimo permitido (unidad límite).	Este problema se devuelve cuando los valores enviados son más cortos que un mínimo dado. Para solucionar esto, corrija el valor y vuelva a enviar. Ejemplo: Valor para `short_item_name` es más corto que el mínimo requerido (`X` caracteres). Los ejemplos más comunes de esto incluyen donde el valor de `externally_assigned_product_identifier` es más corto que el mínimo permitido.	Para evitar esto, aplique restricciones o advertencias a los valores en su sistema donde se conocen los mínimos permitidos.
4005022	Las dimensiones del paquete del artículo deben ser más pequeñas que las dimensiones del paquete de la jerarquía de paquetes que contiene el artículo.	Los valores de las dimensiones del paquete enviado (width, height, length, weight) no pueden ser mayores que los valores de su producto principal.	Para evitar esto, compare los valores de la dimensión con el producto principal y corrija los valores para que sean coherentes en toda la jerarquía.
4005001	La moneda proporcionada para `attribute_name` no coincide con la moneda existente para este artículo.	La moneda no coincide con este ASIN.	Comuníquese con nosotros: abra un caso a Soporte para desarrolladores si necesita soporte técnico o donde se indique en la guía de solución de problemas.
90194	El valor no cumple con la restricción de pattern para el atributo `attribute_name` . El valor debe coincidir con el pattern. `pattern`	Ejemplo: Valor para `[fabric_type]` does not meet pattern: % , e.g. 100% cotton.	Para evitar esto, proporcione el valor en el pattern dado en el mensaje de problema.
4005018	Los productos de marca de lujo requieren una categoría de producto de lujo o profesional.	Este es un producto de marca de lujo. Una categoría de producto que comienza con `Luxury` o Se debe seleccionar `Professional` . Si siente que su marca no es una marca de lujo, comuníquese con su punto de contacto de Amazon.	Para evitar esto, seleccione un `Luxury` Product Type.
90197	Valor por `attribute_name` es mayor que el máximo permitido `limit`	El problema ocurre cuando no se alcanza el límite máximo en el valor de atributo entero o decimal que es aceptable. Ejemplo: Valor para `[manufacturer_minimum_age]` es mayor que el máximo permitido (1188)	Para evitar esto, disminuya el valor e intente enviar de nuevo.
4005006	Ya existe un artículo en su catálogo por el valor de `attribute_name` y el valor de `attribute_name` no es editable. Para productos diferentes, vuelva a enviar con un valor diferente.	Este problema ocurre cuando intenta editar el valor de ID de producto externo para un artículo existente que el vendor ya tiene en su cuenta. El campo de ID de producto externo es un atributo no editable una vez que se crea el artículo. Deberá proporcionar el ID de producto externo original para continuar editando el artículo.	Cree un flujo de trabajo para mostrar cualquier dato de catálogo preexistente para el SKU usando el `y/o` API.
4005019	Las marcas que no sean de lujo no pueden presentarse para una categoría de producto de lujo o profesional.	El selling partner intentó incluir una marca de belleza que no es de lujo en una categoría de belleza de lujo. Pídale al selling partne que elija una categoría de producto que no sea `Luxury` o `Professional`	Si los Selling Partner desean vender en la categoría Belleza de lujo, pídales que trabajen directamente con sus gerentes de vendors de Amazon para habilitar esta categoría para ellos.
4000000	Ha ocurrido un error interno. Inténtalo de nuevo.	Hubo una falla interna y pudimos comunicarle más detalles sobre el problema.	Si el problema persiste después de dos intentos de prueba, envíe un ticket a Atención al cliente.
90199	Valor por `attribute_name` no debe contener etiquetas HTML.	No se puede incluir una etiqueta HTML en este campo. Para resolver esto, ingrese un valor que no incluya una etiqueta HTML.	Para evitar esto, agregue una verificación previa a la validación o una advertencia si el valor proporcionado contiene etiquetas HTML.
4005039	Tiene varios envíos para este artículo. Para editar uno de ellos, comuníquese con el Soporte de Amazon.	Hay múltiples contribuciones dentro del catálogo para este artículo. Plantee un caso de contacto a través de Vendor Central si es un vendor o soporte para desarrolladores si es un seller que indique: El problema encontrado La lista de EAN/UPC afectados SKU y código de vendor.	Requiere soporte de Amazon para resolver.
90196	Valor por `attribute_name` no debe contener una URL.	No se puede incluir una URL en este campo. Para solucionar esto, ingrese un valor que no incluya una URL.	Para evitar esto, agregue una verificación previa a la validación o una advertencia si el valor proporcionado contiene una URL.
4005038	El ID de producto que proporcionó difiere del que proporcionó anteriormente para el mismo SKU. Proporcione el ID del producto original.	Este problema ocurre porque un diferente `external_id` se ha asignado a un SKU existente. Si aún necesita actualizar este ID de producto externo (un atributo no editable), deberá comunicarse con el Soporte de Amazon.	Cree un flujo de trabajo para mostrar cualquier dato de catálogo preexistente para el SKU usando el `y/o` API.
4005002	El valor de `attribute_name` disminuido en más del valor máximo permitido. Reduzca el valor en una cantidad menor y vuelva a enviar.	Este problema ocurre porque no se permite una disminución drástica en el precio de costo. Debe revisar los precios de costo en caso de problemas. También puede utilizar el `Skip Cost Price` para eliminar el requisito de proporcionar un Precio de costo. Si desea modificar sus precios de costo, comuníquese con su punto de contacto de Amazon o envíe un caso a través de Amazon Support con ASIN/EAN precio anterior, precio nuevo y moneda.	Para evitar esto, utilice el ``API para mostrar los costos existentes
4005003	El valor de `attribute_name` no puede ser mayor que el precio de lista.	El precio de costo ingresado es mayor que el precio de lista.	Para evitar esto, proporcione el precio de costo menos que el precio de lista.
4000002	Un valor para `attribute_name` es obligatorio.	Falta un valor obligatorio para un atributo especificado. Proporcione el valor requerido para el atributo faltante como se especifica en el mensaje de problema.	Amazon realiza actualizaciones frecuentes de los esquemas PT. Los integradores y los Selling Partner deben mantenerse actualizados con los requisitos más recientes para evitar este problema. Esto puede hacerse de la siguiente manera: Implementar la Notifications API : `notification_type` `PRODUCT_TYPE_DEFINITIONS_CHANGE` para saber cuándo ocurren las actualizaciones. Actualice el esquema por su parte para obtener lo último de la Product Type Definitions API e identifique los atributos requeridos y requeridos condicionalmente y agréguelos a las comprobaciones de validación. Las versiones preliminares de las definiciones de tipos de productos se pueden recuperar con `release_candidate` .
4000003	El tipo de producto de Amazon especificado no es válido o no es compatible.	El tipo de producto de Amazon especificado no es válido o no es compatible. Las definiciones del tipo de producto ``se debe utilizar para verificar que el tipo de producto es válido. Nota: las definiciones de tipo de producto La operación se "roll up" en los tipos de productos principales y devolverá una respuesta 200 para los PT no lanzados. Si esto sucede, la respuesta Obtener API de Definiciones de tipo de producto tendrá el atributo `productType` establecido en el PT principal, normalmente `PRODUCT`	Para selling partners, seleccione un tipo de producto válido. Para los vendors, asegúrese de estar autorizado para vender ese tipo de producto antes de realizar el envío, como se indica en el Paso 1 de la Guía de casos de uso de la Product Type Definitions API .
4005035	El código de vendor proporcionado no es elegible para vender esta marca. Póngase en contacto con su gerente de vendors para su aprobación.	El código de vendor del vendor no está autorizado para vender esta marca. Para solucionar esto, póngase en contacto con su punto de contacto de Amazon.	El código de vendor proporcionado no es elegible para vender esta marca. Póngase en contacto con su gerente de vendors para su aprobación.
4005012	El valor proporcionado por `attribute_name` y código de vendor se asignan a un ASIN diferente.	El SKU ya está asignado a un ASIN diferente. Un solo código de vendor + SKU se puede asignar a un solo ASIN. Eleve un caso Contáctenos a Amazon para apoyar con la resolución.	Cree un flujo de trabajo para mostrar cualquier dato de catálogo preexistente para el SKU usando el `y/o` API.
18280	Valor de `attribute_name` no contiene un porcentaje (por ejemplo, algodón en lugar de 100% algodón).	Este problema ocurre cuando el selling partner no ha proporcionado una `fabric_type` en el formato esperado o cuando ya hay una mala valor `fabric_type` en el catálogo de contribuciones.	Si el selling partner proporcionó la atributo `fabric_type` en su solicitud, pídales que corrijan el formato para incluir el signo de porcentaje. Si el selling partner no proporcionó la atributo `fabric_type` en su solicitud y no quieren configurarlo, puede corregir el problema eliminando este atributo de la contribución.

Updated over 1 year ago