Cargos

Criação, listagem e delete de cargos

O cargo a ser selecionado na criação de vaga do candidato. Os campos de código, CBO (Classificação Brasileira de Ocupações) e escolaridade mínima são opcionais.

Escolaridade mínima é uma configuração que impede a seleção de uma escolaridade inferior por parte do candidato, assim bloqueando a admissão em caso de ser um pré-requisito para o cargo.

A Classificação Brasileira de Ocupações (CBO) são códigos pré-determinados, padronizados pelo Ministério do Trabalho na tentativa de retratar a realidade das profissões do mercado de trabalho brasileiro. O código a ser inserido deve ser válido. mais info.

Código é um campo aberto para uso de outros sistemas em caso de integração, sendo assim não existe validações neste campo.

Create role

POST https://api.acessorh.com.br/v1/role/json/:acc

Cria um cargo na empresa selecionada.

Path Parameters

Name	Type	Description
acc*	string	UID da empresa onde o cargo será criado

Headers

Name	Type	Description
Authorization*	string	Token de acesso adquirido pela plataforma Identity (bearer)

201 OK

{
    "code": 201,
    "messages": null,
    "result": {
        "uid": "3a46ca19-506f-4e80-a217-891d48a2a0ac"
    },
    "status": "ok"
}

Descrição do body JSON da requisição

code*	string	Código do cargo
name*	string	Nome do cargo
context	object	Informações específicas por país

Context

brazil	object	Informações específicas para o Brasil

Brazil

Chave	Tipo	Descrição
cbo	string	Número do CBO
escolaridadeMinima	string(options)	Escolaridade mínima permitida para o cargo

Opções de escolaridade mínima

"analfabeto", "5_ano_fundamental_incompleto", "5_ano_fundamental_completo", "6_9_fundamental_incompleto", "fundamental_completo", "medio_incompleto", "medio_completo", "superior_incompleto", "superior_completo", "pos_graduacao", "especializacao", "mestrado", "doutorado", "phd"

Exemplo de requisição

{
	"code":"an-prog-jr",
    "name": "Analista Programador Jr",
    "context": {
        "brazil": {
            "cbo": "789",
            "escolaridadeMinima": "superior_completo"
        }
    }
}

List roles

GET https://api.acessorh.com.br/v1/role/:acc

Lista os cargos da empresa selecionada.

Path Parameters

Name	Type	Description
acc*	string	UID da empresa de onde os cargos serão listados

Query Parameters

Name	Type	Description
limit*	string	Limite de cargos que serão listados (paginação)
skip*	string	Indica a quantidade de cargos que serão pulados (paginação)
code*	string	Código do cargo que deverá ser filtrado

Headers

Name	Type	Description
Authorization*	string	Token de acesso adquirido pela plataforma Identity (bearer)

200 OK

[
    {
        "acc": "bf63e2bd-da94-4bc3-862d-49daf9fadb87",
        "code": "an-prog-jr",
        "context": {
            "brazil": {
                "cbo": "789",
                "escolaridadeMinima": "superior_completo"
            }
        },
        "id": "3a46ca19-506f-4e80-a217-891d48a2a0ac",
        "name": "Analista Programador Jr"
    }
]

Caso não seja inserido os parâmetros limit e skip , os valores padrões serão, respectivamente, 1000 e 0.

O parâmetro limit tem o seu valor máximo como 1000.

Delete role

DELETE https://api.acessorh.com.br/v1/role

Deleta um cargo da empresa selecionada.

Query Parameters

Name	Type	Description
uid*	string	UID do cargo a ser deletado.
acc*	string	UID da empresa de onde o cargo será deletado.

Headers

Name	Type	Description
Authorization*	string	Token de acesso adquirido pela plataforma Identity (bearer).

200 OK