Integrando o parceiro de vendas da Amazon API

Para acessar os dados por meio do Amazon Selling Partner API (SP-API), você deve concluir as seguintes ações:

1. Registre-se como API desenvolvedor SP

2. Solicitar API funções de SP-

3. Registre sua inscrição

4. Selecione um modelo de autorização para seu aplicativo

5. Conecte-se ao SP- API

Registre-se como API desenvolvedor SP

Antes de registrar seu API aplicativo SP, você deve criar uma conta de desenvolvedor da Amazon e se registrar como API desenvolvedor SP. Para obter uma visão geral abrangente do processo de registro de desenvolvedores, consulte SP- Visão geral do API registro na API documentação do SP-.

Solicitar API funções de SP-

Uma APIfunção de SP determina se um desenvolvedor ou aplicativo tem acesso a uma operação ou recurso específico. Como desenvolvedor, você deve solicitar e se qualificar para uma função específica, ou não poderá acessar as operações e os recursos agrupados sob essa função.

As funções protegem o acesso a informações de identificação pessoal (PII) e outros dados confidenciais. Eles limitam o acesso aos dados para garantir que os desenvolvedores possam acessar somente os dados necessários para o aplicativo. Isso ajuda a proteger os dados do cliente e a preservar a confiança do cliente.

O acesso aos dados disponíveis nos relatórios de análise de marca exige que você tenha a função Brand Analytics. Para obter mais informações sobre como solicitar acesso a uma função, consulte Como faço para solicitar e me qualificar para uma função na documentação do SP-API.

Registar a sua aplicação

O processo de registro varia um pouco dependendo do tipo de inscrição. Para fins de registro, os aplicativos são classificados como um dos seguintes tipos:

• Aplicativos públicos e aplicativos de vendedores privados — Esses são aplicativos que estão disponíveis publicamente e são autorizados por um vendedor ou fornecedor, ou são aplicativos de vendedores que estão disponíveis somente para sua organização e são autoautorizados.

• Aplicativos de fornecedores privados — Esses são aplicativos de fornecedores que estão disponíveis somente para sua organização e são autoautorizados.

Para obter mais informações, consulte Registrar seu aplicativo na API documentação do SP-.

Selecione um modelo de autorização para sua aplicação

O modelo de autorização para o parceiro de vendas API é baseado no Login with Amazon, uma implementação OAuth 2.0 da Amazon. Sua inscrição é autorizada por meio de interações com páginas exibidas pela Amazon e seu site. O navegador da web é o agente do usuário que passa os parâmetros entre seu site e a Amazon em cada ação do parceiro de vendas. Para implementar a OAuth autorização, você deve configurar seu site para aceitar e processar os parâmetros que a Amazon passa para ele. Você também deve configurar seu site para redirecionar o navegador e passar parâmetros para a Amazon. Para obter mais informações sobre autorização, consulte Autorização de API aplicativos de parceiros de vendas na API documentação do SP-.

Entenda a autorização do aplicativo

Para fins de autorização, existem três tipos de aplicativos:

• Aplicativos públicos para vendedores — Esses aplicativos estão disponíveis publicamente e são autorizados pelos vendedores. Você pode escolher um dos seguintes fluxos de trabalho de autorização:

  • Fluxo de trabalho de autorização da Selling Partner Appstore — Um fluxo de trabalho de OAuth autorização que é iniciado na página de detalhes da Selling Partner Appstore.

  • Fluxo de trabalho de autorização do site — Um fluxo de trabalho de OAuth autorização que é iniciado a partir do seu próprio site.

• Aplicativos públicos para fornecedores — Esses aplicativos estão disponíveis publicamente e são autorizados pelos fornecedores. Você pode usar o fluxo de trabalho de autorização do site. Esse é um fluxo de trabalho de OAuth autorização iniciado em seu próprio site.

• Aplicativos privados para vendedores ou fornecedores — Esses aplicativos estão disponíveis somente para sua organização. Podem ser aplicativos do vendedor ou do fornecedor. Você pode usar a abordagem de autoautorização. Ao criar um aplicativo privado para sua própria organização, você pode se autoautorizar a acessar as informações da sua conta. Você pode autoautorizar sua inscrição no status de rascunho; não há motivo para publicar uma inscrição privada. Para obter informações sobre como revogar a autoautorização de pedidos de vendedores e fornecedores, consulte Revogar autoautorizações na documentação do SP-. API

Autorize grupos de fornecedores para acesso a aplicativos

Ao autorizar seu API aplicativo de parceiro de vendas a acessar seus dados, você concede acesso ao grupo de fornecedores associado às credenciais de login da sua conta do Vendor Central. Por extensão, você está concedendo acesso a todos os códigos de fornecedor que estão presentes no grupo de fornecedores. Portanto, é importante usar as credenciais e o grupo de fornecedores corretos da Central de Fornecedores para sua integração com o parceiro de vendas. API

O grupo de fornecedores é a conta na qual você faz login. Dependendo de seus contratos comerciais, modelos operacionais e outros fatores, seu grupo de fornecedores pode incluir um ou mais códigos de fornecedor. Cada código de fornecedor permite que você liste produtos em uma categoria específica ou inclui os contratos comerciais necessários, como um código de fornecedor para uma marca específica.

Você pode ter várias autorizações para cada grupo de fornecedores ou criar um único grupo de fornecedores que contenha todos os seus códigos de fornecedor. A opção de usar vários grupos de fornecedores associados ao seu perfil permite que você use um aplicativo com o mesmo código de fornecedor em diferentes grupos de fornecedores. Com essa opção, você não precisa enviar vários aplicativos de desenvolvedor de fornecedores para cada grupo de fornecedores.

Para obter mais informações, consulte Autorizar grupos de fornecedores para acesso ao aplicativo na documentação do SP-API.

Conecte-se ao SP- API

Depois de registrar e autorizar sua inscrição, você pode começar a fazer solicitações. Para obter mais informações, consulte Conectando-se ao parceiro de vendas API na API documentação do SP.