integre seus sistemas com o Portal da Americanas

Veja como conectar seus sistemas via API e automatizar sua operação com agilidade e segurança.

 

7-Feb-13-2025-06-08-49-8163-PM como gerar o token de integração (API) para conectar sua integração/sistema com a Americanas?

Para integrar com a Americanas e automatizar sua operação, você vai precisar do token de integração (API key). Ele permite que seu sistema acesse os dados da sua conta com segurança.

Veja como gerar:

  1. Acesse o Portal.

  2. No menu lateral, vá em "Integrações" > "Credenciais API".

  3. Clique em "+ adicionar credencial " (ou clique no ícone de "Visualizar", se já houver um token ativo).

  4. Copie o token e insira no seu sistema, seguindo as orientações do seu sistema.


⚠️ Nunca compartilhe esse token com terceiros. Ele garante a segurança da sua integração.

 

7-Feb-13-2025-06-08-49-8163-PM posso ter mais de uma chave de API ativa no Portal da Americanas?

Sim! Você pode gerar múltiplas credenciais de API, de acordo com a sua necessidade de integração.

Se você precisa integrar com sistemas diferentes (como hubs, ou plataformas específicas), é possível gerar várias chaves de API ativas ao mesmo tempo — não há limitação sistêmica nesse sentido.


⚠️ Atenção: Caso você deixe de usar um ERP ou troque de sistema, é imprescindível revogar a chave antiga tanto no seu sistema quanto no Portal da Americanas, para evitar riscos de uso indevido ou falhas na integração.

 

7-Feb-13-2025-06-08-49-8163-PM posso usar a mesma chave API para integrações de sistemas diferentes? 

Sim, mas não indicamos. O ideal é gerar uma chave API diferente para cada tipo de integração/sistema.

Exemplo: uma para o ERP e outra para o sistema de atendimento.
Isso traz maior segurança e controle, pois, permite revogar ou substituir uma chave sem impactar outras integrações.

Além disso, facilita identificar acessos e oportunidades de diagnóstico caso algo dê errado.

7-Feb-13-2025-06-08-49-8163-PM troquei de integração/sistema, o que devo fazer com as chaves APIs?

Quando o você troca de integração/sistema, o indicado é apagar a chave API antiga no portal de credenciais e no sistema, depois, gerar uma nova chave para uso exclusivo no novo sistema/integração.
Isso garante que o sistema antigo não terá mais acesso à sua operação, aumentando a segurança e evitando conflitos de integração.