Já sou Seller e quero migrar

Como realizar a migração do MWS para a SP-API

❗️

IMPORTANTE!

Os desenvolvedores que usam as seções de Orders, Relatórios e API do Merchant Fulfillment do Amazon MWS devem migrar para Selling Partner API.

Saiba mais informações dos serviços que serão descontinuados.

Para entender mais sobre a questão de Tokens que irão impactar as APIs.

Este documento explica como a SP-API difere do Amazon Marketplace Web Service (Amazon MWS) e mostra como converter seu aplicativo Amazon MWS em um aplicativo Selling Partner API. Para mais informações sobre o que é a SP-API, acesse este link.

Para cada API de parceiro de vendas, há um modelo Swagger, uma referência de API e, em alguns casos, um guia de caso de uso. Também estão incluídas bibliotecas de clientes para ajudar na autenticação de chamadas para APIs de parceiros de vendas.

Novos recursos Selling Partner

  • Entradas e saídas em formato JSON.
  • Novos endpoints com suporte em todas as regiões.
  • Instruções passo a passo no Selling Partner API Developer Guide para geração automatizada de SDKs.
  • Sandbox com endpoints separados para teste com dados fictícios.
  • Plano de uso dinâmico que ajusta automaticamente os limites de throttling para cada parceiro de vendas, com base em uma variedade de medidas.
  • Aplicativos Selling Partner API aplicáveis em todas as regiões.
  • Suporte para tokens de dados restritos, que ajudem a proteger as informações de identificação pessoal (PII) dos clientes.

Convertendo a sua aplicação MWS para SP-API

Nos próximos passos você verá como migrar de MWS > SP-API.

📘

Pré-requisitos

Ter um aplicativo Amazon MWS registrado e publicado na App Store do Marketplace.

1. Solicitar Acesso

Acesse a Seller Central

Acesse com suas credenciais associadas à sua conta de desenvolvedor.

Menu > Aplicativos e Serviços

Clique em Desenvolver aplicativos.

226

Central de desenvolvedor

Na página da Central do Desenvolvedor, clique no link Seu Perfil de Desenvolvedor.

487

Acesso a dados do formulário

Selecione as funções que seus aplicativos exigem e envie o formulário.

🚧

Importante!

Para mais informações sobre mudanças no perfil do desenvolvedor, acesse Perfis de Acesso

A seguir, abriremos um ticket de contato para você rastrear essa solicitação. Após avaliarmos sua solicitação, entraremos em contato. Esse processo pode levar alguns dias.

2. Crie o IAM ARN na AWS

Siga a etapa de Configurar a conta AWS que será utilizada na sequência.

3. Migrar MWS > SP-API

Entre na sua conta

Faça o login usando as credenciais que você usou para se registrar como desenvolvedor.

No menu Aplicativos e serviços

Clique em Desenvolver aplicativos, será exibida a página Developer Central.

Ao lado do seu aplicativo Amazon MWS, no menu Editar aplicativo, clique em Alterar aplicativo.

175

Siga as instruções para registrar seu aplicativo. Na caixa IAM ARN, utilize o IAM ARN do passo anterior

🚧

Observação

O tipo da aplicação a ser selecionada é híbrido (SP-API e MWS)
Nos campos abaixo é onde pode ser realizada a configuração de diferentes developers IDs para cada região.

728

Ao preencher o formulário, você terá um aplicativo de API de parceiro de vendas híbrido com status Rascunho. Agora você está pronto para configurar e testar um fluxo de trabalho de autorização na etapa seguinte.

4. Fluxo de Autorização

Configure e teste um fluxo de autorização para seu aplicativo híbrido Selling Partner API.

Para obter mais informações, consulte como Autorizar uma aplicação SP-API.

Quando terminar de testar seu fluxo de trabalho de autorização, certifique-se de converter seu fluxo de trabalho de autorização de teste em um fluxo de trabalho de autorização de produção.

5. Conectar na SP-API

Configure as chamadas de operações na API Selling Partner. Isso inclui a troca de tokens LWA, a construção de URIs e a adição de cabeçalhos, além da criação e assinatura de solicitações.

A maneira mais fácil de fazer isso é gerando e usando um SDK, que inclua a troca e a autenticação de tokens LWA. Para obter mais informações, consulte Gerando um SDK Java com troca e autenticação de tokens LWA e Conectando-se à API do parceiro de vendas, usando um SDK de Java gerado no Guia do desenvolvedor da API do parceiro de vendas.

Para obter informações sobre como se conectar à sandbox da API do Selling Partner API, consulte a sandbox da API do Selling Partner no Guia do desenvolvedor da Selling Partner API.

6. Publicar sua aplicação

Entre na sua conta

Faça o login usando as credenciais que você usou para se registrar como desenvolvedor.

No menu Aplicativos e serviços

Clique em Desenvolver aplicativos, será exibida a página Developer Central.

Ao lado do seu aplicativo Amazon MWS, no menu Editar aplicativo, clique em Alterar aplicativo.

175

Ao lado do seu aplicativo

No menu Editar aplicativo, clique na seta e, em seguida, clique em Editar listagem.

Continue com o fluxo de trabalho

Depois de concluir a tela final, seu aplicativo de Parceiro de Vendas híbrido será publicado no Marketplace App Store.

Esse processo pode levar de 5 a 10 dias úteis.

7. Migrar a autorização MWS

Migre suas autorizações existentes do Amazon MWS para as autorizações da Selling Partner API.
Para obter mais informações, consulte o usecase da API de autorização.

8. Chamadas de API do MWS

A etapa final é atualizar seu aplicativo para que as ações que acionavam chamadas para operações do Amazon MWS, passem a acionar chamadas para as operações de API dos parceiros de vendas correspondentes.

Consulte o Mapeamento de APIs do Amazon MWS para a API do parceiro de venda para ver quais operações da API do parceiro de venda correspondem às operações do Amazon MWS que o seu aplicativo está chamando.

📘

Referência

Guia de referência para migração.