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) |
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 |
optional | object | Informações específicas por país |
Context
Chave | Tipo | Descrição |
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
Exemplo de requisição
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) |
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). |
Last updated