Modelo de Dados — Motorista

Referencia do objeto de perfil de motorista retornado por GET /api/v1/drivers.

Campos

Campo	Tipo	Nullable	Descricao
`id`	UUID	nao	ID do perfil — mesmo UUID do Supabase Auth
`full_name`	string	nao	Nome completo
`email`	string	nao	Email de acesso
`phone`	string	sim	Telefone com DDD e codigo do pais
`role`	string	nao	Sempre `"driver"` neste contexto
`asaas_account_id`	string	sim	ID da subconta ASAAS criada para recebimentos
`pix_key`	string	sim	Chave Pix padrao para saques
`pix_key_type`	string	sim	Tipo: `cpf`, `phone`, `email` ou `random`
`is_active`	boolean	nao	`true` se o motorista pode aceitar entregas
`created_at`	datetime	nao	Data de cadastro (ISO 8601, UTC)
`updated_at`	datetime	nao	Ultima atualizacao do perfil

Exemplo de objeto completo

{
  "id": "550e8400-e29b-41d4-a716-446655440001",
  "full_name": "Carlos Silva",
  "email": "carlos@motoboy.com",
  "phone": "+5562999990001",
  "role": "driver",
  "asaas_account_id": "acc_123456abcdef",
  "pix_key": "carlos@motoboy.com",
  "pix_key_type": "email",
  "is_active": true,
  "created_at": "2026-01-15T10:30:00Z",
  "updated_at": "2026-05-01T08:00:00Z"
}

Notas

asaas_account_id e null enquanto a subconta ASAAS nao for criada (processo assíncrono no cadastro)
pix_key e a chave padrão do motorista; ele pode informar uma chave diferente ao solicitar cada saque via POST /api/v1/wallets/withdraw
Motoristas com is_active = false nao aparecem no mapa e nao podem aceitar entregas