Entregar com um estafeta Uber Direct

A Uber Direct coloca à sua disposição os estafetas da rede Uber, sem passar por uma plataforma de pedidos: o cliente encomenda na sua própria app, em seu nome, e a Uber fornece apenas o estafeta. Paga cada viagem ao preço fixado pela Uber, sem comissão sobre as suas vendas.

Na XPRIO, chama-se estafeta a pedido. Liga-o uma vez para a sua empresa e decide depois, estabelecimento a estabelecimento, se entrega todos os pedidos ou apenas reforça os seus próprios estafetas.

O que deve saber antes de começar

A conta Uber Direct é sua. Cria-a na Uber, regista lá o seu método de pagamento, e é a Uber que lhe fatura cada viagem. A XPRIO não cobra nada.
O cliente paga a sua taxa de entrega, a do seu estabelecimento, cobrada com o pedido. O custo da viagem Uber é faturado à parte, consoante a cidade, a distância e a hora. Se a sua taxa de entrega for inferior à viagem, a diferença fica por sua conta; se for superior, fica para si. Assim que a conta estiver ligada, a XPRIO mostra-lhe o preço de uma viagem típica a partir do seu estabelecimento.
O pagamento online é obrigatório. Um estafeta a pedido não recebe nenhum pagamento: nem dinheiro, nem cheque, nem cartão na entrega. Os modos de estafeta a pedido só ficam disponíveis quando o pagamento por cartão online (Stripe) está configurado na sua app. Configurar os seus métodos de pagamento
A cobertura depende da cidade. A Uber Direct funciona nas grandes cidades e arredores, não em todo o lado. A XPRIO verifica cada morada no carrinho: uma morada não servida é recusada antes do pedido.
Um cancelamento pode ser cobrado pela Uber depois de um estafeta estar atribuído. A XPRIO avisa-o antes de confirmar.
Reserve cerca de uma hora para o processo completo: criação da conta, chaves, ligação, definições do estabelecimento. A Uber pode demorar alguns dias a validar uma conta real.

Passo 1: criar a sua conta Uber Direct

Abra merchants.uber.com no navegador e procure Uber Direct no menu (ou vá diretamente a merchants.uber.com/uber-direct).
Clique em Começar (ou Get started) e preencha o formulário de empresa: denominação social, morada, número fiscal, contactos, método de pagamento. A Uber verifica estas informações e valida a conta, normalmente em poucos dias.
Depois de validada, inicie sessão em direct.uber.com. É o painel Uber Direct, distinto das aplicações da Uber para o grande público.

A Uber dá-lhe dois ambientes:

Uma conta de teste, gratuita, onde as entregas são simuladas por um estafeta fictício e nunca faturadas.
A sua conta real, onde estafetas reais entregam e cada viagem lhe é faturada.

No topo do painel, uma faixa azul indica «Está a consultar uma conta de teste» quando está na conta de teste, com um botão Mudar de conta à direita para passar de uma para a outra. Faça os seus ensaios na conta de teste e passe à conta real quando tudo funcionar.

Passo 2: obter as suas chaves

No menu esquerdo do painel Uber Direct, em Gestão, clique em Programador.
Fique no separador Chaves API (o primeiro, ao lado de Webhooks).
Vê o nome da sua aplicação e depois três valores, cada um com um botão Copiar à direita:
- Identificador do cliente (Customer ID): uma longa sequência de letras e algarismos separados por hífenes (por exemplo d5d7125d-53a8-…).
- Identificador cliente (Client ID): uma sequência de carateres sem hífenes regulares (por exemplo 3O9Zffr2-…).
- Segredo cliente (Client secret): oculto por predefinição. Clique em Mostrar para o ver e depois em Copiar. Nunca o partilhe.

Estes três valores são diferentes entre a conta de teste e a conta real: use os do ambiente que quer ligar. A faixa azul no topo lembra-lhe em qual está.

Passo 3: ligar a Uber Direct à XPRIO

Na XPRIO, menu esquerdo, abra Configuração da Aplicação e depois Estafetas a pedido (etiqueta New).
A página apresenta os três fornecedores em cartões. No cartão Uber Direct, clique em Ligar.
Abre-se uma janela Ligar Uber Direct. Em Ambiente, escolha:
- Teste se colar as chaves da sua conta de teste Uber;
- Produção se colar as da sua conta real.
Cole os três valores do passo 2 nos campos Customer ID, Client ID e Client secret. O campo secreto está mascarado; o ícone de olho à direita permite mostrá-lo para verificar.
Deixe Chave de assinatura dos webhooks vazia por agora, voltamos a ela no passo 4.
Clique em Guardar e testar. A XPRIO liga-se à Uber com as suas chaves e pede um orçamento de teste à volta do seu estabelecimento. Três resultados possíveis:
- a janela fecha-se e o cartão Uber Direct mostra Ligado (teste) ou Ligado (produção): está feito;
- uma mensagem vermelha «O teste de ligação falhou» com o detalhe devolvido pela Uber: quase sempre um valor copiado com um espaço a mais, ou chaves de teste coladas em modo Produção (ou o inverso). Corrija e tente de novo;
- uma mensagem a indicar que a morada não é servida: a Uber Direct não cobre a zona do seu estabelecimento.

Depois de ligado, o cartão mostra também «Viagem típica a partir do seu estabelecimento (cerca de 1,5 km)» com o preço real devolvido pela Uber, na moeda do fornecedor. Use-o como referência para definir a sua taxa de entrega.

As suas chaves são cifradas e nunca voltam a ser mostradas em claro. Não terá de as reintroduzir: a XPRIO renova automaticamente a ligação à Uber. Se mais tarde mudar de ambiente (por exemplo de Teste para Produção), os campos esvaziam-se: são outras chaves a colar.

Passo 4: ativar as notificações em tempo real (recomendado)

Sem este passo, a XPRIO relê o estado de cada viagem a cada 20 segundos: funciona. Com ele, a Uber avisa a XPRIO instantaneamente a cada alteração (estafeta atribuído, posição, pedido recolhido, entregue), e o cartão Uber Direct mostra «Notificações em tempo real ativas».

Na XPRIO, reabra a janela de ligação Uber Direct (botão Editar no cartão). Por baixo dos campos das chaves, localize URL de notificação a declarar no fornecedor e clique em Copiar.
No painel Uber Direct, menu Programador, clique no separador Webhooks. Em Pontos de terminação, clique em + Criar um webhook.
Abre-se à direita um painel Criar um ponto de terminação. Cole o URL em URL do webhook.
Em Selecionar tipos de eventos, marque event.delivery_status e event.courier_update. Deixe event.refund_request desmarcado.
Clique em Guardar. O seu webhook aparece na lista com o URL e os eventos.
À direita da linha, clique no menu ⋮ e depois na opção que mostra a chave de assinatura («Signing key»). Copie-a.
De volta à XPRIO, janela Uber Direct, cole-a em Chave de assinatura dos webhooks e clique em Guardar e testar.

A partir da primeira viagem, o cartão Uber Direct passa de «Sem notificação em tempo real» a «Notificações em tempo real ativas», com a data da última notificação recebida.

Passo 5: escolher o modo de cada estabelecimento

Na XPRIO, menu Estabelecimentos, abra a ficha do estabelecimento (botão Editar) e depois o separador Entrega e Serviços.
Verifique se o serviço Entrega está ativo.
Localize a secção Quem entrega os seus pedidos, logo acima das opções de estafetas. Três cartões à escolha:
- Os meus estafetas: nada muda, os seus estafetas XPRIO Pro entregam.
- Os meus estafetas + estafeta a pedido de reforço: os seus estafetas têm prioridade. Em cada pedido de entrega pago online, o Live propõe um botão Chamar um estafeta a pedido enquanto nenhum estafeta estiver atribuído. Ideal para uma sexta-feira à noite cheia ou uma ausência.
- Apenas estafeta a pedido: cada pedido de entrega é confiado automaticamente ao estafeta. O cliente só vê o pagamento online.
Se os dois últimos cartões estiverem a cinzento com a mensagem «Pagamento online obrigatório», ative primeiro o Stripe em Configuração da Aplicação, Métodos de Pagamento.
Assim que escolhe um modo parceiro, aparecem as definições seguintes:
- Fornecedor: a lista dos fornecedores ligados que cobrem o país do estabelecimento. Escolha Uber Direct. Se a lista estiver vazia, a ligação Ligar um fornecedor leva-o de volta ao passo 3.
- Em modo reforço: a caixa Chamar automaticamente um estafeta a pedido se nenhum estafeta aceitar o pedido, com um prazo de 5 a 30 minutos depois de o pedido estar pronto. Marque-a se nem sempre houver alguém a vigiar o Live.
- Em modo apenas estafeta a pedido: Quando pedir o estafeta. A escolha recomendada é No início da preparação: o estafeta chega quando o pedido fica pronto. Na aceitação fá-lo vir mais cedo, com risco de espera faturada; Quando o pedido está pronto evita qualquer espera, mas o pedido aguarda 10 a 15 minutos.
- Em modo apenas estafeta a pedido: Taxa de entrega cobrada ao cliente. As minhas taxas fixas mantém as suas zonas e tarifas habituais. O preço do estafeta (+ margem) cobra ao cliente o orçamento Uber calculado para cada morada, mais uma margem à sua escolha, fixa ou em percentagem. Em modo reforço, o cliente paga sempre as suas taxas fixas, porque no momento do pedido ainda não se sabe quem entregará.
- Instruções de recolha para o estafeta: uma frase livre, por exemplo «entrada pelo parque, perguntar ao balcão».
- Transferir a gorjeta do cliente ao estafeta: caso contrário, a gorjeta fica no estabelecimento, como com os seus estafetas.
Guarde a ficha. O modo aplica-se de imediato aos novos pedidos.

No Live

Num pedido de entrega, o bloco do estafeta no cartão mostra:

antes da chamada: o botão 🛵 Chamar um estafeta a pedido (apenas em modo reforço);
depois da chamada: a etiqueta Estafeta a pedido, o nome do fornecedor e depois Estafeta pedido enquanto a Uber atribui alguém;
a partir da atribuição: o nome do estafeta, o telefone (mascarado pela Uber, válido durante a viagem), a etapa (Estafeta a caminho, Estafeta no estabelecimento, Recolhido, No cliente, Entregue) e a hora estimada de chegada.

Quando clica em Chamar um estafeta a pedido, uma janela de confirmação mostra o fornecedor, a morada de entrega, o custo da entrega para si, a hora de recolha prevista e a hora estimada de entrega. Clique em Pedir o estafeta para confirmar.

Quando o estafeta recolhe o pedido, este passa automaticamente a Em entrega, e a Entregue na entrega: não tem nada a fazer. Pode cancelar o estafeta a partir do bloco enquanto ele não tiver recolhido o pedido; a XPRIO lembra-lhe que podem aplicar-se custos de cancelamento.

Se a Uber não encontrar estafeta ou cancelar a viagem, recebe uma notificação na app XPRIO Pro, um som e uma mensagem no Live. O pedido continua aberto e pode pedir outro estafeta ou atribuir um dos seus. O mesmo acontece se o estafeta devolver um pedido que não conseguiu entregar: aparece como Devolvido ao estabelecimento, a tratar (nova entrega ou reembolso).

Do lado do cliente

Na sua app, o cliente vê um cartão de contacto Estafeta a pedido com o nome do estafeta, o veículo, um botão de chamada e uma ligação de acompanhamento. No mapa de acompanhamento, o estafeta move-se em tempo real como um dos seus. Se o seu estabelecimento exigir um código de entrega, o estafeta Uber pede-o ao cliente, tal como os seus estafetas.

Num estabelecimento em modo «apenas estafeta a pedido», o carrinho mostra apenas o pagamento por cartão, com a menção «Entrega por um estafeta a pedido: apenas pagamento online». Uma morada fora da cobertura Uber é assinalada com «Morada não servida pelo nosso estafeta a pedido» antes do pedido.

Perguntas frequentes

Posso testar sem um pedido real? Sim, com a conta de teste Uber (passo 1) ligada no ambiente Teste: as viagens são simuladas por um estafeta fictício, nada é faturado, e vê todo o ciclo no Live em poucos minutos.

Porque é que o orçamento difere da viagem real? O orçamento é válido 15 minutos. Se o estafeta for chamado mais tarde, a Uber recalcula nesse momento. A XPRIO nunca volta a cobrar ao cliente: a diferença é sua.

O que acontece se a minha conta Uber tiver um problema? O cartão Uber Direct passa a Erro com a mensagem da Uber, e o Live recusa chamar um estafeta até estar resolvido. Os seus estafetas continuam a funcionar normalmente.

Posso desligar a Uber Direct? Sim, botão Desligar no cartão, desde que nenhum estabelecimento continue em modo estafeta a pedido. Passe-os primeiro para «Os meus estafetas».