Conectar a Amazon FBA: sincronizar só o estoque FBA

Uma conexão distinta da Amazon SP-API que reutiliza as mesmas credenciais: cole os mesmos oito campos no Integration, teste, confira o pareamento de SKU e ative: só entra o estoque FBA.

É uma segunda conexão, distinta da conexão da Amazon SP-API: mesma conta de vendedor, mesmas credenciais, outra tarefa. A conexão da Amazon FBA só sincroniza para a sua visão de estoque o estoque que a Amazon armazena e despacha por você (estoque FBA). Ela não traz pedidos nem envia fulfillment: pedidos e envios ficam com a conexão da Amazon SP-API. Se você já tem essa conexão, não precisa de credenciais novas: reutilize aqui o mesmo Seller ID, o par LWA, o refresh token e as chaves AWS.

Pré-requisitos#

• Uma conta de vendedor da Amazon com acesso ao Seller Central e estoque já enviado ao FBA (Fulfillment by Amazon).
• Requisito obrigatório: seu app da SP-API precisa estar autorizado com a função Amazon Fulfillment. Sem essa função, as chamadas de estoque FBA são rejeitadas: é a falha mais comum, então confira a função antes de preencher qualquer campo.
• As mesmas credenciais da conexão da Amazon SP-API: Seller ID, Marketplace ID, LWA Client ID e secret, refresh token e um par de chaves de acesso AWS para a assinatura SigV4. Se já existe uma conexão da Amazon SP-API, esse conjunto já existe: reutilize-o.
• Saiba a qual marketplace seu estoque FBA pertence: o Marketplace ID deve corresponder a esse site (EUA: ATVPDKIKX0DER).

Obter credenciais#

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. Função Fulfillment: no Seller Central, abra seu app da SP-API (Apps & Services → Develop apps) e confirme que o app está autorizado para a função Amazon Fulfillment. Se a função faltar, adicione-a e autorize agora: sem ela, o estoque FBA não pode ser lido.
3. Credenciais LWA: na mesma página do app, copie o LWA Client ID (começa com amzn1.application-oa2-client.) e o LWA Client Secret.
4. Refresh token: autorize o app para sua conta de vendedor (Seller Central → Apps & Services → Authorize) e copie o refresh token recebido. Começa com Atzr|.
5. Chaves AWS: no console da AWS (IAM), crie ou copie o par de chaves de acesso usado para a assinatura SigV4: o ID da chave de acesso (começa com AKIA) e sua secret access key.
6. Role ARN (opcional): só se assinar por uma função IAM assumida via STS, anote o ARN dessa função (arn:aws:iam::…:role/…). Se assinar diretamente com o par de chaves, não precisa.

Preencher no Integration#

1. Abra Integration → Marketplace → Amazon FBA → 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 ao qual seu estoque FBA pertence. 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 ID do seu app da SP-API, do Seller Central → Apps & Services → Develop apps. Começa com amzn1.application-oa2-client.
5. LWA Client Secret — obrigatório: o secret associado a esse Client ID, da mesma página do app. Guardado como segredo, nunca exibido.
6. Refresh Token — obrigatório: o refresh token obtido ao autorizar o app para sua conta de vendedor. Começa com Atzr|.
7. AWS Access Key ID — obrigatório: o ID da chave de acesso usado para a assinatura SigV4. Começa com AKIA.
8. AWS Secret Access Key — obrigatório: o secret associado a essa chave de acesso. Guardado como segredo, nunca exibido.
9. IAM Role ARN (optional) — opcional: preencha só se a assinatura passar por uma função IAM assumida via STS (exemplo: arn:aws:iam::123456789012:role/…). Deixe vazio para assinar diretamente com o par de chaves: vazio é o normal.

Testar a conexão#

Leia o resultado com atenção: há dois tipos de «aprovado». Sem credenciais, o teste usa um estoque simulado (um conjunto fixo e pequeno de SKUs de exemplo) e reporta um sucesso de simulação: isso só prova que as telas funcionam, não que a Amazon esteja acessível. Com credenciais, o teste troca seu refresh token por acesso, assina a solicitação e verifica de verdade sua participação no marketplace junto à Amazon. Só uma aprovação sem a nota de simulação conta como conexão real: preencha as credenciais e teste de novo antes de ativar.

Mapping / escolher modelo#

Nesta conexão não há mapeamento de pedidos: aqui o mapeamento é só de estoque. O estoque FBA é pareado pelo SKU do vendedor: cada SKU da Amazon nos resumos de estoque FBA é vinculado ao produto com o mesmo SKU entre seus produtos em estoque, e suas quantidades FBA são registradas nesse produto na visão de estoque compartilhada. Antes de ativar, confira a prévia de mapeamento: um SKU da Amazon sem produto vinculado não tem onde registrar suas quantidades, então vincule primeiro esses SKUs ao produto correto. Não renomeie SKUs de um lado só, ou o pareamento quebra na próxima sincronização.

Ativar#

Após ativar, o Integration sincroniza seus resumos de estoque FBA na frequência definida e mantém as quantidades FBA atualizadas na visão de estoque compartilhada, para que a visibilidade de estoque e os avisos de reposição incluam o que a Amazon guarda por você. Nada mais muda: nenhum pedido FBA é trazido e nenhum fulfillment é enviado; esse tráfego continua na conexão da Amazon SP-API. Acompanhe as primeiras sincronizações em Runs / Logs e confira alguns SKUs no Seller Central antes de confiar nos números.

Perguntas frequentes#

As chamadas de estoque FBA são rejeitadas: falta a função Amazon Fulfillment no app

Por quê: é a falha número um desta conexão. As credenciais podem estar perfeitamente válidas — o mesmo conjunto funciona na conexão da Amazon SP-API — mas o app da SP-API nunca foi autorizado para a função Amazon Fulfillment, e a Amazon recusa as leituras de estoque FBA sem essa função.

Solução: no Seller Central, abra seu app da SP-API (Apps & Services → Develop apps), adicione a função Amazon Fulfillment e conclua a autorização para sua conta de vendedor. Se a autorização emitir um refresh token novo, cole-o também nesta conexão. Depois teste de novo.

O teste passou, mas o estoque FBA real nunca aparece

Por quê: a aprovação que você viu foi a simulada. Sem credenciais, o teste usa um estoque simulado — um conjunto fixo e pequeno de SKUs de exemplo — e reporta sucesso sem contatar a Amazon, então nenhum estoque real pode vir daí.

Solução: preencha todos os campos de credenciais (de Seller ID a AWS Secret Access Key), salve e teste de novo. Só uma aprovação com credenciais reais — e sem nota de simulação — significa que a Amazon foi realmente contatada. Depois ative e confira a primeira sincronização em Runs / Logs.

Alguns SKUs não sincronizam quantidades

Por quê: o estoque FBA é registrado pelo SKU do vendedor. Se um SKU da Amazon não está vinculado a um produto dos seus produtos em estoque — ou o SKU foi renomeado de um lado só — suas quantidades não têm produto onde se registrar e são ignoradas.

Solução: abra a prévia de mapeamento, localize os SKUs da Amazon sem vínculo e vincule cada um ao produto correto. Depois mantenha os nomes de SKU idênticos dos dois lados, sincronize de novo e confira se as quantidades foram registradas.

O estoque vem de outro marketplace

Por quê: o Marketplace ID preenchido não corresponde ao site ao qual seu estoque FBA realmente pertence. A conexão pode até passar no teste, mas a Amazon só devolve estoque FBA do marketplace indicado.

Solução: confirme o site do seu estoque FBA e preencha o Marketplace ID desse site: ATVPDKIKX0DER para os EUA; para outros sites, consulte a documentação da Amazon SP-API. Salve, execute uma sincronização e confirme que o estoque certo chega.