Perguntas frequentes sobre erros da SP-API

Perguntas frequentes sobre erros da SP-API.

Dica

To check the current status of all SP-APIs, refer to the API Health Dashboard. You can access the API Health Dashboard any time by selecting the API Status button in the top right corner of the SP-API documentation site.

Erros comuns

Por que estou recebendo um null valor de enumeração?

Selecione para expandir a resposta.

Você está usando uma versão de modelo desatualizada. Atualize a versão do modelo Swagger em sua integração (por exemplo, regenere as bibliotecas do cliente) e tente novamente.

Como posso evitar erros de limitação?

Selecione para expandir a resposta.

In the SP-API, the token bucket algorithm limits request rates. For information about how to avoid throttling errors, refer to Usage Plans and Rate Limits in the SP-API.

Operações em lote

As seguintes operações em lote estão disponíveis para o SP-API:

For more information, refer to the May 2022 SP-API Release Announcement.

API Notificação

This API sends notifications instead of you having to send multiple requests to other APIs. For more information, refer to the Notifications API v1 Use Case Guide.

Limitador de taxa

To learn how to implement a client-side rate limiter, refer to Optimize Rate Limits for Application Workloads.

Por que estou recebendo uma mensagem de “Processamento” para a chamada da API de transações?

Selecione para expandir a resposta.

O status da transação será compatível com as seguintes operações da API:

  • Confirmar pedido
  • Enviar confirmações de envio
  • Enviar atualizações do status do envio
  • Solicitação de etiqueta de endereço
  • Feed de inventário

Se o status da transação não tiver mudado de Processing para Failure ou Success após 5 minutos, a transação não foi concluída com sucesso em nosso sistema. Se o status da transação for bem-sucedido, o status mudará para Success. Se o status da transação for bem-sucedido, o status mudará para Failure e tem um código de erro associado.

Você não pode usar essa API para Invoice mensagens, pois não há suporte para verificação e o status sempre será Processing.

For shipping label requests, if the transaction failed with a terminal error reason code (for example, Internal server error), you must contact the Selling Partner API Developer Support team using the Contact Us form for investigation. This happens due to operational constraints.

Por que estou recebendo uma mensagem de erro na chamada de operação “Enviar faturas”?

Selecione para expandir a resposta.

Os parâmetros de operação devem ser preenchidos corretamente. Considere estes pontos ao preencher os parâmetros para fazer a chamada da API:

  • Os números das faturas devem ser exclusivos e nunca devem ser reutilizados (mesmo após um ano).
  • Se uma fatura enviada pela API falhar devido a dados incorretos, mas a fatura em papel tiver os dados corretos, o fornecedor deverá atualizá-la por meio da API com os dados corretos usando o mesmo ID da fatura.
  • Se a fatura tiver dados incorretos (em papel e na API), a fatura será cancelada e a nova fatura deverá ser enviada com um novo ID.
  • Nenhuma fatura com valor total 0 deve ser enviado, pois isso faria com que a fatura falhasse.
  • A Amazon exige os detalhes completos do endereço nos segmentos de endereço por motivos de conformidade fiscal. Isso é especialmente importante para a parte de cobrança. Para esse segmento, o sistema Amazon Payee exige uma correspondência exata.
  • As condições de pagamento enviadas na fatura devem corresponder às condições de pagamento acordadas com o comprador da Amazon
  • O identificador do produto do item deve corresponder ao identificador do pedido que foi enviado ao fornecedor na ordem de compra correspondente. O valor total da fatura deve ser igual à soma dos itens, encargos e subsídios.
  • O total do valor do imposto para cada nível de linha deve ser igual ao total do valor do imposto no nível do cabeçalho.
  • A quantidade total da fatura deve corresponder à soma da quantidade de todos os itens. Cada cobrança e subsídio diferentes devem ser discriminados no nível do cabeçalho.

Se um desses parâmetros estiver ausente ou preenchido incorretamente, isso fará com que a chamada da API recupere detalhes incorretos. Certifique-se de fornecer as informações necessárias ao enviar a operação.

Por que estou recebendo um erro SPDC300?

Selecione para expandir a resposta.

Esse erro pode ser causado pelo uso de determinadas tags HTML, especificamente tags de cabeçalho <h1><h2><h3><h4>. Remova essas tags de cabeçalho e use somente as tags fornecidas no editor de texto.

Esse erro também pode indicar que o status da conta passou para inativo devido à falta de atividade. Você pode atualizar as informações do seu cartão de crédito para reativar a conta. Na próxima vez que fizer login na Seller Central, você será redirecionado para a página de atualização do cartão de crédito. Sua conta será restabelecida aproximadamente 48 horas após essa atualização.

Por que estou recebendo um erro 500 quando faço uma solicitação para obter o token de acesso LWA no Postman?

Selecione para expandir a resposta.

Se você estiver recebendo 500 Internal Server Error, verifique se Content-Type header está definido como application/x-www-form-urlencoded e os parâmetros da solicitação são adicionados ao corpo e não como parâmetros de consulta.

Por que estou recebendo um erro 500 ao fazer uma solicitação para um endpoint de sandbox?

Selecione para expandir a resposta.

O sandbox da SP-API funciona como muitas estruturas de simulação; ele usa a correspondência de padrões para retornar uma resposta especificada quando os parâmetros especificados estão presentes. Um desenvolvedor recebe uma resposta definida no objeto x-amazon-spds-sandbox-behaviors quando envia uma solicitação que corresponde aos parâmetros especificados.

Se a solicitação enviada para o endpoint do sandbox não corresponder aos valores dos parâmetros no objeto x-amazon-spds-sandbox-behaviors, você receberá um “500 Internal Server Error” na resposta. Você deve enviar a solicitação com os valores exatos especificados no modelo.

Se a API exigir parâmetros que não estejam especificados no objeto x-amazon-spds-sandbox-behaviors, o sandbox fornece a resposta independentemente dos valores dos parâmetros na solicitação, desde que a solicitação seja válida.

To learn more about making a sandbox call to SP-API, refer to The Selling Partner API sandbox.

Por que estou recebendo um código de erro MD1000?

Selecione para expandir a resposta.

{{0}} é o processo de autorização que outros vendedores iniciarão para autorizar o aplicativo na Appstore.

Se você incluir o version=beta parameter, o fluxo de trabalho autorizará um aplicativo no estado Rascunho. Se você não incluir o parâmetro version=beta, o fluxo de trabalho autorizará uma versão publicada desse ID do aplicativo na Appstore, caso contrário, retornará um código de erro “MD1000".

Por que estou recebendo um código de erro MD1000 quando inicio o fluxo de trabalho OAuth?

Selecione para expandir a resposta.

Se você tiver um aplicativo SP-API que não esteja publicado, mas o fluxo de trabalho OAuthaponta para fluxo de trabalho de Produção, esse erro é retornado. Para resolver, confirme se o aplicativo está na fase de rascunho. Em caso afirmativo, adicione o parâmetro version=betapara o OAuth URI de autorização construído. Depois que o aplicativo for publicado, esse parâmetro poderá ser removido.

Por que estou recebendo um código de erro MD5100?

Selecione para expandir a resposta.

O erro MD5100 pode ser causado pelos seguintes problemas:

  • Erros no URL de autorização OAuth.
  • Links de redirecionamento ausentes no aplicativo.
  • Fragmentos no URL.

Experimente estas soluções para resolver um erro MD5100:

  • Verifique o status do aplicativo:
  • se o aplicativo estiver no status de rascunho, verifique se o URL inclui version=beta.
  • Se o aplicativo for publicado, verifique se o URL não inclui version=beta. Se version=beta estiver incluído no URL, o processo OAuth é iniciado no estado de rascunho do aplicativo, e não no estado publicado.
  • Verify you have followed all steps for Authorizing Selling Partner API applications.
  • Verify that your application has a login URI and redirect URI. You can update the login URI and redirect URI by editing your application in the Solution Provider Portal and updating the login URI and redirect URI details.
  • Verify the application supports the marketplace to which the developer is being authorized. In the Solution Provider Portal, choose the Edit listing option for your application, and in the Pricing section, choose the marketplaces that the application should support.

If after reviewing these details the issue persist, submit a support case.

Por que estou recebendo um código de erro SPDC8143?

Selecione para expandir a resposta.

Esse erro ocorre quando você está tentando autorizar um aplicativo como usuário secundário. Para evitá-lo, entre em contato com o proprietário da conta e peça que ele execute essa ação para você.

Por que continuo vendo a página de autorização do MWS em vez da página de consentimento da SP-API quando inicio o fluxo de trabalho OAuth?

Selecione para expandir a resposta.

Verifique se o URI de login e o URI de redirecionamento estão ausentes em seu aplicativo. Você pode atualizar o URI de login e o URI de redirecionamento editando o aplicativo. Navegue até Appstore > Develop Apps e escolha Edit App para o aplicativo que você está usando para visualizar o formulário de registro do aplicativo e atualizar os detalhes do URI de login e do URI de redirecionamento.

Por que estou recebendo uma mensagem de erro ao usar um código SKU com caracteres especiais?

Selecione para expandir a resposta.

O código SKU que você está usando pode ter caracteres especiais, como uma barra para trás ou para frente (\, /), que exigem codificação de URL. Isso pode ser feito programaticamente em vários idiomas. Aqui está um exemplo em 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*();* } }

For more information, refer to URL encoding.

Recebi um erro 400, o que devo fazer?

Selecione para expandir a resposta.

For more information, refer to Resolving 400 errors.

Precisa de mais ajuda?

For additional support, contact Selling Partner API Developer Support.


Esta página ajudou você?