# Integração com o Aiqfome: conectar a loja e receber os pedidos de entrega própria

> O cliente conecta a loja do Aiqfome pelo Portal B2B (com o ID Magalu vinculado) e os pedidos de entrega própria entram sozinhos, com o andamento devolvido ao Aiqfome.

Fonte: https://ajuda.entregasexpressas.com.br/artigo/integracao-com-aiqfome · Integrações › Marketplaces de Delivery · Atualizado em 27/10/2026

Para que serve

O Aiqfome é um marketplace de delivery. Com a integração, os pedidos de entrega própria da loja entram sozinhos no painel assim que a loja lê o pedido no Aiqfome, e o entregador é chamado no tempo que você definir. O Aiqfome recebe de volta o nome e o telefone do entregador e o andamento da entrega.

O que você precisa do lado do Aiqfome

- A conta do Aiqfome da loja com o ID Magalu vinculado. Sem esse vínculo, a integração não é ativada.

- O acesso de quem administra a loja no Aiqfome (no gestor do Aiqfome, o Geraldo), para autorizar a conexão.

Quem cadastra: o cliente, pelo Portal B2B

Em Configurações › Integrações e API › Aiqfome, no lugar do botão de cadastro aparece o aviso Só o cliente pode cadastrar a integração. É que a conexão pede o login do dono da loja no Aiqfome. Ali você acompanha as integrações já feitas, abre os Logs, edita as opções ou exclui.

No painel você acompanha e ajusta; a conexão da loja é feita pelo cliente.

O passo a passo do cliente, no Portal B2B:

- No menu Integrações, clique no card AiqFome.

- Clique no aviso Atenção: ID Magalu é obrigatório! para ver o passo a passo e o vídeo de como vincular o ID Magalu no Geraldo (o gestor do Aiqfome). Faça o vínculo antes de continuar, usando o mesmo e-mail do Geraldo e marcando todas as permissões de acesso.

- Preencha a Coleta, a Forma de Pagamento Padrão e, se aparecerem, o Tipo de Serviço e a Categoria Padrão dos Pedidos.

- Decida o retorno: com Habilitar retorno dinâmico marcado (padrão), o sistema decide o retorno pela forma de pagamento. Desmarcado, vale Retorno ao local de coleta para todos.

- Informe em chamar entregador após aproximadamente os segundos de espera (padrão 300, 5 minutos), ou marque Criar pedido em preparo para liberar à mão.

- Clique em Salvar e Conectar e autorize o acesso na página do Aiqfome que abrir. Na volta, a loja aparece em Lojas Conectadas.

- Tem outra loja? Clique em Conectar Loja e autorize de novo. Para tirar uma loja, use Remover.

Pedidos para retirada, ou com entrega feita pela logística do próprio Aiqfome, não viram pedido aqui. Eles aparecem nos logs como Ignorado.

O que volta para o Aiqfome

- Quando um entregador aceita: o Aiqfome recebe o nome e o telefone dele, e o pedido fica a caminho da loja.

- Quando o entregador chega perto da loja (cerca de 200 metros): chegada na loja.

- Quando ele coleta: o pedido sai para entrega.

- Quando o pedido é concluído: entregue.

O Aiqfome não envia código de entrega: o entregador finaliza o pedido normalmente no app.

Pedido cancelado no Aiqfome

Enquanto o entregador não chegou na loja (mesmo com o pedido já aceito), o cancelamento no Aiqfome cancela o pedido aqui (ou, se estiver agrupado, tira só aquela entrega). Depois que o entregador chegou na loja ou coletou, o pedido não é cancelado: cancele no painel se for o caso.

Perguntas frequentes

A conexão não termina ou dá erro ao conectar a loja.

Quase sempre é o ID Magalu sem vínculo com a conta do Aiqfome. Siga o passo a passo do aviso Atenção: ID Magalu é obrigatório! e tente conectar de novo.

Posso conectar a loja pelo painel, em nome do cliente?

Não: a autorização é feita com o login do dono da loja no Aiqfome, então o cadastro é pelo Portal B2B. Pelo painel você ajusta as opções da integração depois, em Editar.

Um pedido do Aiqfome não apareceu.

Abra os Logs da integração no painel. Pedido de retirada ou da logística do Aiqfome aparece como Ignorado; uma falha pode ser reenviada pelo botão Reenviar.
