Pular para o conteúdo principal

Create new trucker

POST 
/company/truckers/

Cria um novo transportador associado à empresa do usuário autenticado.

Processo de criação:

  1. Validação de dados obrigatórios (email, taxid)
  2. Verificação de unicidade (email e taxid únicos)
  3. Geração automática de senha (se não for fornecida)
  4. Hash seguro da senha
  5. Upload da imagem de perfil para o S3 (opcional)
  6. Envio de email com credenciais
  7. Associação automática à empresa

Validações automáticas:

  • Email único no sistema
  • Taxid (DNI/NIE/CIF) único e formato válido
  • Telefone com formato válido
  • Função válida conforme modelo

Gestão de senhas:

  • Se enviada: É armazenado um hash seguro
  • Se não enviada: É gerada automaticamente e enviada por email

Gestão de imagens:

  • Suporte para upload multipart/form-data
  • Armazenamento no AWS S3
  • O campo image contém a chave do S3

Email de boas-vindas:

  • É enviado automaticamente ao transportador
  • Inclui credenciais de acesso
  • Personalizado com o nome da empresa
  • Multi-idioma conforme i18n do usuário

Limites:

  • Verificação do plano de assinatura (middleware canCreateUser)
  • Requer permissões multitenant

Respostas:

  • 200 OK: Transportador criado corretamente
  • 400 Bad Request: Dados inválidos ou falta de informação
  • 401 Unauthorized: Empresa não encontrada
  • 406 Not Acceptable: Email ou taxid já existem
  • 503 Service Unavailable: Erro ao salvar no BD

Request​

Responses​

Transportadora criada com sucesso.