O que é o Amazon
A Amazon é um canal exigente: prazo de envio, taxa de cancelamento e tempo de resposta viram métricas de conta, e conta com métrica ruim perde a Buy Box ou é suspensa. Integrar aqui é tanto sobre dado quanto sobre disciplina operacional.
A operação pode ser por conta própria (FBM), com o vendedor enviando, ou por FBA, com a Amazon armazenando e enviando. As duas mudam o desenho da integração de forma significativa.
O que a API entrega
A SP-API é a interface atual, com autenticação por LWA e credenciais de aplicação registradas — o cadastro do aplicativo é uma etapa do projeto, não um detalhe, e costuma levar dias.
Boa parte das operações é assíncrona por relatório: pede-se um relatório, aguarda-se processamento e baixa-se o resultado. Integração que espera resposta imediata para tudo não funciona aqui.
Há cota por operação, com modelo de recarga. Exceder não devolve erro simples: degrada, o que exige respeitar o ritmo em vez de tentar de novo em laço.
Fluxos que construímos
Anúncio e preço
Publicação e atualização de oferta a partir do ERP, com atenção a atributo obrigatório por categoria — item incompleto perde exposição sem gerar erro.
Pedido para o ERP
Venda entrando com a informação de canal e modalidade preservada, porque FBM e FBA seguem caminhos diferentes na expedição.
Estoque por modalidade
Saldo próprio e saldo em centro da Amazon tratados como estoques distintos, e não um número só.
Conciliação de repasse
Relatório financeiro cruzado com os pedidos, aplicando comissão, tarifa de logística e ajuste. É o lugar onde aparece diferença acumulada.
O que costuma quebrar
Tratar relatório como consulta síncrona
O fluxo correto é solicitar, aguardar e baixar. Integração escrita como se fosse consulta direta falha de forma intermitente e parece instabilidade do canal.
Somar estoque FBA e próprio
São estoques diferentes, com logística diferente. Somar gera promessa de prazo que a operação não cumpre — e prazo descumprido vira métrica de conta.
Cota excedida em laço de repetição
Repetir imediatamente após recusa piora a degradação. A nova tentativa precisa de espera progressiva, não de insistência.
Atributo de categoria faltando
Oferta publicada sem atributo obrigatório fica no ar com exposição reduzida. Falha silenciosa, percebida só na queda de venda.
Prazo típico
- 4 a 8
- semanas para anúncio, estoque e pedido
- +2
- semanas para conciliação de repasse
- dias
- só para aprovar o cadastro do aplicativo
Perguntas frequentes
FBA muda muito a integração?
Muda o suficiente para ser decisão de escopo. No FBA a Amazon controla estoque e envio, então a integração cuida de reposição e conciliação; no FBM ela precisa cuidar de expedição e prazo. Operação híbrida exige tratar os dois estoques separadamente desde o começo.
Quanto tempo leva para liberar o acesso à API?
O registro do aplicativo e a aprovação de acesso levam dias e dependem de documentação da conta. Vale iniciar esse trâmite na primeira semana do projeto, porque ele corre em paralelo mas é bloqueante no fim.
Um hub de marketplace já resolve?
Resolve o caminho padrão. Construir vale quando há regra própria de preço, operação híbrida FBA e FBM com rateio de estoque, ou volume que torna o custo por pedido relevante.
Como não perder a Buy Box?
Isso é operação, não integração — mas a integração ajuda garantindo saldo confiável, prazo cumprido e preço atualizado. Cancelamento por falta de estoque é o que mais derruba métrica de conta, e ele nasce de saldo mal sincronizado.