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

NameTypeDescription

acc

string

UID da empresa onde o cargo será criado

Headers

NameTypeDescription

Authorization

string

Token de acesso adquirido pela plataforma Identity (bearer)

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

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

Chave

Tipo

Descrição

code

required

string

Código do cargo

name

required

string

Nome do cargo

context

optional

object

Informações específicas por país

Context

Chave

Tipo

Descrição

brazil

optional

object

Informações específicas para o Brasil

Brazil

Chave

Tipo

Descrição

cbo

optional

string

Número do CBO

escolaridadeMinima

optional

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

NameTypeDescription

acc

string

UID da empresa de onde os cargos serão listados

Query Parameters

NameTypeDescription

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

NameTypeDescription

Authorization

string

Token de acesso adquirido pela plataforma Identity (bearer)

[
    {
        "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

NameTypeDescription

uid

string

UID do cargo a ser deletado.

acc

string

UID da empresa de onde o cargo será deletado.

Headers

NameTypeDescription

Authorization

string

Token de acesso adquirido pela plataforma Identity (bearer).

Last updated