Conectar a Amazon SP-API: receber pedidos e enviar fulfillment

Obtenha Seller ID, credenciais LWA e refresh token no Seller Central, adicione as chaves de assinatura do AWS IAM, cole os oito campos no Integration, teste, mapeie e ative.

O conector da Amazon SP-API traz seus pedidos da Amazon para o OMS e devolve fulfillment, produtos e estoque à Amazon; também pode trazer devoluções. É para pedidos com envio pelo vendedor (MFN). Uma conexão cobre uma conta de vendedor e um marketplace.

Pré-requisitos#

• Uma conta de vendedor da Amazon com acesso ao Seller Central e pedidos MFN.
• Permissão no Seller Central para desenvolver apps e autorizar seu app (Apps & Services → Develop apps).
• Uma conta AWS com acesso ao IAM para criar uma chave de acesso e anexar a política IAM da SP-API para assinatura.
• Saiba a qual marketplace sua loja pertence: o Marketplace ID deve corresponder a esse site (EUA: ATVPDKIKX0DER).

Obter credenciais#

1. Passo 1 — Seller ID: no Seller Central, vá a Settings → Account info e copie o Merchant token. Esse é o seu Seller ID; começa com A.
2. Passo 1 — Credenciais do app: no Seller Central, vá a Apps & Services → Develop apps, abra seu app e copie o LWA Client Identifier (começa com amzn1.application-oa2-client.) e o LWA Client secret.
3. Passo 1 — Refresh token: autorize seu app para sua conta de vendedor e copie o refresh token recebido. É um token de longa duração e começa com Atzr|.

1. Passo 2 — Chave de acesso AWS: no console da AWS, vá a IAM → Security credentials e crie uma chave de acesso. O ID começa com AKIA.
2. Passo 2 — Chave secreta: copie a AWS secret access key da mesma página. É exibida uma única vez.
3. Passo 2 — Política IAM: certifique-se de que o usuário ou função IAM da chave tenha a política IAM da SP-API anexada; sem ela, a assinatura funciona, mas a Amazon devolve 403.
4. Passo 2 — Role ARN (opcional): se assinar por uma função IAM entre contas, anote o role ARN dela. Omita se assinar diretamente com a chave de acesso.

Preencher no Integration#

1. Abra Integration → Marketplace → Amazon SP-API → Nova conexão.
2. Seller ID (Merchant token) — obrigatório: o Merchant token do Seller Central → Settings → Account info. Começa com A.
3. Marketplace ID — obrigatório: o ID do site da sua loja. Para os EUA use ATVPDKIKX0DER; para outros sites, consulte a documentação da Amazon SP-API.
4. LWA Client ID — obrigatório: o LWA Client Identifier do Seller Central → Apps & Services → Develop apps. Começa com amzn1.application-oa2-client.
5. LWA Client secret — obrigatório: o secret da mesma página de Develop apps. Criptografado em repouso, nunca exibido.
6. Refresh token — obrigatório: o token de atualização de longa duração recebido ao autorizar o app. Começa com Atzr|.
7. AWS access key ID — obrigatório: o ID da chave de acesso IAM usado para a assinatura SigV4. Começa com AKIA.
8. AWS secret access key — obrigatório: o secret associado a essa chave de acesso, copiado de IAM → Security credentials. Foi exibido uma única vez.
9. IAM role ARN — opcional: o ARN de uma função IAM entre contas. Se preenchido, a assinatura primeiro assume essa função via STS para credenciais temporárias; se vazio, a chave de acesso assina diretamente.

Testar a conexão#

O teste tem dois níveis: conectividade (autorização LWA e assinatura SigV4) e prévia de um pedido real. Se ainda não houver pedidos, faça um pedido de teste na Amazon primeiro. Se falhar, anote o erro exato e veja as perguntas frequentes.

Mapping / escolher modelo#

Escolha o modelo padrão da Amazon SP-API. Ele mapeia número do pedido, SKU da linha, quantidades, endereço de entrega e status de fulfillment para pedidos MFN. Revise a prévia com um pedido real antes de ativar, principalmente o pareamento de SKU.

Ativar#

Após ativar, o Integration traz novos pedidos MFN e devoluções na frequência definida, e devolve fulfillment com rastreio, além de atualizações de produtos e estoque, à Amazon.

Perguntas frequentes#

O teste falha com 403

Por quê: geralmente é um problema de assinatura. A chave de acesso AWS ou o secret está incorreto, ou o usuário ou função IAM da chave não tem a política IAM da SP-API anexada, e a Amazon rejeita a solicitação assinada.

Solução: copie novamente o AWS access key ID (começa com AKIA) e o secret de IAM → Security credentials, e confirme no IAM que a política da SP-API está anexada a esse usuário ou função. Se preencheu um role ARN, confirme que a função existe e pode ser assumida. Depois teste de novo.

O refresh token é rejeitado ou a autorização está incompleta

Por quê: o refresh token não corresponde ao LWA Client ID e ao secret, ou a autorização do app para sua conta de vendedor nunca foi concluída, e a Amazon não consegue trocar o token por acesso.

Solução: no Seller Central → Apps & Services → Develop apps, conclua a autorização do app para sua conta de vendedor, copie o refresh token novo (começa com Atzr|) e confirme que o LWA Client ID e o secret são desse mesmo app. Cole os três juntos e teste de novo.

Pedidos de outro site, ou nenhum pedido

Por quê: o Marketplace ID não corresponde ao site em que sua loja realmente vende. A conexão pode até passar no teste, mas a Amazon só devolve pedidos do marketplace indicado.

Solução: confirme o site da sua loja e preencha o Marketplace ID desse site: ATVPDKIKX0DER para os EUA; para outros sites, consulte a documentação da Amazon SP-API. Salve e execute uma extração manual para confirmar.

O Seller ID não é aceito

Por quê: o valor preenchido não é o Merchant token; por exemplo, um nome de loja, um e-mail ou outro ID de conta. A Amazon espera como Seller ID o Merchant token das informações da sua conta.

Solução: no Seller Central, vá a Settings → Account info, copie o Merchant token exatamente como exibido (começa com A), cole-o como Seller ID e teste de novo.