Integração Hiper Amazon: listagens, estoque e o cuidado com o FBA

A integração Hiper Amazon conecta o seu ERP à Amazon de forma automática, sincronizando produtos, estoque, preços e pedidos sem digitação manual. O catálogo nasce no Hiper, o saldo publicado é o saldo real e cada venda entra no ERP como pedido, pronto para separação e faturamento.

O Hiper é um ERP de gestão comercial feito para simplicidade — minimercados, lojas de bairro e varejo especializado. A Amazon é um dos maiores marketplaces do mundo, com operação brasileira e regras próprias de logística e fiscal. A integração é a ponte entre os dois — e ela só funciona bem quando respeita o que cada lado exige de verdade.

Neste conteúdo você vai ver como a conexão funciona na prática, quais problemas ela elimina, o que a API da Amazon permite e por que o modelo ERP First é o caminho mais seguro para quem leva o Hiper a sério.

O que é a integração Hiper Amazon?

É a conexão automática entre o ERP Hiper e a Amazon, fazendo os dois sistemas trocarem dados sem intervenção manual.

A divisão de papéis não deveria ser negociável: o Hiper é a fonte oficial — controla estoque, preços, faturamento e fiscal. A Amazon é canal — apresenta o produto, capta o cliente e registra o pedido.

Por que integrar o Hiper exige atenção?

Porque um conector genérico ignora justamente o que faz o ERP funcionar:

• Equipe pequena. Não há um time dedicado ao canal digital. Se a integração exigir conferência diária, ela não se sustenta.
• Estoque único e real. Diferente de uma distribuidora, aqui o estoque costuma ser um só — o mesmo que atende o balcão. Vender no digital o que já saiu na loja física é o erro mais comum.
• Fiscal sem margem para retrabalho. O Hiper emite NF-e de forma direta; a venda pelo canal precisa entrar com a operação certa desde o começo.
• Cadastro enxuto. O produto no ERP costuma ser descrito para o balcão, não para vitrine.

O que a API da Amazon permite?

• A SP-API autentica por Login with Amazon: o access token vai no cabeçalho x-amz-access-token. Operações que expõem dados pessoais exigem um Restricted Data Token.
• Estoque e preço são atributos da listagem, não endpoints separados: a quantidade fica em fulfillment_availability e o preço em purchasable_offer.
• Atenção a uma inversão comum: a Product Pricing API é só de consulta. Quem atualiza preço é a Listings Items API.
• Os campos obrigatórios variam por tipo de produto e precisam ser lidos dinamicamente na Product Type Definitions API, que devolve o JSON Schema daquele productType.
• Grade é modelada por relação pai e filho, com parent_sku, parentage_level e variation_theme.
• Pedidos chegam pela Orders API, e as notificações usam a Notifications API entregando em EventBridge ou SQS — o evento recomendado para pedido é o ORDER_CHANGE.

Os limites são por operação e por par conta-aplicativo. O patchListingsItem, por exemplo, aceita 5 requisições por segundo naquele par. Para catálogo grande, a atualização item a item não fecha a conta: o caminho é o feed de listagens em lote.

Quais problemas surgem sem a integração entre Hiper e Amazon?

• Venda de produto sem estoque. O canal segue anunciando o que já saiu no ERP por outra via, e o cancelamento vem depois.
• Pedido parado esperando digitação. O cliente já pagou e o pedido ainda não existe no ERP.
• Preço desatualizado. A tabela mudou no ERP e o canal não acompanhou — margem errada ou venda perdida.
• Retrabalho fiscal. Pedido lançado às pressas gera nota com operação errada.
• Conciliação manual no fechamento. O que o canal registrou não bate com o que o ERP faturou.

Quanto custa continuar no manual?

O custo raramente aparece como linha de orçamento, e é por isso que passa despercebido. Ele aparece como uma pessoa dedicada a copiar pedido, como venda perdida por ruptura que não existia no estoque real, e como margem errada em item cujo preço mudou sem o canal acompanhar.

Enquanto o volume é baixo, dá para absorver. O problema é o teto: passado certo número de pedidos por dia, a digitação deixa de ser incômoda e passa a ser o que impede o canal de crescer.

Como funciona a integração ERP Hiper Amazon?

A Plugar.me opera como uma camada entre o Hiper e a API da Amazon. Ela traduz os dados de um lado para o outro, orquestra a ordem das operações e trata os erros que aparecem no caminho — porque eles aparecem.

FBA ou envio próprio: a bifurcação fiscal

Essa é a decisão que mais gera erro na integração. Em pedido com envio próprio ou DBA, o vendedor emite a NF-e e faz o upload. Em pedido FBA, a Amazon emite a nota — e o vendedor não deve emitir a sua. Uma integração que não distingue o programa logístico do pedido produz nota indevida, e corrigir documento fiscal emitido é bem mais caro do que tratar o caso na origem. Vale lembrar ainda que o DBA exige inscrição estadual no mesmo estado do CNPJ que fatura.

Como funciona o controle de estoque?

O saldo sai do Hiper e atualiza o canal. A pergunta relevante não é apenas “quanto tem”, e sim quanto pode ser vendido ali.

Como o estoque costuma ser o mesmo que atende a loja física, cada venda no balcão precisa refletir no canal — e rápido. Reservar parte do saldo reduz cancelamento, mas limita o canal. É decisão sua.

Como funciona o faturamento e a emissão de notas fiscais?

A nota nasce no Hiper. É a regra que separa uma integração ERP First de um conector qualquer.

A nota nasce no Hiper, com a operação correta para venda ao consumidor final. O canal recebe a informação do documento emitido; ele não substitui essa etapa. Seu fiscal continua sendo um só.

Qual é o fluxo completo, do clique à nota fiscal?

1. O cliente compra na Amazon.
2. A integração captura o pedido e o cria no Hiper, na operação correta.
3. O estoque é baixado no ERP e o saldo do canal é atualizado.
4. O pedido segue o fluxo interno de separação e conferência.
5. O faturamento é executado no Hiper e a NF-e é emitida.
6. Número da nota e rastreio voltam para o canal.
7. O painel da Plugar.me registra cada etapa em log, para auditoria.

Preciso desenvolver essa integração do zero?

Não existe conector nativo entre o Hiper e a Amazon. Os dois lados têm interface; ninguém fez a ponte por você. E a ponte não é só transporte de dados: é mapear a estrutura do ERP, respeitar os limites do canal e tratar o que falha.

O que costuma ser subestimado no desenvolvimento interno não é construir. É manter: o canal muda regra de API, muda exigência de cadastro, muda comportamento. Quem construiu internamente assume essa fila para sempre.

Quais os benefícios para lojas e minimercados?

• Volume sem headcount proporcional. Dobrar pedidos não significa dobrar gente digitando.
• Menos cancelamento. O saldo publicado passa a refletir o estoque real.
• Margem sob controle. O preço do canal sai da política definida no ERP.
• Fiscal em um lugar só. A nota nasce no Hiper, com a operação correta.
• Fechamento sem conciliação manual. O que aconteceu no canal está registrado no ERP.
• Rastreabilidade. Log de cada etapa, para quando algo precisar ser auditado.

Para quais empresas essa integração é indicada?

• Lojas e minimercados que rodam Hiper e querem o canal como operação, não como teste.
• Operações com equipe pequena, onde ninguém tem tempo para digitar pedido.
• Negócios que vendem também no balcão e precisam que os dois canais vejam o mesmo estoque.

Se o volume é baixo e não há complexidade fiscal, o manual ainda se sustenta. A conta vira quando o volume cresce ou quando o erro passa a custar reputação.

Por que escolher uma integração ERP First para o Hiper?

Porque a alternativa é deixar o canal ditar a operação. Existe um modelo comum em que a plataforma vira o centro: o catálogo passa a viver nela, o pedido é tratado nela e o ERP recebe um resumo depois. Para quem investiu em Hiper, isso é inversão de comando.

• Estoque, preço e cadastro têm uma origem: o Hiper.
• A nota fiscal nasce no ERP, com a operação da sua empresa.
• O canal é canal — importante, mas não dono do dado.
• Se amanhã você abrir outro canal, a fonte da verdade não muda.

Como a Plugar.me realiza a integração Hiper Amazon?

A operação roda 100% em nuvem: não é preciso subir servidor nem manter estrutura adicional na sua infraestrutura.

1. Diagnóstico. Entender como o seu Hiper está configurado e o que a operação exige.
2. Mapeamento e setup. Definir de onde sai cada dado, qual operação o pedido da Amazon deve usar e qual saldo o canal enxerga.
3. Go-live assistido. Acompanhamento nos primeiros ciclos, quando os casos de exceção aparecem, com painel de logs para auditar cada etapa.

Conclusão: vale a pena integrar o Hiper à Amazon?

Vale quando a Amazon deixa de ser teste e passa a ser canal. A partir daí, digitação manual não é economia: é o teto do canal e a origem dos erros que custam tempo e margem.

A integração bem feita não muda a forma como a sua empresa opera. Faz o contrário: garante que o canal se encaixe na operação que já existe no Hiper, em vez de obrigar a operação a se contorcer para caber no canal.

Quer avaliar como ficaria no seu cenário? Fale com a equipe da Plugar.me e conte como o seu Hiper está estruturado hoje: volume, estrutura de estoque e como funciona o seu faturamento.

Luan Carvalho

Luan Carvalho é fundador e CTO da Plugar.me, empresa especializada em integração de ERP com marketplaces e plataformas de e-commerce. Atua no desenvolvimento de soluções para automação de pedidos, estoque, preços, faturamento e documentos fiscais, ajudando empresas a escalarem suas operações com estabilidade, segurança e alto desempenho. Ao longo de sua trajetória, participa da implementação de integrações entre ERPs como SAP Business One, Protheus, WinThor, Consinco e Sankhya, conectando-os aos principais marketplaces e plataformas do mercado.