Conectar Amazon

Objetivo: Liberar repricer automático, criar anúncios com um clique, acessar endereços de entrega de clientes, sincronizar catálogo.

Tempo: 10 minutos (se sua conta está verificada), até 30 minutos (se precisar fazer verificação adicional).

O que você precisa antes de começar

• Conta Seller Central (plano Professional, não Individual)
• Ser o usuário primário da conta (não um sub-usuário)
• Acesso ao seu próprio Seller Central
• Um navegador

Nota importante: Contas de plano Individual não podem criar aplicações SP-API. Você precisará fazer upgrade para Professional.

Passo a Passo

1. Criar uma Aplicação Privada no Seller Central

1. Acesse https://sellercentral.amazon.com
2. Clique em Apps and Services (no menu principal à esquerda)
3. Clique em Develop Apps
4. Você verá um painel de desenvolvededor. Se esta é a primeira vez:
   • Você pode receber uma tela pedindo para confirmar que você é o proprietário da conta
   • Siga as instruções (pode pedir verificação por SMS ou email)

2. Criar um novo "App Client"

1. Clique em Add new app client (ou Create App)
2. Preencha o formulário:

   Campo	O que colocar
   App Name	"SellerForge WMS" ou um nome que preferir
   Type of Integration	"Seller" (se vende seus próprios produtos)
   Developer Type	"Private Developer: I build apps that integrate my own business with Amazon"
   API Type	"Selling Partner API (SP-API)"

1. NÃO preencha "IAM ARN" — em 2026, aplicações privadas LWA-only não precisam de IAM ARN
2. Clique em Create / Next

3. Selecionar Permissões (Roles)

Você verá uma lista de "roles" (permissões). Selecione todas estas:

• ✓ Inventory and Order Tracking — para sincronizar catálogo, verificar estoque, rastrear pedidos
• ✓ Pricing — para atualizar preços e repricer automático
• ✓ Product Listing — para criar anúncios com um clique
• ✓ Direct-to-Consumer Shipping (marcada como *Restricted*) — necessária para etiquetas de envio e acesso ao endereço do cliente
• ✓ Buyer Solicitation — opcional (só se quiser pedir avaliações pelo sistema)

Você pode receber um aviso informando que "Direct-to-Consumer Shipping" requer responder a um questionário de proteção de dados. É normal. Se aparecer:

1. Clique em Review Data Protection Questionnaire
2. Responda com sinceridade (é basicamente: você vai proteger os dados dos clientes?)
3. A Amazon analisa e responde por e-mail (pode levar alguns dias)

1. Após selecionar as roles, clique em Create / Authorize

4. Obter o Refresh Token

Após clicar em "Authorize", você verá uma tela com:

Authorization Code: [código longo]
Refresh Token: [código muito longo] ← ESTE É O MAIS IMPORTANTE

IMPORTANTE: Este Refresh Token aparece apenas uma vez. Se fechar a página sem copiar, você terá que autorizar a aplicação novamente.

1. Copie o Refresh Token completo (use Ctrl+C / Cmd+C)
2. Salve em um lugar seguro (você vai colar no SellerForge WMS em breve)
3. Clique em Done / Voltar

5. Encontrar Client ID e Client Secret

Agora você voltou para a lista de aplicações. Você verá sua aplicação "SellerForge WMS" listada.

1. Clique em View ao lado do nome da aplicação
2. Procure pela seção LWA Credentials
3. Você verá:
   • Client ID — copie este
   • Client Secret — clique em Show, depois copie este

Aviso importante: O Client Secret LWA deve ser rotacionado a cada 180 dias. Amazon vai enviar lembretes por email. O SellerForge WMS também vai avisar você quando faltar 30 dias.

6. Encontrar seu Seller ID

1. Na tela do Seller Central, clique em Settings (engrenagem no canto superior direito)
2. Clique em Account Info
3. Na seção Business Information, procure por Your Merchant Token ou Your Seller ID
4. Copie este código (é algo como "ABCD1234E5FGH")

7. Conectar no SellerForge WMS

1. Na aplicação SellerForge WMS, vá até Configurações → Integrações
2. Clique no card Amazon
3. Preencha os campos:
   • Client ID: Cole o Client ID do passo 5
   • Client Secret: Cole o Client Secret do passo 5
   • Refresh Token: Cole o Refresh Token do passo 4
   • Seller ID: Cole o ID do passo 6
   • Marketplace: Deixe como "Amazon.com / ATVPDKIKX0DER" (padrão para USA)
4. Clique em Testar conexão / Test Connection

Testar a Conexão

Após clicar em "Testar conexão", a aplicação dirá:

• "Conexão bem-sucedida" → Amazon está conectado! Os dados começarão a sincronizar
• "Error: Invalid Client ID" → Verifique se copiou correto (sem espaços)
• "Error: Invalid Refresh Token" → Pode ter expirado; vá para o Seller Central e clique Authorize novamente
• "Error: Access Denied" → Roles não foram selecionadas corretamente no passo 3; corrija na tela do Seller Central

Problemas Comuns

"Error: Access Denied" ou "Unauthorized"

Causa: Você selecionou poucas roles quando criou a aplicação. Solução: No Seller Central, vá a Apps and Services → Develop Apps, clique na sua aplicação, e clique Edit para adicionar mais roles. Depois clique Authorize novamente e copie o novo Refresh Token.

"Refresh Token Expired"

Causa: O Refresh Token foi revogado (alguém clicou em *Revoke* no Seller Central, a aplicação foi editada, ou a Amazon invalidou o token por segurança). Ele não expira sozinho por inatividade. Solução: No Seller Central, clique Authorize novamente na aplicação SellerForge WMS. Copie o novo Refresh Token e atualize no SellerForge WMS.

"Error: Seller ID is incorrect" ou não sincroniza estoque

Causa: Você copiou o ID errado (pode ser ID de marketplace, ASIN, etc.). Solução: Volte ao passo 6 e copie novamente de Settings → Account Info → Your Merchant Token. Ele começa com uma letra (como "A" ou "M").

Os produtos não estão sincronizando

Causa: Pode levar até 30 minutos para a primeira sincronização. Solução: Aguarde 30 minutos. Se após 1 hora nada aparecer, verifique se o Client Secret não expirou (a cada 180 dias precisa rotacionar) e se o Seller ID está correto.

"Error: Data Protection Questionnaire Required"

Causa: Você selecionou "Direct-to-Consumer Shipping" mas não respondeu o questionário. Solução: No Seller Central, procure pela notificação de "Data Protection Questionnaire" e responda. A Amazon responde por e-mail; pode levar alguns dias.

Já existe uma aplicação na lista

Causa: Você (ou um ex-sócio/ferramenta antiga) já criou um app client antes. Solução: Pode criar um novo só para o SellerForge WMS — cada clique em Authorize gera um refresh token novo sem invalidar os anteriores. Revogue os apps que não usa mais (verificar na tela).

Segurança

Seus Client ID, Client Secret e Refresh Token são criptografados e armazenados apenas no seu banco de dados SellerForge WMS.

Ninguém da equipe SellerForge consegue ver estes dados.

• Client Secret deve ser rotacionado a cada 180 dias — vá ao Seller Central, clique na aplicação, e clique Rotate Client Secret. Depois copie o novo valor e atualize no SellerForge WMS.
• Se qualquer credencial vazar, você pode regenerá-la no Seller Central sem afetar os clientes (o Refresh Token continua válido).
• Se você desconectar a integração no SellerForge WMS, as credenciais são deletadas permanentemente.

Próximo passo: Conectar eBay → (opcional) ou Conectar Walmart → ou Seu Primeiro Dia →

Referências Oficiais:

• Amazon: Registrar Aplicação SP-API
• Amazon: Getting Started for Private Developers
• Amazon: Rotação de Credenciais LWA
• Amazon: SP-API Roles