Amazon · Selling Partner API

Integração Amazon pela SP-API: Magento 2, WooCommerce e ERP na Amazon Brasil

Integração Amazon é ligar a sua loja Magento 2 ou WooCommerce e o ERP à Selling Partner API (SP-API) para sincronizar catálogo, estoque, preço, pedidos e nota fiscal na amazon.com.br. Eu faço essa ligação como app privado da sua conta, com token LWA, endpoint da América do Norte, marketplaceId do Brasil e a Orders API v2026-01-01.

Atualizado em · por Roger Takemiya

Onde costuma quebrar

O que trava uma integração com a Amazon Brasil

A primeira surpresa é o endereço. A Amazon Brasil não tem endpoint próprio na SP-API: é atendida pelo da América do Norte, sellingpartnerapi-na.amazon.com, com o marketplaceId A2Q3Y263D00KWC. Os exemplos da documentação usam o dos Estados Unidos, ATVPDKIKX0DER, e código copiado sem troca consulta a loja errada.

Depois vem o plano: app privado na SP-API exige o Plano Profissional. E há prazo correndo: quem lê pedidos pela Orders API v0 tem até 27/03/2027 para migrar para a v2026-01-01.

Eu integro Magento 2, WooCommerce e ERPs à Amazon pela SP-API e ajudo na implantação e otimização da conta, conforme a documentação da SP-API e as páginas de venda da Amazon Brasil, consultadas em 22/11/2026.

Antes do código

Plano Individual ou Profissional: o que muda para a integração

Planos de venda da Amazon Brasil, segundo venda.amazon.com.br/precos (consulta em 22/11/2026)
PontoIndividualProfissional
MensalidadeIsentoR$ 19 por mês a partir do 13º mês; o 1º ano é grátis para vendedor novo
Tarifa por itemR$ 2,00 por item vendido, além da comissãoSó a comissão da categoria
Comissão10% a 15%, conforme a categoria, com mínimo de R$ 1,00 por itemA mesma
SP-API (app privado)Não é elegívelElegível
Integradores, FBA e publicidadeNãoSim
Oferta em destaque (Buy Box)NãoElegível conforme a performance

Segundo o blog de vendedores da Amazon, acima de 10 unidades por mês o Profissional compensa. Para integrar, não há escolha: sem Profissional, não há SP-API. As tarifas são iguais para CPF, MEI e CNPJ; o FBA é que exige CNPJ.

Como funciona

Como eu faço a integração com a Amazon

  1. Diagnóstico. Plano da conta, modalidade de envio (FBA, FBA Onsite, DBA ou envio próprio), quem emite a nota e se os produtos já têm ASIN no catálogo ou precisam de cadastro com EAN ou isenção de GTIN.
  2. Registro como desenvolvedor privado. No Seller Central, em Apps and Services, Develop Apps, opção Private Developer. O app privado se autoriza no próprio Seller Central. Se a Amazon pedir informação no cadastro, há 5 dias para responder.
  3. Token LWA. POST em api.amazon.com/auth/o2/token com grant_type=refresh_token devolve um access token de 1 hora, que vai no header x-amz-access-token. Desde 02/10/2023 a SP-API não exige assinatura AWS SigV4 nem IAM; se o código antigo assina, a assinatura é ignorada.
  4. Catálogo e listagens. ASIN pela Catalog Items API v2022-04-01, oferta pela Listings Items API v2021-08-01 e carga em lote pela Feeds API v2021-06-30. O catálogo é único: ofertas do mesmo produto dividem a página de detalhe, e um ASIN novo leva até 15 minutos para aparecer no inventário.
  5. Pedidos e notificações. Orders API v2026-01-01, com searchOrders e o parâmetro includedData no lugar de chamadas separadas. O nextToken expira em 24 horas, e pedido com mais de dois anos não aparece. A Notifications API v1 avisa mudança de pedido (ORDER_CHANGE), e a fila processa.
  6. Nota fiscal. No FBA, quem emite é o Faturador da Amazon, com o seu certificado A1 e as planilhas fiscais por SKU; a Invoices API, só do Brasil, lê essas notas. No DBA e no envio próprio, você emite e envia, em lote pelo Seller Central ou pela Delivery by Amazon API, de disponibilidade restrita.
  7. Acompanhamento. Log das chamadas, alerta para token e nota rejeitada, e revisão a cada versão nova de API. No FBA, nota rejeitada bloqueia a oferta, e certificado perto do vencimento é uma das causas listadas pela Amazon.

As duas chamadas da base

# token LWA: access token de 3600 segundos
POST https://api.amazon.com/auth/o2/token
     grant_type=refresh_token

# catálogo, com o marketplaceId do Brasil
GET  https://sellingpartnerapi-na.amazon.com/catalog/2022-04-01/items/EXAMPLEASIN?marketplaceIds=A2Q3Y263D00KWC
     x-amz-access-token: <access token LWA>

A chamada de catálogo é o exemplo da documentação oficial da SP-API, com o marketplaceId do Brasil no lugar do americano. Refresh token e credenciais ficam fora do código.

Logística e nota

FBA, DBA e envio próprio: quem emite a nota e por onde ela passa

Modalidades de envio da Amazon Brasil do ponto de vista da integração (consulta em 22/11/2026)
PontoFBADBAEnvio próprio
Quem guarda e entregaA Amazon, nos centros delaVocê embala; a Amazon e transportadoras parceiras entregamVocê, com frete definido por você
Selo PrimeSim, em todos os produtos do FBANãoNão
Nota fiscalEmitida pelo Faturador da Amazon, com o certificado A1 do CNPJEmitida por você e enviada à AmazonEmitida por você e enviada à Amazon; botão Enviar NF-e desde 15/12/2025
API da notaInvoices API (Brazil Only) v2024-06-19, que lê as notasDelivery by Amazon API: submitInvoice e getInvoiceStatusDelivery by Amazon API ou envio em lote no Seller Central
Vendedor CPFNão: o FBA exige CNPJA Amazon emite a DC-e, de forma gradual desde 15/09/2026Uma DC-e por pedido, obrigatória desde 06/04/2026

O FBA tem custo de armazenagem e de logística por unidade, e a promoção de FBA vigente em novembro de 2026 exige investir 3,5% da receita em anúncios patrocinados para manter o benefício. Se compensa para o seu catálogo, a Ana Paula, sócia da Agência Buzz, faz essa conta na página de especialista Amazon.

Exemplo

Um cenário comum

Um cenário comum: loja em Magento 2 que já vende no Mercado Livre e quer entrar na Amazon com marca própria, parte do catálogo no FBA e parte saindo do próprio estoque.

O que eu entrego: conferência do plano e do Brand Registry (gratuito, aceita marca registrada ou em processo de registro no INPI); produtos ligados a ASIN existente ou cadastrados com EAN; estoque do envio próprio vindo da quantidade vendável do Magento e o do FBA lido da Amazon, sem misturar; pedidos criados no Magento com o número da Amazon; nota do envio próprio enviada à Amazon; e alerta para nota do FBA rejeitada.

Quando você não precisa de mim

  • Plano Individual vendendo pouco: sem SP-API, e o painel resolve. Acima de 10 unidades por mês, a própria Amazon recomenda o Profissional.
  • Se o seu ERP está entre os integradores homologados no FBA (Bling, Tray, Anymarket, Ideris, Ambar X e Shopping de Preços) e cobre a sua regra, o trabalho é configurar.
  • Regra fiscal é do contador, inclusive a revisão da classificação de CBS (cClassTrib) dos produtos do FBA, aberta pela Amazon em outubro de 2026 na página da reforma tributária.
  • Não publico app na Appstore: integro a sua conta como app privado. App público exige OAuth de cada vendedor, reautorização anual e revisão de segurança para dados pessoais.
  • Não prometo Buy Box, que considera preço com frete, prazo, saúde da conta e Prime. E não sou parceiro oficial da Amazon.

Perguntas frequentes

Qual é o endpoint e o marketplaceId da Amazon Brasil na SP-API?

O endpoint é o da América do Norte, https://sellingpartnerapi-na.amazon.com, região us-east-1, e o marketplaceId do Brasil é A2Q3Y263D00KWC. O Seller Central brasileiro fica em sellercentral.amazon.com.br.

Preciso do Plano Profissional para integrar com a Amazon?

Para app privado na SP-API, sim; conta no Plano Individual não é elegível. Em novembro de 2026, o Profissional custa R$ 19 por mês a partir do 13º mês, com o primeiro ano grátis para vendedor novo.

O que muda com a Orders API v2026-01-01?

A v0 está descontinuada e sai até 27/03/2027. O getOrders vira searchOrders, o includedData substitui chamadas separadas, e dado pessoal do comprador deixa de exigir Restricted Data Token quando o app tem os papéis certos.

A SP-API ainda exige assinatura AWS?

Não. Desde 02/10/2023, a SP-API não exige IAM nem AWS Signature Version 4. A chamada leva o access token do Login with Amazon no header x-amz-access-token, e esse token vale 1 hora.

Quem emite a nota fiscal no FBA?

O Faturador da Amazon, com o certificado A1 do CNPJ da conta e as planilhas de regras e atributos fiscais por SKU. No DBA e no envio próprio, você emite e envia a nota à Amazon.

A Amazon cobra para usar a SP-API?

Em novembro de 2026, não. A Amazon publicou que não vai seguir com as tarifas de uso e anual da SP-API que tinha anunciado, com a ressalva de que a decisão vale por enquanto.

Quer que eu olhe o seu caso?

Me conte o que está acontecendo. Respondo pessoalmente, em horário comercial.