A página de integrações liga o seu estabelecimento a serviços de terceiros — sobretudo fornecedores de entregas e de estafetas que enviam motoristas para os seus pedidos, e ainda a impressora pela internet Eatabit. É uma funcionalidade da Vista de Localização: as integrações que configurar aqui aplicam-se ao estabelecimento em que está a trabalhar.
O que é a página de integrações?#
Cada fornecedor suportado aparece como um cartão. Um cartão pode conter uma ou mais ligações ("integrações") para esse fornecedor, cada uma associada a um canal de encomenda. Depois de ligar um fornecedor de entregas, a plataforma pode enviar automaticamente um pedido de entrega a esse fornecedor quando um pedido chega ao estado que escolher (o Gatilho de Estado do Pedido).
Onde encontrar as integrações#
- Vista: Vista de Localização
- Menu: Loja e Definições → Integração
Fornecedores disponíveis#
Na Vista de Localização são apresentados os seguintes cartões de fornecedores:
| Fornecedor | Tipo | Dados de ligação a introduzir |
|---|---|---|
| Tookan | Gestão de frota de entregas | ID da Equipa (Opcional), Token de Acesso, Tem Recolha (ligado/desligado), Atribuição Automática (ligado/desligado), Modelo de Campo Personalizado de Recolha (Opcional), Modelo de Campo Personalizado (Opcional) |
| Shipox | Gestão de frota de entregas | Utilizador API, Palavra-passe API |
| Stuart | Gestão de frota de entregas | ID do Cliente, Segredo do Cliente |
| Onro | Gestão de frota de entregas | ID do Cliente, Segredo do Cliente, ID do Cliente (cliente final), ID do Serviço, ID do Tipo de Veículo, URL Base |
| Cab Treasure | Gestão de frota de entregas | ID do Cliente, Segredo do Cliente, ID do Cliente (cliente final), ID da Loja |
| Uber Direct | Gestão de frota de entregas | ID do Cliente (o ID do Cliente e o Segredo do Cliente são definidos ao nível da plataforma) |
| ShipDay | Gestão de frota de entregas | Chave API |
| Eatabit | Impressora de pedidos pela internet | SID, Token, ID da Impressora |
Alguns outros fornecedores (por exemplo OneSignal, Twilio, iCabbi ou Ably) são configurados ao nível da plataforma e não aparecem na Vista de Localização.
Campos comuns a todas as integrações#
Canal (obrigatório)#
O canal de encomenda a que esta ligação se aplica: Todos, Web, iOS ou Android. Se ficar vazio, aparece "Canal é um valor obrigatório".
Gatilho de Estado do Pedido (obrigatório para fornecedores de entregas)#
O estado do pedido que envia o pedido de entrega ao fornecedor: Pendente, Aceite, Pronto para recolha ou A Caminho. O Uber Direct oferece ainda Manual. Se ficar vazio, aparece "Gatilho de Estado do Pedido é um valor obrigatório". A ligação da impressora Eatabit não pede um acionador. Todos os campos de credenciais (chaves de API, tokens, IDs) são obrigatórios, a não ser que o rótulo diga "(Opcional)"; cada um mostra uma mensagem correspondente, como "Chave API é um valor obrigatório", quando fica vazio.
Tarefas comuns#
Ligar um fornecedor#
- Encontre o cartão do fornecedor e clique no pequeno botão + (adicionar) no canto superior direito. Abre-se a janela Adicionar Integração.
- Escolha o Canal e, nos fornecedores de entregas, o Gatilho de Estado do Pedido.
- Introduza as credenciais desse fornecedor (consulte a tabela acima). Obtém estes valores na sua conta junto do fornecedor.
- Guarde. Se correr bem, verá "Integração salva com sucesso" e a ligação aparece no cartão, identificada com o respetivo canal.
Editar uma ligação#
Clique no botão de editar junto à ligação no respetivo cartão. Abre-se a janela Editar Integração com os valores atuais carregados.
Remover uma ligação#
Clique no botão vermelho de eliminar junto à ligação. Confirme a pergunta "Tem a certeza de que pretende eliminar esta integração?" com Sim! Eliminar ou cancele com Não.
Resolução de problemas#
- Não há botão + nos cartões. A sua conta não tem permissão para isto — peça ao seu administrador. O mesmo se aplica se faltarem os botões de editar ou eliminar.
- As entregas não estão a ser enviadas. Verifique se o Gatilho de Estado do Pedido corresponde ao estado que os seus pedidos realmente atingem e se as credenciais continuam válidas junto do fornecedor.
- O cartão de um fornecedor aparece vazio. Esse fornecedor simplesmente ainda não tem ligações para este estabelecimento — é normal até adicionar uma.