Modelo de dados – Lotações

A carga de lotações envia, para um órgão específico:

• as ocupações (cargos/funções);
• as lotações de servidor (servidores em unidades/cargos);
• as comissões;
• as lotações em comissão;
• e os gestores.

Tudo isso é enviado em um único objeto CargaLotacaoEntrada.

Objeto CargaLotacaoEntrada

{
  "PatriarcaId": "GUID-DO-PATRIARCA",
  "ChaveExternaOrgao": "ORG-SESA",
  "OcupacaoServidor": [ { ... } ],
  "LotacoesServidor": [ { ... } ],
  "Gestores": [ { ... } ],
  "OcupacaoComissao": [ { ... } ],
  "Comissoes": [ { ... } ],
  "LotacoesComissao": [ { ... } ]
}

Campo	Tipo	Obrigatório	Descrição
PatriarcaId	string (GUID)	Sim	Identificador do patriarca da carga. Deve ser o mesmo usado na carga de organograma.
ChaveExternaOrgao	string	Sim	Chave externa do órgão (a mesma usada em OrgaoEntrada.ChaveExterna).
OcupacaoServidor	array	Sim	Lista de ocupações que podem ser usadas em lotações de servidor. Cada item é um OcupacaoEntrada.
LotacoesServidor	array	Sim	Lista de lotações de servidor (vínculo CPF + unidade + ocupação). Cada item é um LotacaoServidorEntrada.
Gestores	array	Sim	Lista de vínculos de gestor. Cada item é um GestorEntrada.
OcupacaoComissao	array	Sim	Lista de ocupações que podem ser usadas em lotações de comissão.
Comissoes	array	Sim	Lista de comissões do órgão. Cada item é um ComissaoEntrada.
LotacoesComissao	array	Sim	Lista de lotações em comissão (CPF + comissão + ocupação). Cada item é um LotacaoComissaoEntrada.

Todos esses conjuntos são interpretados de forma completa: se uma ocupação, lotação ou comissão deixar de ser enviada, ela poderá ser removida do sistema dentro do escopo desse órgão.

Objeto OcupacaoEntrada

{
  "ChaveExterna": "OCUP-ANALISTA-SISTEMAS",
  "Nome": "Analista de Sistemas",
  "NomeFeminino": "Analista de Sistemas"
}

Campo	Tipo	Obrigatório	Descrição
ChaveExterna	string	Sim	Identificador único da ocupação. Máx. 200 caracteres. Normalizado em maiúsculas.
Nome	string	Sim	Nome da ocupação (masculino/neutro). Máx. 100 caracteres. Armazenado em maiúsculas.
NomeFeminino	string	Não	Nome da ocupação no feminino, quando aplicável. Máx. 100 caracteres. Armazenado em maiúsculas.

Objeto LotacaoServidorEntrada

{
  "Cpf": "12345678901",
  "ChaveExternaUnidade": "ORG-SESA-UNID-GERH",
  "ChaveExternaOcupacao": "OCUP-ANALISTA-SISTEMAS"
}

Campo	Tipo	Obrigatório	Descrição
Cpf	string	Sim	CPF do servidor, apenas números. Deve ter 11 dígitos e passar na validação padrão de CPF.
ChaveExternaUnidade	string	Sim	Chave externa da unidade onde o servidor está lotado. Deve existir na carga de organograma.
ChaveExternaOcupacao	string	Sim	Chave externa da ocupação usada na lotação. Deve existir na lista de OcupacaoServidor.

Objeto ComissaoEntrada

{
  "ChaveExterna": "COMISSAO-CG-2025",
  "Nome": "Comissão de Governança 2025"
}

Campo	Tipo	Obrigatório	Descrição
ChaveExterna	string	Sim	Identificador da comissão. Máx. 200 caracteres. Normalizado em maiúsculas.
Nome	string	Sim	Nome da comissão. Máx. 100 caracteres. Armazenado em maiúsculas.

Objeto LotacaoComissaoEntrada

{
  "Cpf": "12345678901",
  "ChaveExternaComissao": "COMISSAO-CG-2025",
  "ChaveExternaOcupacao": "OCUP-MEMBRO"
}

Campo	Tipo	Obrigatório	Descrição
Cpf	string	Sim	CPF do membro da comissão, apenas números, 11 dígitos válidos.
ChaveExternaComissao	string	Sim	Chave externa da comissão. Deve existir na lista de Comissoes.
ChaveExternaOcupacao	string	Sim	Chave externa da ocupação exercida dentro da comissão. Deve existir em OcupacaoComissao.

Objeto GestorEntrada

{
  "ChaveExternaUnidade": "ORG-SESA-UNID-GERH",
  "GestorCpf": "12345678901",
  "ChaveExternaOcupacao": "OCUP-GERENTE",
  "ChaveExternaUnidadeDaOcupacao": "ORG-SESA-UNID-GERH"
}

Campo	Tipo	Obrigatório	Descrição
ChaveExternaUnidade	string	Sim	Unidade onde o servidor exerce papel de gestor.
GestorCpf	string	Sim	CPF do gestor. 11 dígitos válidos.
ChaveExternaOcupacao	string	Sim	Ocupação com a qual o servidor é reconhecido como gestor (ex.: “GERENTE”, “DIRETOR”).
ChaveExternaUnidadeDaOcupacao	string ou null	Não	Unidade onde o servidor exerce a ocupação, quando diferente da unidade onde ele é gestor. Pode ser null se não se aplicar.

Exemplo completo de carga de lotações

{
  "PatriarcaId": "8f1d9f5b-0a8e-4f5b-a12b-2a3b4c5d6e7f",
  "ChaveExternaOrgao": "ORG-SESA",
  "OcupacaoServidor": [
    {
      "ChaveExterna": "OCUP-ANALISTA-SISTEMAS",
      "Nome": "Analista de Sistemas",
      "NomeFeminino": "Analista de Sistemas"
    },
    {
      "ChaveExterna": "OCUP-GERENTE",
      "Nome": "Gerente",
      "NomeFeminino": "Gerente"
    }
  ],
  "LotacoesServidor": [
    {
      "Cpf": "12345678901",
      "ChaveExternaUnidade": "ORG-SESA-UNID-GERH",
      "ChaveExternaOcupacao": "OCUP-ANALISTA-SISTEMAS"
    }
  ],
  "Gestores": [
    {
      "ChaveExternaUnidade": "ORG-SESA-UNID-GERH",
      "GestorCpf": "12345678901",
      "ChaveExternaOcupacao": "OCUP-GERENTE",
      "ChaveExternaUnidadeDaOcupacao": "ORG-SESA-UNID-GERH"
    }
  ],
  "OcupacaoComissao": [
    {
      "ChaveExterna": "OCUP-MEMBRO",
      "Nome": "Membro",
      "NomeFeminino": "Membra"
    }
  ],
  "Comissoes": [
    {
      "ChaveExterna": "COMISSAO-CG-2025",
      "Nome": "Comissão de Governança 2025"
    }
  ],
  "LotacoesComissao": [
    {
      "Cpf": "12345678901",
      "ChaveExternaComissao": "COMISSAO-CG-2025",
      "ChaveExternaOcupacao": "OCUP-MEMBRO"
    }
  ]
}