Uber Integration

Ao utilizar a API da Abbiamo para solicitar coleta de pedidos via Uber, alguns erros de validação podem ocorrer no momento da criação do pedido. Abaixo, detalhamos o erro mais recorrente e como corrigi-lo.

Escopo deste guia

As correções descritas aqui valem apenas para pedidos criados via API (API - Pedido). Se o pedido for criado por formulário, importação ou outra origem, o problema também pode estar na formatação do telefone, mas o jeito de corrigir será outro (por exemplo, ajustando o formulário ou o mapeamento dos dados na origem).

1. Erro: `dropoff phone number is not valid`

Este é o erro principal retornado pela Uber quando os dados de contato do cliente (destinatário) não estão em conformidade com os padrões internacionais exigidos pela plataforma deles.

Por que isso acontece?

O motor de validação da Uber exige que o telefone seja composto pela combinação correta do DDI (Código do País) e o Número com DDD. O erro geralmente ocorre por dois motivos:

DDD no campo errado: O usuário preenche o phone_country_code com o DDD (ex: 11) em vez do código do país (Brasil = 55).
Formato inconsistente: O campo phone contém caracteres especiais ou o código do país duplicado.

Como corrigir

No objeto customer da sua chamada à API Create Order V2, certifique-se de seguir este padrão:

phone_country_code: Deve ser estritamente o código do país (ex: "55").
phone: Deve conter apenas números, iniciando pelo DDD (ex: "11940216964").

Exemplo de payload incorreto

Causa o erro

A Uber entende que o país é "11", o que é inválido.

{
  "customer": {
    "name": "CLAUDIONEIDE MARQUES",
    "phone": "11940216964",
    "phone_country_code": "11"
  }
}

Exemplo de payload correto

Aprovação imediata

Combinação correta 55 + 11...

{
  "customer": {
    "name": "CLAUDIONEIDE MARQUES",
    "phone": "11940216964",
    "phone_country_code": "55"
  }
}

Referência Técnica

Para conferir todos os campos obrigatórios do objeto de cliente, acesse a documentação do endpoint Create Order V2.

Tabela de validação rápida

Campo	Descrição	Exemplo correto
`phone_country_code`	Apenas o código internacional do país	`"55"`
`phone`	DDD + Número (apenas dígitos)	`"11940216964"`
`document_type`	Tipo de documento do cliente	`"CPF"`