Add a driver to a carrier
POST/company/my_carriers/driver/:carrierId
Registra um novo motorista associado a um transportador específico. Requer autenticação via JWT.
Casos de uso:
- Registrar motoristas para transportadores existentes
- Manter um diretório de motoristas disponíveis
- Associar motoristas a operações logísticas
Notas:
- O transportador deve existir previamente
- São necessários dados básicos do motorista
- Reutilização de motoristas: Se já existir um motorista com o mesmo
taxid, o endpoint reutilizará o motorista existente em vez de criar um duplicado - Senha automática: Se nenhuma senha for fornecida, uma será gerada automaticamente como 123456 e hashada com bcrypt antes de ser salva
Request
Responses
- 201
- 400
- 401
- 404
Motorista adicionado corretamente.
NOTA IMPORTANTE: O endpoint retorna o objeto Carrier completo com o array de drivers atualizado,
NÃO apenas o driver criado. O novo driver estará no último elemento do array drivers.
Estrutura de IDs em drivers:
_id: ID do subdocumento dentro do arraydriversdo carrierassociated: ID do usuáriotrucker_userna coleçãotruckers_users(referência ao usuário real)
Response Headers
Dados de entrada inválidos. Possíveis causas:
- Nome vazio ou muito curto
- DNI/NIE com formato incorreto
- Email inválido
- Telefone mal formado
Response Headers
Não autorizado. Token JWT inválido ou não fornecido.
Response Headers
Transportadora não encontrada. O ID fornecido não existe ou não está associado à empresa.