# 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](http://www.mtecbo.gov.br/cbosite/pages/home.jsf)

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

<mark style="color:green;">`POST`</mark> `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*) |

{% tabs %}
{% tab title="201 " %}

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

{% endtab %}
{% endtabs %}

* [Descrição do body JSON da requisição](/project/api/cargos.md#descricao-do-body-json-da-requisicao)
* [Exemplo de requisição](/project/api/cargos.md#exemplo-de-requisicao)

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

| Chave                                                                                                     | Tipo   | Descrição                        |
| --------------------------------------------------------------------------------------------------------- | ------ | -------------------------------- |
| <p><strong>code</strong></p><p><em>required</em></p>                                                      | string | Código do cargo                  |
| <p><strong>name</strong></p><p><em>required</em></p>                                                      | string | Nome do cargo                    |
| <p><a href="/pages/-LclZv5YlON3b0HnPt2Q#context"><strong>context</strong></a></p><p><em>optional</em></p> | object | Informações específicas por país |

#### Context

| Chave                                                                                                   | Tipo   | Descrição                             |
| ------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------- |
| <p><a href="/pages/-LclZv5YlON3b0HnPt2Q#brazil"><strong>brazil</strong></a></p><p><em>optional</em></p> | object | Informações específicas para o Brasil |

#### Brazil

| Chave                                                              | Tipo                                                                    | Descrição                                  |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------- | ------------------------------------------ |
| <p><strong>cbo</strong></p><p><em>optional</em></p>                | string                                                                  | Número do CBO                              |
| <p><strong>escolaridadeMinima</strong></p><p><em>optional</em></p> | string([options](/project/api/cargos.md#opcoes-de-escolaridade-minima)) | 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

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

## List roles

<mark style="color:blue;">`GET`</mark> `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*) |

{% tabs %}
{% tab title="200 " %}

```javascript
[
    {
        "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"
    }
]
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
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.
{% endhint %}

## Delete role

<mark style="color:red;">`DELETE`</mark> `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)*. |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://acessorh.gitbook.io/project/api/cargos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.