Uber Direct
A Uber Direct é o serviço de entrega sob demanda da Uber voltado para empresas. Diferente do iFood ou de marketplaces, a Uber Direct não e uma vitrine de pedidos -- ela fornece apenas o entregador para realizar a entrega de pedidos ja recebidos no seu estabelecimento.
Com essa integração, ao receber um pedido delivery no MeuCardapio.ai, solicite um entregador da Uber com poucos cliques. O sistema calcula automaticamente a taxa de entrega via API, despacha o entregador e permite acompanhar a corrida em tempo real.
Como funciona
| Etapa | Descrição |
|---|---|
| 1. Pedido chega | O cliente faz o pedido pelo cardápio digital, WhatsApp ou Instagram |
| 2. Calcula taxa | O sistema consulta a API da Uber e calcula o valor da entrega automaticamente |
| 3. Solicita entregador | O operador confirma e solicita o entregador pelo painel |
| 4. Acompanha em tempo real | Status da corrida atualiza automaticamente via webhook |
| 5. Entrega concluida | O entregador entrega o pedido e o status e atualizado |
A Uber Direct apenas entrega. O pedido continua sendo feito no seu cardápio digital. Isso e diferente de um marketplace (como iFood Delivery), onde o cliente faz o pedido dentro do app do iFood.
Pré-requisitos
Antes de ativar a integração, verifique os seguintes requisitos:
- Endereço completo da empresa cadastrado no sistema, incluindo CEP e localização (latitude/longitude)
- Número de WhatsApp configurado na empresa (usado como telefone de contato para o entregador)
- Plano ativo no MeuCardapio.ai que inclua a funcionalidade de integrações
Sem endereço completo com CEP e coordenadas geográficas, a integração não conseguira calcular rotas nem solicitar entregadores. Configure o endereço da empresa em Configurações > Dados da Empresa.
Ativar a integração
- Acesse o painel administrativo do MeuCardapio.ai
- Navegue ate Integracoes > Uber Direct
- Preencha os dados solicitados (veja a tabela abaixo)
- Clique em Salvar
- O sistema validará as credenciais automaticamente obtendo um token de acesso
- Após a validacao, clique em Ativar
Campos de configuração
| Campo | Tipo | Descrição |
|---|---|---|
| Customer ID | Texto | Identificador da conta Uber Direct fornecido pela Uber |
| Restaurante | Sim/Não | Marque se o estabelecimento e um restaurante. Altera o fluxo de verificação na retirada: restaurantes exigem apenas foto; demais estabelecimentos exigem foto e assinatura |
| Tempo de preparo | Número (minutos) | Tempo estimado para o pedido ficar pronto. Quando o modo restaurante está ativo, o sistema agenda a retirada pelo entregador após esse tempo |
| Instruções de retirada | Texto | Orientacoes para o entregador ao chegar no estabelecimento (ex.: "Retirar no balcao lateral") |
| Acao de retorno | Seleção | Acao padrão de retorno configurável para a integração |
O token de acesso da Uber tem validade de 30 dias e é renovado automaticamente pelo sistema. Não e necessário nenhuma ação manual para manter a conexao ativa.
Configurar taxa de entrega por API Uber
Para que o valor da entrega seja calculado automaticamente pela Uber ao montar o pedido:
- Acesse Configurações > Formas de Entrega
- Na forma de entrega "Receber em casa", selecione o tipo de cobranca Por API Uber
- Salve as configurações
Com isso, quando o cliente informar o endereço de entrega, o sistema consultara a API da Uber para obter uma cotação em tempo real. O valor retornado pela API (em centavos) é convertido automaticamente para reais.
Opcoes adicionais da forma de entrega
| Configuração | Descrição |
|---|---|
| Por API Uber | A taxa de entrega e calculada pela Uber com base na distancia e demanda |
| Frete gratis | Configure um valor minimo de pedido para conceder frete gratis (opcional). Se o pedido atingir o valor configurado, a taxa de entrega será zero |
| Area de entrega (KML) | Restrinja a area de cobertura com um arquivo KML/GeoJSON para evitar cotações fora da região (opcional). Endereços fora da area serao rejeitados antes de consultar a API |
| Taxa extra de retorno | Valor adicional somado a taxa calculada pela Uber (opcional). Util para cobrir margem operacional |
Solicitar entregador para um pedido
Após o pedido ser confirmado e pago:
- Abra o pedido no painel
- Clique em Solicitar entregador (Uber)
- Escolha a opção de nao-entrega:
- Retornar: se o entregador não encontrar o cliente, retorna o pedido ao estabelecimento
- Descartar: se o entregador não encontrar o cliente, descarta o pedido
- Aguarde a confirmacao do entregador
O sistema envia a solicitação para a Uber contendo:
- Endereço de coleta (seu estabelecimento) com CEP, coordenadas e telefone
- Endereço de entrega (endereço do cliente) com complemento e ponto de referencia
- Lista de itens do pedido (nome, quantidade)
- Valor total do pedido
- Código do pedido como referencia
- Configurações de verificação (PIN, foto, assinatura)
Somente pedidos ja pagos podem ser despachados para a Uber Direct. Pedidos pendentes de pagamento serao rejeitados pelo sistema.
Verificação na retirada (coleta)
O sistema configura automaticamente a verificação ao retirar o pedido no estabelecimento:
| Tipo de estabelecimento | Verificação exigida |
|---|---|
| Restaurante | Foto do pedido |
| Outros | Foto do pedido + assinatura do responsável |
Verificação na entrega (dropoff)
Na entrega ao cliente, o sistema configura:
- Código PIN: gerado automaticamente para o cliente confirmar o recebimento
- Foto da entrega: o entregador tira foto como comprovante
- Encontrar na porta: o entregador aguarda o cliente na porta (comportamento padrão)
Acao quando o pedido não pode ser entregue
| Opção | Descrição |
|---|---|
| Retornar | O pedido volta ao estabelecimento. O entregador coleta assinatura e foto no retorno |
| Descartar | O pedido é descartado pelo entregador. Util para alimentos pereciveis |
Acompanhar a entrega
O MeuCardapio.ai recebe atualizações em tempo real via webhook da Uber. Os status da entrega sao:
| Status | Código API | Descrição |
|---|---|---|
| Pendente | pending | Entrega solicitada, aguardando entregador |
| A caminho da loja | pickup | Entregador a caminho do estabelecimento para retirar o pedido |
| Pedido coletado | pickup_complete | Entregador retirou o pedido no estabelecimento |
| Entrega a caminho | dropoff | Entregador a caminho do endereço do cliente |
| Entregue | delivered | Pedido entregue com sucesso ao cliente |
| Cancelado | canceled | Entrega cancelada (pela loja, entregador ou Uber) |
| Rejeitado | rejected | Solicitacao de entrega rejeitada pela Uber |
| Retornado | returned | Pedido retornado ao estabelecimento (quando não foi possível entregar) |
Informações do entregador
Quando o entregador é alocado, o sistema exibe:
- Nome do entregador
- Telefone de contato
- Veículo: tipo (carro/moto), marca, modelo e cor (traduzida para português)
- URL de rastreamento: link para acompanhar a localização do entregador em tempo real
- Código PIN: código que o cliente deve informar ao entregador para confirmar o recebimento
- ETA de coleta: horário estimado de chegada ao estabelecimento
- ETA de entrega: horário estimado de chegada ao cliente
Sincronizar status manualmente
Se necessário, force a atualizacao do status:
- Abra o pedido no painel
- Na seção Delivery, clique em Sincronizar
- O sistema consulta a API da Uber e atualiza o status localmente
Histórico de notificações
Cada atualização de status recebida via webhook é armazenada como uma notificação. Para visualizar o histórico completo:
- Abra o pedido no painel
- Acesse a seção de Notificações da entrega
- Veja todos os eventos com data, hora e status
Cancelar uma entrega
Para cancelar uma entrega ja solicitada:
- Abra o pedido no painel
- Clique em Cancelar entrega
- Confirme o cancelamento
O cancelamento so e permitido enquanto o status for Pendente ou A caminho da loja. Após a coleta do pedido, não é possível cancelar.
O cancelamento pode gerar cobranca pela Uber dependendo do status da corrida. Cancele o mais cedo possível para evitar custos adicionais.
Solicitar novamente após cancelamento
Se uma entrega foi cancelada ou rejeitada, é possível solicitar um novo entregador para o mesmo pedido:
- Abra o pedido no painel
- Clique em Solicitar entregador novamente
- Uma nova corrida será criada na Uber
Custos
| Item | Detalhes |
|---|---|
| Taxa de entrega | Calculada pela Uber com base em distancia, demanda e região. A API retorna o valor em centavos, que é convertido automaticamente para reais |
| Cancelamento | Pode haver cobranca dependendo do andamento da corrida |
| Retorno | Se o pedido retornar ao estabelecimento, pode haver taxa adicional (configurável como "taxa extra retorno" na forma de entrega) |
O valor da taxa de entrega exibido ao cliente ja inclui o calculo da Uber. Configure uma taxa extra de retorno nas formas de entrega se quiser adicionar uma margem ao valor cobrado.
Erros comuns
O sistema traduz automaticamente os erros da API da Uber para mensagens em português. Os mais frequentes:
| Erro | Causa | Solução |
|---|---|---|
Endereço não encontrado (unknown_location) | CEP ou coordenadas inválidos | Verifique o endereço da empresa e do cliente |
Endereço fora da area (address_undeliverable) | Regiao não atendida pela Uber | O cliente esta fora da cobertura Uber na região |
| Permissao negada (403) | Credenciais inválidas | Reconfigure a integração com o Customer ID correto |
| Não autorizado (401) | Token expirado ou inválido | O sistema renova automaticamente; se persistir, desative e reative a integração |
| Apenas pedidos pagos | Pedido não foi pago | Conclua o pagamento antes de solicitar entregador |
| Configure número WhatsApp | WhatsApp da loja não configurado | Cadastre o número de WhatsApp em Configurações > Dados da Empresa |
| Endereço sem CEP | Endereço de entrega ou da empresa sem CEP | Cadastre o CEP no endereço |
| Localização inválida | Coordenadas do endereço não foram encontradas | Verifique o endereço e confirme que possui localização válida |
| Integração OpenDelivery ativa | Tentativa de ativar Uber Direct com OpenDelivery Logística ativa | Desative a integração OpenDelivery Logística antes de ativar a Uber Direct |
Desativar a integração
- Acesse Integracoes > Uber Direct
- Clique em Desativar
Não é possível desativar a integração enquanto houver uma forma de entrega configurada como "Por API Uber". Altere o tipo de cobranca da forma de entrega antes de desativar.
Perguntas frequentes
A Uber Direct funciona em qualquer cidade?
A Uber Direct está disponível nas cidades onde a Uber opera servicos de entrega. Consulte a cobertura na sua região.
Posso usar a Uber Direct junto com outras formas de entrega?
Sim. Configure a forma de entrega "Receber em casa" com tipo de cobranca Por API Uber para delivery via Uber, e mantenha outras formas (retirada, por exemplo) ativas normalmente.
O cliente ve o rastreamento do entregador?
O sistema gera uma URL de rastreamento da Uber quando o entregador é alocado. O acompanhamento detalhado do entregador (nome, veículo, localização) e visivel no painel administrativo.
Preciso ter conta na Uber para usar?
Sim. E necessário ter um Customer ID da Uber Direct. Entre em contato com o suporte do MeuCardapio.ai para obter orientacoes sobre como criar sua conta Uber Direct.
E possível usar Uber Direct e iFood Delivery ao mesmo tempo?
Não na mesma forma de entrega. Cada forma de entrega pode usar apenas uma API por vez (Uber, iFood ou OpenDelivery). Porem, você pode ter formas de entrega diferentes para cada integração.
O que acontece se a integração OpenDelivery Logistica ja estiver ativa?
Não é possível ativar a Uber Direct se a integração com OpenDelivery Logistica ja estiver ativa. Desative uma antes de ativar a outra.
O que e o código PIN exibido na entrega?
E um código gerado automaticamente que o cliente informa ao entregador para confirmar que recebeu o pedido. Isso garante seguranca na entrega.
Posso restringir a area de entrega mesmo usando a API da Uber?
Sim. Configure um arquivo KML/GeoJSON na forma de entrega para definir a area de cobertura. Endereços fora dessa area serao rejeitados antes de consultar a API da Uber, evitando cotações desnecessarias.
Qual a diferença entre o modo "Restaurante" e o modo padrão?
No modo Restaurante, o sistema agenda a retirada considerando o tempo de preparo e exige apenas foto na coleta. No modo padrão (nao-restaurante), a retirada e imediata e exige foto e assinatura do responsável.