# Integração com a Suitable: pedidos de entrega da gestão do restaurante no painel (beta)

> Ligue a Suitable com o Client ID e o Client Secret para os pedidos de entrega entrarem no momento que você escolher.

Fonte: https://ajuda.entregasexpressas.com.br/artigo/integracao-com-suitable · Integrações › Sistemas PDV · Atualizado em 27/10/2026

Para que serve

A Suitable é um sistema de gestão, PDV e cardápio digital para restaurantes, que também reúne pedidos de marketplaces. Com a integração, os pedidos de entrega entram sozinhos no painel em até um minuto, no momento que você escolher (pedido aceito, pronto ou recém-chegado), e o entregador é chamado no tempo que você definir.

A integração está em beta e ainda não foi usada por nenhuma loja em operação. Antes de depender dela, faça um teste: lance um pedido de entrega na Suitable, aceite e confira se ele aparece no painel em até um minuto com o endereço, o valor, o troco e os itens certos. Cancele um pedido de teste na Suitable e veja se ele é cancelado aqui também. Se algo vier diferente, avise o suporte.

O que você precisa do lado da Suitable

Uma chave de API da loja, criada no painel da Suitable:

- Entre no painel da Suitable com um usuário administrador da loja e abra Aplicativos.

- Clique em SuitAPI e dê um nome para a integração (por exemplo, "Entregas Expressas").

- Deixe marcada a permissão de Pedidos. Se puder, marque também a de Loja, que traz o nome e o fuso da loja.

- Clique em Criar chave e copie o Client ID e o Client Secret. O segredo aparece uma única vez.

Como configurar

Acesse Configurações › Integrações e API › Suitable (o card tem o selo Beta) e clique em Cadastrar Integração.

- Em Cliente, escolha o cliente dono da loja. A tela recarrega e mostra o formulário.

- Deixe marcado Ativar integração com a Suitable.

- Em Lojas, preencha a Loja #1: Nome da loja (opcional), Client ID e Client Secret. Clique em Testar credencial. Tem mais de uma loja? Use Adicionar Loja.

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

- Em Quando o pedido vira entrega, escolha:

- Quando a loja aceita o pedido (recomendado): inclui aceito, em preparo, finalizando e pronto. Pedido agendado entra quando a loja começa a prepará-lo.

- Quando a loja marca o pedido como pronto: o entregador só é chamado com o pedido pronto para sair.

- Assim que o pedido chega (pendente), antes de a loja aceitar: o entregador é chamado mesmo antes do aceite; se a loja cancelar depois, o pedido é cancelado aqui sozinho.

- Marque Receber pedidos do iFood que chegam pela Suitable e Receber pedidos da 99Food que chegam pela Suitable só se a sua operação faz essas entregas: a Suitable não informa quando a entrega é da logística do próprio marketplace.

- Decida o retorno: com Exigir retorno só quando houver dinheiro a devolver marcada (padrão), pedido já pago na Suitable dispensa o retorno. Desmarcada, vale Retorno ao local de coleta para todos.

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

- Clique em Salvar.

Depois do teste, aparece o identificador da loja na Suitable.

Pedidos de retirada, salão e senha não viram entrega, nem os que a loja já despachou pela Suitable. Ligar a integração não lança pedidos antigos. Embaixo de cada loja, a tela mostra a Última consulta à Suitable ou o erro da última consulta.

O que volta para a Suitable

Nada. A Suitable só permite ler os pedidos: o andamento da entrega não é enviado de volta. A loja atualiza o pedido na Suitable como já faz hoje.

Pedido cancelado na Suitable

Antes da coleta, o cancelamento na Suitable cancela o pedido aqui (ou, se estiver agrupado, tira só aquela entrega). Depois da coleta, a entrega segue.

O cliente também pode configurar

O próprio cliente pode fazer a mesma configuração pelo Portal B2B, no menu Integrações, card Suitable.

Perguntas frequentes

Um pedido não apareceu.

Confira o gatilho escolhido (com pronto, o pedido só entra quando a loja marca como pronto) e se a loja não é de um canal desmarcado (iFood, 99Food). Depois abra os Logs da integração na lista: cada pedido lido aparece com o motivo ou a falha, que pode ser reenviada.

Pedido agendado entra quando?

Quando a loja tira o pedido do agendamento e começa a prepará-lo na Suitable. A partir daí conta o tempo para chamar o entregador.

O teste de credencial falha.

Confira se copiou o Client ID e o Client Secret da mesma chave e se a permissão de Pedidos está marcada nela. Se o segredo se perdeu, crie uma chave nova na Suitable.