Revisão 2026-07-14 — primeira versão. Cobre a autorização por loja (OAuth do ID Magalu), o recebimento de pedidos por webhook com fila e o controle de abertura/fechamento da loja.

1. Descrição Geral

A integração AiqFome passou a operar na API v2 do aiqfome, que substitui a API legada ("Alfredo"). As principais mudanças:

• Autorização por loja: cada loja autoriza o app Sischef individualmente no painel do aiqfome (padrão OAuth do ID Magalu). Não existe mais usuário/senha por loja.
• Pedidos em tempo real: os pedidos chegam por webhook (o aiqfome avisa o Sischef na hora) e são processados pela fila interna, com retentativas automáticas.
• Token automático: o Sischef troca a autorização por um token de acesso e o renova sozinho a cada 2 horas. Ninguém precisa gerenciar token manualmente.

O que a v2 cobre: recebimento de pedidos, confirmação, marcar como pronto/despachado, detecção de cancelamento, abrir/fechar loja e consulta de status da loja.

A integração legada continua funcionando para as lojas que ainda não migraram — a v2 é ativada loja a loja por um parâmetro na configuração.

2. Como funciona a autorização (leia antes de configurar)

Pense como uma procuração digital:

1. O lojista, dentro do painel do aiqfome, autoriza o aplicativo Sischef a operar os pedidos da loja dele (é a "assinatura da procuração").
2. O aiqfome então redireciona o navegador do lojista para o endereço de retorno do Sischef (a URL de callback), entregando um código de autorização — o "comprovante" da procuração. Esse código é de uso único e expira em poucos minutos.
3. A página do Sischef que recebe o código troca ele automaticamente por um token, descobre qual loja foi autorizada e grava tudo na configuração da integração. Se deu certo, a página mostra "Loja integrada com sucesso" — e acabou: nada pra copiar, nada pra colar.
4. Daí em diante o Sischef renova o token sozinho, indefinidamente. O lojista só precisaria autorizar de novo se revogar a autorização no painel do aiqfome.

O campo "API v2 - Código de autorização" da configuração é o plano B: se a troca automática falhar (motivo aparece na própria página), o suporte cola o código nesse campo e salva — o Sischef completa a troca sozinho em seguida e limpa o campo. No fluxo normal esse campo fica sempre vazio.

Os campos "API v2 - Token / Refresh Token / Validade do token" são preenchidos e renovados automaticamente. Não alterar. Servem só de diagnóstico: token preenchido = loja autorizada.

3. Configuração no Sischef (feita pelo suporte) — ordem importa

1. Acesse Configuração da integração e crie (ou edite) a integração da loja com plataforma AiqFome.
2. Preencha "API v2 - ID da loja no Aiqfome (store_id)" com o ID numérico da loja no aiqfome (ex.: 143039). Onde encontrar: aparece na URL do painel do lojista e no cadastro da loja junto ao aiqfome; em dúvida, confirmar com o contato comercial do aiqfome.
3. Mude "Usar API v2 (ID Magalu)" para ATIVADO.