Cria um usuário
POST/user
Cadastra um usuário na empresa autenticada. É obrigatório informar UserName e pelo menos um identificador de login: Login (e-mail) ou UserCpfCnpj. Quando só o documento é enviado, o sistema gera um login interno no formato <documento>@email.com.br. Quando um e-mail real é informado, um e-mail de boas-vindas é enviado.
Se já existir um registro de pessoa com o mesmo Login/UserCpfCnpj em outra conta (ou desvinculado), o cadastro reaproveita e revincula esse registro à empresa atual em vez de duplicar. Nesse caminho de revínculo apenas os dados do vínculo com a empresa são aplicados — os dados pessoais já existentes da pessoa (UserName, UserTelephone, UserExtenalId, MFAEnabled, MFAType) e RestrictAccessSalesman são preservados como estavam. Login e UserCpfCnpj precisam ser únicos dentro da empresa.
O cadastro também aceita os dados profissionais do colaborador — funções, função atual, cargo, escala, supervisor e categorias/grupos de endereço de armazenagem —, validados contra os cadastros da empresa.
Request
Responses
- 200
- 400
- 500
Usuário criado. Quando o login foi gerado a partir do documento, retorna a string "sucesso". Quando um e-mail real foi informado, retorna o detalhe completo do usuário (mesmo formato de GET /user/{iduser}).
Erros (prefixo [BadRequest]):
CPF / CNPJ inválido, verificar os números digitadosEmail inválido, verificarTipo de MFA inválidoTipo de comissão não existeDocumento obrigatório quando não é informadoDocumento e/ou email obrigatório para cadastrar usuárioEmail já está vinculado a outro usuárioDocumento já está vinculado a outro usuárioEmpresa não existeProblema ao criar usuário
Validação dos dados profissionais:
Função não existente, preencha corretamenteFunção atual não atribuída ao colaboradorCargo não existe, preencha corretamenteFunção não permitida para o cargo selecionadoEscala não existe, preencha corretamenteColaborador superior não existe, preencha corretamenteCategoria de armazenamento não existeGrupo de armazenamento não existe
Erro interno (prefixo Error:).