Solución de problemas de la API de artículos de listings

Contexto y solución de problemas comunes durante la integración de los artículos de los listados.

Solución de problemas de la API de artículos de listings

La API de artículos de listings proporciona acceso programático a los listings de los colaboradores comerciales en Amazon. Puedes crear, editar, eliminar y obtener detalles sobre los listings de Amazon (SKU) para un colaborador comercial. Esto incluye datos del producto, como el título del artículo, y condiciones de venta, como el precio y el inventario.

Listings data submitted to the Listings Items API abide by the JSON Schema format provided by the Selling Partner API for Product Type Definitions.

Los siguientes consejos para la solución de problemas pueden ayudarte si te encuentras con errores para un listing, ya sea durante el envío, durante el proceso o independientemente del proceso de envío.

¿Cómo se reciben los problemas de los listings?

Sincrónico frente a asincrónico

Al preparar un listing, pueden surgir problemas en varias etapas del proceso. Es posible que recibas notificaciones sincrónicas sobre problemas de envío a la API de listings que impidan la aceptación y el procesamiento posterior del envío. También puedes recibir notificaciones asincrónicas de problemas informados después del envío. También se pueden encontrar problemas al leer los datos del listing.

Un problema síncrono se genera cuando el servidor rechaza la solicitud durante la solicitud inicial. Probablemente se trate de un problema relacionado con atributos incorrectos o parámetros mal gestionados adjuntos a la solicitud.

Un Un problema asincrónico ocurre cuando una solicitud pasa la validación inicial pero devuelve un error después de procesar los datos recibidos. El problema devuelto adopta la forma de un mensaje que puede utilizarse para resolver el problema.

Procesamiento después del envío

Amazon lleva a cabo varias validaciones en los envíos realizados por los colaboradores comerciales. Algunas de estas validaciones se devuelven de forma sincrónica en respuesta a los envíos. Abarcan validaciones de datos en la propia entrada, como atributos obligatorios que faltan y atributos no válidos.

Si el envío supera las validaciones sincrónicas anteriores, se aceptará y se enviará para crear o actualizar el SKU. Hay varios procesos posteriores que se llevan a cabo 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 tratar adecuadamente todos los problemas posibles, el cliente debe hacerse cargo de los problemas notificados tanto de forma sincrónica como asincrónica.

Mensajes y códigos de problemas: qué significan y cómo evitarlos

Código de problema Problemas con los listings Descripción Detalles adicionales y acciones preventivas
90220 attribute_name es obligatorio pero no se proporciona. Este problema se genera cuando no se ha proporcionado un atributo obligatorio.

Ejemplo: item_package_dimensions es necesario pero no se ha suministrado. Proporciona información sobre el atributo obligatorio tal y como se indica en el mensaje del problema.
To avoid this, use the Product Type Definitions API to identify required attributes and add to validation checks. Use the Notifications API to be updated with instant updates of Product Type definitions.
4000001 El valor proporcionado para attribute_name no es válido. El valor proporcionado para el atributo especificado no es válido. Algunos atributos tienen listas restringidas de valores permitidos. Este problema suele estar asociado a la categoría de producto, la subcategoría de producto, la palabra clave del tipo de artículo o el nodo de navegación recomendado. Ten en cuenta que se deben cumplir las condiciones. Esto significa que solo se pueden seleccionar determinadas subcategorías para una determinada categoría de producto y solo se pueden seleccionar determinados nodos de navegación para determinadas subcategorías. To avoid this, use the Product Type Definitions API to verify permitted values and conditionality and ensure that they reflect the list of accepted values that can be selected within your system.
4005011 El valor attribute_name entra en conflicto con otro artículo del catálogo de Amazon, conflicting_asin. Cambia el valor a conflicting_value o ponte en contacto con Amazon para resolver el conflicto de datos. Este problema se genera cuando el envío tiene datos conflictivos con otro artículo del catálogo de Amazon. Deberás analizar la información del conflicto del ASIN y los atributos de referencia. Es posible que tengas que cambiar los datos enviados para solucionar el conflicto con los datos existentes.

Si deseas cambiar algún valor existente, deberás crear y enviar un caso de asistencia de Amazon.
Crea un proceso para revelar cualquier dato de catálogo preexistente para el SKU con la API y/o las API .
99022 El campo field_name para el atributo attribute_name no tiene suficientes valores. El mínimo requerido es min_occurrences valor(es). Valor mínimo no alcanzado. Este problema se genera cuando el valor enviado para un campo no cumple los requisitos mínimos o bien falta el valor. Analiza el mensaje del problema para identificar los valores/requisitos que faltan y pide al proveedor que los vuelva a enviar.

Ejemplo: se espera un mínimo de 1 del campo currency para el atributo list_price. Al añadir un precio sugerido, debes proporcionar un valor para la moneda (por ejemplo, GB, EUR).
Una solución recomendada para evitar esto es añadir comprobaciones de validación en tu sistema para resaltar dónde no se han cumplido los requisitos mínimos.
4005034 No es posible aumentar el valor del coste. Utiliza la función Editar costes de artículo en Vendor Central o en Seller Central. No se permiten aumentos de costes. Utiliza la función Editar costes de artículo en Vendor Central o en Seller Central. Si es necesario, puedes utilizar el atributo Skip Cost Price para eliminar el requisito de proporcionar un precio de coste a través de la API. Para evitarlo, utiliza la API para revelar los costes existentes. Además, siempre que sea posible, envía los aumentos de costes a través de la función "Editar costes de artículo" en Vendor Central o en Seller Central para su aprobación antes de enviarlos a través de las API.
90225 El valor de attribute_name es superior al máximo permitido (límite de unidades). Algunos atributos tienen un límite máximo en el tamaño del valor que se puede enviar. Reduce el tamaño del valor del atributo e intenta enviarlo de nuevo.
A continuación, se muestran 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 y 14 para GTIN
4005013 La información proporcionada corresponde a un artículo que ya está en tu catálogo (SKU: matched_sku; ASIN: matched_asin). Los artículos no se pueden duplicar en el catálogo. Este problema se genera cuando se envía un artículo y coincide con un ASIN existente que ya se ha añadido a la cuenta, o cuando un proveedor desea editar un SKU en un ASIN existente. Un SKU es un atributo no editable y, una vez creado, el artículo no puede modificarse. El proveedor debe usar el SKU original utilizado para crear el artículo antes de editar cualquier otro atributo. Crea un proceso para revelar cualquier dato de catálogo preexistente para el SKU con la API y/o las API .
90180 El valor de Boolean | [false, true] del valor de campo del atributo attribute_name es de tipo incorrecto. El tipo proporcionado es STRING mientras que el tipo esperado es BOOL. Una solución es volver a realizar el envío con el tipo esperado al que se hace referencia en el mensaje del problema.

Ejemplo: el valor de number en el campo weight#1.value para el atributo battery tiene un tipo incorrecto. El tipo proporcionado es STRING mientras que el tipo esperado es DECIMAL.
Para evitar que esto suceda, añade advertencias en tu sistema para informar sobre el tipo esperado para este valor.
4005007 No se ha encontrado ninguna coincidencia con el valor de attribute_name de la marca especificada. Corrige el valor e inténtalo de nuevo. Si el valor es correcto, ponte en contacto con el responsable de proveedores para que proporcione documentación que demuestre la afiliación entre el valor y la marca especificada. Este problema se genera cuando el artículo enviado tiene un ID externo que no está registrado para su uso con la marca proporcionada. Comprueba que estás utilizando el valor adecuado (UPC, EAN o GTIN).

Si es correcto, tendrás que proporcionar una prueba de afiliación entre la empresa en la que está registrado el ID externo y la marca seleccionada (por ejemplo, un acuerdo de licencia).

Deberás enviar la siguiente información:
  • ID de vendedor
  • Captura de pantalla del mensaje del problema o ID de envío o ID de lote.
  • Nombre de la marca exacto
  • Título del producto
  • UPC/EAN
  • Sitio web
  • El certificado GS1 para UPC/EAN debe adjuntarse al artículo relacionado.
Contact Us: Open a case to Developer Support if you require technical support or where indicated in the troubleshooting guide.
90244 Valor enumerado no válido value para el atributo attribute_name. This issue means the provided value for the attribute is not valid. Certain attributes have hard enumerated values which the provided value must match exactly.

Ensure you are calling the latest version of the Product Type Definitions API and confirm that the Product Type in the JSON payload is correct.

If this issue still remains unresolved, you can always submit a ticket to Developer Support.
Reference the Product Type Definitions API for a list of permitted values and ensure that they are reflected in your system to prevent failed submissions.
4005033 El valor de attribute_name no se puede editar. Cambia el valor a original_value y vuelve a realizar el envío. This issue is returned when you attempt to modify an un-editable attribute. The attribute value should be changed back to the original provided in the issue message. If the original value is incorrect and you wish to have the value updated, then a Contact Us case should be submitted providing the following:
  • Una lista de UPC/EAN
  • El nombre del atributo que se va a modificar
  • El valor nuevo
There can also be edge cases where the original value is no longer be accepted upon resubmission. If this is the case, you should also submit a Contact Us case.
Crea un proceso para revelar cualquier dato de catálogo preexistente para el SKU con la API y/o las API .
90248 El campo field para el atributo attribute_name tiene demasiados valores. El número máximo permitido de valores es allowed_count, pero actualmente hay actual_count valores. El campo especificado tiene más valores de los permitidos. Esto suele ocurrir con los atributos relacionados con las tallas de ropa, cuyos valores dependen del tipo de producto.

Ejemplo: bottoms_size no esperado para el tipo de producto shirt. Para solucionarlo, elimina o reduce los valores en función del mensaje del problema.
Para evitarlo, añade restricciones para que solo se puedan seleccionar los atributos de talla de ropa relevantes para un tipo de producto determinado. Añade comprobaciones de validación previa para otros atributos, como la divisa, para los que solo se espera un valor.
90114 El valor de attribute_name es inferior al mínimo exigido limit. Este problema se genera cuando no se alcanza el límite mínimo aceptable en el valor del atributo entero o decimal. Normalmente, este problema se observa con el precio de coste, la cantidad de embalaje y items_per_inner_pack.

Pide al proveedor que analice el mensaje del problema y corrija el envío introduciendo un valor mínimo.

Ejemplo: se espera que el precio de coste sea superior a 0, por lo que esta entrada generaría un problema.
cost_price: [{
    "currency" : "GBP",
    "value" : 0
}]
Para evitarlo, añade una comprobación previa a la validación o una advertencia si el valor proporcionado es inferior al mínimo requerido.
90193 El valor de left_attribute_name left_attribute_value no es menor que el valor de right_attribute_name right_attribute_value. Ejemplo: el valor de cost_price "126,1" no es menor que el valor de list_price "33,21". Para evitarlo, proporciona un valor menor que right_attribute_value.
90147 El valor de left_attribute_name left_attribute_value no es menor que o igual al valor de right_attribute_name right_attribute_value. Proporciona un valor menor o igual que el right_attribute_value mencionado en el mensaje del problema.

Esto se debe normalmente a que item_weight es menor que item_package_weight.

Ejemplo: un valor de item_weight#1.value de 3.4 no es menor o igual que el valor de item_package_weight#1.value 6d-1.
Añade comprobaciones de validación previa en tu sistema para señalar si item_weight es menor o igual que item_package_weight, de modo que el proveedor pueda adoptar medidas correctivas antes del envío.
90221 El valor de value para attribute_name debe ser mayor que el límite limit. Este problema suele aparecer cuando se ha enviado un valor de 0 para el peso o el coste. Ejemplo: el valor de 0 para item_package_weight debe ser mayor que el límite 0. Para evitarlo, añada advertencias en las que el valor introducido sea inferior al valor umbral indicado. Los valores de coste y peso deben ser superiores a cero.
4005015 El ASIN proporcionado no coincide con el artículo del catálogo de Amazon. Sustituye el valor por uno de los siguientes y vuelve a realizar el envío: attribute_value. Este problema se genera cuando el servicio de correspondencias de Amazon encuentra un ASIN diferente en el catálogo en lugar del valor de atributo proporcionado de ASIN sugerido por el vendedor.

Deberás introducir el ASIN correspondiente al que se hace referencia en el mensaje del problema en la columna ASIN sugerido por el vendedor. Cualquier error de escritura generará un error de ASIN no válido.

Nota: pide al proveedor que introduzca el valor del ASIN sugerido por el vendedor en mayúsculas.
Crea un proceso para revelar cualquier dato de catálogo preexistente para el SKU con la API y/o las API .
4005008 El valor de attribute_name está restringido o no está registrado en GS1. Ponte en contacto con Amazon para que te facilite el certificado GS1 correspondiente. Este problema se genera cuando un ID de producto externo está restringido o no está registrado en GS1. Si dispones de una prueba de propiedad del producto, ponte en contacto con Amazon para que te proporcione el certificado GS1 correspondiente. Comprueba que el UPC/EAN/GTIN proporcionado sea correcto.
99016 Se permite un máximo de max_count entradas para el atributo attribute_name, pero actualmente aparece actual_count veces. This occurs when there are too many entries for a certain attribute name. A solution would be to remove any additional entries and resubmit. If the issue persists, contact Developer Support to request that they delete the duplicate attributes.

Example: A maximum of two occurrence are allowed for the attribute sport_type but it currently occurs four times. In order to fix this, the vendor should remove two of the entries:
"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 evitarlo, añade una comprobación previa a la validación o advertencias si proporcionas más entradas de las permitidas.
90188 El valor no cumple con ISBN/UCCID. Requisitos de la suma de comprobación para el atributo attribute_name. El valor del atributo ID de producto externo proporcionado no es válido. Cada external_id_type tiene un número de caracteres esperado. Analízalos y corrígelos para que cumplan los siguientes requisitos: 12 caracteres esperados para UPC, 13 caracteres esperados para EAN, 14 caracteres esperados para GTIN. Para evitarlo, añade una advertencia en tu sistema si se infringe la convención. Ejemplo: el UPC se ha seleccionado como tipo, pero el identificador tiene 13 caracteres en lugar de los 12 esperados.
90226 El valor de attribute_name es inferior al mínimo permitido (límite de unidades). Este problema se genera cuando los valores enviados son inferiores a un número mínimo determinado. Para solucionarlo, corrige el valor y vuelve a realizar el envío.

Ejemplo: el valor de short_item_name es inferior al mínimo requerido (X caracteres). Ejemplos comunes de esto son cuando el valor de externally_assigned_product_identifier es inferior al mínimo permitido.
Para evitarlo, aplica restricciones o advertencias a los valores de tu sistema en los que se conozcan los mínimos permitidos.
4005022 Las dimensiones del embalaje del artículo deben ser inferiores a las dimensiones del embalaje de la jerarquía de embalajes que contiene el artículo. Los valores de las dimensiones del embalaje enviado (anchura, altura, longitud, peso) no deben ser superiores a los valores del producto parent. Para evitarlo, compara los valores de las dimensiones con el producto parent y corrige los valores para que sean coherentes en toda la jerarquía.
4005001 La divisa proporcionada para attribute_name no coincide con la divisa actual de este artículo. La divisa no coincide con este ASIN. Contact Us: Open a case to Developer Support if you require technical support or where indicated in the troubleshooting guide.
90194 El valor no cumple la restricción de patrón para el atributo attribute_name. El valor debe coincidir con el patrón pattern. Ejemplo: el valor para [fabric_type] no cumple el patrón: <percentage value>% <fabric name>, por ejemplo, 100 % algodón. Para evitarlo, proporciona el valor en el patrón indicado en el mensaje del problema.
4005018 Los productos de marcas de lujo requieren una categoría de producto profesional o de lujo. Se trata de un producto de marca de lujo. Debe seleccionarse una categoría de producto que empiece por Luxury o Professional. Si crees que tu marca no es una marca de lujo, ponte en contacto con tu representante de Amazon. Para evitarlo, selecciona un tipo de producto de Luxury.
90197 El valor de attribute_name es superior al máximo exigido limit. El problema se genera cuando no se alcanza el límite máximo aceptable del atributo entero o decimal. Ejemplo: el valor de [manufacturer_minimum_age] es superior al máximo permitido (1188). Para evitarlo, disminuye el valor e intenta volver a realizar el envío.
4005006 Ya existe un artículo en tu catálogo con el valor de attribute_name y el valor de attribute_name no es editable. En el caso de productos diferentes, envíalos de nuevo con un valor diferente. Este problema se genera cuando intentas editar el valor de ID de producto externo para un artículo existente que el proveedor ya tiene en su cuenta. El campo ID de producto externo es un atributo no editable una vez que se ha creado el artículo.

Deberás proporcionar el ID de producto externo original para continuar editando el artículo.
Crea un proceso para revelar cualquier dato de catálogo preexistente para el SKU con la API y/o las API .
4005019 Las marcas que no son de lujo no se pueden enviar a una categoría de productos profesionales o de lujo. El colaborador comercial ha intentado incluir una marca de belleza que no es de lujo en una categoría de belleza de lujo. Pide al colaborador comercial que elija una categoría de producto distinta de Luxury o Professional. Si los colaboradores comerciales quieren vender en la categoría Belleza de lujo, pídeles que trabajen directamente con sus responsables de proveedores de Amazon para que habiliten esta categoría para ellos.
4000000 Se ha producido un error interno. Inténtalo de nuevo. Se ha producido un error interno y hemos podido proporcionarte más detalles sobre el problema. Si el problema persiste después de dos intentos de prueba, envía un ticket al servicio de atención al cliente.
90199 El valor de attribute_name no debe contener etiquetas HTML. No es posible incluir una etiqueta HTML en este campo. Para solucionarlo, introduce un valor que no incluya una etiqueta HTML. Para evitarlo, añade una advertencia o comprobación previa a la validación si el valor proporcionado contiene etiquetas HTML.
4005039 Tienes varios envíos para este artículo. Para editar uno de ellos, ponte en contacto con la asistencia de Amazon. There are multiple contributions within the catalog for this item. Raise a Contact Us case via Vendor Central if you're a vendor or Developer Support if you're a seller that states:
  • Se ha encontrado un problema
  • La lista de EAN/UPC afectados
  • SKU y código de proveedor.
Requiere asistencia por parte de Amazon para resolverlo.
90196 El valor de attribute_name no debe contener una URL. No es posible incluir una URL en este campo. Para solucionarlo, introduce un valor que no incluya una URL. Para evitarlo, añade una advertencia o comprobación previa a la validación si el valor proporcionado contiene una URL.
4005038 El ID de producto que has proporcionado es diferente del que proporcionaste anteriormente para el mismo SKU. Proporciona el ID de producto original. Este problema se genera porque se ha asignado un external_id diferente a un SKU existente.
Si aún necesitas actualizar este ID de producto externo (un atributo no editable), deberás ponerte en contacto con el servicio de asistencia de Amazon.
Crea un proceso para revelar cualquier dato de catálogo preexistente para el SKU con la API y/o las API .
4005002 El valor de attribute_name ha disminuido por encima del valor máximo permitido. Reduce el valor en una cantidad menor e inténtalo de nuevo. Este problema se genera porque no se permiten reducciones drásticas del precio de coste. Debes revisar los precios de coste en caso de que haya problemas. También puedes utilizar el atributo Skip Cost Price para eliminar el requisito de proporcionar un precio de coste. Si deseas cambiar tus precios de coste, ponte en contacto con tu representante de Amazon o envía un caso a través del servicio de asistencia de Amazon con el precio antiguo del ASIN/EAN, el precio nuevo y la divisa. Para evitarlo, utiliza la API para revelar los costes existentes
4005003 El valor de attribute_name no puede ser superior al precio sugerido. El precio de coste introducido es superior al precio sugerido. Para evitarlo, indica un precio de coste inferior al precio sugerido.
4000002 Se requiere un valor para attribute_name. Falta un valor obligatorio para un atributo especificado. Proporciona el valor necesario para el atributo que falta, tal y como se especifica en el mensaje del problema. Amazon makes frequent updates to PT schemas. Integrators and Selling Partners need to stay updated with the latest requirements in order to prevent this issue. This can be done as follows:

Implement the Notifications API: notification_type PRODUCT_TYPE_DEFINITIONS_CHANGE to to know about when the updates happen.

Refresh the schema on your end to pull the latest from the Product Type Definitions API and identify required and conditionally required attributes and add them to validation checks. Pre-release versions of product type definitions can be retrieved with 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.

La operación de definiciones de tipo de producto debe utilizarse para comprobar que el tipo de producto sea válido.

Nota: la operación de definiciones de tipo de producto será "acumulativa" para los tipos de producto parent y devolverá una respuesta 200 para los PT no publicados. Si esto ocurre, la respuesta de la API para obtener definiciones de tipos de producto tendrá el atributo productType establecido en el PT parent, normalmente PRODUCT.
For selling partners, select a valid Product Type.

For vendors, ensure that you are authorized to sell for that Product Type prior to making the submission, as stated in Step 1 of the Product Type Definitions Use Case Guide.
4005035 El código de proveedor introducido no está cualificado para vender esta marca. Ponte en contacto con el responsable de proveedores para obtener la autorización. El código de proveedor del proveedor no tiene autorización para vender esta marca. Para resolver este problema, ponte en contacto con tu representante de Amazon. El código de proveedor introducido no está cualificado para vender esta marca. Ponte en contacto con el responsable de proveedores para obtener la autorización.
4005012 El valor proporcionado para attribute_name y el código de proveedor están asignados a un ASIN diferente. The SKU is already assigned to a different ASIN. A single vendor code + SKU can be assigned to only one ASIN. Raise a Contact Us case to Amazon to support with resolution. Crea un proceso para revelar cualquier dato de catálogo preexistente para el SKU con la API y/o las API .
18280 El valor de attribute_name no contiene un porcentaje (por ejemplo, algodón en lugar de 100 % algodón). Este problema se genera cuando el colaborador comercial no proporciona un fabric_type en el formato esperado o cuando ya existe un valor incorrecto de fabric_type en el catálogo de contribuciones. Si el colaborador comercial ha proporcionado el atributo fabric_type en la solicitud, pídele que corrija el formato para incluir el signo de porcentaje.

Si el colaborador comercial no ha proporcionado el atributo fabric_type en la solicitud y no desea establecerlo, puedes corregir el problema excluyendo este atributo de la contribución.

¿Te ha ayudado esta página?