Definições

A área Definições reúne a configuração operacional do seu negócio — o comportamento do Gestor de pedidos, as opções de finalização do pedido, a medição das zonas de entrega, os webhooks e (para negócios alemães) o Impressum legal. Na Vista de Localização, as definições que alterar aqui aplicam-se ao estabelecimento em que está a trabalhar.

Onde encontrar as Definições#

• Vista: Vista de Localização (alguns cartões aparecem também, com efeito em toda a empresa, na Vista da Empresa)
• Menu: Loja e Definições → Definições
• Acesso: as Definições exigem acesso de administrador. A entrada do menu só é apresentada a contas de administrador; os utilizadores normais da equipa não a veem.

A própria página Definições é um conjunto de cartões; clicar num cartão abre a subpágina correspondente. Os cartões que vê dependem da vista atual:

Os interruptores destas páginas ficam guardados de imediato ao clicar e confirmam com "Definição guardada com sucesso".

Gestor de pedidos#

Definições da aplicação Gestor de pedidos usada para receber e processar pedidos. Os interruptores estão agrupados em três cartões:

Geral#

• Desativar ajuste de hora do pedido — "Desativar o ajuste da hora do pedido na aplicação Gestor de pedidos. Só será definida a hora de pedido predefinida". Com isto ligado, a equipa não pode alterar o tempo de preparação/entrega ao aceitar um pedido.

• Mostrar endereço do cliente para entregas externalizadas — mostrar a morada do cliente nos pedidos mesmo quando a entrega é feita por um fornecedor de entregas externo.

Definições da impressora#

• Ocultar gorjeta do motorista no recibo
• Ocultar gorjeta no recibo

Definições de reservas de mesa#

• Desativar reservas de mesa — desativar as reservas de mesa neste estabelecimento.

Finalização do pedido#

Um único interruptor:

• Ativar checkout de convidado — permitir que os clientes façam pedidos sem criar uma conta.

Zonas de entrega (apenas Vista da Empresa)#

Este cartão aparece quando não está selecionado nenhum estabelecimento individual, porque é configurado para toda a empresa:

• Ativar medição de distância por percurso no Google Maps — "Medir a distância pelo percurso em vez de em linha reta". Quando está ativado, as distâncias de entrega (e, portanto, as taxas de entrega baseadas na distância) são calculadas ao longo do percurso de condução em vez de em linha reta.
• Token da API Google Cloud — aparece quando o interruptor acima está ligado. Introduza o seu token e clique em Guardar. Como explica a ajuda no ecrã: "Para medir a distância pelo percurso usamos a API Google Cloud. Certifique-se de que o serviço Route API está ativado na sua conta Google Cloud."

Webhooks#

Os webhooks enviam notificações automáticas para um URL à sua escolha sempre que algo acontece — por exemplo, um novo pedido ou uma reserva de mesa. Na Vista de Localização, os webhooks pertencem ao estabelecimento atual; na Vista da Empresa, pertencem a toda a empresa.

A lista de webhooks#

Colunas: Evento, URL, Estado (Ativo/Inativo), Assinado (um ícone de cadeado que significa "O payload está assinado"), Atualizada e Ações (Editar/Eliminar). Quando está vazia, a página mostra "Ainda não existem webhooks para esta filial. Adicione um para começar a receber eventos."

Adicionar ou editar um webhook#

1. Clique em Adicionar webhook (ou no botão de editar de uma linha existente).
2. Evento(obrigatório) — escolha sobre o que quer ser notificado: Reserva de mesa criada, Reserva de mesa atualizada, Cliente criado, Pedido de cliente criado, Pedido do cliente aceite, Pedido do cliente pronto para recolha, Pedido do cliente a caminho, Pedido do cliente concluído, Pedido do cliente rejeitado ou Pedido do cliente cancelado.
3. URL do payload(obrigatório) — o endereço para onde enviamos a notificação. Tem de ser um URL absoluto válido com no máximo 1024 caracteres; um endereço http:// gera o aviso "Usar http:// não é seguro. Recomenda-se vivamente um endpoint https://."
4. Segredo de assinatura(opcional, máximo 255 caracteres) — "Usado para assinar o payload com HMAC-SHA256, para que possa verificar que foi enviado por nós." Ao editar um webhook que já tem um segredo, o campo fica bloqueado até clicar em Rodar segredo; guardar um valor novo vazio apaga o segredo existente, e o formulário avisa-o antes de isso acontecer.
5. Ativo — liga ou desliga o envio deste webhook.
6. Clique em Guardar. Verá "Webhook criado" ou "Webhook atualizado".

Eliminar um webhook#

Clique na ação de eliminar e confirme "Eliminar este webhook?" — "Os eventos deixarão de ser entregues em [o URL]. Esta ação não pode ser anulada."

Como funcionam os envios#

Um painel expansível na página explica o contrato técnico ao seu programador: cada evento é enviado como um HTTP POST com um envelope JSON e cabeçalhos de identificação (incluindo X-Webhook-Event, X-Webhook-Delivery-Id e, quando está definido um segredo, X-Webhook-Signature). O seu endpoint deve responder com HTTP 200; os envios falhados são repetidos até 6 vezes, com intervalos crescentes (0s, 15s, 60s, 120s, 240s, 600s). O envio é feito pelo menos uma vez, por isso os duplicados devem ser filtrados com X-Webhook-Delivery-Id.

Impressum (apenas estabelecimentos alemães)#

"A lei alemã exige que todos os sites comerciais apresentem um Impressum (aviso legal). As informações abaixo são publicadas para esta localização." Este cartão só aparece na Vista de Localização para empresas sediadas na Alemanha, e o aviso legal é guardado por estabelecimento. O formulário está dividido em secções; o comprimento dos textos é limitado e os valores demasiado longos mostram "Deve ter no máximo … caracteres":

Prestador#

• Razão social(obrigatório, máx. 500) — incluindo a forma jurídica, por exemplo "Oase Bistro GmbH"
• Nome comercial(máx. 200), Forma jurídica(máx. 100)
• Representantes autorizados(máx. 500) — exigido por lei para pessoas coletivas como uma GmbH

Morada registada#

• Rua e número(obrigatório, máx. 250) — não é permitido um apartado
• Linha de endereço 2(máx. 250), Código Postal(obrigatório, máx. 10), Cidade(obrigatório, máx. 200), País(máx. 200)

Contacto#

• E-mail(obrigatório, tem de ser um endereço válido, máx. 200), Telefone(máx. 100), Fax(máx. 100)

Registo e IVA#

"Obrigatório se a empresa estiver registada (por exemplo, uma GmbH) ou tiver número de IVA." Campos: Tribunal de registo(máx. 200), Número de registo(máx. 100), Número de IVA(máx. 50), Autoridade supervisora(máx. 500, incluindo a morada; obrigatório para atividades licenciadas).

Responsável pelo conteúdo#

A pessoa responsável pelo conteúdo editorial (§ 18 Abs. 2 MStV): Nome(máx. 200) e Endereço(máx. 500).

Resolução de litígios de consumo#

• Participa da resolução de litígios de consumo — um interruptor que indica se o prestador participa em procedimentos perante uma entidade de resolução alternativa de litígios de consumo (§ 36 VSBG)

• Declaração sobre resolução de litígios — indique a entidade de resolução de litígios competente, se participar
• Informações adicionais — texto livre para quaisquer outras declarações exigidas por lei

Clique em Guardar para publicar ("Impressum criado" / "Impressum atualizado"). Um Impressum existente pode ser removido com o botão Excluir Impressum; a confirmação avisa "O aviso legal desta localização será removido. Esta ação não pode ser anulada."

Resolução de problemas#

• Não vejo Definições no menu. As Definições estão limitadas a contas de administrador; peça a um administrador que faça a alteração por si.
• O cartão Zonas de entrega não aparece. Só é apresentado na Vista da Empresa, e não quando está selecionado um estabelecimento específico.
• O cartão Impressum não aparece. Só aparece na Vista de Localização e apenas para empresas sediadas na Alemanha.
• O meu webhook deixou de chegar. Verifique se continua marcado como Ativo, se o seu endpoint responde com HTTP 200 e lembre-se de que, após 6 tentativas falhadas, o envio é marcado como falhado.