Conceitos e fluxo de carga

Carga completa por escopo

O CargaRH trabalha sempre com carga completa, nunca com “diff”.

Em cada chamada você pode enviar:

• para um patriarca: toda a estrutura daquele patriarca (todos os orgãos e a estrutura de unidades de cada um);
• para um órgão: todas as lotações daquele órgão (seguindo a hierarquia de unidades);
• para um pacote de órgãos: vários objetos de carga de orgão, como específicado acima, mas em pacotes com mais de um orgão.

O sistema compara o conteúdo enviado com o que já existe e faz:

• inclusões para o que é novo;
• atualizações para o que mudou;
• exclusões para o que deixou de existir na carga.

Importante

Tudo o que NÃO for enviado dentro do escopo da carga pode ser considerado para exclusão. Cada carga deve representar a visão completa e atual do seu sistema para aquele patriarca/órgão.

Patriarca, órgãos e unidades

• Patriarca: raiz lógica de uma estrutura organizacional (por exemplo, “Governo do ES”, "Prefeitura de Vitória").
• Órgão: é a unidade administrativa de primeiro nível dentro de um patriarca, responsável por um conjunto próprio de competências (por exemplo: secretaria, autarquia, fundação, instituto, etc.), que agrupa setores e lotações. Secretarias que não possuem CNPJ próprio podem (e devem) ser modeladas como órgãos, desde que sejam reconhecidas na estrutura oficial do ente como unidades administrativas com competências próprias.
• Unidade: unidades internas do órgão (departamentos, gerências etc.).

A carga de organograma envia todos os órgãos do patriarca e, dentro de cada órgão, suas unidades e a relação hierárquica entre elas.

Lotações, ocupações, comissões e gestores

No CargaRH:

• você cadastra ocupações (cargos/funções) que podem ser usadas em lotações. Podem ser dos tipos:
  • servidor (gerente, analista, técnico, etc.)
  • comissão (presidente, membro, suplente, etc.);
• uma lotação de servidor liga:
  • um CPF
  • a uma unidade
  • e a uma ocupação;
• uma comissão agrupa pessoas em ocupações específicas dentro daquele órgão;
• uma lotação em comissão liga um CPF a uma comissão e a uma ocupação do tipo comissão;
• um gestor é um vínculo que indica qual CPF é gestor de determinada unidade, com determinada ocupação. Não é necessário que o gestor esteja lotado na unidade que ele gerencia. Caso ele não esteja lotado na unidade que ele gerencia, a unidade da lotação de gestor deve ser informada separadamente junto com a informação de gestão.

Essas estruturas são enviadas juntas na carga de lotações.

Cargas por patriarca

Os endpoints de patriarca são usados quando a autorização do CargaRH tem escopo para o patriarca inteiro:

• POST /v3/Carga/organograma/{guidPatriarcaRaiz}
• POST /v3/Carga/lotacoes/{guidPatriarcaRaiz}
• POST /v3/Carga/lotacoes/pacote/{guidPatriarcaRaiz}

Enquanto uma carga estiver em processamento para um patriarca, novas cargas para o mesmo patriarca vão ser recusadas. Por isso, quando há muitos órgãos, recomenda-se usar o endpoint de pacote de lotações para enviar várias lotações de órgão de uma vez, sem repetir órgãos na lista.

Cargas por órgão avulso

Alguns órgãos dentro de um patriarca (por exemplo, empresas públicas como Banestes ou Cesan) possuem gestão própria de suas informações de RH.

Para esses casos:

• a carga por patriarca ignora esse órgão;

• o cadastro do órgão é mantido manualmente no Organograma;

• existe uma autorização e um endpoint específico para ele:

• POST /v3/CargaOrgaoAvulso/organograma/{guidRaiz}

• POST /v3/CargaOrgaoAvulso/lotacoes/{guidRaiz}

Assim, o órgão avulso controla suas informações de forma independente, sem depender da carga do patriarca inteiro.

Consulta de status

Toda carga gera um identificador (Guid) que pode ser usado para consultar o status do processamento:

• GET /v3/Carga/{guid}/status
• GET /v3/Carga/{guidPatriarcaRaiz}/ultimasStatus
• GET /v3/CargaOrgaoAvulso/{guid}/status
• GET /v3/CargaOrgaoAvulso/{guidRaiz}/ultimasStatus

Isso permite que o sistema integrador acompanhe o resultado das cargas sem intervenção manual.