Tipos básicos (value objects)

Alguns campos do CargaRH usam tipos de valor (value objects) que aplicam validações e normalização de texto ainda no backend.

Na API, todos esses tipos são representados como string no JSON, mas seguem regras específicas.

Cpf

Representa um CPF.

• Formato de entrada aceito:
  • com ou sem máscara ("123.456.789-01" ou "12345678901").
• A API:
  • remove pontos e traços;
  • exige exatamente 11 dígitos;
  • recusa valores com letras;
  • valida o dígito verificador do CPF.

Se qualquer regra for violada, a carga é rejeitada com erro de validação.

ChaveExterna

Chave textual usada para identificar órgãos, unidades, ocupações e comissões.

• String obrigatória;
• Espaços internos são normalizados (múltiplos espaços viram um só);
• Texto é Trim() + convertido para maiúsculas;
• Tamanho máximo: 200 caracteres.

Use um identificador estável do seu sistema (por exemplo, código interno ou chave natural).

OrgaoNome, UnidadeNome, OcupacaoNome, ComissaoNome

Nomes descritivos de órgãos, unidades, ocupações e comissões.

• String obrigatória;
• Espaços internos normalizados;
• Texto armazenado em maiúsculas;
• Tamanho máximo: 100 caracteres.

OrgaoSigla

Sigla do órgão.

• String obrigatória;
• Espaços normalizados;
• Texto armazenado em maiúsculas;
• Tamanho máximo: 20 caracteres.

UnidadeSigla

Sigla da unidade.

• String obrigatória;
• Espaços normalizados;
• Texto armazenado em maiúsculas;
• Tamanho máximo: 25 caracteres.