Cargas por órgão avulso
Alguns órgãos dentro de um patriarca (por exemplo, empresas públicas) possuem gestão própria de RH e não são atualizados pela carga do patriarca inteiro.
Para esses casos existe o controller:
/v3/CargaOrgaoAvulso
A autorização é concedida diretamente ao órgão raiz, e a carga alcança apenas esse órgão.
Headers comuns:
- Authorization: Bearer {access_token}
- Content-Type: application/json (para requisições com corpo)
POST /v3/CargaOrgaoAvulso/organograma/{guidRaiz}
Envia a estrutura completa de órgãos/unidades do órgão raiz controlado de forma avulsa.
POST /v3/CargaOrgaoAvulso/organograma/{guidRaiz}
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
guidRaiz | GUID | Sim | Identificador do órgão raiz autorizado para carga. |
Corpo (JSON)
O corpo segue o mesmo formato lógico da carga de organograma (descrito em CargaOrganogramaEntrada), aplicado ao escopo do órgão avulso autorizado.
Resposta
- 201 Created com um Guid identificando o pedido de carga.
- Erros de validação/autorização retornam 4xx.
POST /v3/CargaOrgaoAvulso/lotacoes/{guidRaiz}
Envia a carga de lotações (ocupações, lotações, comissões, gestores) para o órgão raiz autorizado.
POST /v3/CargaOrgaoAvulso/lotacoes/{guidRaiz}
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
guidRaiz | GUID | Sim | Identificador do órgão raiz autorizado para carga. |
Corpo (JSON)
Segue o mesmo formato conceitual da CargaLotacaoEntrada , aplicado ao contexto do órgão avulso.
A carga é interpretada como completa para aquele órgão.
Resposta
- 201 Created com um Guid identificando o pedido de carga.
- Erros de validação/autorização retornam 4xx.
GET /v3/CargaOrgaoAvulso/{guid}/status
Consulta a situação de um pedido de carga de órgão avulso.
GET /v3/CargaOrgaoAvulso/{guid}/status
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
guid | GUID | Sim | Identificador do pedido de carga. |
Resposta
- 200 OK com um objeto de status da carga (por exemplo, situação, data de criação, tipo de carga, mensagens de erro, etc.).
- Erros de validação/autorização retornam 4xx.
GET /v3/CargaOrgaoAvulso/{guidRaiz}/ultimasStatus
Retorna a situação dos últimos pedidos de carga para um patriarca.
GET /v3/CargaOrgaoAvulso/{guidRaiz}/ultimasStatus
Parâmetros de rota
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
guidRaiz | GUID | Sim | Identificador do órgão raiz autorizado. |
Resposta
- 200 OK com a lista das cargas mais recentes daquele órgão avulso.
- Erros de validação/autorização retornam 4xx.