Olá Aiqdevs
Com o objetivo de simplificar e fortalecer nossa plataforma, o aiqfome está consolidando todas as integrações na API V2 e descontinuando a API V1. A API V2 é a nossa solução definitiva e unificada, capaz de gerenciar lojas tanto do tipo Catálogo quanto Cardápio.
A principal mudança técnica é a implementação do ID Magalu como novo padrão de autenticação. Diferente do modelo anterior, a autorização agora passa a ser por loja, garantindo maior segurança e controle individual para cada unidade do portfólio do seller.
A partir de 05/01/2026, a API V2 passará a ser a única API oficial, incorporando o sistema de Autenticação via ID Magalu.
Recomendamos que novos parceiros aguardem o lançamento oficial em 05/01/2026 para iniciar o desenvolvimento, evitando o retrabalho de migração da API V1.
Cronograma de Transição e Marcos Importantes
Para facilitar o planejamento do seu time de desenvolvimento, resumimos as datas críticas e o impacto em cada versão da API.
| Data | Marco / Evento | Impacto e Ação do Parceiro |
|---|---|---|
| 05/01/2026 |  Lançamento Oficial API V2(Com Autenticação ID Magalu) |
• Novas Lojas: Só poderão ser autorizadas via API V2. • Parceiros V0 (Alfredo): Recomendamos iniciar o novo fluxo de autorização. • Parceiros V1: Devem parar de usar V1 para novas lojas. |
| 05/01/2026até07/04/2026 |  Período de Transição(Convivência V1 e V2) |
• Lojas Legadas (V1): Continuam funcionando normalmente.• Desenvolvimento: Janela de 90 dias para migrar as lojas da base atual para a V2. |
| 07/04/2026 |  Descontinuação da API V1 |
• Fim da API V1: O acesso será revogado. • Obrigatório: Todas as integrações (novas e antigas) devem estar operando 100% na API V2. |
Nota para usuários da API V0 (Alfredo): Seus endpoints não mudam, mas a partir de 05/01/2026, a forma de autenticar (login) muda para o modelo ID Magalu por loja.
1. O Novo Padrão de Integração: API V2 e ID Magalu
A API V2 agora se torna a plataforma unificada, suportando lojas do tipo Lojas do tipo Catálogo (Mercados, Pets, Farmácias) e Lojas do tipo Cardápio (Restaurantes). O principal impacto é a mudança no modelo de segurança.
Alerta Crítico: Novo Modelo de Autorização (Por Loja)
Este é o ponto mais importante desta comunicação e exige sua atenção:
| Antes (API aiqfome V1) | Agora (API V2 com ID Magalu) |
|---|---|
| **Autorização por Usuário:**O usuário dono da loja autorizava o parceiro no Geraldo, e todas as lojas desse usuário eram liberadas com um único token. | **Autorização por Loja:**O usuário dono da loja deve autorizar individualmente cada loja de seu portfólio para o parceiro integrador. |
| **Resultado:**Um único Access Token gerenciava todas as lojas. | **Resultado:**Cada loja autorizada terá seu próprio e exclusivo Access Token.Seu sistema precisará gerenciar e utilizar o token correto para a loja que deseja gerenciar. |
2. Cenário para Parceiros Atualmente Integrados com a API V0 (Alfredo)
Se sua empresa já utiliza a API aiqfome V0 (Alfredo), a boa notícia é que não há impacto em seu código de integração (Endpoints e Payloads).
Ação Necessária do Parceiro (Recomendado)
Devido à migração para o novo modelo de autenticação (ID Magalu e autorização por loja), você deverá seguir os passos de cadastro e nova autorização a partir de 05/01/2026:
-
Portal do Desenvolvedor: Crie sua conta e registre sua Aplicação de Produção.
-
Avisar o Seller: O Seller precisará autorizar a sua aplicação, loja por loja, através do menu de Integrações do painel do Geraldo.
-
Obtenção de Novos Tokens: Seu sistema deve implementar o fluxo para obter o Access Token específico para cada Loja autorizada, utilizando o novo padrão ID Magalu.
Para mais detalhes sobre cada etapa deste processo, consulte o passo a passo completo em nossa documentação oficial: Credenciais e Autenticação
3. Cenário para Parceiros Atualmente Integrados com a API V1
A API V1 será descontinuada em 07/04/2026, 90 dias a partir do lançamento da nova versão. A migração para a API V2 é obrigatória.
Ação Necessária (Obrigatório)
| Status da Loja | Ação do Parceiro |
|---|---|
| Lojas Existentes (Já Autorizadas na V1) | Continuarão ativas na API V1 por um período de transição até 07/04/2026. |
| Novas Lojas (Qualquer Loja após 05/01/2026) | Você deverá migrar para a API V2. A autorização de novas lojas só será possível via API V2 a partir de 05/01/2026. |
Se você integra com a API V1, prepare-se para:
-
Desenvolvimento: Necessário integrar-se aos endpoints da API V2.
-
Autenticação: Adotar o novo modelo de Autorização por Loja via ID Magalu.
Próximos Passos e Suporte
O processo básico de credenciamento, criação de conta e obtenção de client_id e client_secret permanece o mesmo e deve ser consultado em nossa documentação oficial:
Em caso de dúvidas sobre como este novo modelo impactará seu sistema, entre em contato: integracao@aiqfome.zendesk.com.