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

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.

O que você precisa do lado da Suitable

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

1. Entre no painel da Suitable com um usuário administrador da loja e abra Aplicativos.
2. Clique em SuitAPI e dê um nome para a integração (por exemplo, "Entregas Expressas").
3. Deixe marcada a permissão de Pedidos. Se puder, marque também a de Loja, que traz o nome e o fuso da loja.
4. 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.

1. Em Cliente, escolha o cliente dono da loja. A tela recarrega e mostra o formulário.
2. Deixe marcado Ativar integração com a Suitable.
3. 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.
4. Preencha a Coleta, a Forma de Pagamento Padrão e, se aparecerem, o Tipo de Serviço e a Categoria Padrão dos Pedidos.
5. 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.
6. 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.
7. 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.
8. 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.
9. Clique em Salvar.

   

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.