Preguntas frecuentes sobre errores de la SP-API

Preguntas frecuentes sobre errores de la SP-API.

Sugerencia

Para comprobar el estado actual de todas las API de SP, consulte la Panel de estado de la API. Puedes acceder al panel de estado de la API en cualquier momento seleccionando el Estado de la API botón en la esquina superior derecha del sitio de documentación de SP-API.

Errores comunes

¿Por qué recibo un null ¿valor de enumeración?

Selecciona esta opción para ampliar la respuesta.

Estás usando una versión de modelo anticuada. Actualice la versión del modelo Swagger en su integración (por ejemplo, regenere las bibliotecas cliente) e inténtelo de nuevo.

¿Cómo puedo evitar errores de limitación?

Selecciona esta opción para ampliar la respuesta.

En la SP-API, la algoritmo token bucket limita las tasas de solicitud. Para obtener información sobre cómo evitar errores de limitación, consulte Planes de uso y límites de tarifas en la SP-API.

Operaciones por lotes

Las siguientes operaciones por lotes están disponibles para SP-API:

Para obtener más información, consulte la Anuncio de lanzamiento de SP-API en mayo de 2022.

API de notificaciones

Esta API envía notificaciones en lugar de que tengas que enviar varias solicitudes a otras API. Para obtener más información, consulte la Guía de casos de uso de la API de notificaciones v1.

Limitador de tasa

Para obtener información sobre cómo implementar un limitador de velocidad del lado del cliente, consulte Optimice los límites de velocidad para las cargas de trabajo de las aplicaciones.

¿Por qué recibo un mensaje "En proceso" para la llamada a la API de transacciones?

Selecciona esta opción para ampliar la respuesta.

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

  • Confirmación del pedido
  • Enviar confirmaciones de envío
  • Enviar actualizaciones sobre el estado del envío
  • Solicitud de etiqueta de envío
  • Fichero de inventario

Si el estado de la transacción no ha cambiado desde Processing a Failure o Success transcurridos 5 minutos, la transacción no se ha completado correctamente en nuestro sistema. Si el estado de la transacción es exitoso, el estado cambia a Success. Si el estado de la transacción es exitoso, el estado cambia a Failure y tiene un código de error asociado.

No puedes usar esta API para Invoice mensajes, ya que no se pueden comprobar y el estado siempre será Processing.

En el caso de las solicitudes de etiquetas de envío, si la transacción falló con un código de motivo de error de terminal (por ejemplo, Internal server error), debes ponerte en contacto con el equipo de asistencia para desarrolladores de la API para socios vendedores mediante el Póngase en contacto con nosotros formulario de investigación. Esto ocurre debido a restricciones operativas.

¿Por qué recibo un mensaje de error en la llamada a la operación "Enviar facturas"?

Selecciona esta opción para ampliar la respuesta.

Los parámetros de la operación deben rellenarse correctamente. Ten en cuenta 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 (ni siquiera después de un año).
  • Si una factura enviada por la API ha dado error debido a datos incorrectos, pero la factura en papel tiene los datos correctos, el proveedor debe actualizarla a través de la API con los datos correctos con el mismo ID de factura.
  • Si la factura tiene datos incorrectos (tanto impresa como en la API), la factura se cancela y se debe enviar la nueva factura con un nuevo ID de factura.
  • Sin factura con importe total 0 debe enviarse, ya que esto provocaría un error en la factura.
  • Amazon requiere los detalles completos de la dirección en los segmentos de dirección por motivos de cumplimiento tributario. Esto es especialmente importante para la parte que envía la factura. Para este segmento, el sistema Amazon Payee requiere una coincidencia exacta.
  • Las condiciones de pago enviadas en la factura deben coincidir con las condiciones de pago acordadas con el comprador de Amazon.
  • El identificador de producto del producto debe coincidir con el identificador de producto del producto del pedido que se ha enviado al proveedor en el pedido de compra coincidente. El importe total de la factura debe ser igual a la suma total de los productos, cargos y descuentos.
  • El importe total del impuesto para cada nivel de línea debe ser igual al importe total del impuesto en el nivel de encabezado.
  • 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 descuentos debe desglosarse en el encabezado.

Si falta uno de estos parámetros o se rellena incorrectamente, la llamada a la API recuperará detalles incorrectos. Asegúrate de facilitar la información requerida al enviar la operación.

¿Por qué aparece un error SPDC300?

Selecciona esta opción para ampliar la respuesta.

Este error puede deberse al uso de ciertas etiquetas HTML, en concreto las etiquetas de encabezado <h1><h2><h3><h4>. Elimina estas etiquetas de encabezado y utiliza únicamente las etiquetas que se proporcionan en el editor de texto.

Este error también puede indicar que el estado de la cuenta ha pasado a estar inactivo debido a la falta de actividad. Puedes actualizar la información de tu tarjeta de crédito para reactivar la cuenta. La próxima vez que inicies sesión en Seller Central, se te redirigirá a la página de actualización de la tarjeta de crédito. Tu cuenta se restablecerá aproximadamente 48 horas después de actualizar la tarjeta de crédito.

¿Por qué aparece un error 500 cuando solicito obtener el token de acceso de LWA en Postman?

Selecciona esta opción para ampliar la respuesta.

Si recibe un error interno del servidor 500, compruebe que Content-Type header está configurado en application/x-www-form-urlencoded y los parámetros de la solicitud se añaden al cuerpo y no como parámetros de consulta.

¿Por qué aparece un error 500 al realizar una solicitud a un endpoint de entorno aislado?

Selecciona esta opción para ampliar la respuesta.

El entorno aislado de la SP-API funciona como muchos marcos simulados; 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ía una solicitud que coincide con los parámetros especificados.

Si la solicitud enviada al endpoint del entorno aislado no coincide con los valores de los parámetros del objeto x-amazon-spds-sandbox-behaviors, recibirás un "error interno del servidor 500" en la respuesta. Debes 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-behaviors, el entorno aislado proporciona la respuesta independientemente de los valores de los parámetros de la solicitud, siempre que la solicitud sea válida.

Para obtener más información sobre cómo realizar una llamada de entorno aislado a la API del colaborador comercial, consulta el tema Entorno aislado de la API del colaborador comercial.

¿Por qué recibo un código de error MD1000?

Selecciona esta opción para ampliar la respuesta.

{{0}} es el proceso de autorización que otros vendedores iniciarán para autorizar tu aplicación en la Tienda de aplicaciones.

Si incluyes el parámetro version=beta parameter, el proceso autoriza una aplicación en estado de borrador. Si no incluyes el parámetro version=beta, el proceso autorizará la versión publicada de ese ID de aplicación en la Tienda de aplicaciones; de lo contrario, devolverá el código de error "MD1000".

¿Por qué recibo un código de error MD1000 al iniciar el proceso de OAuth?

Selecciona esta opción para ampliar la respuesta.

Este error se devuelve si tienes una aplicación de la SP-API que no está publicada, pero el proceso de OAuth apunta al proceso de producción. Para solucionarlo, confirma que la aplicación se encuentra en fase de borrador. Si es así, añade el parámetro version=beta para el URI de autorización de OAuth construido. Una vez publicada la aplicación, se puede eliminar este parámetro.

¿Por qué recibo un código de error MD5100?

Selecciona esta opción para ampliar la respuesta.

El código de error MD5100 puede deberse a los siguientes problemas:

  • Errores en la URL de autorización de OAuth.
  • Faltan enlaces de redireccionamiento en la aplicación.
  • Fragmentos en la URL.

Prueba estas soluciones para resolver un error MD5100:

  • Comprueba el estado de la aplicación:
  • Si la aplicación está en estado de borrador, comprueba que la URL incluya version=beta.
  • Si la aplicación está publicada, comprueba que la URL no incluya version=beta. Si se incluye version=beta en la URL, el proceso de OAuth se inicia para el estado preliminar de la aplicación en lugar del estado publicado.
  • Comprueba que has seguido todos los pasos de laAutorización de aplicaciones de la API del colaborador comercial.
  • Comprueba que tu aplicación tiene un URI de inicio de sesión y un URI de redireccionamiento. Puedes actualizar el URI de inicio de sesión y el URI de redireccionamiento editando tu aplicación en el Portal para proveedores de soluciones y actualizar el URI de inicio de sesión y los detalles del URI de redireccionamiento.
  • Verifica que la aplicación sea compatible con el mercado al que está autorizado el desarrollador. En el Portal para proveedores de soluciones, elige el Edit opción de publicación para tu aplicación y, en la sección de precios, elige los sitios web a los que debe admitir la aplicación.

Si después de revisar estos detalles el problema persiste, abre un caso de asistencia.

¿Por qué recibo un código de error SPDC8143?

Selecciona esta opción para ampliar la respuesta.

Este error se produce al intentar autorizar una aplicación como usuario secundario. Para evitar este error, ponte en contacto con el propietario de la cuenta y pídele que realice esta acción por ti.

¿Por qué sigo viendo la página de autorización de MWS en lugar de la página de consentimiento de la SP-API cuando inicio el proceso de OAuth?

Selecciona esta opción para ampliar la respuesta.

Comprueba si a tu aplicación le faltan el URI de inicio de sesión y el URI de redireccionamiento. Puedes actualizar el URI de inicio de sesión y el URI de redireccionamiento editando la aplicación. Navega hasta Appstore > Develop Apps y elige Edit App para la aplicación que está utilizando para ver el formulario de registro de la aplicación y actualizar los detalles del URI de inicio de sesión y del URI de redireccionamiento.

¿Por qué recibo un error al utilizar un SKU con caracteres especiales?

Selecciona esta opción para ampliar la respuesta.

Es posible que el SKU que utilices tenga caracteres especiales, como una barra inclinada hacia atrás o hacia adelante (\, /), que requieren la codificación de la URL. Esto se puede hacer de forma programática en varios idiomas. A continuación puedes ver 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*();* } }

Para obtener más información, consulte Codificación de URL.

He recibido un error 400, ¿qué debo hacer?

Selecciona esta opción para ampliar la respuesta.

Para obtener más información, consulte Resolviendo 400 errores.

¿Necesitas más ayuda?

Para obtener asistencia adicional, póngase en contacto con Soporte para desarrolladores de API para socios vendedores.


¿Te ha ayudado esta página?