Após solicitar a integração, é hora de prepará-la para o uso. A configuração da integração entre Saipos e Foody Delivery é muito simples, basta seguir o passo a passo a seguir ou entrar em contato com nosso time de Suporte para configurarmos para você!
Tipo: Integração de logística;
Desenvolvimento: API própria da Foody Delivery (nativa);
Troca de status da venda: Bilateral, há comunicação de status entre as duas plataformas.
SUMÁRIO
CONFIGURANDO O ENTREGADOR
O primeiro passo consiste em configurar um entregador na Saipos. Para isso, acesse vá em Menu > Entregadores e clique no botão '+ Entregadores' para cadastrar um novo entregador, ou edite um já existente clicando no ícone de lápis, localizado à direita do monitor, na coluna 'Ações'. Selecione o entregador como padrão e clique em 'Selecione o serviço de entrega' escolha a opção 'Foody', como na imagem abaixo.
Feito isso, o sistema habilitará um campo para a informação do Token de Integração. Esse token é um código que pode ser encontrado no painel da sua conta na Foody em Minha conta > Configurações avançadas > APIs e Hooks > Credenciais API. Informe o token no cadastro do entregador na Saipos e clique em salvar.
OBS: Caso ainda não tenha as credenciais, clique em Criar credencial e marque o tipo Foody Delivery, como na imagem abaixo.
Por fim, bastará incluir o Token no entregador na Saipos e salvar.
ATENÇÃO! Para o pleno funcionamento da integração, é muito importante que o token informado esteja exatamente igual ao encontrado em sua conta na Foody.
CONFIGURANDO OS STATUS DE PEDIDO
É necessário configurar a correlação entre os status dos pedidos na Saipos e na Foody. Recomendamos como padrão os seguintes vínculos:
OBS: O status Cancelado, o pedido é dado como cancelado no sistema da Foody, na Saipos e também na plataforma de integração, caso seja um pedido integrado.
Para configurar isso, basta acessar na Saipos o Menu > Status da venda e em cada status cadastrado na Saipos, adicionar o status equivalente na Foody, clicando na linha abaixo da descrição e selecionando a correlação desejada. Não esqueça de clicar em 'Salvar' para gravar as suas alterações.
CADASTRANDO O USUÁRIO DE INTEGRAÇÃO NA SAIPOS
Uma vez configurados os status, é necessário que se crie um usuário de integração na Saipos. Para isso, chame o nosso suporte que eles farão o processo.
Primeiramente, é necessário acessar o Menu > Serviços e realizar a contratação da 'Integração Foody Delivery (Obrigatório contratar Foody a parte)'. Não será cobrado nenhum valor por parte da Saipos, esse passo deve ser seguido somente para prosseguir com a integração.
Após o usuário ter sido criado, acesse o Menu > Usuários e permissões, o sistema apresentará a guia 'Usuários de integração'. Observe que o sistema apresenta algumas opções de ação para o usuário de integração com a Foody.
Você pode utilizar o botão com o ícone de olho para visualizar o token gerado para este usuário. Caso ainda não exista, você poderá gerar e copiar um token automaticamente, clicando em 'Continuar'.
Utilizando o botão com o ícone de folhas de papel você pode gerar e copiar um novo token sempre que necessário.
ATENÇÃO! Antes de gerar um novo token para um usuário de integração, certifique-se de que não há integrações utilizando este token. Esse processo é irreversível e pode travar a sua integração.
CADASTRANDO O WEBHOOK NA FOODY
O último passo na configuração da integração Saipos <> Foody consiste em cadastrar uma webhook no painel da Foody. Essa definição permitirá que os dois sistemas se comuniquem de modo que você consiga acompanhar tudo na Saipos.
Para cadastrar a webhook, no portal da Foody, siga estes passos:
Clique em Minha conta > APIs e Hooks > Gatilhos (webhooks) > Criar gatilho;
Marque a opção 'Ativado';
Copie esta URL:
https://api.saipos.com/v1/webhook/partners_delivery/3/events?access_token=Cole no campo URL no cadastro do gatilho (webhook);
Copie o token do usuário de integração com a Foody cadastrado na Saipos;
Cole o token no final do campo URL, sem deixar espaço após o sinal de "=" (igual);
Clique em 'Salvar'.
IMPORTANTE! Ao clicar em 'Salvar', a Foody exibe uma mensagem de sucesso ou de erro.
Em caso de sucesso, a configuração está finalizada e a integração está pronta para uso.
Em caso de erro, verifique se a URL está correta e se o token colado está de acordo com o token gerado no usuário de integração da Foody na Saipos.
STATUS FOODY
Foody Solicitar Entrega: Neste status o pedido é enviado para a Foody com todas as informações necessárias no sistema deles.
Foody Liberar Entrega: Neste status o pedido muda para pronto na Foody.
Foody Saiu para Entrega: Este status serve somente para atualizar o pedido na Saipos quando o pedido é marcado como despachado na Foody, ou seja, se mover manualmente na Saipos para "Saiu para Entrega" NÃO irá trocar o status na Foody, uma vez que essa atualização é feita por eles no momento em que o motoboy pega o pedido para entregar.
Foody Finalizar Entrega: Neste status o pedido é dado como finalizado no sistema da Foody.
Foody Cancelar Entrega: Neste status o pedido é dado como cancelado no sistema da Foody, na Saipos e também na plataforma de integração, caso seja um pedido integrado.
NOVIDADE! Quando um pedido é movido de status na Foody, SIM ele altera esse status na Saipos. Isso significa que a integração é bilateral, podemos mover de status na Foody que será atualizado na Saipos.
REGRAS & OBSERVAÇÕES:
Um pedido só pode ser cancelado ou finalizado após ter sido solicitada a entrega.
Após finalizar entrega não é possível cancelar.
Após cancelar entrega não é possível finalizar.
Quando o pedido é alterado de status na Foody, ele também altera na Saipos. Com exceção de quando o pedido volta algum status, por exemplo, de Entregue para Cozinha.
Se cancelar o pedido na plataforma da foody e for um pedido de alguma integração o mesmo vai ser cancelado na foody, na Saipos e na integradora. O ideal nesses casos é o cancelar esse tipo de pedido sempre na Saipos, que ai vai oferecer a opção de não cancelar na integração (ifood, neemo, accon) e sim so na Saipos e na foody.
Para um pedido integrar, ele deve ser um pedido de Delivery, estar com o entregador Foody padrão, ter o próximo status de venda com Foody vinculado e NÃO deve ser full service.
O plano gratuito não aceita mais integrações
É possível utilizar uma mesma conta Foody para integrar pedidos de mais de uma loja Saipos. Neste caso terá dois ou mais gatilhos nas configurações da plataforma.
Não é possível integrar mais de uma conta foody na mesma conta Saipos, pois o entregador precisa ser padrão, caso contrario não comunica.
Vídeo explicando sobre o funcionamento da integração Foody: