Preguntas frecuentes sobre errores de SP-API

• Su aplicación MWS debe estar publicada.
• La aplicación MWS publicada debe convertirse en una aplicación SP-API híbrida.
• La aplicación SP-API híbrida debe publicarse en la Amazon Selling Partner Appstore .
• Todos los ID de desarrollador de MWS deben agregarse a la aplicación SP-API híbrida y el seller debe autorizar la aplicación SP-API o la aplicación SP-API híbrida que está utilizando en MWS.

La solicitud debe ser publicada. Para publicar su aplicación, siga los pasos a continuación:

1. Inicie sesión en Seller Central con las credenciales que utilizó para registrarse como desarrollador.
2. En el menú Appstore, seleccione Desarrollo de Aplicaciones . Aparecerá la página de Central de desarrolladores.
3. Elija el menú desplegable en el lado derecho de su aplicación y seleccione "Editar listado".
4. Edite los valores en la página que desea actualizar y asegúrese de que no falte información en las tres secciones del proceso: información de la aplicación, precios y detalles de la aplicación.
5. Si la información no está completa, verá la opción "Guardar y salir" al final del tercer paso. Regrese y asegúrese de haber ingresado toda la información requerida.
6. Una vez que haya ingresado toda la información requerida, elija "Guardar y enviar" para confirmar y enviar su aplicación para su publicación.

Una vez que esto se complete, el equipo de verificación de la aplicación borrará la aplicación y se creará automáticamente un caso. Recibirá una notificación de que la aplicación será aprobada dentro de los 10 días, lo que le permitirá realizar llamadas para terceros. Con fines de prueba, puede realizar llamadas desde su propia cuenta a través de una llamada de autoautorización.

Si el problema persiste, comuníquese con Soporte para desarrollador .

Para resolver este error:

• Asegúrese de que su aplicación híbrida se haya publicado por completo. Después de la revisión, recibirá una notificación de Amazon verificando que su aplicación está completamente publicada.
• Verifique que los roles SP-API se hayan agregado a su aplicación híbrida publicada.

En la API de selling partner, el algoritmo del depósito de tokens limita las tasas de solicitud. Consulte Planes de uso y límites de velocidad en SP-API para obtener más información sobre cómo evitar errores de limitación.

Operaciones por lotes

Actualmente, las siguientes operaciones por lotes están disponibles para SP-API:

• searchCatalogItems
• getItemOffersBatch
• getListingOffersBatch
• getMyFeesEstimates

Consulte el anuncio de lanzamiento de SP-API de mayo de 2022 para obtener más información.

API de notificación

Esta API envía notificaciones en lugar de tener que enviar varias solicitudes a otras API. Consulte la Guía de casos de uso de la API de notificaciones v1 para obtener más información.

Limitador de velocidad

Consulte la publicación de blog Estrategias para optimizar los límites de velocidad para las cargas de trabajo de su aplicación para obtener información sobre cómo implementar un limitador de velocidad del lado del cliente.

Revise los Endpoint de SP-API .

El estado de la transacción será compatible con las siguientes operaciones de la API:

• Confirmar pedido
• Enviar confirmaciones de envío
• Enviar actualizaciones de estado de envío
• Solicitud de etiqueta de envío
• Fuente de inventario

Si el estado de la transacción es "Procesando" y no se actualiza a "Error" o "Éxito" después de 5 minutos, eso indica que la transacción no se completó con éxito en nuestro sistema. El estado "Éxito" estará allí si la transacción es exitosa y se proporcionará un código de error para "Error".

No puede usar esta API para los mensajes de "Factura", ya que no se admiten para verificar y el estado siempre será "Procesando".

Para las solicitudes de etiquetas de envío, si la transacción falla con un código de motivo como "Error interno del servidor", que son errores de terminal, debe crear un caso de "contáctenos" para investigar la causa. Esto generalmente sucede debido a restricciones operativas.

Los parámetros de operación deben ser llenados correctamente. Considere estos puntos al completar los parámetros para realizar la llamada a la API:

• Los números de factura deben ser únicos y nunca deben reutilizarse (incluso después de un año).
• Si una factura enviada por API ha fallado debido a datos incorrectos, pero la factura en papel tiene los datos correctos, el vendor debe actualizarla a través de API con los datos correctos bajo la misma ID de factura.
• Si la factura tiene datos incorrectos (tanto en papel como en API), la factura se cancela y se debe enviar una nueva factura con una nueva ID de factura.
• No se debe enviar ninguna factura con monto total "0", ya que esto provocaría que la factura fallara.
• Amazon requiere los detalles completos de la dirección en los segmentos de dirección por motivos de cumplimiento fiscal. Esto es especialmente importante para el destinatario de la factura. Para este segmento, el sistema Amazon Payee requiere una coincidencia exacta.
• Los términos de pago enviados en la factura deben coincidir con los términos de pago acordados con el comprador de Amazon
• El identificador del producto del artículo debe coincidir con el identificador del producto del artículo del pedido que se envió al vendor en la orden de compra correspondiente. El monto total de la factura debe ser igual a la suma total de los artículos, cargos y descuentos.
• El monto total del impuesto para cada nivel de línea debe ser igual al monto total del impuesto en el nivel del header.
• La cantidad total de la factura debe coincidir con la suma de la cantidad de todos los artículos. Cada uno de los diferentes cargos y asignaciones debe detallarse en el nivel del header.

Si uno de estos parámetros falta o se completó incorrectamente, esto hará que la llamada a la API recupere detalles incorrectos. Asegúrese de proporcionar la información requerida al enviar la operación.

Este error puede deberse al uso de ciertas etiquetas HTML, en particular etiquetas de header. <h1><h2><h3><h4>. Remove these header tags and only use the tags that are provided in the text editor.

Este error también puede indicar que el estado de la cuenta pasó a inactivo debido a la falta de actividad. Puede actualizar la información de su tarjeta de crédito para reactivar la cuenta. La próxima vez que inicie sesión en Seller Central, será redirigido a la página de actualización de la tarjeta de crédito. Su cuenta se restablecerá aproximadamente 48 horas después de que se haya actualizado la tarjeta de crédito.

Para resolver este error, enumere su aplicación con los siguientes pasos:

1. Accede a Central de desarrolladores .
2. Seleccione Edit App para la aplicación que desea incluir en la lista y elija Crear listado en la lista desplegable.
3. Ingresa la información de la aplicación.
4. Envíe su aplicación.

Si recibe un error de Acceso denegado para su solicitud de API, consulte los consejos de resolución de problemas para Acceso denegado a la fuente solicitada .

Cuando envía solicitudes HTTP a la API de selling partner, firma las solicitudes para que Amazon pueda identificar quién las envió. Usted firma las solicitudes con sus claves de acceso de AWS, que consisten en un ID de clave de acceso y una clave de acceso secreta. Si registró su aplicación con un rol de IAM, debe utilizar AWS Security Token Service (AWS STS) para solicitar claves de acceso temporales de AWS para firmar sus solicitudes.

Restringir el acceso al rol de IAM o al usuario de IAM en la Política de control de servicios (SCP) puede causar errores de acceso denegado . Si usa la Política de control de servicios (SCP) para administrar los permisos de acceso para su organización, asegúrese de que SCP no restrinja el usuario de IAM o la función de IAM para la cuenta de miembro.

Para obtener más información sobre el uso de AWS STS y los SDK de AWS que pueden ayudarlo con su implementación, consulte Solicitud de credenciales de seguridad temporales en la documentación de AWS.

Si el error persiste, registre un caso de soporte con Amazon para solucionar el problema. Incluya los siguientes detalles en el caso de soporte:

• ID de aplicación
• Solicitar ID con marca de tiempo
• Operación API (especificar si es una solicitud de sandbox (entorno de pruebas))
• Respuesta de error recibida

Si recibe 500 Error interno del servidor, verifique que Content-Type header esté configurado en application/x-www-form-urlencoded y los parámetros de solicitud se agregan al cuerpo y no como parámetros de consulta.

El sandbox (entorno de pruebas) de SP-API funciona como muchos marcos de prueba; utiliza la coincidencia de patrones para devolver una respuesta específica cuando los parámetros especificados están presentes. Un desarrollador recibe una respuesta definida en el objeto x-amazon-spds-sandbox-behaviors cuando envían una solicitud que coincide con los parámetros especificados.

Si la solicitud enviada al extremo de la zona de pruebas no coincide con los valores de los parámetros en el objeto x-amazon-spds-sandbox-behaviors , recibirá un "Error interno del servidor 500" en la respuesta. Debe enviar la solicitud con los valores exactos especificados en el modelo.

Si la API requiere algún parámetro que no esté especificado en el objeto x-amazon-spds-sandbox-behaviours , el sandbox (entorno de pruebas) proporciona la respuesta independientemente de los valores de los parámetros en la solicitud, siempre que la solicitud sea válida.

Para obtener más información sobre cómo realizar una llamada de sandbox (entorno de pruebas) a SP-API, consulte la sección Sandbox de API de selling partner de la Guía para desarrollador de API de selling partner .

OAuth es el proceso de autorización que otros sellers iniciarán para autorizar su aplicación en la Appstore.

Si incluyes el version=beta parámetro , el flujo de trabajo autoriza una aplicación en estado Borrador. Si no incluye el parámetro version=beta , el flujo de trabajo autorizará una versión publicada de esa ID de aplicación en Appstore; de lo contrario, devolverá un código de error "MD1000".

Si tiene una aplicación SP-API que no está publicada pero el flujo de trabajo de OAuth apunta al flujo de trabajo de producción, se devuelve este error. Para resolver, confirme que la aplicación está en etapa de Borrador. Si es así, agregue versión = parámetro beta para el URI de autorización de OAuth construido. Una vez que se publica la aplicación, este parámetro se puede eliminar.

El MD5100 puede deberse a los siguientes problemas:

• Errores en la URL de autorización de OAuth.
• Faltan enlaces de redirección en la aplicación.
• Si un usuario intenta autorizar la aplicación híbrida en un mercado o región que no se agregó en la aplicación.
• Fragmentos en la URL.

Pruebe estas soluciones para resolver un error MD5100:

• Consulta el estado de la solicitud:
• Si la aplicación está en estado de borrador, verifique que la URL incluya version=beta.
• Si la aplicación está publicada, verifique que la URL no incluya version=beta. Si se incluye version=beta en la URL, el proceso de OAuth se inicia para el estado de borrador de la aplicación en lugar del estado publicado.
• • Si su aplicación es solo para Amazon MWS y está tratando de autoautorizar la aplicación, conviértala en una aplicación híbrida registrándose en SP-API. Para obtener más información, consulte Self-Authorization (autoautorización) .
• Verifique que haya seguido todos los pasos para Autorizar las aplicaciones API de selling partner .
• Para aplicaciones híbridas, asegúrese de haber agregado la ID de desarrollador de MWS para cada región (NA|EU|FE) donde opera. Puede agregar el ID de desarrollador de MWS editando su aplicación en Central de desarrolladores. Para obtener más información, consulte Crear una aplicación híbrida .
• Verifique que su aplicación tenga un URI de inicio de sesión y un URI de redirección. Puede actualizar el URI de inicio de sesión y el URI de redireccionamiento editando su aplicación en Central de desarrolladores y actualizando los detalles del URI de inicio de sesión y el URI de redireccionamiento.
• Verifique que la aplicación sea compatible con el mercado en el que se autoriza al desarrollador. En Central de desarrolladores, elija la opción Edit lista para su aplicación y, en la sección Precios, elija los mercados que debe admitir la aplicación.

Si después de revisar estos detalles el problema persiste, envíe un caso de soporte .

Este error ocurre cuando intenta autorizar una aplicación como usuario secundario. Para evitar este error, comuníquese con el propietario de la cuenta y pídale que realice esta acción por usted.

Este error se produce en los siguientes escenarios:

• Cuando intenta autoautorizar una aplicación que solo tiene credenciales de Amazon MWS, o
• Cuando intenta utilizar una aplicación híbrida globalmente pero las credenciales de Amazon MWS son válidas solo para una región o mercado específico.

Pruebe estas soluciones para resolver los errores MD9000:

• Consulta el estado de la solicitud:

• Si la aplicación está en estado draft , verifique que la URL incluya version=beta..

• Si la aplicación está published , verifique que la URL no incluya version=beta. Si se incluye version=beta en la URL, el proceso de OAuth se inicia para el estado de borrador de la aplicación en lugar del estado publicado.

• Si su aplicación es solo para Amazon MWS y está intentando autoautorizar la aplicación, conviértala en una aplicación híbrida registrándose en SP-API. Para obtener más información, consulte Self-Authorization (autoautorización) .

• Verifique que haya seguido todos los pasos para Autorizar las aplicaciones API de selling partner .

• Para aplicaciones híbridas, asegúrese de haber agregado la ID de developer de MWS para cada región (NA|EU|FE) donde opera. Puede agregar el ID de desarrollador de MWS editando su aplicación en Central de desarrolladores. Para obtener más información, consulte Crear una aplicación híbrida .

• Verifique que su aplicación tenga un URI de inicio de sesión y un URI de redirección. Puede actualizar el URI de inicio de sesión y el URI de redireccionamiento editando su aplicación en Central de desarrolladores y actualizando los detalles del URI de inicio de sesión y el URI de redireccionamiento.

• Verifique que la aplicación sea compatible con el mercado en el que se autoriza al desarrollador. En Central de desarrolladores, elija la opción Edit listing para su aplicación y, en la sección Precios, elija los mercados que debe admitir la aplicación.

Si el problema persiste, envíe un caso de soporte .

Compruebe si a su aplicación le faltan el URI de inicio de sesión y el URI de redireccionamiento. Puede actualizar el URI de inicio de sesión y el URI de redirección editando la aplicación. Vaya a Appstore > Develop Apps y elija Edit App para la aplicación que está utilizando para ver el formulario de registro de la aplicación y actualizar los detalles de URI de inicio de sesión y URI de redirección.

El SKU que está utilizando puede tener caracteres especiales, como una barra inclinada hacia adelante o hacia atrás (\, / ), que requieren codificación de URL. Esto se puede hacer programáticamente en varios lenguajes. Aquí hay un ejemplo en Java:

import java.net.URLEncoder;
import java.nio.charset.StandardCharsets;
import java.io.UnsupportedEncodingException*;*

 // Method to encode a SKU using the UTF-8 encoding scheme  
  private static String encodeSKU(String sSKU) {  
    try {  
      return URLEncoder.encode(sSKU, StandardCharsets.UTF_8.toString());  
    } catch (UnsupportedEncodingException ex) {  
      e_._printStackTrace_();\_  
    }  
  }

Consulte Codificación de URL para obtener más información.